Übersicht

Für eine effektive Nutzung der Merchant API ist es wichtig, die Konzepte 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 sind miteinander verbunden, haben aber jeweils eine eigene Bedeutung und einen eigenen Zweck.

• Authentifizierung: Bei diesem Vorgang überprüft der Dienst die Identität des Nutzers oder der Anwendung, der bzw. die eine API-Anfrage stellt. Die Merchant API verwendet Standardmechanismen von Google wie OAuth 2.0. 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. Dabei wird die Frage beantwortet, was der Nutzer basierend auf den Rollen und Berechtigungen tun kann, die ihm im Merchant Center-Konto gewährt wurden. Ein Nutzer kann beispielsweise berechtigt sein, Produktdaten zu lesen, aber nicht, Kontoeinstellungen zu ändern.
• Registrierung: Im Hinblick auf die Merchant API ist dies ein einmaliger Einrichtungsvorgang, mit dem Google Ihnen wichtige Servicemitteilungen für die von Ihnen verwalteten Händlerkonten senden kann. Bei der Registrierung werden Ihre E-Mail-Adressen für Entwickler Ihrem Haupt-Merchant Center-Konto 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 erhalten. Weitere Informationen finden Sie unter Google Cloud Projekt erstellen.

Registrierung

Der Registrierungsvorgang ist entscheidend, damit Ihre Anwendung die Merchant API verwenden kann. Dazu sollten Sie Folgendes wissen:

Vorbereitung

Für die Registrierung zur Nutzung 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 Administratorrechte 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 enthält die erforderlichen Anmeldedaten (z. B. OAuth 2.0-Client-IDs) für die Authentifizierung Ihrer Anwendung.

Warum Sie kein freigegebenes Google Cloud-Projekt registrieren können

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

• Sie für Tests und Erkundungen gedacht sind, nicht für die Identität von Produktionsanwendungen.
• Die Registrierung eine Verknüpfung zwischen dem freigegebenen Tool und Ihren spezifischen Merchant Center-Daten implizieren würde und zu unerwünschter Kommunikation führen könnte.

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 Webanwendungen OAuth Playground und API Explorer jedoch verwenden, um die Merchant API für Tests und nicht produktionsbezogene Anwendungsfälle zu nutzen.

Google Cloud-Projekt-ID finden

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

Registrierungsaufruf ausführen

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

Geben Sie dabei eine E-Mail-Adresse an, die mit einem einzelnen Nutzer verknüpft ist und mit der Sie die API aufrufen. Diese E-Mail-Adresse muss zu einem Nutzer mit Administratorzugriff auf das Merchant Center-Konto gehören.

Das Feld „E-Mail-Adresse“

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

• Zweck: Google verwendet diese E-Mail-Adresse als primären Kontakt für API-bezogene Mitteilungen.
• E-Mail-Adresse von wem: 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:
  • DO: Verwenden Sie die geschäftliche E-Mail-Adresse einer Person.
  • DO NOT: Verwenden Sie keine allgemeinen Gruppen-Aliasse oder E-Mail-Adressen von Dienstkonten. Wir richten unsere Mitteilungen an menschliche Empfänger.

Die Ressource users für die Kontaktverwaltung

Die E-Mail-Adresse im Registrierungsaufruf legt zwar einen ersten Kontakt fest, aber die robustere Methode zum Verwalten von Kontakten und Berechtigungen ist die Verwendung der Merchant API accounts.users Ressource oder der Einstellungen für die Nutzerverwaltung in der Merchant Center-Benutzeroberfläche. Weitere Informationen zur Verwendung des Merchant Center 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 API-Kontaktverwaltung wird von der einmaligen Registrierung entkoppelt.
   • Flexibilität: Aktualisieren Sie Kontakte, wenn sich Teammitglieder ändern.
   • Gezielte 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:

• Kurzanleitung
• DeveloperRegistration -Methoden