Способ создания и настройки проекта Google API Console зависит от сценария авторизации OAuth 2.0 в вашем приложении. Выберите сценарий авторизации, чтобы настроить это руководство.
Чтобы создать учетные данные OAuth 2.0 и включить Google Ads API для своего приложения, вам потребуется проект Google API Console.
Эти учетные данные используются для аутентификации и авторизации вашего приложения или пользователей Google Рекламы на серверах Google и позволяют генерировать токены OAuth, которые будут использоваться при вызовах API.
Как выбрать или создать проект Google API Console
Чтобы настроить новый проект, следуйте руководству по созданию проекта Google API Console. Включать платежные функции для проекта необязательно. Если у вас включена оплата, выберите платежный аккаунт для нового проекта. Google Ads API можно использовать бесплатно, но на облачные проекты распространяются стандартные квоты.
Как включить Google Ads API в проекте
Чтобы включить Google Ads API в проекте, выполните следующие действия:
Откройте библиотеку API в Google API Console. При необходимости выберите проект или создайте новый. В библиотеке API перечислены все доступные API, сгруппированные по семейству продуктов и популярности.
Если вы не видите Google Ads API в списке, воспользуйтесь поиском.
Выберите Google Ads API и нажмите кнопку Включить.
Как запросить доступ к API
Затем перейдите на обзорную страницу Google Ads API и проверьте текущий уровень доступа к API. Если у вас тестовый уровень доступа, разверните раздел Повысить уровень доступа. Следуйте инструкциям, чтобы подать заявку на уровень доступа Исследователь.
После того как вы заполните заявку, 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 в диалоговом окне подтверждения.