Kontoverknüpfung migrieren

Die Verwaltung von Kontobeziehungen hat sich von einer einzelnen link-Methode in der Content API for Shopping zu einem detaillierteren und expliziten System in der Merchant API entwickelt. Die neue API verwendet dedizierte Ressourcen wie AccountRelationship und AccountService, um die spezifischen Dienste zu definieren, die ein Konto für ein anderes bereitstellt. Weitere Informationen finden Sie unter Beziehungen zwischen Konten.

Wichtige Unterschiede

  • Spezielle Ressourcen für Beziehungen und Dienste: In der Merchant API wird mit der Ressource AccountRelationship die Verbindung zwischen einem Dienstanbieter und einem Händler definiert, während mit der Ressource AccountService der genaue Dienst angegeben wird (z. B. accountAggregation). Dies ersetzt die generischen Felder linkType und services aus der Content API for Shopping.
  • Methoden für explizite Aktionen: Anstelle einer einzelnen link-Methode mit einem action-Parameter werden in der Merchant API separate Methoden zum Verwalten von Diensten verwendet, z. B. propose, approve und reject.
  • Spezielle Verknüpfung mit Google Unternehmensprofil: Die Verknüpfung mit einem Google Unternehmensprofil, die bisher durch Festlegen des Felds googleMyBusinessLink erfolgte, wird jetzt über die spezielle Methode gbpAccounts.linkGbpAccount gehandhabt.
  • Erstellung von Kundenkonten als Dienstleistung: Die Erstellung eines Kundenkontos unter einem erweiterten Konto wird jetzt als Vorschlag für einen accountAggregation-Dienst mit der Methode accounts.createAndConfigure behandelt. Weitere Informationen zu Konten finden Sie auf der Seite Merchant Accounts API. Es ist kein Handshake erforderlich, da der Nutzer Zugriff auf das erweiterte Konto und das Kundenkonto hat.

Anfragen

Die Merchant API bietet spezifische Endpunkte für die Verwaltung verschiedener Arten von Kontoverknüpfungen und ‑diensten:

Merchant API-Anfrage-URLs

  • Neuen Dienst vorschlagen: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Dienst genehmigen: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Dienst ablehnen: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Link zu einem Google Unternehmensprofil: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Kundenkonto erstellen (Link zur Kontoaggregation): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Vergleich von Anfrage-URLs

Beschreibung der Anfrage Content API for Shopping Merchant API
Konten verknüpfen (z. B. Drittanbieterplattformen) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Mit Google Unternehmensprofil verknüpfen PUT .../v2.1/{merchantId}/accounts/{accountId} (mit Feld googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Kundenkonto erstellen POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Methoden

Content API for Shopping-Methode Merchant API-Methode Verfügbarkeit und Hinweise
accounts.link accountServices.propose Mit dieser Methode können Sie einen neuen Dienst mit einem anderen Konto starten.
accounts.link (mit action: "approve") accountServices.approve Mit dieser Methode können Sie einen ausstehenden Dienstvorschlag genehmigen.
accounts.link (mit action: "remove") accountServices.reject Mit dieser Methode können Sie einen ausstehenden oder eingerichteten Dienst ablehnen.
accounts.insert (für Kundenkonten) accounts.createAndConfigure Verwenden Sie diese Methode mit einem accountAggregation-Dienst, um ein neues Kundenkonto unter einem erweiterten Konto zu erstellen.
accounts.update (mit googleMyBusinessLink) gbpAccounts.linkGbpAccount Verwenden Sie diese spezielle Methode, um ein Merchant Center-Konto mit einem Unternehmensprofil zu verknüpfen.
accounts.update (mit adsLinks) AccountRelationship-Ressource Die Verknüpfung mit Google Ads wird über die Google Ads-Benutzeroberfläche verwaltet. Der resultierende Link wird in der Merchant API als AccountRelationship dargestellt. Er kann aufgerufen, aber nicht direkt erstellt werden.

Detaillierte Feldänderungen

Content API for Shopping Merchant API Beschreibung
AccountsLinkRequest.action propose-, approve- und reject-Methoden Das einzelne Feld action wird durch dedizierte API-Methoden für jede Statusänderung im Dienstlebenszyklus ersetzt.
AccountsLinkRequest.linkType AccountService.service_type Der generische String linkType wird durch ein strukturiertes service_type-Oneof-Feld innerhalb der AccountService-Ressource ersetzt, z. B. productsManagement oder accountAggregation.
AccountsLinkRequest.services AccountService.service_type Die Liste der stringbasierten Dienste wird jetzt durch die spezifische service_type dargestellt, die in der AccountService-Ressource ausgewählt wurde.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider Die ID des Kontos, das den Dienst bereitstellt, wird jetzt im Feld provider der Anfrage propose angegeben.
Account.googleMyBusinessLink LinkGbpAccountRequest Das Objekt mit den Details zum Unternehmensprofil wird durch eine spezielle Anfragenachricht für die Methode linkGbpAccount ersetzt.
Account.adsLinks AccountRelationship Google Ads-Verknüpfungen werden als AccountRelationship-Ressource dargestellt, wobei provider providers/GOOGLE_ADS ist. Diese Beziehung wird in der Regel über die Google Ads-Benutzeroberfläche verwaltet.