Миграция привязки аккаунта

Управление отношениями между аккаунтами претерпело эволюцию от метода единственной link в Content API for Shopping до более детальной и подробной системы в Merchant API. Новый API использует специальные ресурсы, такие как AccountRelationship и AccountService для определения конкретных услуг, предоставляемых одним аккаунтом другому. Подробнее см. в разделе « Отношения между аккаунтами» .

Ключевые отличия

  • Специализированные ресурсы для отношений и услуг : в Merchant API ресурс AccountRelationship определяет связь между поставщиком услуг и продавцом, а ресурс AccountService определяет конкретную предоставляемую услугу (например, accountAggregation ). Он заменяет общие поля linkType и services из Content API for Shopping.
  • Явные методы действий : вместо одного метода link с параметром action API-интерфейс Merchant использует отдельные методы для управления службами, такие как propose , approve и reject .
  • Специальная привязка к бизнес-профилю Google : привязка к бизнес-профилю Google, которая ранее осуществлялась путем настройки поля googleMyBusinessLink , теперь имеет специальный метод gbpAccounts.linkGbpAccount .
  • Создание клиентской учётной записи как услуга : создание клиентской учётной записи в рамках расширенной учётной записи теперь рассматривается как предложение услуги accountAggregation с помощью метода accounts.createAndConfigure . Подробнее об учётных записях см. на странице API торговых учётных записей . Подтверждение не требуется, поскольку у пользователя есть доступ как к расширенной учётной записи, так и к клиентской.

Запросы

API торговца предоставляет определенные конечные точки для управления различными типами связей и услуг счетов:

URL-адреса запросов API торговца

  • Предложить новую услугу : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Одобрить услугу : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Отклонить услугу : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Ссылка на профиль компании в Google : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Создайте учетную запись клиента (ссылка для агрегации учетных записей) : POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Запросить сравнение URL

Запросить описание API контента для покупок API торговца
Связать аккаунты (например, сторонние платформы) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Ссылка на профиль компании Google PUT .../v2.1/{merchantId}/accounts/{accountId} (с полем googleMyBusinessLink ) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Создать учетную запись клиента POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Методы

API контента для метода покупок Метод API торговца Доступность и примечания
accounts.link accountServices.propose Используйте этот метод для инициирования новой услуги с другой учетной записью.
accounts.link (с action: "approve" ) accountServices.approve Используйте этот метод для одобрения ожидающего рассмотрения предложения об услуге.
accounts.link (с action: "remove" ) accountServices.reject Используйте этот метод для отклонения ожидающей или установленной услуги.
accounts.insert (для клиентских аккаунтов) accounts.createAndConfigure Используйте этот метод со службой accountAggregation для создания новой клиентской учетной записи в рамках расширенной учетной записи.
accounts.update (с googleMyBusinessLink ) gbpAccounts.linkGbpAccount Используйте этот специальный метод для привязки аккаунта Merchant Center к профилю компании Google.
accounts.update (с adsLinks ) Ресурс AccountRelationship Связывание с Google Ads осуществляется через пользовательский интерфейс Google Ads. Полученная связь представлена как AccountRelationship в API Merchant, который можно просматривать, но нельзя создать напрямую.

Подробные изменения полей

API контента для покупок API торговца Описание
AccountsLinkRequest.action propose , approve , reject методы Поле отдельного action заменяется специализированными методами API для каждого изменения состояния в жизненном цикле услуги.
AccountsLinkRequest.linkType AccountService.service_type Универсальная строка linkType заменяется структурированным полем service_type oneof в ресурсе AccountService , например productsManagement или accountAggregation
AccountsLinkRequest.services AccountService.service_type Список строковых служб теперь представлен конкретным service_type выбранным в ресурсе AccountService .
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider Идентификатор учетной записи, предоставляющей услугу, теперь указывается в поле provider запроса propose .
Account.googleMyBusinessLink LinkGbpAccountRequest Объект, содержащий данные ссылки GBP, заменяется специальным сообщением-запросом для метода linkGbpAccount .
Account.adsLinks AccountRelationship Ссылки Google Рекламы представлены как ресурс AccountRelationship , где provider — providers/GOOGLE_ADS . Управление этой связью обычно осуществляется через интерфейс Google Рекламы.