- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Restituisce un report personalizzato dei dati sugli eventi di Google Analytics. I report contengono statistiche derivate dai dati raccolti dal codice di monitoraggio di Google Analytics. I dati restituiti dall'API sono rappresentati da una tabella con colonne per le dimensioni e le metriche richieste. Le metriche sono misurazioni individuali dell'attività utente sulla tua proprietà, come gli utenti attivi o il numero di eventi. Le dimensioni suddividono le metriche in base ad alcuni criteri comuni, come il paese o il nome dell'evento.
Per una guida alla creazione delle richieste consulta le risposte, consulta la sezione Creazione di un report.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runReport
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. 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 di batch. Esempio: proprietà/1234 |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "dimensions": [ { object ( |
Campi | |
---|---|
dimensions[] |
Le dimensioni richieste e visualizzate. |
metrics[] |
Le metriche richieste e visualizzate. |
dateRanges[] |
Intervalli di date dei dati da leggere. Se sono richiesti più intervalli di date, ogni riga di risposta conterrà un indice di intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i dati sugli eventi per i giorni che si sovrappongono vengono inclusi nelle righe di risposta per entrambi gli intervalli di date. In una richiesta di coorte, questo |
dimensionFilter |
I filtri delle dimensioni ti consentono di richiedere solo valori di dimensione specifici nel report. Per ulteriori informazioni, consulta la sezione Concetti fondamentali dei filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato dopo aver aggregato le righe del report, in modo simile alla clausola SQL. Le dimensioni non possono essere utilizzate 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 Pagination. |
limit |
Il numero di righe da restituire. Se non vengono specificate, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante sono le richieste. L'API può anche restituire meno righe rispetto al valore Per scoprire di più su questo parametro di impaginazione, consulta Pagination. |
metricAggregations[] |
Aggregazione delle metriche. I valori aggregati delle metriche verranno mostrati nelle righe in cui i valori di dimensionValue sono impostati su "RESERVED_(MetricAggregation)". |
orderBys[] |
Specifica l'ordine delle 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 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. Indipendentemente da questa impostazione di Ad esempio, se una proprietà non registra mai un evento |
returnPropertyQuota |
Consente di scegliere se restituire lo stato attuale della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota. |
comparisons[] |
(Facoltativo) La configurazione dei confronti richiesti e visualizzati. La richiesta richiede solo un campo di confronto per ricevere una colonna di confronto nella risposta. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di RunReportResponse
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics