Настройка проекта консоли Google API для Google Ads API

Учетные данные для доступа к серверам Google OAuth2 необходимы для аутентификации и авторизации пользователей Google Рекламы. Эти учетные данные идентифицируют ваше приложение для Google, что позволяет вам генерировать токены OAuth для управления пользователями Google Рекламы. Доступ к учетным данным Google OAuth2 управляется из консоли Google API .

Посмотрите это видео, чтобы узнать о некоторых лучших практиках облачных проектов.

Проверка Google OAuth

Любое приложение Google Cloud, используемое для получения учетных данных для области Google Ads API, должно будет пройти проверку Google OAuth, чтобы избежать появления непроверенного экрана пользовательского интерфейса для своих пользователей. В этом контексте приложение определяется как уникальный идентификатор клиента OAuth 2.0 в Google Cloud.

Эта проверка является независимой и дополняет любые проверки, проводимые в рамках процесса утверждения токена разработчика , и является обязательной, поскольку область действия API Google Рекламы является конфиденциальной областью .

Проверка Google не требует затрат и обычно занимает от 3 до 5 рабочих дней. Эта политика применяется ко всем приложениям.

Мы рекомендуем как можно скорее пройти проверку Google OAuth для всех приложений, чтобы избежать перебоев в работе.

Создать проект

Перейдите в консоль Google API . Нажмите «Создать проект» , введите имя и нажмите «Создать» .

Ключевой момент: если у вас включена оплата (например, для Google Cloud), вам необходимо выбрать учетную запись для выставления счетов для нового проекта.

За использование Google Ads API плата не взимается, однако существует квота на общее количество облачных проектов. Кроме того, вы можете зарегистрировать новую учетную запись Google, которая включает бесплатную квоту проекта.

Включите Google Ads API в своем проекте.

Чтобы включить API Google Рекламы для вашего проекта, выполните следующие действия:

1. Откройте библиотеку API в консоли Google API. При появлении запроса выберите свой проект или создайте новый. В библиотеке API перечислены все доступные API, сгруппированные по семействам продуктов и популярности.

2. Используйте поиск, чтобы найти Google Ads API, если его нет в списке.

3. Выберите Google Ads API, затем нажмите кнопку «Включить» .

Выберите тип пользователя и статус публикации

После включения API вам необходимо указать тип пользователя и статус публикации вашего проекта. В следующей таблице показаны некоторые ключевые атрибуты и ограничения каждой комбинации этих параметров. Более подробную информацию можно найти в документации Google Cloud Platform .

Тип пользователя	Статус публикации	Ограничения
Внутренний	Тестирование	Доступно только для проектов, связанных с организацией Google Cloud. Ограничено до 100 тестовых пользователей, перечисленных на экране согласия OAuth. Тестовые пользователи должны быть внутренними пользователями в организации Google Cloud, связанной с проектом. Срок действия разрешений истекает через семь дней с момента получения согласия.
Внешний	Тестирование	Доступно для всех проектов. Ограничено до 100 тестовых пользователей, перечисленных на экране согласия OAuth. Тестовыми пользователями могут быть любые пользователи с учетной записью Google. Срок действия разрешений истекает через семь дней с момента получения согласия.
Внутренний	В производстве	Доступно только для проектов, связанных с организацией Google Cloud. Позволяет авторизовать любого пользователя в организации Google Cloud, связанной с проектом.
Внешний	В производстве	Доступно для всех проектов. Позволяет авторизовать любого пользователя с учетной записью Google.

Невыполнение проверки Google OAuth приводит к следующему, независимо от типа пользователя или статуса публикации вашего проекта:

• В процессе авторизации пользователям предоставляется непроверенный экран пользовательского интерфейса .

• Вы можете авторизовать только 100 пользователей.

Настройка экрана согласия OAuth

1. Откройте страницу «Экран согласия» и выберите свой проект в раскрывающемся меню вверху страницы.

2. Выберите тип пользователя и нажмите СОЗДАТЬ .

3. Заполните экранную форму согласия. При необходимости вы можете отредактировать это позже. Нажмите СОХРАНИТЬ И ПРОДОЛЖИТЬ, когда закончите.

4. На следующей странице нажмите ДОБАВИТЬ ИЛИ УДАЛИТЬ ОБЛАСТИ .

   • Прокрутите вниз и введите следующее в поле « Добавление областей вручную» :

     https://www.googleapis.com/auth/adwords
     

   • Нажмите ДОБАВИТЬ В ТАБЛИЦУ .

   • Добавьте любые другие области, которые запросит ваш проект, затем нажмите «ОБНОВИТЬ» .

   • Нажмите СОХРАНИТЬ И ПРОДОЛЖИТЬ .

5. Если вы не планируете публиковать свой проект немедленно, добавьте адрес электронной почты каждой учетной записи пользователя, которую вы будете использовать для тестирования, затем нажмите «СОХРАНИТЬ И ПРОДОЛЖИТЬ» .

6. Просмотрите сводную страницу и нажмите «ВЕРНУТЬСЯ НА ПАНЕЛЬ ПАНЕЛИ» .

После того как вы протестировали свое приложение и процесс авторизации, вы можете вернуться на панель управления и нажать «ПУБЛИКОВАТЬ ПРИЛОЖЕНИЕ», чтобы изменить его статус публикации с «Тестирование» на «В производстве» .

Выберите тип приложения

Для API Google Рекламы существует два типа приложений: настольное или веб-приложение. Обратитесь к следующей таблице, чтобы определить, какой тип наиболее подходит для приложения, которое вы хотите создать:

Выберите этот тип приложения	Если ...
Настольное приложение	Вы управляете всеми своими аккаунтами Google Рекламы с помощью одного управляющего аккаунта верхнего уровня. Вы впервые пользуетесь программой или хотите быстро начать работу с простейшей настройкой. Ваше приложение будет аутентифицировать пользователей Google только с одного компьютера.
Веб-приложение	Вы хотите пройти аутентификацию как пользователь, который может предоставить вашему приложению разрешение на доступ к данным своего аккаунта Google Рекламы. Вы хотите легко создавать несколько учетных данных для авторизации, например, для управления сторонними учетными записями. Вашему приложению требуются URL-адреса обратного вызова. URL-адреса обратного вызова не поддерживаются в потоке настольного приложения.

Ключевой момент: вы по-прежнему можете выбрать процесс создания настольного приложения, даже если вы разрабатываете приложение для запуска на сервере. Разница заключается в том, выполняется ли авторизация OAuth локально или удаленно. Поток рабочего стола требует завершения авторизации на локальном компьютере, тогда как веб-поток позволяет выполнить авторизацию на сервере авторизации Google.

Дополнительные сведения см. в документации Google Identity Platform OAuth для настольных или веб-приложений .

Создайте идентификатор клиента и секрет клиента.

Определив тип приложения, следуйте приведенным ниже инструкциям, чтобы сгенерировать идентификатор клиента OAuth2 и секрет клиента:

1. Откройте страницу учетных данных . Выберите ранее созданный проект или создайте новый.

2. На экране «Учетные данные» нажмите «СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ» , затем выберите «Идентификатор клиента OAuth» .

   1. Если вы ранее не настроили экран согласия OAuth для этого проекта, вам будет предложено сделать это сейчас. Нажмите НАСТРОЙКА ЭКРАНА СОГЛАСИЯ .

      1. Выберите тип пользователя и нажмите СОЗДАТЬ .

      2. Заполните первоначальную форму. При необходимости вы можете отредактировать это позже. Нажмите «Сохранить», когда закончите.

   2. Вернитесь в раздел «Учетные данные» > «СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ» > «Идентификатор клиента OAuth», чтобы продолжить.

3. Выберите настольное приложение или веб-приложение в качестве типа приложения, в зависимости от вашего варианта использования.

4. Дайте ему имя, затем нажмите «Создать» .

5. Если тип вашего клиента — веб-приложение , добавьте хотя бы один URI авторизованного перенаправления.

   Для локального тестирования, совместимого с конфигурацией по умолчанию в примерах нашей клиентской библиотеки, используйте http://127.0.0.1 .

   Примечание. Вы можете добавить номер порта в свой URI перенаправления, чтобы ограничить использование определенного порта. Если порт не установлен, клиент OAuth может перенаправить на любой порт.

   Для клиентов настольных приложений вы по-прежнему будете использовать перенаправление IP-адреса с обратной связью , но URI не настраивается явно в облачной консоли.

6. На странице подтверждения скопируйте свой идентификатор клиента и секрет клиента в буфер обмена, так как они понадобятся вам при настройке клиентской библиотеки. Вы также можете вернуться на страницу учетных данных позже, чтобы получить эти данные.