Kontobeziehungen verwalten

Mit der Accounts API können Sie die Beziehungen zwischen Ihrem Merchant Center-Konto und anderen Dienstanbietern verwalten. Eine Beziehung ist eine formelle Verbindung, die es einem Anbieter ermöglicht, Ihrem Unternehmen bestimmte Dienste anzubieten. Ein Dienst definiert die Berechtigungen und Funktionen, die dem Anbieter gewährt werden, z. B. Produkt- oder Kampagnenverwaltung. Wenn Sie beispielsweise Ihr Merchant Center-Konto mit einem Google Ads-Konto verknüpfen, können Sie Ihre Produktdaten im Google Ads-Konto für Werbekampagnen verwenden.

Eine Beziehung besteht aus den folgenden Attributen:

  • Das Merchant Center-Konto, in dem der Dienst genutzt wird
  • Der Dienstanbieter
  • Der Dienst oder die Dienste, die für das Merchant Center-Konto bereitgestellt werden

Alias

Dienstanbieter können einem Konto, das sie verwalten, einen Alias zuweisen. Das entspricht dem Feld seller_id, das in der Ressource account in der Content API for Shopping vorhanden war. Der Alias kann über das optionale Feld account_id_alias in der Ressource AccountRelationship zugewiesen werden und dient als benutzerdefinierte Kennung. Der Alias muss aus 1 bis 50 Zeichen bestehen, die aus ASCII-Buchstaben, Dezimalziffern, Bindestrichen, Unterstrichen, Punkten oder Tilden ([A-Za-z0-9_~.-]{1,50}) ausgewählt werden.

Die URL-Struktur für den Zugriff auf ein Konto über seinen Alias lautet GET /accounts/v1/accounts/{provider}~{account_id_alias}.

Dienste

In der Accounts API können Konten die folgenden Dienste erhalten. Viele dieser Dienste können Sie bei der Kontoerstellung hinzufügen.

  • Kontoaggregation: Bei diesem Dienst wird ein erweitertes Konto mit einem anderen Konto verknüpft, wodurch das erweiterte Konto uneingeschränkten Zugriff erhält. Es wird in der Regel von Marktplätzen, Einzelhändlern mit mehreren Marken oder internationalen Einzelhändlern verwendet, die eine zentrale Kontrolle über untergeordnete Konten benötigen. Wenn Sie eine E-Commerce-Plattform oder ein Channel-Partner sind, empfehlen wir stattdessen die Verwendung von accountManagement. Wenn Sie ein Konto erstellen und dabei die Kontoaggregation verwenden, muss externalAccountId weggelassen werden.

  • Kampagnenverwaltung: Dieser Dienst bildet die Verknüpfung zwischen einem Merchant Center-Konto und einem Google Ads-Konto ab. Das Google Ads-Konto erhält so Zugriff auf Produkt- und Kontodaten, die für die Durchführung von Werbekampagnen erforderlich sind. Der Dienstanbieter ist in diesem Fall GOOGLE_ADS und externalAccountId ist die ID des Google Ads-Kontos. Dieser Dienst kann auch für ein bestehendes Konto vorgeschlagen werden.

  • Mit diesem Dienst können Sie produktspezifische Partnerfilter erstellen, wenn Sie Commerce Media Network-Kampagnen schalten.
  • Derzeit müssen Sie die Alphaversion der Accounts-Unter-API verwenden.
  • Für die Nutzung dieser Funktion ist eine bestimmte GMC-Zulassungsliste erforderlich.

Weitere Informationen erhalten Sie von Ihrem Google Ads-Kontoverwaltungsteam.

  • Preisvergleich: Dies bezieht sich auf die Beziehung zu einem Preisvergleichsportal, das das Merchant Center-Konto betreibt.

  • Verwaltung lokaler Einträge: Dies bezieht sich auf die Beziehung zu einem Filialleiter für die Verwaltung von lokalem Inventar und Einträgen über ein Google Unternehmensprofil.

  • Kontoverwaltung: Mit diesem Dienst kann der Anbieter administrative Aktionen im Merchant Center-Konto ausführen, z. B. Kontoeinstellungen konfigurieren, Nutzer verwalten oder Informationen zum Unternehmen aktualisieren. Das Unternehmen kann den gewährten Zugriff auch einschränken. Wenn dieser Dienst bei der Kontoerstellung verwendet wird, wird ein mit dem Anbieter verknüpftes Konto erstellt. Dies ist der empfohlene Ansatz für E-Commerce-Plattformen und Channel-Partner. Es kann auch für ein bestehendes Konto vorgeschlagen werden.

  • Produktverwaltung: Mit diesem Dienst können Anbieter Produkte und zugehörige Funktionen wie Datenquellen und Regeln verwalten. Wenn sie bei der Kontoerstellung hinzugefügt werden, geschieht das in der Regel in Kombination mit accountManagement oder accountAggregation. Dieser Dienst kann auch für ein bestehendes Konto vorgeschlagen werden.

Handschlag

Damit eine Verbindung hergestellt werden kann, müssen sowohl das Konto, das den Dienst bereitstellt, als auch das Konto, das den Dienst empfängt, die Verbindung autorisieren. Dieser Autorisierungsvorgang wird als „Handshake“ bezeichnet.

Der Handschlagprozess umfasst zwei Schritte:

  1. Eine Partei schlägt einen Dienstlink vor.
  2. Die andere Partei genehmigt oder lehnt den Vorschlag ab.

Sobald ein Vorschlag angenommen wurde, ist der Dienst genehmigt und gilt als vollständig eingerichtet. Alle Zugriffsrechte, die dem Dienstanbieter gewährt wurden, werden jetzt qualifizierten Nutzern gewährt (siehe Zugriffsrechte unten).

Der Nutzer, der einen Vorschlag erstellt, ablehnt oder genehmigt, muss ADMIN-Zugriffsrechte für das Konto haben, mit dem der Prozess gestartet wird. Wenn der Dienstanbieter also einen Dienst vorschlägt, muss der Nutzer, der den Vorschlag macht, ein ADMIN im Konto des Dienstanbieters sein. Der Nutzer, der den Vorschlag annimmt oder ablehnt, muss ein ADMIN im Empfängerkonto sein.

Dienstspezifisches Handshake-Verhalten

Im Folgenden werden die spezifischen Handshake-Anforderungen für die einzelnen Dienste beschrieben:

  • Kontoaggregation: Dieser Dienst kann nur im Rahmen der Kontoerstellung eingerichtet werden. Der Dienstanbieter muss ein erweitertes Konto sein und der Dienst wird automatisch genehmigt, da Nutzer des erweiterten Kontos vollen ADMIN-Zugriff auf das erstellte Konto haben.

  • Preisvergleich: Dieser Dienst wird automatisch genehmigt, wenn er bei der Kontoerstellung über createAndConfigure hinzugefügt wird.

  • Kampagnenverwaltung: Hier wird zwar der normale Handshake-Prozess durchlaufen, Vorschläge werden aber in einem System (z. B. Google Ads) erstellt und Genehmigungen im anderen System (z. B. im Merchant Center oder über die Merchant API) erteilt.

  • Verwaltung lokaler Einträge: Für diesen Dienst wird der Handshake in einer speziellen Methode vorgeschlagen und Genehmigungen erfolgen im anderen System (z. B. Google Unternehmensprofil). Eine detaillierte Anleitung finden Sie im Leitfaden zum Verknüpfen eines Google Unternehmensprofils.

  • Kontoverwaltung: Für diesen Dienst gilt bei der Verwendung von propose der reguläre Handshake-Prozess. Wenn der Dienst während der Kontoerstellung mit createAndConfigure hinzugefügt wird, wird er automatisch genehmigt.

  • Produktverwaltung: Für diesen Dienst gilt der reguläre Handshake-Prozess (Vorschlag von einer Partei, gefolgt von der Annahme durch die andere).

Zugriffsrechte

Jeder Diensttyp bietet ein bestimmtes Maß an Zugriff für Nutzer des Dienstanbieters auf das Konto, das gewartet wird:

  • Kontoaggregation: Dieser Dienst bietet vollständige ADMIN-Rechte.

  • Kampagnenverwaltung: Dieser Dienst bietet ein eingeschränktes Zugriffsrecht, mit dem das verknüpfte Google Ads-Konto auf Produkte und grundlegende Kontoinformationen zugreifen kann.

  • Preisvergleich: Dieser Dienst bietet standardmäßig vollständige ADMIN-Rechte. Das Unternehmen kann den im Merchant Center gewährten Zugriff jedoch einschränken.

  • Verwaltung lokaler Einträge: Für diesen Dienst gibt es kein direktes Zugriffsrecht. Stattdessen können die Produkte des Eintrags mit dem Merchant Center-Konto synchronisiert werden.

Wichtig: Die für die folgenden Diensttypen beschriebenen Zugriffsrechte gelten nur für genehmigte Dienstanbieter. Wenn Sie ein Dienstanbieter sind und diese Funktion nutzen möchten, wenden Sie sich an unser Supportteam. Wenn Sie bereits für die accounts.link-Methode zur Produktverwaltung in der Content API for Shopping zugelassen wurden, können Sie diesen Dienst in der Merchant API ohne weitere Genehmigungen verwenden.

  • Kontoverwaltung: Dieser Dienst bietet standardmäßig vollständige ADMIN-Berechtigungen.

  • Produktverwaltung: Dieser Dienst bietet vollständige ADMIN-Rechte. In Zukunft wird dies nur auf produktbezogene Zugriffsrechte beschränkt sein.

Beziehungen auf Drittanbieterplattformen

Wenn Sie eine Drittanbieterplattform sind, die Konten im Namen anderer Unternehmen verwaltet, sehen Sie hier, wie die verschiedenen Konzepte Ihrer Kontostruktur zugeordnet werden:

  1. Dienstanbieter: Ihr erweitertes Konto.
  2. Konto, das den Dienst erhält: Ein Merchant Center-Konto, das das von Ihnen verwaltete Unternehmen repräsentiert.
  3. Dienst:
    • accountManagement: Dies ist der empfohlene Dienst für E-Commerce-Plattformen und Channelpartner, die im Namen von Händlern neue Konten erstellen. Es wird ein Konto erstellt, das dem Händler gehört und mit Ihnen für die Verwaltung verknüpft ist. Dies entspricht der bevorzugten Merchant Center-Struktur für diesen Anwendungsfall.
    • accountAggregation: Mit diesem Dienst wird Ihr erweitertes Konto mit einem anderen Konto verknüpft. Es wird zwar unterstützt, ist aber nicht für E-Commerce-Plattformen und Channelpartner zu empfehlen.

Weitere Informationen zum Einrichten eines erweiterten Kontos und zum Verknüpfen mit neuen Merchant Center-Konten finden Sie unter Konten erstellen.