- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- MinuteRange
- Prova!
Restituisce un report personalizzato sui dati degli eventi in tempo reale per la tua proprietà. Gli eventi vengono visualizzati nei report in tempo reale pochi secondi dopo essere stati inviati a Google Analytics. I report In tempo reale mostrano gli eventi e i dati sull'utilizzo relativi a periodi di tempo che vanno dal momento attuale a 30 minuti prima (fino a 60 minuti per le proprietà Google Analytics 360).
Per una guida alla creazione di richieste in tempo reale e all'interpretazione delle risposte, consulta la sezione Creare un report In tempo reale.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/{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. |
dimensionFilter |
La clausola di filtro delle 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. Impossibile utilizzare le dimensioni in questo filtro. |
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 |
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. |
minuteRanges[] |
Gli intervalli minuti di dati sugli eventi da leggere. Se non specificato, verrà utilizzato un intervallo di minuti degli ultimi 30 minuti. Se vengono richiesti più intervalli di minuti, ogni riga di risposta conterrà un indice di intervallo di minuti in base zero. Se gli intervalli di due minuti si sovrappongono, i dati sugli eventi per i minuti sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli di minuti. |
Corpo della risposta
La tabella del report in tempo reale sulle risposte corrispondente a una richiesta.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
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. |
propertyQuota |
Lo stato della quota in tempo reale di questa proprietà Analytics, inclusa questa richiesta. |
kind |
Identifica il tipo di risorsa di questo messaggio. Questo |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinuteRange
Una serie di minuti contigui: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. Le richieste sono consentite per intervalli di massimo 2 minuti.
Rappresentazione JSON |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Campi | |
---|---|
name |
Assegna un nome a questo intervallo di minuti. Questo nome viene attribuito alla dimensione |
startMinutesAgo |
Il minuto di inizio inclusivo per la query espresso come numero di minuti prima di adesso. Ad esempio, Se non specificato, il valore predefinito per |
endMinutesAgo |
Il minuto finale inclusivo per la query come numero di minuti prima di adesso. Non può essere precedente al giorno Se non specificato, il valore predefinito di |