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à i cui eventi vengono monitorati. 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 valori: dimensionEspressione, dimensionFilter, pivots, orderBys. |
metrics[] |
Le metriche richieste. È necessario specificare almeno una metrica. Tutte le metriche definite devono essere utilizzate da uno dei seguenti valori: metric_expression, metricFilter, orderBys. |
dimensionFilter |
La clausola di filtro delle dimensioni. Per l'utilizzo in questo filtro è necessario richiedere le dimensioni. Impossibile utilizzare metriche in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato in fase di post-aggregazione, in modo simile alla clausola SQL. L'utilizzo delle metriche in questo filtro è obbligatorio. Impossibile utilizzare le dimensioni in questo filtro. |
pivots[] |
Descrive il formato visivo delle dimensioni del report in colonne o righe. L'unione dei nomi dei campi (nomi delle dimensioni) in tutti i pivot deve essere un sottoinsieme di nomi delle dimensioni definiti in Dimensioni. Due pivot non possono condividere una dimensione. Una dimensione è visibile solo se compare in un pivot. |
dateRanges[] |
L'intervallo di date in cui recuperare i dati sugli eventi per il report. Se vengono specificati più intervalli di date, nel report vengono utilizzati i dati sugli eventi di ogni intervallo. Una dimensione speciale con nome campo "dateRange" può essere inclusa nei nomi dei campi di un pivot; se inclusa, 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 coorte associato a questa richiesta. Se la richiesta include un gruppo di coorte, deve essere presente la dimensione "coorte". |
keepEmptyRows |
Se il valore è false o non specificato, non verrà restituita ogni riga con tutte le metriche uguali a 0. Se il valore è true, queste righe vengono restituite se non vengono rimosse separatamente da un filtro. |
returnPropertyQuota |
Consente di attivare/disattivare la restituzione dello stato corrente 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.readonly
https://www.googleapis.com/auth/analytics