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. Produktverwaltung oder Kampagnenverwaltung. Wenn Sie beispielsweise Ihr Merchant Center-Konto mit einem Google Ads-Konto verknüpfen, kann das Google Ads-Konto Ihre Produktdaten für die Ausführung von Werbekampagnen verwenden.

Eine Beziehung besteht aus den folgenden Attributen:

  • Das Merchant Center-Konto, das den Dienst erhält
  • Der Dienstanbieter
  • Der Dienst oder die Dienste, die für das Merchant Center-Konto bereitgestellt werden

Alias

Dienstanbieter können Konten, die sie betreuen, einen Alias zuweisen. Dies ist das Äquivalent des seller_id Feldes, das in der Konto Ressource in der Content API for Shopping vorhanden war. Der Alias kann mit dem optionalen 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 beim Erstellen des Kontos hinzufügen.

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

  • Kampagnenverwaltung: Dieser Dienst modelliert die Verknüpfung zwischen einem Merchant Center-Konto und einem Google Ads-Konto. Dadurch erhält das Google Ads-Konto Zugriff auf Produkt- und Kontodaten, die für die Ausfü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.

  • Preisvergleich: Dies stellt die Beziehung zu einem Preisvergleichsportal dar, das das Merchant Center-Konto betreibt.

  • Verwaltung lokaler Einträge: Dies stellt die Beziehung zu einem Filialleiter dar, der lokale Inventare und Einträge mit einem Google Unternehmensprofil verwaltet.

  • Kontoverwaltung: Mit diesem Dienst kann der Anbieter administrative Aktionen für das 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 während der Kontoerstellungverwendet wird, wird ein Konto erstellt, das mit dem Anbieter verknüpft ist. Dies ist der empfohlene Ansatz für E‑Commerce-Plattformen und Channel partner. Er 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 er beim Erstellen eines Kontos hinzugefügt wird, erfolgt dies in der Regel in Kombination mit accountManagement oder accountAggregation. Dieser Dienst kann auch für ein bestehendes Konto vorgeschlagen werden.

Handschlag

Um einen Dienst einzurichten, müssen sowohl das Konto, das den Dienst bereitstellt, als auch das Konto, das den Dienst erhält, die Verbindung autorisieren. Dieser Autorisierungsprozess wird als Handschlag bezeichnet.

Der Handschlag ist ein zweistufiger Prozess:

  1. Eine Partei schlägt eine Dienstverknüpfung 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 dem Dienstanbieter gewährten Zugriffsrechte werden jetzt qualifizierten Nutzern gewährt (siehe Zugriffsrechte unten).

Der Nutzer, der einen Vorschlag erstellt, ablehnt oder genehmigt, muss ADMIN Zugriffs rechte für das Konto haben, das den Prozess initiiert. Wenn der Dienstanbieter also einen Dienst vorschlägt, muss der Nutzer, der den Vorschlag macht, ein ADMIN für das Konto des Dienstanbieters sein. Der Nutzer, der den Vorschlag annimmt oder ablehnt, muss ein ADMIN für das empfangende Konto sein.

Dienstspezifisches Handschlagverhalten

Im Folgenden finden Sie eine Beschreibung der spezifischen Handschlaganforderungen für jeden einzelnen Dienst:

  • Kontozusammenführung: 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 uneingeschränkten ADMIN-Zugriff auf das erstellte Konto haben.

  • Preisvergleich: Dieser Dienst wird automatisch genehmigt, wenn er beim Erstellen eines Kontos mit createAndConfigure hinzugefügt wird.

  • Kampagnenverwaltung: Dieser Dienst folgt dem normalen Handschlagprozess. Vorschläge werden in einem System (z. B. Google Ads) gemacht und Genehmigungen erfolgen im anderen System (z. B. im Merchant Center oder über die Merchant API).

  • Verwaltung lokaler Einträge: Für diesen Dienst wird der Handschlag mit 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 der reguläre Handschlagprozess wenn Sie propose verwenden. Wenn der Dienst beim Erstellen eines Kontos mit createAndConfigure hinzugefügt wird, wird er automatisch genehmigt.

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

Zugriffsrechte

Jeder Diensttyp bietet Nutzern des Dienstanbieters ein bestimmtes Zugriffsniveau auf das Konto, das betreut wird:

  • Kontozusammenführung: 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 Konten informationen zugreifen kann.

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

  • Verwaltung lokaler Einträge: Dieser Dienst bietet kein direktes Zugriffsrecht. Stattdessen kann der Eintrag seine Produkte mit dem Merchant Center-Konto synchronisieren.

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 Support Team. Wenn Sie bereits für die Methode accounts.link zur Produktverwaltung in der Content API for Shopping genehmigt wurden, können Sie diesen Dienst in der Merchant API ohne weitere Genehmigungen verwenden.

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

  • Produktverwaltung: Dieser Dienst bietet vollständige ADMIN Rechte. Beachten Sie, dass dies in Zukunft auf produktbezogene Zugriffsrechte beschränkt sein wird.

Anwendung von Beziehungen für 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 darstellt.
  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, dessen Inhaber der Händler ist und das für die Verwaltung mit Ihnen 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. Er wird zwar unterstützt, ist aber für E‑Commerce-Plattformen und Channelpartner nicht empfehlenswert.

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

Zurück
Create accounts
Weiter
Control access to your account