Dienstkonten

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, für den keine Autorisierung durch einen Nutzer erforderlich ist. Stattdessen wird eine Schlüsseldatei verwendet, auf die nur Ihre Anwendung zugreifen kann. In dieser Anleitung wird beschrieben, wie Sie mit Dienstkonten auf die Content API for Shopping zugreifen.

Hinweis:Anwendungen, die Dienstkonten zur Authentifizierung 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 die Anleitung zum Autorisieren von Anfragen.

Vorbereitung

Schritte zur Verwendung eines Dienstkontos für den Zugriff auf die Content API for Shopping

  1. Generieren Sie Anmeldedaten für das Dienstkonto oder greifen Sie auf die öffentlichen Anmeldedaten zu, die Sie bereits generiert haben. Sie müssen eine OAuth 2.0-Client-ID erstellen und eine private *.json-Schlüsseldatei abrufen:
    1. Gehen Sie zur Google API Console.
    2. Wählen Sie oben auf der Seite im Drop-down-Menü ein Projekt aus. Wenn Sie noch keines haben, erstellen Sie eines, indem Sie auf NEUES PROJEKT klicken.
    3. Wenn Sie die Content API for Shopping für dieses Projekt noch nicht aktiviert haben, suchen Sie sie in der Liste der Google APIs und aktivieren Sie sie.
    4. Klicken Sie oben links auf das Navigationsmenü (☰), wählen Sie APIs &Dienste und dann Anmeldedaten aus.
    5. Wenn Sie ein Dienstkonto einrichten möchten, wählen Sie ANMELDEDATEN ERSTELLEN und dann Dienstkonto aus.
    6. Geben Sie einen Namen für das neue Dienstkonto ein. Dieser Name dient auch als Standardnutzername für die Dienstkonto-ID. Notieren Sie sich die Dienstkonto-ID einschließlich des Teils nach dem @-Zeichen für die spätere Verwendung. Klicken Sie auf ERSTELLEN und führen Sie dann die optionalen Schritte zum Gewähren des Zugriffs auf Projekt und Nutzer aus. Klicken Sie anschließ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 mit der Dienstkonto-ID im Merchant Center verknüpft ist. Wenn Sie sich nicht sicher sind, was Sie auswählen sollen, wählen Sie einfach Projekt > Betrachter aus.

    7. Sie werden zur Seite „Dienstkonten“ weitergeleitet, auf der Sie auf Ihr neues Dienstkonto zugreifen können.
    8. Wenn Sie einen privaten JSON-Schlüssel abrufen möchten, klicken Sie auf das Dienstkonto und dann auf den Tab SCHLÜSSEL. Klicken Sie auf SCHLÜSSEL HINZUFÜGEN > Neuen Schlüssel erstellen und wählen Sie dann „JSON“ als Schlüsseltyp aus. Klicken Sie auf ERSTELLEN , um den privaten Schlüssel auf Ihren Computer herunterzuladen.
  2. Fügen Sie das neue Dienstkonto als Nutzer zu Ihrem Merchant Center-Konto hinzu. Wenn Sie ein Drittanbieterentwickler sind, müssen Sie diesen Schritt von Ihrem Kunden ausführen lassen.
    1. Rufen Sie Ihr Merchant Center-Konto auf.
    2. Rufen Sie in den Einstellungen Ihres Merchant Center-Kontos die Option Kontozugriff auf.
    3. Klicken Sie auf + Nutzer hinzufügen und verwenden Sie die Dienstkonto-ID als E-Mail-Adresse für den neuen Nutzer.

      Wenn Sie sich die Dienstkonto-ID nicht notiert haben, rufen Sie die Verwaltungsseite für Dienstkonten auf und wählen Sie das von Ihnen erstellte Projekt aus.

    4. Geben Sie die Einstellungen für Nutzerzugriff und E-Mail-Benachrichtigungen für das Dienstkonto an. Für die Verwendung des Dienstes Accounts ist Administratorzugriff erforderlich.
    5. 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 aufgeführt sein.
    6. Wiederholen Sie den Vorgang für alle anderen Dienstkonten, die Sie hinzufügen möchten.
  3. Jetzt können Sie mit dem Dienstkonto auf Ihr Merchant Center-Konto zugreifen. Verwenden Sie dazu entweder den Google Application Default Credentials-Ablauf oder den Dienstkontoablauf direkt. In den Beispielen für die Content API for Shopping wird gezeigt, wie Sie beide Abläufe für Dienstkontoanmeldedaten in jeder unterstützten Programmiersprache verwenden. Sehen Sie sich die Codebeispiele an, um Ihr neues Dienstkonto zu testen und zu erfahren, 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 Zugriffstokens für Dienstkonten aktualisieren?
Zugriffstokens laufen eine Stunde nach der Ausstellung durch den Google OAuth 2.0-Autorisierungsserver ab. Wenn ein Zugriffstoken abläuft, sollte die Anwendung mit der Clientbibliothek ein anderes Zugriffstoken abrufen.