Method: properties.runReport

Restituisce un report personalizzato dei dati sugli eventi di Google Analytics. I report contengono statistiche ricavate dai dati raccolti dal codice di monitoraggio di Google Analytics. I dati restituiti dall'API sono sotto forma di tabella con colonne per le dimensioni e le metriche richieste. Le metriche sono misurazioni individuali dell'attività utente nella tua proprietà, ad esempio utenti attivi o conteggio eventi. Le dimensioni suddividono le metriche in base ad alcuni criteri comuni, come il paese o il nome dell'evento.

Per una guida alla creazione delle richieste e alla comprensione delle risposte, consulta Creare un report.

Richiesta HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runReport

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
property

string

Un identificatore della proprietà Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, consulta dove trovare l'ID proprietà. All'interno di una richiesta batch, questa proprietà deve essere non specificata o coerente con la proprietà a livello di batch.

Esempio: properties/1234

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Campi
dimensions[]

object (Dimension)

Le dimensioni richieste e visualizzate.

metrics[]

object (Metric)

Le metriche richieste e visualizzate.

dateRanges[]

object (DateRange)

Intervalli di date dei dati da leggere. Se vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice di intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i dati sugli eventi relativi ai giorni in cui si sovrappongono sono inclusi nelle righe di risposta per entrambi gli intervalli di date. In una richiesta di coorte, questo dateRanges deve essere non specificato.

dimensionFilter

object (FilterExpression)

I filtri delle dimensioni ti consentono di richiedere solo valori specifici delle dimensioni nel report. Per scoprire di più, consulta la sezione Nozioni di base sui filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro.

metricFilter

object (FilterExpression)

La clausola di filtro delle metriche. Applicato dopo l'aggregazione delle righe del report, in modo simile alla clausola having di SQL. Le dimensioni non possono essere utilizzate in questo filtro.

offset

string (int64 format)

Il conteggio delle righe della riga iniziale. La prima riga viene conteggiata come riga 0.

Quando viene utilizzata la paginazione, la prima richiesta non specifica l'offset; in alternativa, imposta l'offset su 0; la prima richiesta restituisce le prime limit righe. La seconda richiesta imposta l'offset sul limit della prima richiesta; la seconda richiesta restituisce il secondo limit di righe.

Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione.

limit

string (int64 format)

Il numero di righe da restituire. Se non specificato, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne richiedi. limit deve essere positivo.

L'API può anche restituire meno righe rispetto al limit richiesto, se non sono presenti gli stessi valori delle dimensioni del limit. Ad esempio, esistono meno di 300 valori possibili per la dimensione country, pertanto, quando generi report solo su country, non puoi ottenere più di 300 righe, anche se imposti country su un valore più alto.limit

Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione.

metricAggregations[]

enum (MetricAggregation)

Aggregazione delle metriche. I valori delle metriche aggregate verranno visualizzati nelle righe in cui i valori delle dimensioni sono impostati su "RISERVATO_(MetricAggregation)". Gli aggregati che includono sia i confronti sia più intervalli di date verranno aggregati in base agli intervalli di date.

orderBys[]

object (OrderBy)

Specifica l'ordinamento delle righe nella risposta. Alle richieste che includono sia i confronti sia più intervalli di date verranno applicati ordini per i confronti.

currencyCode

string

Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita della proprietà.

cohortSpec

object (CohortSpec)

Gruppo di coorte associato a questa richiesta. Se nella richiesta è presente un gruppo di coorti, deve essere presente la dimensione "cohort".

keepEmptyRows

boolean

Se è false o non specificato, ogni riga con tutte le metriche uguali a 0 non verrà restituita. Se true, queste righe verranno restituite se non vengono rimosse separatamente da un filtro.

Indipendentemente da questa impostazione keepEmptyRows, in un report possono essere visualizzati solo i dati registrati dalla proprietà Google Analytics.

Ad esempio, se una proprietà non registra mai un evento purchase, una query per la dimensione eventName e la metrica eventCount non avrà una riga eventName: "purchase" e eventCount: 0.

returnPropertyQuota

boolean

Attiva/disattiva la restituzione dello stato corrente della quota di questa proprietà Google Analytics. La quota viene restituita in PropertyQuota.

comparisons[]

object (Comparison)

Facoltativo. La configurazione dei confronti richiesti e visualizzati. La richiesta richiede solo un campo di confronti per ricevere una colonna di confronto nella risposta.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RunReportResponse.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics