Einstieg

Auf dieser Seite wird beschrieben, wie Sie Ihre Entwicklungsumgebung für die Verwendung der Service Usage API einrichten. Für die meisten praktischen Anwendungsfälle ist es am einfachsten, Dienste über die Google Cloud Platform Console zu aktivieren und zu deaktivieren. Wenn Sie Skripts erstellen müssen, können Sie die Befehlszeilenschnittstelle gcloud verwenden. Wenn Sie Programme unter Verwendung der Service Usage API schreiben müssen, empfehlen wir Ihnen, eine der von uns bereitgestellten Clientbibliotheken zu verwenden. Um die API auszuprobieren, ohne gleich eine komplette Entwicklungsumgebung für Anwendungen einzurichten, können Sie die alternative Einrichtungsanleitung in diesem Dokument und den Befehl curl verwenden. Einige der in dieser Anleitung verlinkten Ressourcen stehen ggf. nur auf Englisch zur Verfügung.

Direkten API-Aufruf einrichten

In diesem Abschnitt werden die grundlegenden Schritte zum Einrichten Ihrer lokalen Umgebung und zum Testen der Service Usage API mit dem Befehl curl beschrieben. Der Abschnitt ist für Entwickler bestimmt, die unter Verwendung der Service Usage API programmieren möchten.

Service Usage API aktivieren

Bevor Sie die Service Usage API für ein GCP-Projekt verwenden können, müssen Sie sie zuerst in diesem Projekt aktivieren:

  1. Öffnen Sie in der Google Cloud Platform Console die Seite API-Bibliothek.
    Weiter zur Seite "API-Bibliothek"
  2. Klicken Sie auf Auswählen, um das GCP-Projekt auszuwählen, das Sie für den Zugriff auf den Dienst verwenden möchten.
  3. Klicken Sie auf der Seite "API-Bibliothek" auf Aktivieren.

Dienstkonto erstellen

Erstellen Sie ein Dienstkonto und einen Schlüssel, um die curl-Befehle in diesem Abschnitt auszuführen:

  1. Öffnen Sie in der GCP Console die Seite Dienstkonten.
    Zur Seite "Dienstkonten"
  2. Klicken Sie auf Auswählen, um das GCP-Projekt auszuwählen, das Sie für den Zugriff auf den Dienst verwenden möchten.
  3. Erstellen Sie ein Dienstkonto. Informationen zum Erstellen von Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten. Um die Schritte dieser Anleitung umzusetzen, müssen Sie dem Dienstkonto die Rolle roles/serviceusage.serviceUsageAdmin zuweisen. Weitere Informationen zum Zuweisen von Rollen für Dienstkonten finden Sie unter Dienstkonten Rollen zuweisen.
  4. Öffnen Sie in der GCP Console die Seite Anmeldedaten.
    Weiter zur Seite "Anmeldedaten"
  5. Erstellen Sie einen Dienstkontoschlüssel für Ihr neues Dienstkonto und laden Sie die JSON-Datei mit den Anmeldedaten auf Ihren lokalen Computer herunter. In den Beispielen in diesem Leitfaden wird der Dateipfad ~/credentials.json verwendet. Informationen zum Erstellen von Dienstkontoschlüsseln finden Sie unter Dienstkontoschlüssel erstellen und verwalten.
  6. Installieren Sie oauth2l auf Ihrem lokalen Gerät, um mit dem Google OAuth-System zu interagieren.

Mit curl testen

  1. Überprüfen Sie Ihre Ersteinrichtung:

    oauth2l header --json ~/credentials.json cloud-platform
    
  2. Nach Beendigung des OAuth-Ablaufs müssten Sie eine Ausgabe ähnlich der folgenden sehen:

    Authorization: Bearer y29.xxxxxxx
    
  3. Definieren Sie ein geeignetes Shell-Alias zum Aufrufen der Google REST APIs:

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
    
  4. Versuchen Sie, verfügbare und aktivierte APIs und Dienste in einem Projekt aufzulisten:

    gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services
    

    Wenn eine Liste der Dienste angezeigt wird, war die Einrichtung erfolgreich.

Weitere Informationen

Führen Sie für Ihr GCP-Projekt je nach Bedarf die Schritte unter Dienste aktivieren und deaktivieren aus.