Diese Seite wurde von der Cloud Translation API übersetzt.

API-Kurzanleitung über die Befehlszeile

Auf dieser Seite werden die ersten Schritte mit der Google Analytics Data API v1 über die Befehlszeile beschrieben.

Schritt 1. API aktivieren

Klicken Sie auf diese Schaltfläche, um ein neues Cloud Platform-Projekt zu erstellen. Aktivieren Sie automatisch die Google Analytics Data API v1 und erstellen Sie die für diese Anleitung erforderlichen OAuth2-Anmeldedaten:

Sie werden automatisch zum Dialogfeld für die Konfiguration von OAuth2-Anmeldedaten weitergeleitet. Wählen Sie „Desktop“, wenn Sie gefragt werden, von wo aus Sie anrufen?

Klicken Sie im daraufhin angezeigten Dialogfeld auf CLIENTKONFIGURATION HERUNTERLADEN und speichern Sie die Datei credentials.json in Ihrem Arbeitsverzeichnis.

Alternativ können Sie diese Schritte zum manuellen Erstellen von OAuth2-Anmeldedaten in einem vorhandenen Projekt ausführen.

Schritt 2. Cloud SDK installieren und initialisieren

Dazu muss das gcloud-Befehlszeilentool auf dem Entwicklungscomputer installiert sein.

Schritt 3: API-Aufruf ausführen

Jetzt können Sie mit der Google Analytics Data API eine Google Analytics 4-Property abfragen.

Meldeentität auswählen

In dieser Anleitung verwenden wir die Umgebungsvariable GA4_PROPERTY_ID, um die Attribut-ID zu speichern, die in API-Anfragen verwendet werden soll.

Geben Sie Folgendes in die Befehlszeile ein, um die Variable GA4_PROPERTY_ID festzulegen:

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

Ersetzen Sie [YOUR-GA4-PROPERTY-ID] durch Ihre Google Analytics 4-Property-ID. Beispiel:

export GA4_PROPERTY_ID=1234567890

JSON-Anfrage erstellen

Die folgende request.json-Datei zeigt, wie ein einfacher Bericht erstellt wird.

Erstellen Sie die JSON-Anfragedatei mit dem folgenden Text und speichern Sie sie als Nur-Text-Datei request.json in Ihrem Arbeitsverzeichnis:

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

Authentifizieren

Zum Abrufen der Nutzeranmeldedaten in diesem Beispiel führen Sie den folgenden Befehl aus und verwenden den Pfad zur JSON-Datei mit den Anmeldedaten, die in Schritt 1 heruntergeladen wurde:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

In einem neuen Browserfenster wird ein OAuth-Dialogfeld zur Nutzereinwilligung geöffnet.

Anfrage senden

Verwenden Sie curl und den Textinhalt aus request.json, um die Anfrage an die Google Analytics Data API zu senden. Geben Sie Folgendes in die Befehlszeile ein:

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json

Der Befehl curl verwendet den Befehl gcloud auth application-default print-access-token, um ein Authentifizierungstoken abzurufen.

Beachten Sie, dass Sie bei der Übergabe eines Dateinamens an curl die Option -d (für "Daten") verwenden und dem Dateinamen ein @-Zeichen voranstellen müssen. Diese Datei sollte sich in demselben Verzeichnis befinden, in dem Sie den curl-Befehl ausführen.

Glückwunsch! Sie haben Ihre erste Anfrage an die Google Analytics Data API gesendet.