Diese Seite wurde von der Cloud Translation API übersetzt.

API-Kurzanleitung über die Befehlszeile

Auf dieser Seite erhalten Sie Informationen zu den ersten Schritten mit der Google Analytics Data API v1. Verwenden Sie dazu den Befehl Zeile.

Schritt 1: API aktivieren

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

Sie werden automatisch zur Konfiguration der OAuth2-Anmeldedaten weitergeleitet Dialogfeld. Wenn im Dialogfeld gefragt wird Von wo aus rufen Sie an?, wählen Sie Computer:

Klicken Sie im daraufhin angezeigten Dialogfeld auf CLIENT-KONFIGURATION HERUNTERLADEN und speichern Sie die Datei. credentials.json in Ihr Arbeitsverzeichnis.

Alternativ können Sie diese Schritte ausführen, um ein OAuth2- Anmeldedaten in einer vorhandenen manuell Projekt erstellen.

Schritt 2: Cloud SDK installieren und initialisieren

Sie benötigen die gcloud-Befehlszeile. das auf Ihrem Entwicklungscomputer installiert ist.

Schritt 3: API-Aufruf starten

Jetzt können Sie das Google Analytics Data API verwenden, um eine Google Analytics- Property.

Meldende Person auswählen

In dieser Anleitung speichern wir mit der Umgebungsvariable GA_PROPERTY_ID Die Property-ID, die in API-Anfragen verwendet werden soll.

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

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Ersetzen Sie [YOUR_GA_PROPERTY_ID] durch Ihre Google Analytics-Property. Kennzeichnung. Beispiel:

export GA_PROPERTY_ID=1234567890

JSON-Anfrage erstellen

In der folgenden request.json-Datei sehen Sie, wie ein einfacher Bericht erstellt wird.

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

request.json

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

Authentifizieren

Um in diesem Beispiel Nutzeranmeldedaten abzurufen, führen Sie den folgenden Befehl aus und verwenden 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 Dialogfeld zur Zustimmung des OAuth-Nutzers geöffnet.

Anfrage senden

Verwenden Sie curl und den Textinhalt aus request.json, um die Anfrage an den Google Analytics Data API. 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/$GA_PROPERTY_ID:runReport -d @request.json

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

Beachten Sie, dass Sie zur Übergabe eines Dateinamens für "curl" die Option -d (für "Daten") und setzen Sie ein @-Zeichen vor den Dateinamen. Diese Datei muss sich im selben Verzeichnis befinden in dem Sie den curl-Befehl ausführen.