Übersicht über die Accounts-Unter-API

Mit der Accounts-Sub-API in der Merchant API können Sie Ihre Google Merchant Center-Konten programmatisch erstellen, konfigurieren und verwalten. Sie bietet eine umfassende Suite von Tools zum Verwalten des gesamten Lebenszyklus und der Kernkonfigurationen Ihrer Merchant Center-Konten. Diese API ist für Unternehmen und Drittanbieter, die die Kontoeinrichtung und die laufende Wartung automatisieren möchten, unerlässlich.

Mit der Accounts-Sub-API können Sie Folgendes tun:

  • Grundlegende Merchant Center-Kontovorgänge ausführen: Neue Merchant Center-Konten erstellen, ihre Details abrufen, grundlegende Einstellungen aktualisieren, Probleme auf Kontoebene überwachen, Konten auflisten, auf die Sie zugreifen können, und Konten bei Bedarf löschen.
  • Informationen zum Unternehmen und Onlineshop-Präsenz einrichten: Konfigurieren Sie die wichtigsten Informationen zu Ihrem Unternehmen (z. B. Adresse und Kontaktdaten) und selbst deklarierte Identitätsattribute. Richten Sie außerdem die Website Ihres Onlineshops ein, indem Sie die URL Ihrer Startseite angeben, bestätigen und beanspruchen. Dies ist entscheidend dafür, wie Ihr Unternehmen dargestellt wird.
  • Nutzerzugriff und Kommunikationseinstellungen verwalten: Hier erfahren Sie, wie Sie festlegen, wer auf Ihr Merchant Center-Konto zugreifen darf, wie Sie die jeweiligen Berechtigungen definieren und wie Sie die Einstellungen für E-Mail-Benachrichtigungen zu wichtigen Kontoaktualisierungen und Neuigkeiten konfigurieren.
  • Anmeldung und Teilnahme an Programmen verwalten: Sie können Ihre Anmeldung für verschiedene Merchant Center-Programme (z. B. Produkteinträge oder Shopping-Anzeigen) verwalten, Ihren Teilnahmestatus einsehen und sich über programmspezifische Anforderungen informieren, um die Reichweite Ihrer Produkte zu erhöhen.
  • Logistik konfigurieren: Versand, Rückgaben und Regionen: Richten Sie Ihre Versandeinstellungen auf Kontoebene ein, legen Sie Ihre Online-Rückgabebedingungen für Kunden fest und erstellen Sie geografische Regionen für präzises Targeting und die Bereitstellung von Dienstleistungen.
  • Erweiterte Integrationen und Kontoverknüpfungen nutzen: Hier erfahren Sie, wie Sie Einstellungen für Omnichannel-Angebote verwalten, Verknüpfungen mit Google Unternehmensprofil-Konten und Anbietern von lokalen Feeds herstellen und Dienstbeziehungen mit anderen Konten wie Drittanbietern oder Agenturen einrichten und verwalten.

Diese Reihe von Leitfäden enthält detaillierte Anleitungen und Beispiele für gängige Anwendungsfälle:

  • Konto erstellen: Hier erfahren Sie, wie Sie programmatisch ein neues Merchant Center-Konto erstellen und seine Beziehungen zu einem erweiterten Konto verwalten, was für die Verwaltung mehrerer Verkäufer oder Marken unerlässlich ist.
  • Beziehungen: Informationen dazu, wie Dienstbeziehungen zwischen verschiedenen Merchant Center-Konten (z.B. mit erweiterten Konten oder Drittanbietern) strukturiert und verwaltet werden.
  • Google Unternehmensprofil verknüpfen: Verknüpfen Sie Ihr Merchant Center-Konto mit Ihrem Google Unternehmensprofil, um die Präsenz Ihres lokalen Geschäfts zu verbessern.
  • Zugriff auf Ihr Konto steuern: Verwalten Sie Nutzerberechtigungen und ‑rollen in Ihrem Merchant Center-Konto, um festzulegen, wer bestimmte Aktionen ausführen darf.
  • Merchant Center-E-Mail-Benachrichtigungen verwalten: Sie können die E-Mail-Benachrichtigungen anpassen, die Sie und andere Nutzer zu Kontobenachrichtigungen, Neuigkeiten und Tipps erhalten.
  • Einstellungen für die Startseite verwalten: Legen Sie die Website-URL Ihres Onlineshops fest, bestätigen und beanspruchen Sie sie. Dies ist ein wichtiger Schritt für die Kontobestätigung und die Teilnahme am Programm.
  • Content API-Migration: Informationen zur Migration von der Content API for Shopping finden Sie unter „Kontoverwaltung migrieren“.

Merchant Center-Kontostruktur und -Beziehungen

Das Merchant Center-Ökosystem unterstützt verschiedene Kontostrukturen, um unterschiedlichen Geschäftsanforderungen gerecht zu werden. Diese Konten können auch Beziehungen zueinander aufbauen, wobei ein Konto (ein Dienstleister) einem anderen bestimmte Dienste anbietet. Mit der Accounts-Sub-API können Sie mit diesen Typen und ihren Beziehungen interagieren und sie verwalten.

Händlerkonten

Dies ist ein Merchant Center-Konto, das in der Regel von einem einzelnen Unternehmen verwendet wird, um seine eigenen Produkteinträge und Programme direkt zu verwalten.

Häufige Anwendungsfälle:

  • Kleine bis mittlere Unternehmen, die ihre eigene E-Commerce-Präsenz verwalten.
  • Händler, die die direkte Kontrolle über die Einrichtung ihres Google Merchant Centers haben möchten.
  • Händler, die Store Builder oder andere Drittanbieter verwenden, die sie beim Erstellen und Verwalten ihres Kontos unterstützen.

Beziehungen und Dienste:

Händlerkonten können mit Dienstleistern verknüpft werden, um Unterstützung bei Aufgaben wie der Verwaltung von Produktdaten oder der Konto- und Kampagnenverwaltung zu erhalten.

Erweiterte Konten

Ein erweitertes Konto ist ein spezielles Konto im Google Merchant Center. Es ist für Unternehmen und Drittanbieter (z. B. Store Builder, Channelpartner, Agenturen und Marktplätze) gedacht, die mehrere Merchant Center-Konten gleichzeitig verwalten müssen.

Häufige Anwendungsfälle:

  • Store Builder: Drittanbieter, die es Händlern ermöglichen, Onlineshops zu erstellen und zu betreiben.
  • Marktplätze: Online-Shopping-Plattformen, auf denen mehrere einzelne Händler ihre Produkte verkaufen.
  • Händler mit mehreren Marken: Diese Händler besitzen mehrere Marken und verkaufen Produkte in Ladengeschäften oder online über mehrere Domains.
  • Internationale Einzelhändler: Einzelhändler, die Produkte in mehreren Ländern und über mehrere Domains verkaufen.
  • Channelpartner: Unternehmen, die Händler dabei unterstützen, ihre Produkte auf verschiedenen Marketingkanälen zu präsentieren, und oft auch damit zusammenhängende Dienstleistungen anbieten.
  • Agenturen: Marketing- und Werbeagenturen, die Merchant Center-Konten, Produktfeeds und Kampagnen im Namen ihrer Kunden verwalten.

Beziehungen und Dienste:

In allen erweiterten Konten werden mehrere Händlerkonten verwaltet. Die optimale Konfiguration und Nutzung von Beziehungen und Diensten hängt jedoch oft vom jeweiligen Geschäftsmodell ab. Diese Unterschiede zu kennen, ist entscheidend, um die API effektiv zu nutzen. Im Folgenden finden Sie empfohlene Best Practices für gängige Anwendungsfälle:

Store-Builder und Channelpartner

Diese Partner sollten ein erweitertes Konto erstellen und Beziehungen zu den Händlern aufbauen, mit denen sie zusammenarbeiten:

  • Für neue Händler ohne Konto: Wenn ein Konto in der Merchant Center-Benutzeroberfläche in ein erweitertes Konto umgewandelt wird, konfiguriert Google Store Builder und Channelpartner automatisch als erweiterte Mehrfachkundenkonten mit dem Dienst Account Aggregation (accountAggregation). Der Store Builder oder Channelpartner kann accounts.createAndConfigure mit accountAggregation verwenden, um neue Unterkonten für Händler zu erstellen, die im Merchant Center sichtbar sind und verwaltet werden können.
  • Bestehende Merchant Center-Konten: Bestehende eigenständige Konten können nicht in ein erweitertes Konto mit accountAggregation verschoben werden. Stattdessen sollte der Store Builder oder Channelpartner eine Account Management-Dienstverknüpfung (accountManagement) mit dem bestehenden individuellen Konto des Händlers herstellen. So kann der Store Builder oder Channelpartner mit Zustimmung des Händlers bestimmte Aspekte des Kontos verwalten.

Informationen zu verwalteten Konten abrufen: Wenn Sie Informationen zu Händlerkonten abrufen möchten, die Sie über accountManagement verwalten, rufen Sie accounts.list mit einem relationship-Filter auf, z. B. filter=relationship(providerId={PROVIDER_ID} AND service(type="ACCOUNT_MANAGEMENT")), und rufen Sie dann accounts.get oder accountServices.list auf, um bestimmte Konto- und Dienstdetails zu prüfen.

Agenturen

Agenturen verwalten in der Regel eigenständige Merchant Center-Konten, die ihren Kunden gehören, anstatt Unterkonten unter einem einzigen erweiterten Konto zusammenzufassen:

  • Für bestehende Merchant Center-Konten: Die Agentur schlägt eine Dienstverknüpfung vom Typ Account Management (accountManagement) vor (oft kombiniert mit Products Management (productsManagement) oder Campaign Management (campaignsManagement)), die der Händler genehmigt.
  • Für neue Händler ohne Konto: Die Agentur kann accounts.createAndConfigure mit dem Dienst Account Management (accountManagement) aufrufen und den Händler als ADMIN-Nutzer hinzufügen, damit der Händler Inhaber des eigenständigen Kontos bleibt.

Marktplätze

Marktplätze betreiben ein erweitertes Konto pro Domain und erstellen Verkäuferkonten mit dem Account Aggregation-Dienst. Es ist üblich, dass Marktplätze mehrere Verkäufertypen verwenden, von denen einige eine zusätzliche Konfiguration durch das Google-Supportteam erfordern. Die Domainbestätigung und die Programmverwaltung erfolgen auf der Ebene des erweiterten Kontos und werden von den Verkäuferkonten übernommen. Weitere Informationen finden Sie im Hilfeartikel Gültige Marktplatz-Kontostruktur.

  • Marktplatz-Verkäuferkonto: Ein spezielles Konto für die Produkte des Marktplatzes. So kann der Marktplatz seine Markenwiedererkennung, Verkäuferbewertungen und spezifische 1P-Kampagnenstrategien nutzen.
  • Einzelkundenkonten: Jedes Konto enthält Produkte für einen einzelnen Drittanbieter. Diese Struktur ist ideal für größere Verkäufer, die eindeutige, verkäuferspezifische Attribute benötigen oder verkäuferspezifische Werbekampagnen durchführen.
  • Mehrfachkundenkonten: Ein einzelnes Konto enthält Produkte von mehreren Drittanbietern, was die Konto- und Produktverwaltung vereinfacht. Weitere Informationen finden Sie im Hilfeartikel zu Mehrfachkundenkonten.

Händler mit mehreren Marken

Unternehmen mit mehreren Marken verwenden in der Regel ein erweitertes Konto, um einzelne Konten für jede Marke zu verwalten, die über einen Account Aggregation-Dienst verknüpft sind. So können Marken unabhängig voneinander agieren (z.B. Websiteansprüche, Produktdaten), während das erweiterte Konto zentrale Funktionen wie Nutzerzugriff, Berichterstellung und manchmal auch die Kampagnenaufsicht vereinfacht.

Internationale Einzelhändler

Internationale Einzelhändler verwalten ihre globale Präsenz über ein erweitertes Konto, wobei einzelne Konten pro Land oder Region über einen Account Aggregation-Dienst verknüpft sind. Die Einrichtung variiert oft je nach Domainstruktur:

  • Einzelne Domain (mit länderspezifischen Subdomains/Pfaden): Die Hauptdomain wird in der Regel auf der Ebene des erweiterten Kontos beansprucht und von regionalen Konten übernommen. Diese regionalen Konten konzentrieren sich dann auf die Verwaltung lokalisierter Produktdaten, Preise und Verfügbarkeit.
  • Mehrere länderspezifische Domains: Jedes regionale Konto beansprucht eine eigene Domain. In diesem Modell werden die lokalen Vorgänge über die einzelnen Konten abgewickelt, während das erweiterte Konto hauptsächlich für zentrale Funktionen wie Nutzerzugriff, globale Berichte und übergreifende Kampagnenverwaltung verwendet wird.