- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- RunReportRequest
- Prova!
Restituisce più report in gruppo. Tutti i report devono riguardare la stessa proprietà GA4.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
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 RunReportRequest potrebbe non essere specificata o 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 al report distinta. Ogni richiesta batch è consentita fino a 5 richieste. |
Corpo della risposta
La risposta batch contenente più report.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"reports": [
{
object ( |
Campi | |
---|---|
reports[] |
Risposte individuali. Ogni risposta contiene una richiesta di report 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
RunReportRequest
La richiesta per generare un report.
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 e visualizzate. |
metrics[] |
Le metriche richieste e visualizzate. |
dateRanges[] |
Intervalli di date di dati da leggere. Se vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice dell'intervallo di date basato su zero. Se si sovrappongono due intervalli di date, i dati sugli eventi per i giorni sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli. In una richiesta di coorte, questo |
dimensionFilter |
I filtri delle dimensioni ti consentono di richiedere solo valori di dimensione specifici nel report. Per scoprire di più, consulta la sezione Nozioni di base sui filtri delle dimensioni per alcuni esempi. Impossibile utilizzare metriche in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato dopo aver aggregato le righe del report, in modo simile alla clausola con SQL. Impossibile utilizzare le dimensioni in questo filtro. |
offset |
Il conteggio delle righe della riga iniziale. La prima riga viene conteggiata come riga 0. Durante il paging, la prima richiesta non specifica l'offset o, equivalente, imposta l'offset su 0. La prima richiesta restituisce il primo Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione. |
limit |
Il numero di righe da restituire. Se non specificati, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne chiedi. L'API può anche restituire meno righe rispetto al valore Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione. |
metricAggregations[] |
Aggregazione delle metriche. I valori aggregati delle metriche verranno mostrati nelle righe in cui i valori delle dimensioni sono impostati su "RESERVED_(MetricAggregation)". |
orderBys[] |
Specifica in che modo vengono ordinate le righe nella risposta. |
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 solo un campo di confronto per ricevere una colonna di confronto nella risposta. |