Migracja połączenia kont

Zarządzanie relacjami między kontami przeszło ewolucję od pojedynczej metody link w Content API for Shopping do bardziej szczegółowego i wyraźnego systemu w Merchant API. Nowy interfejs API używa dedykowanych zasobów, takich jak AccountRelationship i AccountService, aby określić konkretne usługi, które jedno konto świadczy na rzecz innego. Więcej informacji znajdziesz w artykule Relacje 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 konkretną świadczoną usługę (np. accountAggregation). Zastępuje to ogólne pola linkType i services z Content API for Shopping.
  • Metody działań jawnych: zamiast pojedynczej 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ługi: utworzenie konta klienta w ramach konta zaawansowanego jest teraz traktowane jako zaproponowanie usługi accountAggregation za pomocą accounts.createAndConfigure metody. Więcej informacji o kontach znajdziesz na stronie Merchant Accounts API. Nie jest wymagane uzgadnianie, ponieważ użytkownik ma dostęp zarówno do konta zaawansowanego, jak i do konta klienta.

Żądania

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

Adresy URL żądań do interfejsu API Merchant Center

  • Zaproponuj nową usługę: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Zatwierdź usługę: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Odrzuć usługę: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Połącz z Profilem Firmy w Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Utwórz konto klienta (połączenie agregacji kont): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Porównanie adresów URL żądań

Opis prośby Content API for Shopping Merchant API
Łączenie kont (np. platform zewnętrznych) 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
Utwórz konto 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 ustanowioną usługę.
accounts.insert (w przypadku kont klientów) accounts.createAndConfigure Użyj tej metody z usługą accountAggregation, aby utworzyć nowe konto klienta w ramach konta zaawansowanego.
accounts.update (z googleMyBusinessLink) gbpAccounts.linkGbpAccount Użyj tej dedykowanej metody, aby połączyć konto Merchant Center z Profilem Firmy w Google.
accounts.update (z adsLinks) Zasób AccountRelationship Łączenie z Google Ads jest zarządzane w interfejsie Google Ads. Wynikowe połączenie jest reprezentowane jako AccountRelationship w Merchant API, które można wyświetlić, ale nie można utworzyć bezpośrednio.

Szczegółowe zmiany pól

Content API for Shopping Merchant API Opis
AccountsLinkRequest.action Metody propose, approve, reject 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 został zastąpiony przez uporządkowane pole service_type oneof w zasobie AccountService, takie jak productsManagement lub accountAggregation.
AccountsLinkRequest.services AccountService.service_type Lista usług opartych na ciągach znaków jest teraz reprezentowana przez konkretny typ usługi service_type wybrany w zasobie AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider Identyfikator konta świadczącego usługę jest teraz określony w polu provider żądania propose.
Account.googleMyBusinessLink LinkGbpAccountRequest Obiekt zawierający szczegóły połączenia z Profilem Firmy w Google został zastąpiony dedykowaną wiadomością żądania dla metody linkGbpAccount.
Account.adsLinks AccountRelationship Połączenia z Google Ads są reprezentowane jako zasób AccountRelationship, w którym provider to providers/GOOGLE_ADS. Ta relacja jest zwykle zarządzana w interfejsie Google Ads.