Google Ads API позволяет связывать аккаунты Google Рекламы с аккаунтами других продуктов. В этом руководстве рассказывается, как связать аккаунты с помощью API.
Как связать аккаунты
Связать аккаунт Google Рекламы с аккаунтом другого продукта можно двумя способами.
Процесс приглашения
Используйте приглашение, если у вас есть доступ с правами администратора к аккаунту Google Рекламы, но не к аккаунту продукта. Этот процесс работает в двух сценариях:
- Вы хотите связать эти два аккаунта и создать приглашение для администратора аккаунта продукта. Администратор аккаунта продукта принимает приглашение, чтобы завершить процесс связывания аккаунтов.
- Администратор аккаунта продукта хочет связать два аккаунта, но у него нет доступа к аккаунту Google Рекламы. Администратор аккаунта продукта создает приглашение, а вы принимаете его и завершаете процесс связывания.
В этом случае используйте следующие методы:
| Сценарий | Действие | Примечания |
|---|---|---|
| Scenario 1 | Как создать приглашение | Чтобы создать приглашение, используйте метод
ProductLinkInvitationService.CreateProductLinkInvitation. Не задавайте значение status для
ProductLinkInvitation. Сервер Google Ads API установит значение REQUESTED после успешного завершения вызова API. При создании приглашения для партнера по рекламе (AdvertisingPartnerLinkInvitationIdentifier) начиная с версии 25 необходимо указывать advertising_partner_properties.allowed_domain (в версии 24 и более ранних это необязательно). |
| Как проверить статус приглашения | Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream, чтобы запросить ресурс product_link_invitation и проверить его статус. |
|
| Scenario 2 | Как получить приглашение | Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream, чтобы запросить ресурс product_link_invitation. Чтобы принять или отклонить ожидающее приглашение, отфильтруйте список по значению
status = PENDING_APPROVAL. |
| Как принять или отклонить приглашение | Используйте метод
ProductLinkInvitationService.UpdateProductLinkInvitation, чтобы изменить статус
ProductLinkInvitation на ACCEPTED или REJECTED. |
|
| Как отозвать приглашение | Чтобы отозвать существующий объект
ProductLinkInvitation, используйте метод
ProductLinkInvitationService.RemoveProductLinkInvitation. |
В этом рабочем процессе могут возникать следующие распространенные ошибки:
| Код ошибки | Описание |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
У клиента нет разрешения на выполнение этого действия. |
ProductLinkInvitationError.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 |
Невозможно создать ссылку, поскольку уже есть ожидающее приглашение. |
Как получить существующие ссылки на товары
Чтобы получить все ссылки на продукты, связанные с вашим аккаунтом Google Рекламы, используйте запрос GAQL к ресурсу product_link.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
Поле product_link.type указывает на тип связанного продукта или сервиса.
В зависимости от значения type будут заполнены другие поля ресурса product_link, содержащие дополнительные сведения о ссылке. Например, если тип – DATA_PARTNER, то поле data_partner будет содержать информацию о связанном аккаунте партнера по обработке данных.
Это позволяет получить список внешних сервисов и аккаунтов продуктов, связанных непосредственно с вашим аккаунтом Google Рекламы, например Merchant Center, Google Рекламы, партнеров по рекламе или партнеров по обработке данных.
Изменения в AccountLinkService
Если вы используете AccountLinkService, чтобы связать аккаунт Google Рекламы с аккаунтом другого продукта, вам нужно перенести существующее приложение в один из рабочих процессов, перечисленных выше. Для следующих типов ссылок прекратите использовать AccountLinkService и перейдите на ProductLinkService:
Для ThirdPartyAppAnalyticsLinkIdentifier продолжайте использовать AccountLinkService.