Настройка проекта консоли 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 Ads API в своем проекте.

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

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

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

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. Просмотрите сводную страницу и нажмите «ВЕРНУТЬСЯ НА ПАНЕЛЬ ПАНЕЛИ» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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