API Google Рекламы поддерживает связывание учетных записей Google Рекламы с учетными записями других продуктов. В этом руководстве объясняется, как использовать версию v16 API для связывания ваших учетных записей.
Способы связать аккаунты
При связывании аккаунта Google Рекламы с аккаунтом другого продукта существует два разных способа.
Приглашение
Поток приглашений используется, когда у вас есть доступ администратора к аккаунту Google Рекламы, но не к аккаунту продукта. Этот поток работает в двух сценариях:
- Вы хотите связать две учетные записи и создать приглашение для администратора учетной записи продукта. Администратор учетной записи продукта принимает приглашение завершить процесс привязки учетной записи.
- Администратор аккаунта продукта хочет связать два аккаунта, но у него нет доступа к аккаунту 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 и MerchantCenterLinkService
Если вы раньше использовали MerchantCenterLinkService или AccountLinkService для привязки аккаунта Google Рекламы к другому аккаунту продукта, вам необходимо перенести существующее приложение в один из рабочих процессов, перечисленных ранее. В следующей таблице показан статус миграции:
| Тип ссылки | Поддерживается в новых сервисах? | Поддержка доступна с | Примечания |
|---|---|---|---|
DataPartnerIdentifier | Да | v15 | Перенос MerchantCenterLinkService |
GoogleAdsIdentifier | Да | v16 | Миграция с AccountLinkService |
MerchantCenterIdentifier | Да | v16 | Миграция с AccountLinkService |
AdvertisingPartnerIdentifier | Да | v16 | Миграция с AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier | Нет | – | Продолжить использование AccountLinkService |