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

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

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

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

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

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

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

• Войдите в управляющий аккаунт Google Рекламы, который вы использовали при подаче заявки на доступ к Google Реклама API. Это та же учетная запись, в которой находится ваш токен разработчика.
• Перейдите в Инструменты и настройки > Центр API .
• Нажмите стрелку под разделом контактной электронной почты API .
• Обновите адрес электронной почты и нажмите кнопку «Сохранить» .

Аккаунт Google Cloud Console

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

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

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

Управляющий аккаунт Google Рекламы

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

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

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