Questa pagina è stata tradotta dall'API Cloud Translation.

Guida rapida dell'API mediante riga di comando

Questa pagina mostra come iniziare a utilizzare l'API di dati di Google Analytics v1 utilizzando il comando dalla riga di comando.

Passaggio 1. Abilita l'API

Fai clic sul pulsante seguente per creare automaticamente un nuovo progetto Google Cloud Attiva l'API di dati di Google Analytics v1 e crea le credenziali OAuth2 necessarie a questo scopo tutorial:

Ti reindirizzeremo automaticamente alla configurazione delle credenziali OAuth2 . Quando la finestra di dialogo chiede Da dove chiami?, scegli Computer.

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

In alternativa, puoi seguire questi passaggi per creare un account OAuth2 Credenziali in un account utente progetto manualmente.

Passaggio 2: Installa e inizializza Cloud SDK

Devi avere la riga di comando gcloud installato sul tuo computer di sviluppo.

Passaggio 3: effettua una chiamata API

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

Seleziona un'entità segnalante

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

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

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Sostituisci [YOUR_GA_PROPERTY_ID] con la tua proprietà Google Analytics identificativo. Ad esempio:

export GA_PROPERTY_ID=1234567890

Crea il file JSON della richiesta

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

Crea il file di richiesta JSON con il testo seguente e salvalo come file request.json di testo normale 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 questo comando e usa Il percorso del file JSON delle credenziali scaricato al passaggio 1:

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

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

Invia la richiesta

Utilizza curl e i contenuti del corpo di request.json per inviare la richiesta al 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/$GA_PROPERTY_ID:runReport -d @request.json

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

Tieni presente che per passare un nome file al curl utilizza l'opzione -d (per "dati") e il segno @ deve precedere il nome del file. Questo file deve trovarsi nella stessa directory in cui eseguirai il comando curl.