Menampilkan laporan yang disesuaikan tentang data peristiwa realtime untuk properti Anda. Peristiwa muncul di laporan real-time beberapa detik setelah dikirim ke Google Analytics. Laporan Real-Time menampilkan data peristiwa dan penggunaan untuk jangka waktu mulai dari momen saat ini hingga 30 menit yang lalu (hingga 60 menit untuk properti Google Analytics 360).
Untuk panduan pembuatan permintaan realtime & memahami respons, lihat Membuat Laporan Real-Time.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
property |
ID properti GA4 Google Analytics yang peristiwanya dilacak. Ditentukan dalam jalur URL dan bukan isi. Untuk mempelajari lebih lanjut, lihat tempat menemukan ID Properti. Contoh: properties/1234 |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "dimensions": [ { object ( |
Kolom | |
---|---|
dimensions[] |
Dimensi yang diminta dan ditampilkan. |
metrics[] |
Metrik yang diminta dan ditampilkan. |
dimensionFilter |
Klausa filter dimensi. Metrik tidak dapat digunakan di filter ini. |
metricFilter |
Klausa filter metrik. Diterapkan pada fase pasca-agregasi, mirip dengan klausa memiliki SQL. Dimensi tidak dapat digunakan di filter ini. |
limit |
Jumlah baris yang akan ditampilkan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. API juga dapat menampilkan lebih sedikit baris dari |
metricAggregations[] |
Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris tempat dimensionsValues ditetapkan ke "RESERVED_(MetricAggregation)". |
orderBys[] |
Menentukan bagaimana baris diurutkan dalam respons. |
returnPropertyQuota |
Mengalihkan apakah akan menampilkan status kuota Realtime Properti Analytics saat ini atau tidak. Kuota ditampilkan di PropertyQuota. |
minuteRanges[] |
Rentang menit data peristiwa yang akan dibaca. Jika tidak ditentukan, rentang satu menit untuk 30 menit terakhir akan digunakan. Jika beberapa rentang menit diminta, setiap baris respons akan berisi indeks rentang menit berbasis nol. Jika rentang dua menit tumpang-tindih, data peristiwa untuk menit yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang menit tersebut. |
Isi respons
Tabel laporan real-time respons yang sesuai dengan permintaan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "dimensionHeaders": [ { object ( |
Kolom | |
---|---|
dimensionHeaders[] |
Menjelaskan kolom dimensi. Jumlah DimensionHeaders dan urutan DimensionHeaders cocok dengan dimensi yang ada dalam baris. |
metricHeaders[] |
Menjelaskan kolom metrik. Jumlah MetricHeaders dan pengurutan MetricHeaders cocok dengan metrik yang ada dalam baris. |
rows[] |
Baris kombinasi nilai dimensi dan nilai metrik dalam laporan. |
totals[] |
Jika diminta, total nilai metrik. |
maximums[] |
Jika diminta, nilai maksimum metrik. |
minimums[] |
Jika diminta, nilai minimum metrik. |
rowCount |
Jumlah total baris dalam hasil kueri. |
propertyQuota |
Status kuota Realtime Properti Analytics ini termasuk permintaan ini. |
kind |
Mengidentifikasi jenis resource pesan ini. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinuteRange
Kumpulan menit yang berdekatan: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. Permintaan diizinkan dengan rentang hingga 2 menit.
Representasi JSON |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Kolom | |
---|---|
name |
Menetapkan nama untuk rentang menit ini. Dimensi |
startMinutesAgo |
Menit mulai inklusif untuk kueri dalam jumlah menit sebelumnya. Misalnya, Jika tidak ditentukan, |
endMinutesAgo |
Menit akhir inklusif untuk kueri dalam jumlah menit sebelumnya. Tidak boleh sebelum Jika tidak ditentukan, |