Общие псевдонимы

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

• Контактный адрес электронной почты API Google Ads : этот адрес электронной почты указан в качестве контакта в API-центре пользовательского интерфейса Google Ads.
• Электронная почта учетной записи Google Cloud Console : это адрес электронной почты, имеющий доступ администратора к учетной записи Google Cloud Console, используемой для вашего приложения OAuth 2.0.
• Адреса электронной почты управляющего аккаунта Google Ads : это адреса электронной почты, имеющие права администратора управляющего аккаунта Google Ads, к которому вы получаете доступ через API Google Ads. При создании токена обновления для своего приложения вы обычно аутентифицируете его API Google Ads с помощью одного из этих адресов.

Мы настоятельно рекомендуем использовать общие командные псевдонимы, чтобы не потерять доступ к этим учётным записям при переходе отдельных членов команды в другую команду или увольнении из компании. Далее в этом руководстве подробно рассматривается каждый из перечисленных ранее адресов электронной почты и то, как можно изменить его, чтобы использовать общий командный псевдоним вместо адреса электронной почты отдельного пользователя.

Контактный адрес электронной почты API Google Ads

Контактный адрес электронной почты Google Ads API — это адрес электронной почты, который вы указываете при регистрации в Google Ads API. Вам следует обеспечить доступ к этому псевдониму и регулярно проверять письма, отправляемые на этот адрес. Google использует этот адрес электронной почты для связи с вашей командой во время проверок API, запросов на аудит или чрезвычайных ситуаций, требующих немедленного внимания. Используйте общий псевдоним команды в качестве контактного адреса электронной почты, чтобы гарантировать, что все члены команды получат эти уведомления.

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

1. Войдите в свой аккаунт менеджера Google Ads.

2. Нажмите «Администратор» в левом нижнем углу экрана.

3. В разделе «Настройки учетной записи менеджера» нажмите «Центр API» .

4. В разделе «Сведения о разработчике» найдите контактный адрес электронной почты API. Нажмите стрелку вниз и отредактируйте адрес электронной почты. Нажмите «Сохранить» .

Учетная запись Google Cloud Console

Проект Google API Console содержит учётные данные OAuth вашего приложения и управляет доступом к API Google Ads. Обеспечьте доступ к этой учётной записи, назначив её владельцу общий псевдоним.

Чтобы обновить владельца проекта Google API Console, выполните следующие действия:

• Войдите в консоль API Google .
• Выберите свой проект из раскрывающегося меню в левом верхнем углу страницы.
• Перейдите в раздел IAM и администрирование > IAM в меню слева.
• Нажмите кнопку Предоставить доступ .
• Введите общий адрес электронной почты в разделе «Добавить участников» .
• Назначьте роль владельца .
• Нажмите кнопку «Сохранить» . Подробнее о предоставлении и отзыве доступа см. в документации Cloud.

Управляющий аккаунт Google Ads

Распространённый метод управления аккаунтами с помощью API Google Ads — это объединение всех аккаунтов в один управляющий аккаунт и выполнение вызовов API ко всем аккаунтам, используя данные самого верхнего управляющего аккаунта. В этой конфигурации:

• Разработчик выпускает токен обновления, используя учетные данные пользователя, имеющего доступ к аккаунту менеджера Google Ads.
• Разработчик устанавливает заголовок login_customer_id как идентификатор клиента учетной записи менеджера Google Ads, а заголовок customer_id — как идентификатор клиента учетной записи, к которой выполняются вызовы API.

Один из потенциальных рисков такой настройки заключается в том, что если авторизованный пользователь потеряет доступ к управляющему аккаунту Google Ads, токен обновления станет недействительным, и все вызовы API завершатся ошибкой. Чтобы избежать этого, вы можете пригласить общий псевдоним электронной почты для управления этим управляющим аккаунтом Google Ads с соответствующими уровнями доступа . Используйте этот общий псевдоним электронной почты для выдачи токена обновления для выполнения вызовов API.