Übersicht

Um die Merchant API effektiv nutzen zu können, ist es wichtig, die Konzepte der Registrierung, Authentifizierung und Autorisierung zu verstehen. Sie dienen unterschiedlichen Zwecken, um einen sicheren und korrekten Zugriff auf Merchant Center-Daten zu gewährleisten.

Terminologie

Registrierung, Authentifizierung und Autorisierung hängen zusammen, haben aber jeweils eine eigene Bedeutung und einen eigenen Zweck.

  • Authentifizierung: Bei diesem Prozess überprüft der Dienst die Identität des Nutzers oder der Anwendung, der bzw. die eine API-Anfrage stellt. Die Merchant API verwendet standardmäßige Google-Mechanismen wie OAuth 2.0. Die Verwendung von API-Schlüsseln für die Authentifizierung wird nicht unterstützt und führt zu Authentifizierungsfehlern. Weitere Informationen finden Sie unter Anfragen authentifizieren und Als eigenes Konto authentifizieren.
  • Autorisierung: Bei diesem Vorgang wird festgelegt, welche Aktionen der authentifizierte Nutzer oder die authentifizierte Anwendung mit einem Merchant Center-Konto ausführen darf. Sie beantwortet die Frage „Was können Sie tun?“ basierend auf den Rollen und Berechtigungen, die dem authentifizierten Nutzer im Merchant Center-Konto gewährt wurden. Ein Nutzer kann beispielsweise berechtigt sein, Produktdaten zu lesen, aber nicht, Kontoeinstellungen zu ändern.
  • Registrierung: Bei der Merchant API ist dies ein einmaliger Einrichtungsprozess, über den Google Ihnen wichtige Servicemitteilungen für die von Ihnen verwalteten Händlerkonten senden kann. Bei der Registrierung werden Ihre Entwickler-E-Mail-Adressen Ihrem Merchant Center-Hauptkonto hinzugefügt und mit den Google Cloud-Projekt-IDs verknüpft, die Sie für die Authentifizierung verwenden. Durch diese Verknüpfung kann Ihre Anwendung Servicemitteilungen für alle von Ihnen verwalteten Händlerkonten empfangen. Weitere Informationen finden Sie unter Google Cloud-Projekt erstellen.

Anmeldung

Die Registrierung ist erforderlich, damit Ihre Anwendung die Merchant API verwenden kann. Dazu sollten Sie Folgendes wissen:

Vorbereitung

Für die Registrierung zur Verwendung der Merchant API ist Folgendes erforderlich:

  • Merchant Center-Konto: Sie benötigen ein bestehendes Merchant Center-Konto.
  • Administratorzugriff: Das Google-Nutzerkonto, mit dem Sie den Registrierungsaufruf initiieren, muss Administratorberechtigungen für das Merchant Center-Konto haben, das Sie registrieren.
  • Google Cloud-Projekt: Ihre Anwendung muss mit einem Google Cloud-Projekt verknüpft sein. Dieses Projekt stellt die erforderlichen Anmeldedaten (z. B. OAuth 2.0-Client-IDs) für die Authentifizierung Ihrer Anwendung bereit.

Warum Sie ein freigegebenes Google Cloud-Projekt nicht registrieren können

Tools wie Google OAuth Playground und APIs Explorer verwenden freigegebene Google Cloud-Projekte, die Google gehören. Sie können sich aus folgenden Gründen nicht mit freigegebenen Projekten registrieren:

  • Sie sind für Tests und explorative Datenanalysen gedacht, nicht für die Identität von Produktionsanwendungen.
  • Wenn Sie sie registrieren, wird eine Verknüpfung zwischen dem gemeinsam genutzten Tool und Ihren spezifischen Merchant Center-Daten hergestellt. Dies kann zu unerwünschter Kommunikation führen.

Ihre Anwendung benötigt ein eigenes Google Cloud-Projekt, damit die Merchant API-Mitteilungen, die Google Ihnen sendet, für Ihre tatsächliche Nutzung relevant bleiben.

Sie können die Merchant API jedoch mit den Webanwendungen OAuth Playground und API Explorer für Tests und nicht produktive Anwendungsfälle verwenden.

Google Cloud-Projekt-ID suchen

Sie finden Ihre Projekt-ID und Projektnummer in der Google Cloud Console. Weitere Informationen finden Sie unter Projektname, ‑nummer und ‑ID ermitteln.

Registrierungsaufruf ausführen

Registrieren Sie sich mit der Methode registerGcp in der Sub-API Accounts. Durch diesen Aufruf wird Ihre Google Cloud-Projektnummer mit dem Merchant Center-Konto verknüpft.

Während des Vorgangs müssen Sie eine E-Mail-Adresse angeben, die mit einem einzelnen Nutzer verknüpft ist, den Sie zum Aufrufen der API verwenden. Diese E-Mail-Adresse muss zu einem Nutzer mit Administratorzugriff auf das Merchant Center-Konto gehören.

Feld für die E‑Mail-Adresse

Eine effektive Kommunikation ist entscheidend. Google sendet wichtige Updates, Servicemitteilungen, Entwicklerumfragen und andere Informationen zur Merchant API. Durch eine ordnungsgemäße Kontaktverwaltung wird sichergestellt, dass diese die richtigen Personen erreichen.

  • Zweck: Google verwendet diese E-Mail-Adresse als primären Kontakt für API-bezogene Mitteilungen.
  • Whose email (E-Mail-Adresse): Dies sollte die E-Mail-Adresse eines einzelnen Entwicklers oder eines wichtigen technischen Kontakts sein, der für die API-Integration verantwortlich ist.
  • Best Practices:
    • RICHTIG: Verwenden Sie die geschäftliche E‑Mail-Adresse einer Person.
    • NICHT: Allgemeine Gruppen-Aliasse oder E‑Mail-Adressen von Dienstkonten verwenden. Unsere Mitteilungen sind für menschliche Empfänger bestimmt.

Die users-Ressource für die Kontaktverwaltung

Mit der E-Mail-Adresse im Registrierungsaufruf wird ein erster Kontakt festgelegt. Die zuverlässigere Methode zum Verwalten von Kontakten und Berechtigungen ist jedoch die Verwendung der Merchant API-Ressource accounts.users oder der Einstellungen für die Nutzerverwaltung in der Merchant Center-Benutzeroberfläche. Weitere Informationen zur Verwendung des Merchant Centers finden Sie unter Nutzer in Ihrem Konto verwalten.

So nutzen Sie diese Funktionen:

  1. Alle Entwickler hinzufügen: Fügen Sie Entwickler, die an der API-Integration arbeiten, als Nutzer des Merchant Center-Kontos hinzu.
  2. Rolle API_DEVELOPER zuweisen: Neben den Standardrollen (Administrator, Standard) können Sie Nutzern die Rolle API_DEVELOPER zuweisen. Weisen Sie diese Rolle insbesondere Nutzern zu, die API-bezogene Mitteilungen erhalten sollen. Sie können sie mit anderen Rollen kombinieren.
  3. Vorteile:
    • Klare Trennung: Die Verwaltung von API-Kontakten wird von der einmaligen Registrierung entkoppelt.
    • Flexibilität: Kontakte können aktualisiert werden, wenn sich die Teammitglieder ändern.
    • Zielgerichtete Kommunikation: API-spezifische Neuigkeiten werden an die relevanten Personen gesendet.

Auch wenn Sie bei der Registrierung eine E-Mail-Adresse angegeben haben, empfehlen wir dringend, API-Kontakte zu verwalten, indem Sie Nutzer mit der Rolle API_DEVELOPER hinzufügen.

Verweise

Hier finden Sie weitere Informationen:

Zurück
Known issues
Weiter
Access client accounts