- 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 sui dati degli eventi in tempo reale relativi alla 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 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à. 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 di filtro delle dimensioni. Per l'utilizzo in questo filtro è necessario richiedere le dimensioni. Impossibile utilizzare metriche in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato in fase di post-aggregazione, in modo simile alla clausola SQL. L'utilizzo delle metriche in questo filtro è obbligatorio. Impossibile utilizzare le dimensioni in questo filtro. |
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. |
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 QuoteHeader e l'ordine di QuoteHeaders 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 richiesto, 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 il 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