OAuth 2.0-Dienstkonten mit der Manufacturer Center API verwenden

Dienstkonten sind spezielle Google-Konten, mit denen Anwendungen programmatisch über OAuth 2.0 auf Google APIs zugreifen können. Ein Dienstkonto verwendet einen OAuth 2.0-Vorgang, der keine zusätzliche 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 Manufacturer Center API zugreifen.

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

Voraussetzungen

• Ein Manufacturer Center-Konto.

Schritte zum Verwenden eines Dienstkontos für den Zugriff auf die Manufacturer Center API

1. Generieren Sie Anmeldedaten für ein Dienstkonto oder greifen Sie auf die öffentlichen Anmeldedaten zu, die Sie bereits generiert haben. Du musst 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, erstellen Sie eines, indem Sie auf Projekt erstellen klicken.

   3. Wenn Sie die Manufacturer Center API für dieses Projekt noch nicht aktiviert haben, suchen Sie in der Liste der Google APIs danach und aktivieren Sie sie.

   4. Wählen Sie in der linken Seitenleiste Anmeldedaten aus.

   5. Wählen Sie zum Einrichten eines Dienstkontos Anmeldedaten erstellen und dann Dienstkontoschlüssel aus.

   

   1. Wählen Sie auf der nächsten Seite in der Drop-down-Liste Neues Dienstkonto aus.

   2. Geben Sie dem neuen Dienstkonto einen Namen. Dies dient auch als Standardnutzername für die Dienstkonto-ID. Merken Sie sich die Dienstkonto-ID zur späteren Verwendung.

   Hinweis: Die Auswahl der Rolle für das Dienstkonto hat keinen Einfluss darauf, welche Aufrufe an die Manufacturer Center API gesendet werden können. Der Zugriff auf die Methoden der Manufacturer Center API wird durch die Rolle bestimmt, die mit der Dienstkonto-ID im Manufacturer Center verknüpft ist. Wenn Sie nicht sicher sind, was Sie auswählen sollen, wählen Sie einfach „Project►Viewer“.

   

   1. Wählen Sie als Schlüsseltyp JSON aus und klicken Sie dann auf Erstellen.

   2. Die Schaltfläche Erstellen ändert sich zu Erstellen.... Sobald die Schlüsselgenerierung abgeschlossen ist, wird der private Schlüssel automatisch als *.json-Datei heruntergeladen.

   Wichtig :Schützen Sie die *.json-Schlüsseldatei, mit der ein Dienstkonto auf die Google-Dienste zugreifen kann, für die es autorisiert wurde. Es empfiehlt sich, Dienstkonten den Zugriff auf jeweils nur eine Google API zu gestatten. Dies ist eine vorbeugende Maßnahme, um die Datenmenge zu reduzieren, auf die ein Angreifer zugreifen kann, wenn die *.json-Schlüsseldatei des Dienstkontos manipuliert wurde.
   1. Sie kehren zur Seite „Anmeldedaten“ zurück. Das neue Dienstkonto sollte in der Liste der Dienstkontoschlüssel für Ihr Konto angezeigt werden.

2. Fügen Sie das neue Dienstkonto Ihrem Manufacturer Center-Konto als Nutzer hinzu. Wenn Sie ein Drittanbieter-Entwickler sind, müssen Sie Ihren Kunden diesen Schritt für Sie ausführen lassen.

   1. Rufen Sie Ihr Manufacturer Center-Konto auf.

   2. Rufen Sie in den Einstellungen Ihres Manufacturer Center-Kontos die Liste "Nutzer" auf.

   3. Klicken Sie auf die Schaltfläche „+ Nutzer“ und verwenden Sie die Dienstkonto-ID als E-Mail-Adresse für den neuen Nutzer.

      

   4. Füllen Sie das Formular mit der Dienstkonto-ID aus und wählen Sie die gewünschte(n) Nutzerrolle(n) aus. Es muss mindestens eine Option ausgewählt werden. Zur Verwendung des Dienstes Accounts ist die Administratorrolle erforderlich.

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

   

   1. Klicken Sie auf die Schaltfläche Speichern. Sie kehren zur Liste der Nutzer zurück. Die Dienstkonto-ID sollte mit der/den ausgewählten Nutzerrolle(n) aufgelistet sein.

   2. Wiederholen Sie diesen Vorgang für alle anderen Dienstkonten, die Sie hinzufügen möchten.

   3. Vorhandene Dienstkontonutzer finden Sie auf dem Tab „Nutzer“. Dabei handelt es sich um Nutzer mit einer E-Mail-Adresse, die auf „gserviceaccount.com“ endet.

3. Sie können jetzt über das Dienstkonto auf Ihr Manufacturer Center-Konto zugreifen. Verwenden Sie dazu entweder den Ablauf für Standardanmeldedaten für Anwendungen oder direkt den Ablauf für Dienstkonten. In den Manufacturer Center API-Beispielen wird gezeigt, wie Sie beide Abläufe für Dienstkonto-Anmeldedaten in den jeweils unterstützten Programmiersprachen verwenden. Anhand der Codebeispiele können Sie Ihr neues Dienstkonto testen und erfahren, welche Änderungen Sie für die Verwendung von Dienstkonten in Ihrem eigenen Code benötigen.

Häufig gestellte Fragen

Kann ich mich mit meinem Dienstkonto in der Weboberfläche des Manufacturer Centers anmelden?

Nein, Dienstkonten sind keine regulären Google-Konten und können daher nicht auf die Weboberfläche des Manufacturer Centers zugreifen.

Wie oft muss ich Zugriffstokens für Dienstkonten aktualisieren?

Zugriffstokens laufen eine Stunde nach ihrer Ausstellung vom Google OAuth 2.0-Autorisierungsserver ab. Wenn ein Zugriffstoken abläuft, sollte die Anwendung die Clientbibliothek verwenden, um ein anderes Zugriffstoken abzurufen.