- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- RunPivotReportRequest
- Prova!
Restituisce più report pivot in gruppo. Tutti i report devono riguardare la stessa proprietà GA4.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
property |
Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Viene specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, scopri dove trovare il tuo ID proprietà. Questa proprietà deve essere specificata per il batch. La proprietà all'interno di RunPivotReportRequest potrebbe non essere specificata o essere coerente con questa proprietà. Esempio: Properties/1234 |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"requests": [
{
object ( |
Campi | |
---|---|
requests[] |
Richieste individuali. Ogni richiesta ha una risposta a un report pivot separato. Ogni richiesta batch è consentita fino a 5 richieste. |
Corpo della risposta
La risposta batch contenente più report pivot.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"pivotReports": [
{
object ( |
Campi | |
---|---|
pivotReports[] |
Risposte individuali. Ogni risposta contiene una richiesta di report pivot separata. |
kind |
Identifica il tipo di risorsa del messaggio. Questo |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunPivotReportRequest
La richiesta di generare un report pivot.
Rappresentazione JSON |
---|
{ "property": string, "dimensions": [ { object ( |
Campi | |
---|---|
property |
Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Viene specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, scopri dove trovare il tuo ID proprietà. All'interno di una richiesta batch, questa proprietà non deve essere specificata o deve essere coerente con la proprietà a livello batch. Esempio: Properties/1234 |
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. |
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 |
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. |
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. |
currencyCode |
Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita della proprietà. |
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. Indipendentemente dall'impostazione Ad esempio, se una proprietà non registra mai un evento |
returnPropertyQuota |
Consente di attivare/disattivare la restituzione dello stato corrente della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota. |
comparisons[] |
Campo facoltativo. La configurazione dei confronti richiesti e visualizzati. La richiesta richiede sia un campo sia una dimensione di confronto per ricevere una colonna di confronto nella risposta. |