Dienstkonten

Dienstkonten sind spezielle Google-Konten, mit denen Anwendungen programmgesteuert über OAuth 2.0 auf Google APIs zugreifen können. 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 wird erläutert, wie Sie mit Dienstkonten auf die Content API for Shopping zugreifen können.

Hinweis: Anwendungen, die Dienstkonten zur Authentifizierung verwenden, können nur auf Ihr eigenes Merchant Center-Konto zugreifen. Wenn Sie eine Drittanbieteranwendung schreiben, die Zugriff auf die Merchant Center-Konten Ihrer Kunden benötigt, lesen Sie stattdessen den Leitfaden Anfragen autorisieren.

Voraussetzungen

Schritte zum Verwenden eines Dienstkontos für den Zugriff auf die Content API for Shopping

  1. Generieren Sie Dienstkonto-Anmeldedaten 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 kein Projekt haben, klicken Sie auf NEUES PROJEKT.
    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. Wählen Sie links Anmeldedaten aus. Möglicherweise müssen Sie links oben auf den Linkspfeil klicken, um die Option zu sehen.
    5. Wählen Sie zum Einrichten eines Dienstkontos ANMELDEDATEN ERSTELLEN und dann Dienstkonto aus.
    6. Geben Sie dem neuen Dienstkonto einen Namen. Dies dient auch als Standardnutzername für die Dienstkonto-ID. Notieren Sie sich die Dienstkonto-ID, einschließlich des Teils nach dem @-Zeichen, um sie später zu verwenden. Klicken Sie auf ERSTELLEN, führen Sie die optionalen Schritte aus, um Projekt- und Nutzerzugriff zu gewähren. Klicken Sie dann auf FERTIG.

      Die Wahl der Rolle für das Dienstkonto hat keinen Einfluss darauf, welche Aufrufe an die Content API erfolgen können. Der Zugriff auf Content API-Methoden wird stattdessen durch die Rolle bestimmt, die der Dienstkonto-ID im Merchant Center zugeordnet ist. Wenn Sie nicht sicher sind, was Sie auswählen sollen, wählen Sie Projekt > Betrachter aus.

    7. Sie werden zur Seite „Dienstkonten“ weitergeleitet, auf der Sie auf Ihr neues Dienstkonto zugreifen können.
    8. Zum Abrufen eines privaten JSON-Schlüssels 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üge das neue Dienstkonto deinem Merchant Center-Konto als Nutzer hinzu. Wenn Sie ein Drittentwickler sind, muss Ihr Kunde diesen Schritt für Sie ausführen.
    1. Rufen Sie Ihr Merchant Center-Konto auf.
    2. Klicken Sie in den Einstellungen Ihres Merchant Center-Kontos auf Kontozugriff.
    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 Dienstkonten auf und wählen Sie das Projekt aus, das Sie erstellt haben.

    4. Legen Sie die Einstellungen für Nutzerzugriff und E-Mail-Benachrichtigungen für das Dienstkonto fest. Die Verwendung des Accounts-Dienstes erfordert Administratorzugriff.
    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. Sie können jetzt entweder über das Dienstkonto Google Standardanmeldedaten oder den Dienstkontoablauf direkt auf Ihr Merchant Center-Konto zugreifen. Die Beispiele für die Content API for Shopping zeigen, wie Sie beide Abläufe für Dienstkonto-Anmeldedaten in jeder unterstützten Programmiersprache verwenden. Sehen Sie sich die Codebeispiele an, um Ihr neues Dienstkonto auszuprobieren und zu erfahren, welche Änderungen Sie zur Verwendung von Dienstkonten in Ihrem eigenen Code benötigen.

Häufig gestellte Fragen

Kann ich mich mit meinem Dienstkonto auf der Merchant Center-Benutzeroberfläche anmelden?
Nein, Dienstkonten sind keine regulären Google-Konten und können nicht auf die Merchant Center-UI zugreifen.
Wie oft muss ich Dienstkonto-Zugriffstoken aktualisieren?
Zugriffstokens laufen eine Stunde ab, nachdem sie vom Google OAuth 2.0-Autorisierungsserver ausgestellt wurden. Wenn ein Zugriffstoken abläuft, sollte die Anwendung die Clientbibliothek verwenden, um ein weiteres Zugriffstoken abzurufen.