Häufig gestellte Fragen

In diesem Abschnitt finden Sie Antworten auf häufig gestellte Fragen zur Entwicklerregistrierung für die Merchant API.

Allgemeine Registrierung

Häufig gestellte Fragen zum Registrierungsprozess:

Ist die Registrierung als Entwickler erforderlich, um die Merchant API zu verwenden?

Ja. Sie müssen Ihre Entwickler-Kontaktdaten registrieren, damit Google Ihnen wichtige API-spezifische Updates wie Servicemitteilungen und Informationen zu neuen Funktionen senden kann.

Wenn Sie die Merchant API nur kennenlernen und testen möchten, können Sie Tools wie Google OAuth Playground und API Explorer verwenden, für die keine Registrierung erforderlich ist.

Wie oft muss ich mich registrieren?

Die Registrierung ist eine einmalige Einrichtung für jedes Google Cloud-Projekt. Unabhängig davon, ob Sie mit mehreren Händlerkonten arbeiten oder nicht, führen Sie den Registrierungsvorgang nur einmal aus. Er gilt für alle Nutzer und Dienstkonten im verknüpften Google Cloud-Projekt.

Sobald ein Google Cloud-Projekt erfolgreich registriert wurde, bleibt die Verknüpfung aktiv, es sei denn, sie wird explizit durch Aufrufen der Methode unregisterGcp entfernt. Sie können keine freigegebenen, Google-eigenen Projekte wie den APIs Explorer oder OAuth Playground registrieren.

Welche E‑Mail-Adresse sollte ich als Entwicklerkontakt angeben?

Wir empfehlen, die geschäftliche E-Mail-Adresse einer Person zu verwenden. Alternativ können Sie allgemeine Gruppenaliasse verwenden. Sie können keine E-Mail-Adressen von Dienstkonten verwenden, da die Kommunikation für menschliche Empfänger bestimmt ist. Google sendet wichtige API-spezifische Updates, z. B. Servicemitteilungen und Informationen zu neuen Funktionen.

Wenn die E-Mail-Adresse zu einem vorhandenen Nutzer im Merchant Center-Konto gehört, wird ihm automatisch die Rolle API developer zugewiesen. Falls nicht, wird eine Einladung an diese Adresse gesendet.

Das Feld für die Kontakt-E-Mail-Adresse des Entwicklers ist in der Methode registerGcp optional. Wenn Sie bei der Registrierung keinen Wert für dieses Feld angeben, müssen Sie entweder in der Merchant Center-Benutzeroberfläche oder durch Aufrufen der Methode accounts.users.create einen Nutzer mit der Rolle API developer erstellen.

Muss die E‑Mail-Adresse des Entwicklers mit einem Google-Konto verknüpft sein?

Ja. Wenn Sie eine vorhandene E‑Mail-Adresse verwenden möchten, die nicht von Google stammt, können Sie sie mit einem Google-Konto verknüpfen. Wählen Sie dazu bei der Registrierung für ein Google-Konto die Option Vorhandene E‑Mail-Adresse verwenden aus. Sie können keine E-Mail-Adressen von Dienstkonten verwenden, da Dienstkonten keine E-Mails empfangen können.

Wie führe ich die Authentifizierung und Autorisierung für den Registrierungsaufruf durch?

Je nach Anwendungsfall sind zwei verschiedene Authentifizierungsszenarien für die Authentifizierung und Autorisierung des Registrierungsaufrufs verfügbar:

• OAuth 2.0: für Drittanbieter oder Agenturen, die mehrere Händlerkonten verwalten
• Dienstkonten: für den Zugriff auf Ihr eigenes Merchant Center-Konto

Das obige Diagramm zeigt die beiden Authentifizierungs- und Autorisierungsabläufe für den Registrierungsaufruf. Sie haben folgende Optionen zur Auswahl:

• OAuth mit einer E‑Mail-Adresse wie account@email.com verwenden, die mit einem Google-Konto verknüpft ist
• Verwenden Sie ein Dienstkonto wie sa@project.iam.gserviceaccount.com.

Wenn Sie sich für OAuth entscheiden:

• OAuth-Anmeldedaten in Ihrem Google Cloud-Projekt für Ihre E-Mail-Adresse erstellen
• Prüfen Sie, ob die autorisierende E-Mail-Adresse in Ihrem Merchant Center vorhanden ist und den Zugriffstyp ADMIN hat.

Wenn Sie sich für ein Dienstkonto entscheiden:

• Prüfen, ob das Dienstkonto in Ihrem Google Cloud-Projekt vorhanden ist
• Prüfen Sie, ob die mit dem Dienstkonto verknüpfte E-Mail-Adresse in Ihrem Merchant Center-Konto vorhanden ist und den Zugriffstyp ADMIN hat.

Führen Sie den Registrierungsaufruf im Sicherheitskontext der authentifizierenden Identität aus. Verwenden Sie dazu direkte API-Aufrufe oder Clientbibliotheken. Geben Sie eine E‑Mail-Adresse für den Entwicklerkontakt an, z. B. developer@email.com.

Wenn der Registrierungsaufruf erfolgreich ist, ist in Ihrem Merchant Center ein Nutzer mit der angegebenen Entwickler-E-Mail-Adresse und der Rolle API developer vorhanden. Sie erhalten als Antwort eine DeveloperRegistration-Ressource.

Was ist der Unterschied zwischen der E‑Mail-Adresse für die Authentifizierung und der Kontakt-E‑Mail-Adresse für Entwickler?

Die beiden E-Mail-Adressen haben im Merchant API-Ökosystem unterschiedliche Zwecke:

• Authentifizierungs-E-Mail-Adresse: In der Regel verwenden Sie eine E-Mail-Adresse, die mit Ihrem Google-Konto oder einem Dienstkonto verknüpft ist, als Identität, um Anfragen an die Merchant API zu autorisieren, sofern Folgendes zutrifft:
  • Es ist in Ihrem Merchant Center-Konto vorhanden und hat die Rolle „ADMIN“.
  • In einem Google Cloud-Projekt, in dem die Merchant API aktiviert ist, wird der OAuth-Client oder das Dienstkonto gehostet, das mit der E‑Mail-Adresse verknüpft ist, die die API-Aufrufe autorisiert.
• E-Mail-Adresse des Entwicklers: Die E-Mail-Adresse des Entwicklers muss ebenfalls mit einem Google-Konto verknüpft sein. Sie dient als primärer Kontakt für wichtige Servicemitteilungen und API-Updates von Google. Es kann einem Nutzer oder einer Gruppe von Nutzern gehören. Standardmäßig erhält es die Rolle API developer im Merchant Center.

Muss ich die Einladung annehmen, die ich über die Kontakt-E-Mail-Adresse des Entwicklers erhalten habe?

Ja. Der Empfänger der Entwickler-Kontakt-E‑Mail-Adresse hat 14 Tage Zeit, die Einladung anzunehmen. Die Registrierung ist erst abgeschlossen, wenn die Einladung angenommen wurde. Sie können während dieser Zeit jedoch API-Aufrufe ausführen.

Wenn die Einladung nicht innerhalb der angegebenen Zeit angenommen wird, läuft der Einladungslink ab. Sie können keine Merchant API-Aufrufe mehr ausführen und müssen den Registrierungsprozess neu starten.

Warum schlägt meine Entwicklerregistrierung mit einem „Testkonto“-Fehler fehl?

Die Entwicklerregistrierung ist auf Produktionskonten (Live-Konten) beschränkt, um die Stabilität der Integration zu gewährleisten. Wenn Sie ein Konto verwenden, das speziell für Tests erstellt wurde und im Merchant Center als „Testkonto“ gekennzeichnet ist, wird die Registrierung abgelehnt.

Kann ich ein Unterkonto registrieren, das ich für einen Kunden verwalte?

Wir empfehlen dringend, das Konto zu registrieren, das Ihre Geschäftsidentität darstellt. Die Registrierung des Unterkontos eines Kunden ist nicht zulässig und fehleranfällig. Wenn dieser Kunde Ihren Dienst verlässt oder das Konto löscht, wird möglicherweise Ihre gesamte API-Integration deaktiviert.

Muss meine Website beansprucht oder nur bestätigt werden?

Für die Entwicklerregistrierung muss die Website bestätigt sein. Damit weisen Sie nach, dass Sie die administrative Kontrolle über die mit dem Konto verknüpfte Website haben. Während die Beanspruchung für andere Funktionen wie Shopping-Anzeigen erforderlich ist, ist die Bestätigung die wichtigste Voraussetzung für die API-Registrierung.

Konto- und Projektverwaltung

Häufig gestellte Fragen zur Konto- und Projektverwaltung:

Ich arbeite mit mehreren Merchant Center-Konten. Muss ich jedes Merchant Center-Konto registrieren, das ich mit der Merchant API verwenden möchte?

Nein. Wenn Sie ein Drittanbieter-Entwickler oder eine Agentur sind, die mehrere Händlerkonten verwaltet, registrieren Sie Ihr Google Cloud-Projekt mit Ihrem eigenen primären Merchant Center-Konto, nicht mit jedem Ihrer Händlerkonten. Auf diese Weise vertreten Sie den Entwickler bei allen API-Arbeiten, die Sie für Ihre Händler ausführen.

Ich arbeite mit mehreren Merchant Center-Konten. Wie wähle ich mein primäres Merchant Center-Konto aus?

Welches primäre Konto Sie verwenden sollten, hängt von Ihrem Unternehmenstyp ab:

• Marktplätze mit einem bestehenden erweiterten Konto: Wenn Ihr Unternehmen als Marktplatz agiert und bereits ein erweitertes Konto für die gesamte Plattform hat, verwenden Sie diese bestehende Konto-ID als primäres Merchant Center-Konto.
• Preisvergleichsportale (CSS): Wenn Sie ein Preisvergleichsportal sind, verwenden Sie Ihre eindeutige CSS-Konto-ID oder Preisvergleichsportal-Gruppenkonto-ID.
• Agenturen, Entwickler und andere Drittanbieter: Wenn Sie ein Drittanbieterunternehmen wie eine Agentur oder ein Drittanbieterentwickler sind, das mehrere Händlerkonten verwaltet, und keine einzelne Merchant Center-ID haben, die Ihr Unternehmen repräsentiert, sollten Sie ein neues primäres Merchant Center-Konto erstellen und beantragen, dass es in ein erweitertes Konto umgewandelt wird.

Sobald Ihr Google Cloud-Projekt in Ihrem primären Merchant Center-Konto registriert ist, können Sie mit diesem Projekt alle anderen Merchant Center-Konten verwalten, auf die Sie Zugriff haben, ohne diese Konten einzeln registrieren zu müssen.

Ich verwende mehrere Google Cloud-Projekte. Muss ich jedes Gerät einzeln registrieren?

Ja. Da bei der Registrierung das aufrufende Google Cloud-Projekt verknüpft wird, müssen Sie den Aufruf registerGcp von jedem Google Cloud-Projekt ausführen, das Sie für API-Aufrufe verwenden.

Ein einzelnes Google Cloud-Projekt kann jeweils nur für ein Merchant Center-Konto registriert werden. In einem einzelnen Merchant Center-Konto können jedoch mehrere Google Cloud-Projekte registriert sein. Ebenso können Sie dieselbe Entwickler-E-Mail-Adresse verwenden, um mehrere Registrierungen in mehreren Google Cloud-Projekten oder mehreren Merchant Centern durchzuführen.

Was passiert, wenn ich ein Google Cloud-Projekt mit mehreren Merchant Center-Konten registriere?

Wenn Sie versuchen, ein Google Cloud-Projekt zu registrieren, das bereits bei einem anderen Merchant Center-Konto registriert ist, wird der Fehler ALREADY_REGISTERED ausgegeben.

Wie authentifiziere ich den API-Aufruf zur Entwicklerregistrierung?

Zum Authentifizieren des API-Aufrufs für die Entwicklerregistrierung für die Merchant API verwenden Sie Anmeldedaten, die über ein Google Cloud-Projekt verwaltet werden. Für die Identität, die die Authentifizierung durchführt, haben Sie zwei Hauptoptionen:

• Google-Konto wie Gmail mit OAuth 2.0: Bei dieser Methode werden OAuth 2.0-Clientanmeldedaten verwendet, die in Ihrem Google Cloud-Projekt generiert wurden. Der API-Aufruf wird im Namen eines bestimmten Google-Kontos autorisiert, in dem sich der Nutzer anmeldet.
• Dienstkonto: Bei dieser Methode wird ein Google Cloud-Dienstkonto verwendet. Dies ist ein spezieller Google-Kontotyp, der für Anwendungen vorgesehen ist. Die Anmeldedaten für das Dienstkonto werden ebenfalls in Ihrem Google Cloud-Projekt verwaltet.

Für eine erfolgreiche Entwicklerregistrierung muss die authentifizierende Identität (Google-Konto oder Dienstkonto) die folgenden Kriterien im Merchant Center erfüllen:

• Als Nutzer im Merchant Center vorhanden: Die E-Mail-Adresse, die mit dem authentifizierenden Google-Konto oder dem Dienstkonto verknüpft ist, muss als Nutzer im Merchant Center-Konto hinzugefügt werden, das Sie registrieren.
• Administratorrolle erforderlich: Diesem Nutzer muss die Rolle ADMIN in diesem Merchant Center-Konto zugewiesen sein.

Beachten Sie bei den API-Aufrufen Folgendes:

• Wenn Sie direkte API-Aufrufe verwenden, müssen Sie ein gültiges Zugriffstoken im Authorization-Header abrufen und angeben. Dieses Token wird durch den OAuth 2.0-Vorgang für ein Google-Konto oder den Server-zu-Server-Authentifizierungsvorgang für ein Dienstkonto generiert.
• Die von Google bereitgestellten Clientbibliotheken übernehmen in der Regel die komplexen Aufgaben des Abrufens und Aktualisierens von Zugriffstokens für Sie im Rahmen ihrer Konfiguration.

Der authentifizierende Nutzer ist möglicherweise nicht mit dem Entwicklerkontakt identisch. Weitere Informationen finden Sie unter Was ist der Unterschied zwischen der E‑Mail-Adresse für die Authentifizierung und der E‑Mail-Adresse für den Entwicklerkontakt?.

Wie oft muss ich Zugriffstokens aktualisieren?

Zugriffstokens für Dienstkonten und OAuth 2.0 laufen in der Regel nach einer Stunde ab. Der Mechanismus zum Abrufen eines neuen Tokens hängt jedoch von der verwendeten Authentifizierungsmethode ab:

• Dienstkonten verwenden einen privaten Schlüssel oder Umgebungsanmeldedaten, um bei Bedarf ein neues Zugriffstoken zu erstellen.
• Bei OAuth 2.0-Vorgängen wird ein refresh_token verwendet, um den Google OAuth2-Token-Endpunkt aufzurufen und ein neues Zugriffstoken mit einer Gültigkeit von einer Stunde zu erhalten.

Wir empfehlen dringend, die offiziellen Google Auth-Bibliotheken zu verwenden, die diese Rotation automatisch verarbeiten, damit Ihre Anwendung nie ausfällt.

Nutzer und Rollen

Häufig gestellte Fragen zu Nutzern und Rollen:

Muss das E-Mail-Konto des Entwicklers bereits im Merchant Center vorhanden sein?

Nein. Wenn das E-Mail-Konto für die Registrierung noch nicht im Merchant Center vorhanden ist, erstellt die Merchant API das Konto im Merchant Center mit der angegebenen E-Mail-Adresse im Status „Ausstehend“. Wenn die E-Mail-Adresse des Entwicklers zu einem vorhandenen Nutzer im Merchant Center-Konto gehört, wird ihm automatisch die Rolle API developer zugewiesen.

Muss die Kontakt-E-Mail-Adresse des Entwicklers Administratorrechte im Merchant Center haben?

Nein. Der Merchant Center-Nutzer, der mit der Kontakt-E-Mail-Adresse des Entwicklers verknüpft ist, erhält standardmäßig die Rolle API developer, die erforderlich ist, um wichtige Benachrichtigungen zu erhalten. Es hat jedoch nur minimale Berechtigungen im Merchant Center. Wenn Sie diesem Nutzer erlauben möchten, andere API-Aufrufe auszuführen oder Einstellungen in der Merchant Center-Benutzeroberfläche zu verwalten, müssen Sie ihm zusätzliche Rollen zuweisen, z. B. STANDARD oder ADMIN. Weitere Informationen zu den Merchant Center-Rollen finden Sie unter „Zugriffstypen“.

Welche Berechtigungen hat die Rolle „API developer“?

Die Rolle API developer ist eine Rolle mit minimalen Rechten im Merchant Center. Wenn Sie die E-Mail-Adresse des Entwicklerkontakts verwenden möchten, um Aufrufe der Merchant API zu autorisieren, empfehlen wir, die Berechtigungen ADMIN oder STANDARD hinzuzufügen, damit der Nutzer API-Aufrufe ausführen kann.

Muss ich jeden Entwicklernutzer oder jedes Dienstkonto registrieren, der bzw. das die API aufruft?

Nein. Die Entwicklerregistrierung ist an das Google Cloud-Projekt gebunden, das für die API-Aufrufe verwendet wird, und nicht an einzelne Nutzer oder Dienstkonten. Sobald ein Google Cloud-Projekt erfolgreich in Ihrem primären Merchant Center-Konto registriert wurde, können Sie jede Identität, die über das verknüpfte Google Cloud-Projekt verwaltet wird, mit OAuth-Anmeldedaten oder Dienstkonten verwenden, um Merchant API-Aufrufe zu autorisieren, sofern sie in Ihrem Merchant Center vorhanden sind und ihnen die Rolle ADMIN zugewiesen ist.

Wie ändere ich die Kontakt-E‑Mail-Adresse des Entwicklers nach der ersten Registrierung?

Wenn Sie Kontakte verwalten oder ändern möchten, verwenden Sie den Standarddienst accounts.users oder die Seite „Zugriff und Dienste“ in der Merchant Center-Benutzeroberfläche, um Nutzer mit der Rolle API developer hinzuzufügen oder zu entfernen.

Was passiert, wenn der letzte Nutzer mit der Rolle „API developer“ aus dem Merchant Center-Konto entfernt wird?

Es wird ein 30-tägiger Kulanzzeitraum ausgelöst, um eine sofortige Dienstunterbrechung zu vermeiden. Während dieser Zeit:

• Administratoren erhalten drei obligatorische Servicemitteilungen per E‑Mail (in der Regel etwa 30, 17 und 4 Tage vor der Sperrung).
• API-Aufrufe funktionieren weiterhin normal.
• Wenn vor Ablauf des Kulanzzeitraums kein neues API developer hinzugefügt wird, werden API-Aufrufe aus den zugehörigen Google Cloud-Projekten mit dem Fehler AUTH_GCP_NOT_REGISTERED blockiert.

Nach Ablauf des 30-tägigen Kulanzzeitraums werden API-Aufrufe aus den zugehörigen Google Cloud-Projekten blockiert und es wird ein AUTH_GCP_NOT_REGISTERED-Fehler ausgegeben, bis ein gültiger Entwicklerkontakt wiederhergestellt ist.

Was passiert, wenn die Merchant Center-ID, mit der die Entwicklerregistrierung erfolgt ist, gelöscht wird?

Löschen Sie das Merchant Center-Konto, das für die Entwicklerregistrierung verwendet wurde, nicht, solange Ihre Integration aktiv ist. Wenn Sie dieses Konto löschen, wird die Integration sofort unterbrochen und Sie können keine API-Aufrufe mehr über das zugehörige Google Cloud-Projekt ausführen.

Wenn Sie dieses Merchant Center-Konto löschen müssen, sollten Sie zuerst die Methode unregisterGcp aufrufen, um die Verknüpfung sicher zu entfernen. Erst danach sollten Sie die Merchant Center-ID löschen. Wenn Sie die Merchant API weiterhin verwenden möchten, müssen Sie sich direkt nach der Abmeldung der aktuellen Merchant Center-ID mit einer anderen Merchant Center-ID registrieren. Erst dann sollten Sie die Merchant Center-ID löschen.

Warum wird die Rolle „API developer“ im Merchant Center nicht angezeigt?

Die Rolle API developer ist erst nach der Entwicklerregistrierung für das jeweilige Merchant Center-Konto in der Merchant Center-Benutzeroberfläche sichtbar. In Merchant Center-Konten ohne Registrierungen wird die Rolle API developer nicht angezeigt.

Besondere Anwendungsfälle

Häufige Fragen zu besonderen Anwendungsfällen:

Ich bin eine Agentur oder ein Drittanbieter, der mehrere Händlerkonten verwaltet. Wie richten Sie das am besten ein?

Drittanbieter und Agenturen sollten ein eigenes primäres Merchant Center-Konto haben und alle ihre Google Cloud-Projekte in diesem zentralen Konto registrieren. Registrieren Sie Ihr Google Cloud-Projekt nicht für jedes einzelne Händlerkonto.

Wie funktioniert die Registrierung für Google Apps Script?

Apps Script-Skripts werden normalerweise in einem Google Cloud-Standardprojekt ausgeführt. Sie müssen diese Standard-Google Cloud-ID in Ihrem Merchant Center-Konto registrieren. Die Google Cloud-ID wird automatisch von der API abgerufen, sodass Sie sie nicht als Parameter angeben müssen.

Kann ich prüfen, ob eine Merchant Center-ID für eine bestimmte Google Cloud-Projekt-ID registriert ist?

Ja. Mit der Methode getAccountForGcpRegistration können Sie prüfen, welche Merchant Center-ID für ein bestimmtes Google Cloud-Projekt registriert ist. Wenn Sie die Verknüpfung eines Google Cloud-Projekts mit Ihrem Merchant Center-Konto aufheben möchten, verwenden Sie die Methode unregisterGcp.

Migration von der Content API zur Merchant API für die Nutzung der Google & YouTube App auf Shopify

Häufig gestellte Fragen zur Migration von der Content API zur Merchant API für Drittanbieterplattformen und ‑apps:

Muss ich etwas tun, um von der Content API zur Merchant API zu migrieren?

Es sind keine Maßnahmen erforderlich. Wenn Sie die Google & YouTube App auf Shopify verwenden, um Ihre Merchant Center-Feeds zu verwalten, wird die Migration von der Content API zur Merchant API von Google durchgeführt.

Ändern sich meine Produkt-IDs durch die Migration?

Nein, die Migration ändert die Produkt-IDs in Ihren Merchant Center-Feeds nicht.

Muss ich die Google & YouTube App auf Shopify neu installieren, um die Umstellung abzuschließen?

Es sind keine Schritte Ihrerseits erforderlich, um die Umstellung abzuschließen. Sie müssen die Google & YouTube App nicht neu installieren.

Warum sehe ich im Merchant Center immer noch Content API-Datenquellen?

Content API-Datenquellen werden während der Umstellung auf die Merchant API möglicherweise weiterhin im Merchant Center angezeigt. Diese Instanzen sind normal und erfordern keine Maßnahmen Ihrerseits.