Method: properties.batchRunPivotReports

Restituisce più report pivot in un 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

string

Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per saperne 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: proprietà/1234

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
Campi
requests[]

object (RunPivotReportRequest)

Richieste singole. Ogni richiesta ha una risposta a un report pivot separato. Ogni richiesta batch è consentita fino a 5 richieste.

Corpo della risposta

La risposta in gruppo contenente più report pivot.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ],
  "kind": string
}
Campi
pivotReports[]

object (RunPivotReportResponse)

Risposte individuali. Ogni risposta ha una richiesta di report pivot separata.
kind

string

Identifica il tipo di risorsa di questo messaggio. kind è sempre la stringa fissa "analyticsData#batchRunPivotReports". Utile per distinguere i tipi di risposta in JSON.

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 (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Campi
property

string

Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per saperne 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 di batch.

Esempio: proprietà/1234
dimensions[]

object (Dimension)

Le dimensioni richieste. Tutte le dimensioni definite devono essere utilizzate da uno dei seguenti valori: dimensionEspressione, dimensionFilter, pivots, orderBys.
metrics[]

object (Metric)

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[]

object (DateRange)

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. È possibile includere una dimensione speciale con nome di campo "dateRange" nei nomi di campo di un pivot; se inclusa, il report confronta gli intervalli di date. In una richiesta di coorte, questo dateRanges non deve essere specificato.
pivots[]

object (Pivot)

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. Due pivot non possono condividere una dimensione. Una dimensione è visibile solo se appare in un pivot.
dimensionFilter

object (FilterExpression)

La clausola di filtro sulle dimensioni. Devi richiedere l'utilizzo delle dimensioni in questo filtro. Le metriche non possono essere utilizzate in questo filtro.
metricFilter

object (FilterExpression)

La clausola di filtro delle metriche. Applicata nella fase di post-aggregazione, in modo simile alla clausola con formula SQL. È necessario richiedere l'utilizzo delle metriche in questo filtro. Le dimensioni non possono essere utilizzate in questo filtro.
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 la richiesta include un gruppo di coorti, deve essere presente la dimensione "coorte".
keepEmptyRows

boolean

Se il valore è 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 (GA4).

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" ed eventCount: 0.
returnPropertyQuota

boolean

Consente di attivare o disattivare la restituzione dello stato corrente della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota.