- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
L'API Realtime di Google Analytics restituisce un report personalizzato di dati sugli eventi in tempo reale per la tua proprietà. Questi report mostrano gli eventi e l'utilizzo degli ultimi 30 minuti.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runRealtimeReport
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
property |
Un identificatore della proprietà GA4 di Google Analytics i cui eventi vengono monitorati. Specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, scopri dove trovare il tuo ID proprietà. 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. |
limit |
Il numero di righe da restituire. Se il parametro |
dimensionFilter |
La clausola relativa al filtro per le dimensioni. È necessario richiedere l'utilizzo delle dimensioni in questo filtro. Le metriche non possono essere utilizzate in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato nella fase di post-aggregazione, in modo simile alla clausola SQL. Le metriche devono essere richieste per essere utilizzate in questo filtro. Le dimensioni non possono essere utilizzate in questo filtro. |
metricAggregations[] |
Aggregazione di metriche. I valori delle metriche aggregati verranno mostrati nelle righe in cui i valori dimensionValues sono impostati su "RESERVED_(MetricAggregation)". |
orderBys[] |
Specifica l'ordine delle righe nella risposta. |
returnPropertyQuota |
Consente di attivare/disattivare la restituzione dello stato corrente della quota in tempo reale di questa proprietà Analytics. La quota viene restituita in PropertyQuota. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
La tabella del report in tempo reale sulle risposte corrispondente a una richiesta.
Rappresentazione JSON | |
---|---|
{ "dimensionHeaders": [ { object ( |
Campi | |
---|---|
dimensionHeaders[] |
Descrive le colonne delle dimensioni. Il numero di DimensionHeaders e l'ordine di DimensionHeaders corrisponde alle dimensioni presenti nelle righe. |
metricHeaders[] |
Descrive le colonne delle metriche. Il numero di MetricHeaders e l'ordine di MetricHeaders corrisponde alle metriche presenti nelle righe. |
rows[] |
Righe di combinazioni di valori di dimensioni e valori delle metriche nel report. |
totals[] |
Se richiesto, i valori totali delle metriche. |
maximums[] |
Se richiesto, i valori massimi delle metriche. |
minimums[] |
Se richiesti, i valori minimi delle metriche. |
rowCount |
Il numero totale di righe nel risultato della query, indipendentemente dal numero di righe restituite nella risposta. Ad esempio, se una query restituisce 175 righe e include un limite = 50 nella richiesta API, la risposta conterrà rowCount = 175 ma solo 50 righe. |
propertyQuota |
Lo stato della quota in tempo reale di questa proprietà Analytics, inclusa questa richiesta. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics