Google Analytics Realtime API menampilkan laporan yang disesuaikan berisi data peristiwa realtime untuk properti Anda. Laporan ini menunjukkan peristiwa dan penggunaan selama 30 menit terakhir.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{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. |
limit |
Jumlah baris yang akan ditampilkan. Jika parameter |
dimensionFilter |
Klausa filter dimensi. Dimensi harus diminta untuk digunakan dalam filter ini. Metrik tidak dapat digunakan dalam filter ini. |
metricFilter |
Klausa filter metrik. Diterapkan pada fase agregasi pasca, mirip dengan klausa penggunaan SQL. Metrik harus diminta untuk digunakan dalam filter ini. Dimensi tidak dapat digunakan dalam filter ini. |
metricAggregations[] |
Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris tempat dimensionValues ditetapkan ke "RESERVED_(MetricAggregation)". |
orderBys[] |
Menentukan bagaimana baris diurutkan dalam respons. |
returnPropertyQuota |
Beralih apakah akan menampilkan status saat ini dari kuota Realtime Properti Analytics ini. Kuota ditampilkan di PropertyQuota. |
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Tabel laporan real-time respons yang sesuai dengan permintaan.
Representasi JSON | |
---|---|
{ "dimensionHeaders": [ { object ( |
Kolom | |
---|---|
dimensionHeaders[] |
Menjelaskan kolom dimensi. Jumlah DimensionHeader dan urutan DimensionHeaders cocok dengan dimensi yang ada dalam baris. |
metricHeaders[] |
Menjelaskan kolom metrik. Jumlah MetricHeader 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 metrik maksimum. |
minimums[] |
Jika diminta, nilai metrik minimum. |
rowCount |
Jumlah total baris dalam hasil kueri, berapa pun jumlah baris yang ditampilkan dalam respons. Misalnya, jika kueri menampilkan 175 baris dan menyertakan limit = 50 dalam permintaan API, respons akan berisi rowCount = 175, tetapi hanya 50 baris. |
propertyQuota |
Status kuota Realtime Properti Analytics ini termasuk permintaan ini. |
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics