Связывание учетных записей продуктов

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

Способы связать аккаунты

При связывании аккаунта Google Рекламы с аккаунтом другого продукта существует два разных способа.

Приглашение

Поток приглашений используется, когда у вас есть доступ администратора к аккаунту Google Рекламы, но не к аккаунту продукта. Этот поток работает в двух сценариях:

1. Вы хотите связать две учетные записи и создать приглашение для администратора учетной записи продукта. Администратор учетной записи продукта принимает приглашение завершить процесс привязки учетной записи.
2. Администратор аккаунта продукта хочет связать два аккаунта, но у него нет доступа к аккаунту Google Реклама. Администратор учетной записи продукта создает приглашение, вы принимаете приглашение и завершаете процесс связывания.

В этом сценарии используются следующие методы:

Сценарий	Действие	Примечания
Сценарий 1	Создать приглашение	Используйте метод ProductLinkInvitationService.CreateProductLinkInvitation , чтобы создать приглашение. status ProductLinkInvitation не должен быть установлен; Сервер API Google Рекламы установит для этого REQUESTED после успешного завершения вызова API.
	Проверить статус приглашения	Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream чтобы запросить ресурс product_link_invitation и проверить его статус.
Сценарий 2	Получить приглашение	Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream для запроса ресурса product_link_invitation . Отфильтруйте status = PENDING_APPROVAL , чтобы принять или отклонить ожидающее приглашение.
	Принять или отклонить приглашение	Используйте метод ProductLinkInvitationService.UpdateProductLinkInvitation , чтобы обновить статус ProductLinkInvitation на ACCEPTED или REJECTED .
	Отозвать приглашение	Используйте метод ProductLinkInvitationService.RemoveProductLinkInvitation , чтобы отозвать существующий ProductLinkInvitation .

В этом рабочем процессе могут возникнуть следующие распространенные ошибки:

Код ошибки	Объяснение
ProductLinkInvitationError.PERMISSION_DENIED	У клиента нет разрешения на выполнение этого действия.
ProductLinkError.NO_INVITATION_REQUIRED	Не удалось создать приглашение, поскольку у пользователя уже есть доступ администратора к приглашенной учетной записи. Пользователь должен использовать ProductLinkService для непосредственного создания активной ссылки.

Поток прямых ссылок

Прямая связь используется, когда у вас есть доступ администратора как к аккаунту Google Рекламы, так и к аккаунту продукта. В этом случае вы напрямую связываете аккаунт Google Рекламы с аккаунтом продукта, а не отправляете приглашение.

В этом сценарии используются следующие методы:

Действие	Примечания
Создайте активную ссылку	Используйте ProductLinkService.createProductLink для создания ProductLink .
Отключить активную ссылку	Используйте ProductLinkService.removeProductLink , чтобы удалить активную ProductLink .
Получить активные ссылки	Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream для запроса ресурса product_link .

В этом рабочем процессе могут возникать следующие распространенные ошибки:

Код ошибки	Объяснение
ProductLinkError.CREATION_NOT_PERMITTED	Была предпринята попытка связать учетную запись с использованием потока прямых ссылок, но это не поддерживается из-за отсутствия разрешений. Вместо этого пользователю следует использовать ProductLinkInvitationService для потока приглашений.
ProductLinkError.INVITATION_EXISTS	Невозможно создать ссылку, поскольку ожидающее приглашение уже существует.

Изменения в AccountLinkService

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

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

Для ThirdPartyAppAnalyticsLinkIdentifier продолжайте использовать AccountLinkService .