Technische Konfiguration

Hinweise

Folgendes ist erforderlich:

• Super Admin-Zugriff auf Ihre Reseller-Domain. Weitere Informationen finden Sie unter Auf die Cloud Channel API zugreifen.

• Zugriff auf die Google Cloud Console und die Partner Sales Console.

Schritt 1: Partner Sales Console vorbereiten

Bevor Sie die API verwenden können, müssen Sie die Nutzungsbedingungen der Channel Services-Plattform akzeptieren.

Melden Sie sich mindestens einmal als Administrator der Reseller-Domain in der Partner Sales Console an. Bei der ersten Anmeldung müssen Sie ggf. die Reseller-Nutzungsbedingungen akzeptieren. Wenn Sie bestimmte Nutzungsbedingungen offline akzeptiert haben, gilt dieser Schritt nicht für Sie.

Sie können zusätzliche Nutzungsbedingungen in der Partner Sales Console auf der Seite „Nutzungsbedingungen“ akzeptieren.

Hinweis :Für die API-Integration benötigen Sie Ihre Konto-ID, die Sie auf der Seite „Einstellungen“ der Partner Sales Console finden.

Schritt 2: Google Cloud-Projekt konfigurieren

Wenn Sie eine Google API verwenden möchten, benötigen Sie ein Google Cloud-Projekt.

Google Cloud-Projekt erstellen

Rufen Sie in der Google Cloud Console den Bereich Projekte auf und klicken Sie auf Projekt erstellen, um ein Projekt zu erstellen.

Eine ausführlichere Anleitung zum Erstellen eines Projekts und eine Liste von Best Practices finden Sie im Leitfaden Projekte erstellen und verwalten.

Die meisten Reseller erstellen Google Cloud-Projekte in ihrer Google Cloud-Hauptorganisation und nicht in der Reseller-Domain. Der Zugriff auf Daten von der Reseller-Domain wird gewährt, indem die domainweite Delegierung so eingerichtet wird, dass ein Dienstkonto auf Daten aus der Reseller-Domain zugreifen kann.

Geben Sie dem Projekt einen aussagekräftigen Namen. Die Projekt-ID ist eine beliebige Kennung, die keinen Einfluss auf den Aufruf der Cloud Channel API hat.

API aktivieren

Rufen Sie in der Google Cloud Console den Bereich API-Bibliothek auf und aktivieren Sie die Cloud Channel API.

Dienstkonto erstellen

Rufen Sie zum Erstellen des Dienstkontos die Seite Dienstkonten auf.

Zur Seite „Dienstkonten“

Hinweis: Dienstkontoschlüssel stellen ein Sicherheitsrisiko dar, wenn sie nicht ordnungsgemäß verwaltet werden. Sie sollten nach Möglichkeit eine sicherere Alternative zu Dienstkontoschlüsseln auswählen. Wenn Sie sich mit einem Dienstkontoschlüssel authentifizieren müssen, sind Sie für die Sicherheit des privaten Schlüssels und für andere Vorgänge verantwortlich, die unter Best Practices für die Verwaltung von Dienstkontoschlüsseln beschrieben werden. Wenn Sie keinen Dienstkontoschlüssel erstellen können, ist das Erstellen von Dienstkontoschlüsseln für Ihre Organisation möglicherweise deaktiviert. Weitere Informationen finden Sie unter Standardmäßig sichere Organisationsressourcen verwalten.

1. Klicken Sie auf Dienstkonto erstellen.
2. Geben Sie den Namen des Dienstkontos und optional die Beschreibung des Dienstkontos ein und klicken Sie dann auf Erstellen.
3. Klicken Sie auf Weiter, um die Option Dienstkonto Zugriff auf Projekt gewähren zu überspringen.
4. Überspringen Sie den Abschnitt Nutzern Zugriff auf dieses Dienstkonto gewähren und klicken Sie auf Fertig, um die Kontoerstellung abzuschließen.

Nachdem Sie Ihr Konto erstellt haben, erstellen Sie einen Dienstkontoschlüssel:

1. Klicken Sie in der Google Cloud Console auf die E-Mail-Adresse für das von Ihnen erstellte Dienstkonto.
2. Klicken Sie auf Schlüssel.
3. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.

4. Klicken Sie auf Erstellen. Daraufhin wird eine JSON-Schlüsseldatei auf Ihren Computer heruntergeladen.

   Bewahren Sie die Schlüsseldatei sicher auf, da sie zur Authentifizierung als Ihr Dienstkonto verwendet werden kann. Sie können diese Datei beliebig verschieben und umbenennen.

5. Klicken Sie auf Schließen.

Auf der Seite „Dienstkonten“ können Sie private Schlüsseldateien löschen und erstellen.

Schritt 3: Dienstkonto für die Reseller-Domain autorisieren

Für diesen Abschnitt benötigen Sie die Client-ID Ihres Dienstkontos. Wählen Sie im Menü Aktionen die Option Details verwalten aus und kopieren Sie Ihre eindeutige ID.

Rufen Sie die Seite für die domainweite Delegierung über das Super Admin-Konto Ihrer Reseller-Domain auf.

• Klicken Sie auf Neu hinzufügen und geben Sie die ID Ihres Dienstkontos in das Feld Client-ID ein.
• Geben Sie https://www.googleapis.com/auth/apps.order in das Feld OAuth-Bereiche ein.
• Klicken Sie auf Autorisieren, damit Ihr Dienstkonto die Cloud Channel API im Kontext Ihres Channel Services-Kontos verwenden kann.

Hinweis: Wenn Sie bei der endgültigen Integration weitere APIs verwenden, haben Sie möglicherweise mehrere Bereiche für den Client Ihres Dienstkontos.

Klicken Sie dann auf Autorisieren, damit Ihr Dienstkonto die Cloud Channel API im Kontext Ihres Channel Services-Kontos verwenden kann.

Hinweis: Möglicherweise müssen Sie weitere APIs aktivieren und in anderen Codelabs weitere Bereiche hinzufügen. Die endgültige Integration kann mehr als einen Bereich für den Client Ihres Dienstkontos haben.

Weitere Informationen

Nach der ersten technischen Integration können Sie die API in der Dokumentation zur Cloud Channel API entdecken.

Hinweis: Wenn Sie auch eine Test Partner Sales Console haben, führen Sie die Schritte 1 bis 4 für Ihre Reseller-Testdomain aus. Erstellen Sie unbedingt ein separates Projekt, da Google APIs projektbezogene Kontingente haben. Die umgebungsübergreifende Freigabe eines Projekts kann dazu führen, dass sich Ihre Testkonten auf die Kontingente Ihres Produktionskontos auswirken.