- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Fai una prova!
Restituisce un report personalizzato contenente i 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 in formato tabellare, con colonne per le dimensioni e le metriche richieste. Le metriche sono misurazioni individuali dell'attività utente nella tua proprietà, ad esempio utenti attivi o conteggio eventi. Le dimensioni suddividono le metriche in base a criteri comuni, come paese o nome evento.
Per una guida alla creazione di richieste e alla comprensione delle risposte, consulta Creare 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à Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per saperne di più, consulta Dove trovare l'ID proprietà. In una richiesta batch, questa proprietà deve essere non specificata o coerente con la proprietà a livello di batch. Esempio: properties/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 vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice dell'intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i dati sugli eventi per i giorni sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli di date. In una richiesta di coorte, questo |
dimensionFilter |
I filtri di dimensione consentono di richiedere solo valori di dimensione specifici nel report. Per saperne di più, consulta Nozioni di base sui filtri di dimensione per esempi. Le metriche non possono essere utilizzate in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicata dopo l'aggregazione delle righe del report, in modo simile alla clausola SQL having. 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. Quando si esegue la paginazione, la prima richiesta non specifica l'offset o, in modo equivalente, imposta l'offset su 0; la prima richiesta restituisce il primo Per saperne di più su questo parametro di paginazione, consulta Paginazione. |
limit |
Il numero di righe da restituire. Se non specificato, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente dal numero di righe richieste. L'API può anche restituire meno righe del Per saperne di più su questo parametro di paginazione, consulta Paginazione. |
metricAggregations[] |
Aggregazione delle metriche. I valori delle metriche aggregate verranno mostrati nelle righe in cui i valori di dimensione sono impostati su "RESERVED_(MetricAggregation)". Gli aggregati che includono sia i confronti sia più intervalli di date verranno aggregati in base agli intervalli di date. |
orderBys[] |
Specifica l'ordine delle righe nella risposta. Le richieste che includono sia i confronti sia più intervalli di date avranno gli ordini applicati ai confronti. |
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 coorti, deve essere presente la dimensione "coorte". |
keepEmptyRows |
Se è false o non specificato, non verrà restituita ogni riga con tutte le metriche uguali a 0. Se è true, queste righe verranno restituite se non vengono rimosse separatamente da un filtro. Indipendentemente da questa impostazione Ad esempio, se una proprietà non registra mai un evento |
returnPropertyQuota |
Attiva/disattiva la restituzione dello stato attuale della quota di questa proprietà Google Analytics. La quota viene restituita in PropertyQuota. |
comparisons[] |
Facoltativo. La configurazione dei confronti richiesti e visualizzati. La richiesta richiede solo un campo di confronti 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.readonlyhttps://www.googleapis.com/auth/analytics