Способ создания и настройки проекта в Google API Console зависит от сценария авторизации OAuth 2.0 вашего приложения. Выберите сценарий авторизации, чтобы настроить это руководство.
Для создания учетных данных OAuth 2.0 и включения Google Ads API для вашего приложения вам потребуется проект в Google API Console.
Эти учетные данные аутентифицируют и авторизуют пользователей вашего приложения или Google Ads на серверах Google и позволяют генерировать токены OAuth для использования в запросах к API.
Выберите или создайте проект в Google API Console.
Чтобы создать новый проект, следуйте инструкциям по созданию проекта в Google API Console . Включение оплаты для вашего проекта необязательно. Если оплата включена, выберите платежный аккаунт для нового проекта. Использование Google Ads API бесплатно, однако на проекты в облаке распространяются стандартные ограничения по квоте проекта.
Включите API Google Ads в своем проекте.
Чтобы включить API Google Ads в вашем проекте, выполните следующие действия:
Откройте библиотеку API в консоли Google API. При появлении запроса выберите свой проект или создайте новый. В библиотеке API отображаются все доступные API, сгруппированные по семействам продуктов и популярности.
Воспользуйтесь поиском, чтобы найти API Google Ads, если он не отображается в списке.
Выберите Google Ads API , затем нажмите кнопку «Включить» .
Подайте заявку на доступ к API
Далее перейдите на страницу обзора API Google Ads , чтобы проверить свой текущий уровень доступа к API . Если ваш текущий уровень доступа к API — «Тест» , разверните раздел «Повысить уровень доступа» . Следуйте инструкциям, чтобы применить уровень доступа «Explorer» .
После заполнения заявки Google автоматически проверит её и в большинстве случаев предоставит доступ к Explorer.
Настройте экран согласия OAuth.
При использовании OAuth 2.0 для авторизации Google отображает пользователю экран согласия, содержащий краткое описание вашего проекта, его политики и запрашиваемые области доступа. Настройка экрана согласия OAuth для вашего приложения определяет, что отображается пользователям и рецензентам приложения, а также регистрирует ваше приложение, чтобы вы могли опубликовать его позже.
Настройте экран согласия OAuth для вашего приложения и добавьте https://www.googleapis.com/auth/adwords в качестве области действия OAuth.
Важные моменты, которые следует учитывать при выборе типа пользователя и статусе публикации.
При настройке экрана согласия OAuth обратите внимание на параметры « Тип пользователя» и «Статус публикации» .
- Тип пользователя: определяет, будет ли ваше приложение доступно только пользователям внутри вашей организации ( внутренний ) или любому пользователю Google ( внешний ). Внутренний тип доступен только в том случае, если ваш проект является частью организации Google Workspace.
- Статус публикации: определяет, находится ли приложение в режиме тестирования (доступно только определенным пользователям, которых вы добавите) или в рабочем режиме (доступно для аудитории, определенной типом пользователя , что может потребовать проверки приложения компанией Google).
Чтобы сделать оптимальный выбор для вашего приложения, ознакомьтесь с подробными объяснениями и последствиями этих настроек в официальной документации службы поддержки Google Cloud:
- Параметры типа пользователя на экране согласия OAuth
- Параметры статуса публикации экрана согласия OAuth
Понимание этих настроек имеет решающее значение для обеспечения доступности вашего приложения для целевых пользователей.
Создайте идентификатор клиента и секретный ключ клиента.
Создайте идентификатор клиента и секретный ключ клиента . В качестве типа приложения вы можете выбрать либо настольное приложение , либо веб-приложение . После создания клиента OAuth 2.0 загрузите JSON-файл клиента, нажав кнопку «Загрузить JSON» в диалоговом окне подтверждения.