Последовательность действий для создания и настройки проекта в Google API Console зависит от типа сценария авторизации OAuth 2.0, который вы используете в своем приложении. Выберите сценарий авторизации, для которого вы разрабатываете приложение; данное руководство будет адаптировано в соответствии с вашим выбором.
Для создания учетных данных OAuth 2.0 и включения Google Ads API для вашего приложения вам потребуется проект в Google API Console.
Учетные данные необходимы для аутентификации и авторизации пользователей Google Ads серверами Google. Эти учетные данные позволяют генерировать токены OAuth для использования в запросах к API.
Хотя вы можете использовать один токен разработчика для нескольких проектов, каждый проект может использовать только один токен разработчика.
Выберите или создайте проект в Google API Console.
Следуйте инструкциям , чтобы создать проект. Включение оплаты для вашего проекта необязательно. Если оплата включена, выберите платежный аккаунт для нового проекта. Использование API Google Ads бесплатно, но существует квота на общее количество проектов в облаке.
Включите API Google Ads в своем проекте.
Чтобы включить API Google Ads в вашем проекте, выполните следующие действия:
Откройте библиотеку API в консоли Google API. При появлении запроса выберите свой проект или создайте новый. В библиотеке API отображаются все доступные API, сгруппированные по семействам продуктов и популярности.
Воспользуйтесь поиском, чтобы найти API Google Ads, если он не отображается в списке.
Выберите API Google Ads, затем нажмите кнопку «Включить» .
Настройте экран согласия OAuth.
При использовании OAuth 2.0 для авторизации Google отображает пользователю экран согласия, содержащий краткое описание вашего проекта, его политики и запрашиваемые области доступа. Настройка экрана согласия OAuth для вашего приложения определяет, что отображается пользователям и рецензентам приложения, а также регистрирует ваше приложение, чтобы вы могли опубликовать его позже.
Следуйте инструкциям , чтобы настроить экран согласия OAuth для вашего приложения и добавьте https://www.googleapis.com/auth/adwords в качестве области действия OAuth.
Важные моменты, которые следует учитывать при выборе типа пользователя и статусе публикации.
При настройке экрана согласия OAuth обратите внимание на параметры « Тип пользователя» и «Статус публикации» .
- Тип пользователя: определяет, будет ли ваше приложение доступно только пользователям внутри вашей организации («Внутренние») или любому пользователю Google («Внешние»). Обратите внимание, что вариант «Внутренние» доступен только в том случае, если ваш проект является частью организации Google Workspace.
- Статус публикации: определяет, находится ли приложение в режиме «Тестирование» (доступно только определенным пользователям, которых вы добавите в тестовый режим) или в режиме «В эксплуатации» (доступно для аудитории, определенной типом пользователя, и может потребовать проверки приложения компанией Google).
Чтобы сделать оптимальный выбор для вашего приложения, ознакомьтесь с подробными объяснениями и последствиями этих настроек в официальной документации службы поддержки Google Cloud:
- Параметры типа пользователя на экране согласия OAuth
- Параметры статуса публикации экрана согласия OAuth
Понимание этих настроек имеет решающее значение для обеспечения доступности вашего приложения для целевых пользователей.
Создайте идентификатор клиента и секретный ключ клиента.
Этот шаг можно пропустить, если вы используете существующий проект Google API Console, в котором уже сгенерированы идентификатор клиента и секретный ключ клиента. В противном случае создайте идентификатор клиента и секретный ключ клиента, следуя инструкциям . В качестве типа приложения можно выбрать либо настольное приложение , либо веб-приложение . После создания клиента OAuth 2.0 загрузите JSON-файл клиента, сначала нажав на значок «Загрузить клиент OAuth» , а затем на кнопку «ЗАГРУЗИТЬ JSON» на следующем экране.