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