Technische Einrichtung

Hinweise

Für den Start ist Folgendes 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 du die API verwenden kannst, musst du die Nutzungsbedingungen der Channel Services-Plattform akzeptieren.

Melden Sie sich mindestens einmal als Administrator der Resellerdomain in der Partner Sales Console an. Wenn Sie sich zum ersten Mal anmelden, müssen Sie gegebenenfalls die Nutzungsbedingungen des Resellers akzeptieren. Wenn Sie bestimmte Nutzungsbedingungen offline akzeptiert haben, gilt dieser Schritt nicht für Sie.

Sie können zusätzliche Nutzungsbedingungen auf der Seite mit den Nutzungsbedingungen in der Partner Sales Console 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

Wenn Sie ein Projekt erstellen möchten, rufen Sie in der Google Cloud Console den Bereich Projects (Projekte) auf und klicken Sie auf Create Project (Projekt erstellen).

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

Die meisten Reseller erstellen Google Cloud-Projekte in ihrer Haupt-Google Cloud-Organisation und nicht in der Reseller-Domain. Der Zugriff auf Daten aus der Resellerdomain wird durch die Einrichtung der domainweiten Delegation gewährt, damit ein Dienstkonto auf Daten aus der Resellerdomain zugreifen kann.

Geben Sie dem Projekt einen aussagekräftigen Namen. Die Projekt-ID ist eine beliebige Kennung, die keine Auswirkungen auf die Aufrufbarkeit 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 die Seite Dienstkonten auf, um ein Dienstkonto zu erstellen.

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 eine Beschreibung des Dienstkontos) ein und klicken Sie auf Erstellen.
3. Klicken Sie auf Weiter, um die Option Dienstkonto Zugriff auf das Projekt gewähren zu überspringen.
4. Überspringen Sie den Abschnitt Nutzern Zugriff auf dieses Dienstkonto erteilen 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 des von Ihnen erstellten Dienstkontos.
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 Dateien mit privaten Schlüsseln 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 Domainweite Delegierung mit dem 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 im Feld OAuth-Bereiche https://www.googleapis.com/auth/apps.order ein.
• Klicke auf Autorisieren, damit dein Dienstkonto die Cloud Channel API im Kontext deines Channel Services-Kontos verwenden kann.

Hinweis: Wenn Sie in Ihrer endgültigen Integration zusätzliche APIs verwenden, kann es sein, dass Sie mehr als einen Gültigkeitsbereich für den Client Ihres Dienstkontos haben.

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

Hinweis: In anderen Codelabs müssen Sie möglicherweise weitere APIs aktivieren und weitere Bereiche hinzufügen. Ihre endgültige Integration kann mehrere Bereiche für den Client Ihres Dienstkontos haben.

Nächste Schritte

Nachdem du die erste technische Integration vorgenommen hast, kannst du dich mit der API vertraut machen. Lies dazu die Dokumentation zur Cloud Channel API.

Hinweis :Wenn Sie auch eine Test-Partner Sales Console haben, folgen Sie den Schritten 1 bis 4 mit Ihrer Test-Reseller-Domain. Erstellen Sie ein separates Projekt, da Google APIs pro Projekt Kontingente haben. Wenn Sie ein Projekt für mehrere Umgebungen freigeben, kann es sein, dass Ihre Testkonten sich auf die Kontingente Ihres Produktionskontos auswirken.