Integrationsleitfaden

Privaten Schlüssel abrufen

Einrichtungsoberfläche verwenden

Für die Einbindung in die API müssen Sie ein Google Cloud-Projekt erstellen. Erstellen Sie anschließend ein Dienstkonto und rufen Sie einen privaten Schlüssel ab. Klicken Sie zuerst auf die folgende Schaltfläche:

Dienstkonto erstellen

Schlüssel manuell generieren

Wenn die obige Benutzeroberfläche nicht funktioniert, versuchen Sie Folgendes:

  1. Rufen Sie die Google Cloud Console auf.
  2. Wählen Sie das Projekt aus, über das auf die API zugegriffen wird.
  3. Suchen Sie links im IAM-Menü „Admin“ die Dienstkonten und erstellen Sie ein neues Dienstkonto, das Inhaber des Projekts ist.
  4. Nachdem das Dienstkonto erstellt wurde, sollten Sie einen privaten Schlüssel erhalten.

Dienstkonto auf die Zulassungsliste setzen

Nachdem Sie ein Dienstkonto erstellt haben:

  1. Wenden Sie sich unter mdp-support@google.com mit einem Google-Konto an den GTAF-Team. Wir setzen das Google-Konto für den Zugriff auf die Mobile Data Plan Sharing API-Endpunkte auf die Zulassungsliste.
  2. Verknüpfen Sie das Dienstkonto mit dem Mobilfunkanbieter im Google ISP-Portal. Der Anbieter kann diese Verknüpfung über API-Zugriff herstellen.

Mediathek aktivieren

Nach dem Erstellen der Zulassungsliste:

  1. Öffnen Sie Google Cloud Console.
  2. Achten Sie darauf, dass Sie im Drop-down-Menü oben in der Menüleiste das richtige Projekt ausgewählt haben.
  3. Aktivieren Sie in der API-Bibliothek die Mobile Data Plan Sharing API.
  4. Aktivieren Sie in der API-Bibliothek die Option Preprod Mobile Data Plan Sharing API.

API-Zugriff testen

So testen Sie Ihren Zugriff auf Methoden von Google:

  1. Installieren Sie oauth2l:

  2. Rufen Sie so ein Zugriffstoken für Ihr Dienstkonto ab. your-service-account-key-file.json ist eine Schlüsseldatei Ihres Dienstkontos.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Das Zugriffstoken läuft in etwa einer Stunde ab. Bevor Sie den obigen Befehl für ein neues Zugriffstoken noch einmal ausführen, führen Sie oauth2l reset aus, um den lokalen Cache zu leeren.

  3. Führen Sie die folgenden Testaufrufe aus. YOUR-ASN muss eine der ASNs sein, die Sie uns bei der Konfiguration von GTAF während des Integrationsprozesses senden. ACCESS-TOKEN-OBTAINED ist die Ausgabe des obigen oauth2l fetch-Befehls. PLAN_STATUS ist der Anfragetext PlanStatus, den Sie an GTAF senden möchten.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Programmatische API-Aufrufe

Folgen Sie der Anleitung, um autorisierte Aufrufe der Google-Methoden mit dem folgenden OAuth-Bereich auszuführen:

https://www.googleapis.com/auth/dataplansharing

Projektinhaberschaft teilen

Die Ersteinrichtung umfasst ein einzelnes Google-Konto. Es empfiehlt sich jedoch, einer Gruppe von autorisierten Nutzern die Eigentümerschaft an dem Projekt zu übertragen. In der Google Cloud Console können Sie unter „IAM &Verwaltung“ im Administratormenü neue Mitglieder (einschließlich Google Groups-Konten) als Inhaber des Projekts hinzufügen.