Настройка проекта консоли 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. Используйте поиск, чтобы найти 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 приводит к следующему, независимо от типа пользователя или статуса публикации вашего проекта:

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

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

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

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

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

      https://www.googleapis.com/auth/adwords
      
    • Нажмите ДОБАВИТЬ В ТАБЛИЦУ .

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

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

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

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

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

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

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

Выберите этот тип приложения Если ...
Настольное приложение
  • Вы управляете всеми своими аккаунтами 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. На странице подтверждения скопируйте свой идентификатор клиента и секрет клиента в буфер обмена, так как они понадобятся вам при настройке клиентской библиотеки. Вы также можете вернуться на страницу учетных данных позже, чтобы получить эти данные.