API Google Ads поддерживает связывание аккаунтов Google Ads с другими аккаунтами товаров. В этом руководстве объясняется, как использовать API для связывания ваших аккаунтов.
Способы связывания учетных записей
При связывании аккаунта Google Ads с другим аккаунтом продукта существует два разных способа осуществления этой связи.
Поток приглашений
Процесс отправки приглашений используется, когда у вас есть права администратора в аккаунте Google Ads, но нет прав доступа к аккаунту продукта. Этот процесс работает в двух сценариях:
- Вы хотите связать две учетные записи и создать приглашение для администратора учетной записи продукта. Администратор учетной записи продукта принимает приглашение, чтобы завершить процесс связывания учетных записей.
- Администратор аккаунта продукта хочет связать два аккаунта, но не имеет доступа к аккаунту Google Ads. Администратор аккаунта продукта создает приглашение, вы принимаете приглашение и завершаете процесс связывания.
В данном сценарии используются следующие методы:
| Сценарий | Действие | Примечания |
|---|---|---|
| Сценарий 1 | Создать приглашение | Для создания приглашения используйте метод ProductLinkInvitationService.CreateProductLinkInvitation . status объекта ProductLinkInvitation не должен быть установлен; сервер Google Ads API установит его в значение 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 . | |
| Отозвать приглашение | Для отмены существующего ProductLinkInvitation ProductLinkInvitation используйте метод ProductLinkInvitationService.RemoveProductLinkInvitation . |
В этом рабочем процессе могут возникать следующие распространенные ошибки:
| Код ошибки | Объяснение |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED | У клиента нет разрешения на выполнение этого действия. |
ProductLinkError.NO_INVITATION_REQUIRED | Не удалось создать приглашение, поскольку у пользователя уже есть права администратора в приглашенной учетной записи. Пользователю следует использовать ProductLinkService для непосредственного создания активной ссылки. |
Прямой поток связи
Прямая привязка используется, когда у вас есть административный доступ как к аккаунту Google Ads, так и к аккаунту продукта. В этом случае вы напрямую связываете аккаунт Google Ads с аккаунтом продукта, вместо того чтобы отправлять приглашение.
В данном сценарии используются следующие методы:
| Действие | Примечания |
|---|---|
| Создать активную ссылку | Используйте ProductLinkService.createProductLink для создания ProductLink . |
| Отключить активную ссылку | Используйте ProductLinkService.removeProductLink для удаления активной ProductLink . |
| Получить активные ссылки | Для запроса ресурса product_link используйте GoogleAdsService.Search или GoogleAdsService.SearchStream . |
В этом рабочем процессе могут возникать следующие распространенные ошибки:
| Код ошибки | Объяснение |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED | Была предпринята попытка связать учетную запись с помощью прямой ссылки, но это не поддерживается из-за отсутствия необходимых разрешений. Пользователю следует использовать ProductLinkInvitationService для создания приглашения. |
ProductLinkError.INVITATION_EXISTS | Создать ссылку невозможно, поскольку уже существует ожидающее подтверждения приглашение. |
Восстановить существующие ссылки на товары
Вы можете получить все ссылки на товары, связанные с вашим аккаунтом Google Ads, используя GAQL-запрос к ресурсу product_link .
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
Поле product_link.type указывает тип связанного продукта или услуги. В зависимости от type будут заполнены другие поля ресурса product_link , предоставляющие более подробную информацию о ссылке. Например, если тип — THIRD_PARTY_APP_ANALYTICS , поле third_party_app_analytics будет содержать информацию о поставщике аналитики.
Это позволяет получить список внешних сервисов и приложений, напрямую связанных с вашим аккаунтом Google Ads, таких как Google Play, партнеры по обработке данных или сторонние платформы для анализа приложений.
Изменения в AccountLinkService
Если вы используете AccountLinkService для привязки аккаунта Google Ads к другому аккаунту продукта, вам необходимо перевести существующее приложение на один из перечисленных ранее рабочих процессов. Для следующих типов привязки откажитесь от AccountLinkService и используйте ProductLinkService :
-
GoogleAdsIdentifier -
MerchantCenterIdentifier -
AdvertisingPartnerIdentifier
Для ThirdPartyAppAnalyticsLinkIdentifier продолжайте использовать AccountLinkService .