Способ создания и настройки проекта 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. Если у вас уровень доступа к 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 в диалоговом окне подтверждения.