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

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

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

  • Выделенные ресурсы для связей и услуг : В Merchant API ресурс AccountRelationship определяет связь между поставщиком услуг и продавцом, а ресурс AccountService указывает точную предоставляемую услугу (например, accountAggregation ). Это заменяет общие поля linkType и services из Content API для покупок.
  • Явные методы действий : Вместо одного метода link с параметром action , Merchant API использует отдельные методы для управления услугами, такие как 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} (with googleMyBusinessLink field) 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 (with googleMyBusinessLink ) gbpAccounts.linkGbpAccount Воспользуйтесь этим специальным методом для привязки аккаунта Merchant Center к профилю Google Business.
accounts.update (with adsLinks ) Ресурс AccountRelationship Связывание с Google Ads осуществляется через пользовательский интерфейс Google Ads. Полученная связь представляется в Merchant API как AccountRelationship , которую можно просмотреть, но нельзя создать напрямую.

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

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 Объект, содержащий подробную информацию о ссылке в фунтах стерлингов, заменяется специальным запросом для метода linkGbpAccount .
Account.adsLinks AccountRelationship Ссылки Google Ads представлены в виде ресурса AccountRelationship , где provider является providers/GOOGLE_ADS . Управление этими связями обычно осуществляется через пользовательский интерфейс Google Ads.