Gibt einen benutzerdefinierten Bericht mit Echtzeitereignisdaten für Ihre Property zurück. Ereignisse werden innerhalb von Sekunden nach dem Senden an Google Analytics in Echtzeitberichten angezeigt. Echtzeitberichte enthalten Ereignisse und Nutzungsdaten für einen Zeitraum, der vom aktuellen Zeitpunkt bis zu 30 Minuten zurückliegt (bis zu 60 Minuten bei Google Analytics 360-Properties).
Eine Anleitung zum Erstellen von Echtzeitanfragen und zum Verständnis von Antworten finden Sie unter Echtzeitberichte erstellen.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
property |
Eine Google Analytics GA4-Property-ID, deren Ereignisse erfasst werden. Wird im URL-Pfad und nicht im Text angegeben. Weitere Informationen dazu, wo Sie die Property-ID finden Beispiel: properties/1234 |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "dimensions": [ { object ( |
Felder | |
---|---|
dimensions[] |
Die angeforderten und angezeigten Dimensionen. |
metrics[] |
Die angeforderten und angezeigten Messwerte. |
dimensionFilter |
Die Filterklausel der Dimensionen. Messwerte können in diesem Filter nicht verwendet werden. |
metricFilter |
Die Filterklausel von Messwerten. Wird in der Post-Aggregationsphase angewendet, ähnlich wie bei SQL-Klauseln. Dimensionen können in diesem Filter nicht verwendet werden. |
limit |
Die Anzahl der zurückzugebenden Zeilen. Wenn kein Wert angegeben ist, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. Die API kann auch weniger Zeilen als die angeforderte Anzahl von |
metricAggregations[] |
Zusammenfassung von Messwerten. Zusammengefasste Messwerte werden in Zeilen angezeigt, in denen „dimensionValues“ auf „RESERVED_(MetricAggregation)“ festgelegt ist. |
orderBys[] |
Gibt an, wie Zeilen in der Antwort sortiert werden. |
returnPropertyQuota |
Gibt an, ob der aktuelle Status des Echtzeitkontingents dieser Analytics-Property zurückgegeben werden soll. Das Kontingent wird in PropertyQuota zurückgegeben. |
minuteRanges[] |
Die Minutenbereiche der zu lesenden Ereignisdaten. Wenn kein Wert angegeben ist, wird ein Minutenbereich der letzten 30 Minuten verwendet. Wenn mehrere Minutenbereiche angefordert werden, enthält jede Antwortzeile einen nullbasierten Minutenbereichsindex. Wenn sich zwei Minutenbereiche überschneiden, werden die Ereignisdaten für die sich überschneidenden Minuten in den Antwortzeilen für beide Minutenbereiche enthalten. |
Antworttext
Die Tabelle im Echtzeitbericht der Antwort, die einer Anfrage entspricht
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "dimensionHeaders": [ { object ( |
Felder | |
---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Die Anzahl der DimensionHeaders und die Reihenfolge der DimensionHeaders stimmen mit den Dimensionen in den Zeilen überein. |
metricHeaders[] |
Beschreibt Messwertspalten. Die Anzahl der MetricHeader und die Reihenfolge der MetricHeaders entsprechen den Messwerten in den Zeilen. |
rows[] |
Zeilen mit Kombinationen aus Dimensionswerten und Messwerten im Bericht. |
totals[] |
Auf Anfrage die Gesamtwerte der Messwerte. |
maximums[] |
Auf Anfrage die Maximalwerte von Messwerten. |
minimums[] |
Auf Anfrage die Mindestwerte von Messwerten. |
rowCount |
Die Gesamtzahl der Zeilen im Abfrageergebnis. |
propertyQuota |
Status des Echtzeitkontingents dieser Analytics-Property, einschließlich dieser Anfrage. |
kind |
Gibt an, um welche Art von Ressource diese Nachricht geht. Diese |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinutenBereich
Ein aufeinanderfolgender Satz von Minuten: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. Anfragen sind für Zeiträume von bis zu 2 Minuten zulässig.
JSON-Darstellung |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Felder | |
---|---|
name |
Weist diesem Minutenbereich einen Namen zu. Die Dimension „ |
startMinutesAgo |
Die inklusive Startminute für die Abfrage in Minuten vor dem aktuellen Zeitpunkt. Beispielsweise gibt Wenn keine Vorgabe erfolgt, wird für |
endMinutesAgo |
Die inklusive Endminute für die Abfrage in Minuten vor dem aktuellen Zeitpunkt. Darf nicht vor Wenn keine Vorgabe erfolgt, wird für |