Dienstkonten sind spezielle Google-Konten, die von Anwendungen verwendet werden können, um programmatisch über OAuth 2.0 auf Google APIs zuzugreifen. Ein Dienstkonto verwendet einen OAuth 2.0-Vorgang, der keine manuelle Autorisierung erfordert. Stattdessen wird eine Schlüsseldatei verwendet, auf die nur Ihre Anwendung zugreifen kann. In diesem Leitfaden erfahren Sie, wie Sie mit Dienstkonten auf die Content API for Shopping zugreifen.
Hinweis:Anwendungen, die für die Authentifizierung Dienstkonten verwenden, können nur auf Ihr eigenes Merchant Center-Konto zugreifen. Wenn Sie eine Drittanbieteranwendung entwickeln, die Zugriff auf die Merchant Center-Konten Ihrer Kunden benötigt, lesen Sie stattdessen den Leitfaden Anfragen autorisieren.
Vorbereitung
- Sie haben ein Merchant Center-Konto.
Schritte zum Zugriff auf die Content API for Shopping über ein Dienstkonto
- Generieren Sie Anmeldedaten für ein Dienstkonto oder greifen Sie auf die bereits generierten öffentlichen Anmeldedaten zu. Du musst eine OAuth 2.0-Client-ID erstellen und eine private *.json-Schlüsseldatei abrufen:
- Gehen Sie zur Google API Console.
- Wählen Sie oben auf der Seite im Drop-down-Menü ein Projekt aus. Falls Sie noch kein Projekt haben, erstellen Sie eines. Klicken Sie dazu auf NEUES PROJEKT.
- Wenn Sie die Content API for Shopping für dieses Projekt noch nicht aktiviert haben, suchen Sie in der Liste der Google APIs danach und aktivieren Sie sie.
- Wähle in der Seitenleiste links Anmeldedaten aus. Möglicherweise müssen Sie oben links auf den nach links weisenden Pfeil klicken, um diese Option zu sehen.
- Wählen Sie zum Einrichten eines Dienstkontos ANMELDEDATEN ERSTELLEN und dann Dienstkonto aus.
- Geben Sie dem neuen Dienstkonto einen Namen. Dieser dient auch als Standardnutzername für die Dienstkonto-ID. Notieren Sie sich die Dienstkonto-ID, einschließlich des Teils nach dem Zeichen „@“, für später. Klicken Sie auf ERSTELLEN und führen Sie dann die optionalen Schritte aus, um Zugriff auf das Projekt und die Nutzer zu gewähren. Klicken Sie abschließend auf FERTIG.
Die Auswahl der Rolle für das Dienstkonto hat keine Auswirkungen darauf, welche Aufrufe an die Content API gesendet werden können. Der Zugriff auf Content API-Methoden wird stattdessen durch die Rolle bestimmt, die der Dienstkonto-ID im Merchant Center zugewiesen ist. Wenn Sie nicht sicher sind, was Sie auswählen sollen, wählen Sie einfach Projekt > Betrachter aus.
- Sie werden zur Seite „Dienstkonten“ weitergeleitet, auf der Sie auf das neue Dienstkonto zugreifen können.
- Klicken Sie auf das Dienstkonto und dann auf den Tab SCHLÜSSEL, um einen privaten JSON-Schlüssel abzurufen. Klicken Sie auf SCHLÜSSEL HINZUFÜGEN > Neuen Schlüssel erstellen und wählen Sie dann JSON als Schlüsseltyp aus. Klicke auf ERSTELLEN, um den privaten Schlüssel auf deinen Computer herunterzuladen.
- Füge deinem Merchant Center-Konto das neue Dienstkonto als Nutzer hinzu. Drittanbieter-Entwickler müssen Ihren Kunden diesen Schritt für Sie ausführen lassen.
- Rufen Sie Ihr Merchant Center-Konto auf.
- Rufen Sie in den Einstellungen Ihres Merchant Center-Kontos Kontozugriff auf.
- Klicken Sie auf + Nutzer hinzufügen und verwenden Sie die ID des Dienstkontos als E-Mail-Adresse für den neuen Nutzer.
Wenn Sie sich die Dienstkonto-ID nicht notiert haben, rufen Sie die Seite Dienstkonten auf und wählen Sie das von Ihnen erstellte Projekt aus.
- Geben Sie die Einstellungen für den Nutzerzugriff und die E-Mail-Benachrichtigungen für das Dienstkonto an. Für die Nutzung des
Accounts
-Dienstes ist Administratorzugriff erforderlich. - Klicken Sie auf Nutzer hinzufügen, um die Einstellungen zu speichern und zur Liste der Nutzer zurückzukehren. Die Dienstkonto-ID sollte mit der ausgewählten Nutzerrolle aufgelistet sein.
- Wiederholen Sie diesen Vorgang für alle anderen Dienstkonten, die Sie hinzufügen möchten.
- Sie können jetzt über das Dienstkonto auf Ihr Merchant Center-Konto zugreifen. Verwenden Sie dazu entweder den Ablauf Standardanmeldedaten für Google-Anwendungen oder direkt den Ablauf für Dienstkonten. In den Beispielen für die Content API for Shopping wird gezeigt, wie Sie beide Abläufe für Dienstkonto-Anmeldedaten in den einzelnen unterstützten Programmiersprachen verwenden. Sehen Sie sich die Codebeispiele an, um Ihr neues Dienstkonto auszuprobieren und herauszufinden, welche Änderungen Sie vornehmen müssen, um Dienstkonten in Ihrem eigenen Code zu verwenden.
Häufig gestellte Fragen
- Kann ich mich mit meinem Dienstkonto in der Merchant Center-Benutzeroberfläche anmelden?
- Nein. Dienstkonten sind keine regulären Google-Konten und können nicht auf die Merchant Center-Benutzeroberfläche zugreifen.
- Wie oft muss ich die Zugriffstokens für Dienstkonten aktualisieren?
- Zugriffstokens verfallen eine Stunde, nachdem sie vom Google OAuth 2.0 Authorization Server ausgestellt wurden. Wenn ein Zugriffstoken abläuft, sollte die Anwendung über die Clientbibliothek ein neues abrufen.