Migracja połączenia kont

Zarządzanie relacjami między kontami przeszło od pojedynczej link metody w Content API for Shopping do bardziej szczegółowego i jednoznacznego systemu w Merchant API. Nowy interfejs API korzysta z dedykowanych zasobów, takich jak AccountRelationship i AccountService, aby określić konkretne usługi, które jedno konto udostępnia innemu. Więcej informacji znajdziesz w artykule Powiązania między kontami.

Najważniejsze różnice

  • Dedykowane zasoby dla relacji i usług: w Merchant API zasób AccountRelationship określa połączenie między dostawcą usług a sprzedawcą, a zasób AccountService określa dokładną usługę (np. accountAggregation). Zastępuje to ogólne pola linkType i services z Content API for Shopping.
  • Metody jawnego działania: zamiast jednej metody link z parametrem action Merchant API używa odrębnych metod zarządzania usługami, takich jak propose, approve i reject.
  • Dedykowane łączenie z Profilem Firmy w Google: łączenie z Profilem Firmy w Google, które wcześniej było obsługiwane przez ustawienie pola googleMyBusinessLink, ma teraz dedykowaną metodę gbpAccounts.linkGbpAccount.
  • Tworzenie konta klienta jako usługa: tworzenie konta klienta na koncie zaawansowanym jest teraz traktowane jako proponowanie usługi accountAggregation za pomocą metody accounts.createAndConfigure. Więcej informacji o kontach znajdziesz na stronie Merchant Accounts API. Nie jest wymagane żadne potwierdzenie, ponieważ użytkownik ma dostęp zarówno do konta zaawansowanego, jak i do konta klienta.

Żądania

Interfejs Merchant API udostępnia konkretne punkty końcowe do zarządzania różnymi typami połączeń kont i usług:

Adresy URL żądań do interfejsu Merchant API

  • Proponowanie nowej usługi: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Zatwierdzanie usługi: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Odrzucanie usługi: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Link do Profilu Firmy w Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Utwórz konto klienta (link do agregacji kont): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Porównanie URL-i żądań

Opis prośby Content API for Shopping Merchant API
Łączenie kont (np. platform innych firm) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Połącz z profilem firmy w Google PUT .../v2.1/{merchantId}/accounts/{accountId} (z polem googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Tworzenie konta klienta POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Metody

Metoda Content API for Shopping Metoda Merchant API Dostępność i uwagi
accounts.link accountServices.propose Użyj tej metody, aby zainicjować nową usługę na innym koncie.
accounts.link (z: action: "approve") accountServices.approve Użyj tej metody, aby zatwierdzić oczekującą propozycję usługi.
accounts.link (z: action: "remove") accountServices.reject Użyj tej metody, aby odrzucić oczekującą lub utworzoną usługę.
accounts.insert (w przypadku kont klientów) accounts.createAndConfigure Użyj tej metody w usłudze accountAggregation, aby utworzyć nowe konto klienta na koncie zaawansowanym.
accounts.update (z: googleMyBusinessLink) gbpAccounts.linkGbpAccount Użyj tej metody, aby połączyć konto Merchant Center z Profilem Firmy w Google.
accounts.update (z: adsLinks) AccountRelationship zasób Łączenie z Google Ads odbywa się w interfejsie Google Ads. Wynikowy link jest reprezentowany w interfejsie Merchant API jako AccountRelationship, który można wyświetlić, ale nie można go utworzyć bezpośrednio.

Szczegółowe zmiany w polach

Content API for Shopping Merchant API Opis
AccountsLinkRequest.action propose, approve, reject metody Pojedyncze pole action zostało zastąpione dedykowanymi metodami interfejsu API dla każdej zmiany stanu w cyklu życia usługi.
AccountsLinkRequest.linkType AccountService.service_type Ogólny ciąg znaków linkType jest zastępowany przez strukturalne pole service_type oneof w ramach zasobu AccountService, np. productsManagement lub accountAggregation.
AccountsLinkRequest.services AccountService.service_type Lista usług opartych na ciągach znaków jest teraz reprezentowana przez konkretny ciąg znaków service_type wybrany w zasobie AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider Identyfikator konta, które świadczy usługę, jest teraz określony w polu provider żądania propose.
Account.googleMyBusinessLink LinkGbpAccountRequest Obiekt zawierający szczegóły linku do profilu firmy w Google jest zastępowany specjalną wiadomością z prośbą o wywołanie metody linkGbpAccount.
Account.adsLinks AccountRelationship Połączenia z Google Ads są reprezentowane jako zasób AccountRelationship, w którym provider to providers/GOOGLE_ADS. Zwykle zarządza się nią w interfejsie Google Ads.