Questa pagina è stata tradotta dall'API Cloud Translation.

Guida rapida dell'API mediante riga di comando

Questa pagina mostra come iniziare a utilizzare la versione 1 dell'API di dati di Google Analytics dalla riga di comando.

Passaggio 1. Abilita l'API

Fai clic su questo pulsante per creare un nuovo progetto nella piattaforma Cloud, attivare automaticamente l'API di dati di Google Analytics v1 e creare le credenziali OAuth2 necessarie per questo tutorial:

Verrà visualizzata automaticamente la finestra di dialogo di configurazione delle credenziali OAuth2. Scegli "Computer" quando ti viene chiesto "Da dove chiami?"

Nella finestra di dialogo visualizzata, fai clic su SCARICA CONFIGURAZIONE CLIENT e salva il file credentials.json nella tua directory di lavoro.

In alternativa, puoi seguire manualmente questi passaggi per creare manualmente le credenziali OAuth2 in un progetto esistente.

Passaggio 2. Installa e inizializza Cloud SDK

Devi installare lo strumento a riga di comando gcloud sulla tua macchina di sviluppo.

Passaggio 3: effettua una chiamata API

Ora puoi utilizzare l'API di dati di Google Analytics per eseguire query su una proprietà Google Analytics 4.

Seleziona un'entità segnalante

In questo tutorial utilizzeremo la variabile di ambiente GA4_PROPERTY_ID per archiviare l'ID proprietà da utilizzare nelle richieste API.

Inserisci quanto segue nella riga di comando per impostare la variabile GA4_PROPERTY_ID:

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

Sostituisci [YOUR-GA4-PROPERTY-ID] con l'identificatore della proprietà Google Analytics 4. Ad esempio:

export GA4_PROPERTY_ID=1234567890

crea il codice JSON della richiesta

Il seguente file request.json mostra come creare un semplice report.

Crea il file di richiesta JSON con il testo seguente e salvalo come file di testo normale request.json nella tua directory di lavoro:

request.json

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

Autentica

Per ottenere le credenziali utente in questo esempio, esegui il comando seguente e utilizza il percorso del file JSON delle credenziali scaricato nel passaggio 1:

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

Si aprirà una finestra di dialogo per il consenso degli utenti OAuth in una nuova finestra del browser.

Invia la richiesta

Utilizza curl e il contenuto del corpo di request.json per inviare la richiesta all'API di dati di Google Analytics. Inserisci quanto segue nella riga di comando:

  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

Il comando curl utilizza il comando gcloud auth application-default print-access-token per ottenere un token di autenticazione.

Tieni presente che per passare un nome file a curl, devi usare l'opzione -d (per i "dati") e far precedere il nome del file dal simbolo @. Questo file deve trovarsi nella stessa directory in cui esegui il comando curl.

Complimenti! Hai inviato la tua prima richiesta all'API di dati di Google Analytics.