Restituisce un report pivot personalizzato dei dati sugli eventi di Google Analytics. I report pivot sono formati più avanzati ed espressivi rispetto ai report normali. In un report pivot, le dimensioni sono visibili solo se sono incluse in un pivot. È possibile specificare più pivot per analizzare ulteriormente i dati.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON | |
|---|---|
{ "entity": { object ( |
|
| Campi | |
|---|---|
entity |
Una proprietà di cui vengono monitorati gli eventi. All'interno di una richiesta batch, questa entità non deve essere specificata o deve essere coerente con l'entità a livello di batch. |
dimensions[] |
Le dimensioni richieste. Tutte le dimensioni definite devono essere utilizzate da uno dei seguenti elementi: dimensionExpression, dimensionFilter, pivot e orderBys. |
metrics[] |
Le metriche richieste. È necessario specificare almeno una metrica. Tutte le metriche definite devono essere utilizzate da uno dei seguenti elementi: espressione_metrica, metricaFiltro, ordineBys. |
dimensionFilter |
La clausola del filtro delle dimensioni. È necessario richiedere le dimensioni per poter essere utilizzate in questo filtro. Le metriche non possono essere utilizzate in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato nella fase di post-aggregazione, in modo simile alla clausola SQL. È necessario richiedere le metriche per poter essere utilizzate in questo filtro. Le dimensioni non possono essere utilizzate in questo filtro. |
pivots[] |
Descrive il formato visivo delle dimensioni del report in colonne o righe. L'unione dei fieldNames (nomi delle dimensioni) in tutti i pivot deve essere un sottoinsieme dei nomi delle dimensioni definiti in Dimensioni. Una dimensione non può essere condivisa da due pivot. Una dimensione è visibile solo se appare in un pivot. |
dateRanges[] |
L'intervallo di date per recuperare i dati sugli eventi per il report. Se vengono specificati più intervalli di date, nel report vengono utilizzati i dati sugli eventi di ciascun intervallo. Una dimensione speciale con il nome del campo "dateRange" può essere incluso nei nomi dei campi di un pivot, se incluso, il report confronta tra intervalli di date. In una richiesta di coorte, questo |
currencyCode |
Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita dell'entità. |
cohortSpec |
Gruppo di coorti associato a questa richiesta. Se nella richiesta è presente un gruppo di coorte, la "coorte" deve essere presente. |
keepEmptyRows |
Se il valore è false o non specificato, non verrà restituita ogni riga con tutte le metriche uguali a 0. Se impostato su true, queste righe vengono restituite se non vengono rimosse separatamente da un filtro. |
returnPropertyQuota |
Consente di scegliere se restituire lo stato attuale della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di RunPivotReportResponse.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics