При работе с Google Ads API адреса электронной почты используются в нескольких местах для управления контактами и доступом. Вот основные из них:
- Контактный адрес электронной почты Google Ads API. Адреса электронной почты, которым назначена роль Владелец или Редактор в вашем проекте Google Cloud. На эти адреса Google отправляет обязательные уведомления и административные сообщения.
- Адрес электронной почты аккаунта консоли Google Cloud: Адрес электронной почты, у которого есть доступ с правами администратора к облачному проекту Google Cloud, используемому для вашего приложения OAuth 2.0.
- Доступ к управляющему аккаунту Google Рекламы. Сервисный аккаунт (рекомендуется) или общий псевдоним электронной почты, у которого есть разрешения на доступ к управляющим аккаунтам Google Рекламы, доступным через Google Ads API.
В оставшейся части этого руководства подробно описывается каждый из перечисленных выше аккаунтов и то, как вы можете настроить их, чтобы ваша интеграция не зависела от адреса электронной почты отдельного пользователя.
Контактный адрес электронной почты для Google Ads API
Google отправляет административные уведомления, обновления проверок API, запросы на аудит, обязательные уведомления (MSA) и сообщения о связи в экстренных ситуациях на адреса электронной почты, связанные с ролями Владелец и Редактор вашего облачного проекта Google Cloud (см. Новые контактные адреса электронной почты API, поскольку устаревшие настройки контактных адресов электронной почты Центра API в интерфейсе Google Рекламы больше не поддерживаются).
Чтобы обновить контактный адрес электронной почты и обеспечить получение этих уведомлений всей командой, назначьте роль Владелец или Редактор общему псевдониму команды в облачном проекте Google Cloud и регулярно проверяйте электронные письма, отправленные на этот псевдоним.
Аккаунт консоли Google Cloud
Проект консоли Google Cloud содержит учетные данные OAuth вашего приложения и управляет доступом к Google Ads API. Чтобы обеспечить доступ к проекту, назначьте общему псевдониму команды роль Владелец или Редактор.
Чтобы добавить общий псевдоним в качестве владельца облачного проекта Google Cloud, выполните следующие действия:
- Войдите в консоль Google Cloud.
- Выберите проект в верхней части страницы.
- В меню навигации выберите IAM & Admin (IAM и администрирование) > IAM.
- Нажмите Предоставить доступ.
- В разделе Добавление субъектов введите общий адрес электронной почты в поле Новые субъекты.
- В разделе Назначение ролей нажмите Выберите роль и выберите Базовые > Владелец (или Базовые > Редактор).
- Нажмите Сохранить. Если вы предоставили роль владельца пользователю с адресом электронной почты, который не относится к вашей организации Google Cloud (или к проекту без организации), Google Cloud отправит на этот адрес электронное письмо с приглашением. Чтобы роль вступила в силу, приглашение нужно принять. Подробнее о том, как предоставлять и отзывать доступ, рассказывается в документации по Cloud.
управляющий аккаунт Google Ads
Распространенный способ управления аккаунтами с помощью Google Ads API – связать все аккаунты с общим управляющим аккаунтом и выполнять вызовы API ко всем аккаунтам, используя учетные данные управляющего аккаунта верхнего уровня. В этой конфигурации разработчик задает в заголовке запроса login-customer-id (или в параметре конфигурации клиентской библиотеки login_customer_id) 10-значный идентификатор клиента (без дефисов) управляющего аккаунта Google Рекламы, а в качестве целевого аккаунта customer_id указывает рабочий аккаунт, в который отправляются вызовы API.
Рекомендуемый вариант: используйте сервисный аккаунт
Для аутентификации и доступа к управляющему аккаунту Google Рекламы рекомендуется использовать сервисный аккаунт. В отличие от индивидуальных аккаунтов пользователей, сервисный аккаунт управляется в рамках проекта Google Cloud и не привязан к конкретному человеку, что позволяет избежать сбоев, когда участники команды меняют роли или уходят из компании. Следуйте руководству по работе с сервисными аккаунтами, чтобы создать сервисный аккаунт и предоставить ему доступ к управляющему аккаунту Google Рекламы.
Альтернативный вариант: используйте общий псевдоним электронной почты
Если в вашей интеграции нельзя использовать сервисный аккаунт и вместо этого применяется процесс аутентификации одного пользователя, то пользователь с доступом к управляющему аккаунту Google Рекламы выдает токен обновления OAuth 2.0.
Чтобы избежать этого при использовании учетных данных пользователя:
- Пригласите общий псевдоним электронной почты (связанный с активным аккаунтом Google, в котором включена проверка с помощью ключа доступа) для управления этим управляющим аккаунтом Google Рекламы с соответствующими уровнями доступа.
- Примите приглашение, используя общий псевдоним электронной почты.
- Используйте этот общий псевдоним электронной почты, чтобы выпустить токен обновления OAuth для вызовов API.