Authentifizierung für die Merchant API einrichten

Um die Datensicherheit zu gewährleisten, die Zugriffssteuerung zu erzwingen und die Systemintegrität aufrechtzuerhalten, müssen Sie alle Merchant API-Anfragen authentifizieren. Die API verwendet die authentifizierte Identität, um die Aktionen zu bestimmen, die der Aufrufer ausführen darf. Beispielsweise haben einige Aufrufer möglicherweise nur Lesezugriff auf Produktdaten, während andere die Kontoeinstellungen im Merchant Center ändern können.

Dieses Dokument ist Teil einer mehrteiligen Reihe zu den ersten Schritten mit der Merchant API. Wenn Sie die Authentifizierung bereits mit der Merchant API eingerichtet haben, können Sie mit dem nächsten Abschnitt fortfahren: Als Entwickler registrieren

Anfragen an die Merchant API autorisieren

Jede Anfrage, die an die Merchant API gesendet wird, muss ein Autorisierungstoken enthalten, um Ihre Anwendung gegenüber Google zu identifizieren. Wählen Sie zum Einrichten der Authentifizierung und Autorisierung den Anwendungsfall aus, der am besten beschreibt, wie Sie die Merchant API verwenden möchten:

Entwickeln Sie eine Anwendung, die von anderen Unternehmen verwendet werden soll?

Falls ja, verwenden Sie die OAuth 2.0-Autorisierung. Wählen Sie die OAuth 2.0-Autorisierung in folgenden Fällen aus:

• Sie sind ein Drittanbieter oder eine Agentur: Sie entwickeln eine Anwendung, z. B. eine SaaS-Plattform, die von anderen Unternehmen zur Verwaltung ihrer eigenen Merchant Center-Daten verwendet wird.
• Sie müssen viele externe Konten verwalten: Sie möchten eine einzige Anwendung für mehrere unabhängige Merchant Center-Konten verwenden, die verschiedenen Kontoinhabern gehören. Ihre Kunden erteilen Berechtigungen, indem sie sich in ihren eigenen Google-Konten anmelden und auf einem Zustimmungsbildschirm auf „Zulassen“ klicken.

Entwickeln Sie eine App für Ihr eigenes Unternehmen?

Wenn ja, verwenden Sie eine Dienstkontoautorisierung, um Zugriff auf die Merchant API zu erhalten. Wählen Sie eine Dienstkonto-Autorisierung aus, wenn:

• Sie entwickeln eine eigene interne Anwendung: Sie entwickeln ein Tool speziell für Ihr eigenes Unternehmen, um Ihre eigenen Merchant Center-Daten zu verwalten, oder Sie möchten, dass die Anmeldedaten zur Anwendung selbst und nicht zu einem bestimmten einzelnen Nutzer gehören.
• Sie benötigen eine Automatisierung ohne menschliche Anmeldung: Ihre Anwendung führt Hintergrundaufgaben wie automatisierte Inventaraktualisierungen oder „Cron“-Jobs aus.

OAuth 2.0-Autorisierung

Wenn Sie ein Drittanbieter oder eine Agentur sind, die mehrere Kundenkonten verwaltet, muss Ihre Anwendung OAuth 2.0 verwenden, um Anfragen zu autorisieren. So richten Sie OAuth 2.0 für die Merchant API ein:

1. Erstellen Sie OAuth 2.0-Anmeldedaten in der Google Cloud Console unter APIs und Dienste.
2. Laden Sie die OAuth2-Clientanmeldedaten in die Datei herunter, z. B. client-secrets.json.
3. E-Mail-Konto als Nutzer im Merchant Center hinzufügen: Das Google-Konto, mit dem Sie Anfragen autorisieren, muss als Nutzer im Merchant Center vorhanden sein. Weitere Informationen finden Sie unter Nutzer im Merchant Center hinzufügen oder entfernen.
4. Weisen Sie ihm die Rolle Admin zu, um die Registrierung durchzuführen. Weitere Informationen zu Rollen finden Sie unter Personen und Zugriffsebenen im Merchant Center verwalten.
5. Authentifizierung mit Codebeispielen einrichten: Folgen Sie der Anleitung in den offiziellen Codebeispielen im Dokumentationsabschnitt Authentifizierung und Beispielkonfiguration einrichten.

Weitere Informationen zur OAuth 2.0-Autorisierung finden Sie unter Zugriff von Drittanbieter-Apps auf das Merchant Center-Konto autorisieren und Mit OAuth 2.0 auf Google APIs zugreifen.

Autorisierung über ein Dienstkonto

Sie verwenden ein Dienstkonto, um den Zugriff der Merchant API auf Ihr eigenes Merchant Center-Konto zu autorisieren. So richten Sie die Dienstkontoautorisierung für die Merchant API ein:

1. Erstellen Sie Anmeldedaten für das Dienstkonto in der Google Cloud Console unter APIs und Dienste.
2. Privaten Schlüssel herunterladen: Erstellen Sie den privaten Schlüssel im JSON-Format für das Dienstkonto und laden Sie ihn herunter. Benennen Sie die Datei in service-account.json um.
3. Dienstkonto zum Merchant Center hinzufügen: Kopieren Sie die eindeutige E-Mail-Adresse des Dienstkontos, z. B. [e-mail], und fügen Sie sie als neuen Nutzer in Ihrem Merchant Center hinzu. Weitere Informationen finden Sie unter Nutzer im Merchant Center hinzufügen oder entfernen.
4. Weisen Sie ihm den Zugriff Admin zu. Weitere Informationen zu Zugriffsebenen finden Sie unter Personen und Zugriffsebenen im Merchant Center verwalten.
5. Authentifizierung mit Codebeispielen einrichten: Folgen Sie der Anleitung in den offiziellen Codebeispielen im Dokumentationsabschnitt Authentifizierung und Beispielkonfiguration einrichten.

Weitere Informationen zur Autorisierung von Dienstkonten finden Sie unter Zugriff auf Ihr Merchant Center-Konto autorisieren und Dienstkonten – Übersicht.