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

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 mit dem optionalen Feld account_id_alias in der Ressource AccountRelationship zugewiesen werden und dient als benutzerdefinierte Kennung.

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:

  • Kontoaggregation: Hier wird die Beziehung zwischen einem erweiterten Konto und den Konten modelliert, für die es Dienste bereitstellt. Der Dienstanbieter (das erweiterte Konto) erhält uneingeschränkten Zugriff auf die verknüpften untergeordneten Konten. Die externalAccountId ist in diesem Fall die ID des Merchant Center-Kontos. Wenn Sie ein Unterkonto erstellen, muss externalAccountId weggelassen werden, da es der ID des Kontos bei der Erstellung zugewiesen wird.

  • Kampagnenverwaltung: Dieser Dienst bildet die Verknüpfung zwischen einem Merchant Center-Konto und einem Google Ads-Konto ab. Das Google Ads-Konto erhält 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.

  • Preisvergleich: Dies steht für 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.

  • Produktverwaltung: Mit diesem Dienst können Anbieter Produkte und zugehörige Funktionen wie Datenquellen und Regeln verwalten.

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 nun 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 empfangenden Konto 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 Konto haben, das erstellt 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 der reguläre Handshake-Prozess (Vorschlag des Dienstanbieters oder Unternehmens, gefolgt von der Annahme durch die andere Partei).

  • 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 zugehörige 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 werden die Produkte des Eintrags mit dem Merchant Center-Konto synchronisiert.

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-Rechte.

  • Produktverwaltung: Dieser Dienst bietet vollständige ADMIN-Rechte. In Zukunft wird dies 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:
    • accountAggregation, wenn Sie diese Konten als Unterkonten Ihres erweiterten Kontos erstellen. Dies wird jedoch nicht empfohlen. Der bevorzugte Dienst ist accountManagement.
    • accountManagement, wenn Sie diesen Dienst nach der Kontoerstellung für Konten einrichten, die keine untergeordneten Konten Ihres erweiterten Kontos sind.

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