Menampilkan laporan catatan akses data yang disesuaikan. Laporan ini menyediakan catatan setiap kali pengguna membaca data pelaporan Google Analytics. Data akses disimpan hingga 2 tahun.
Laporan Akses Data dapat diminta untuk properti. Properti harus berada di Google Analytics 360. Metode ini hanya tersedia untuk Administrator.
Data akses data ini mencakup Pelaporan UI GA4, Eksplorasi UI GA4, Data API GA4, dan produk lain seperti Firebase & AdMob yang dapat mengambil data dari Google Analytics melalui penautan. Data ini tidak mencakup perubahan konfigurasi properti seperti menambahkan aliran data atau mengubah zona waktu properti. Untuk histori perubahan konfigurasi, lihat searchChangeHistoryEvents.
Permintaan HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{entity=properties/*}:runAccessReport
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
entity |
Laporan Akses Data mendukung permintaan di tingkat properti atau tingkat akun. Jika diminta di tingkat akun, Laporan Akses Data mencakup semua akses untuk semua properti di bagian akun tersebut. Untuk meminta di tingkat properti, entitas harus berupa misalnya 'properties/123' jika "123" merupakan ID properti GA4 Anda. Untuk meminta di tingkat akun, entitas harus misalnya 'accounts/1234' jika "1234" adalah ID Akun GA4 Anda. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "dimensions": [ { object ( |
Kolom | |
---|---|
dimensions[] |
Dimensi yang diminta dan ditampilkan di respons. Permintaan diizinkan hingga 9 dimensi. |
metrics[] |
Metrik yang diminta dan ditampilkan dalam respons. Permintaan diizinkan hingga 10 metrik. |
dateRanges[] |
Rentang tanggal catatan akses untuk dibaca. Jika beberapa rentang tanggal diminta, setiap baris respons akan berisi indeks rentang tanggal berbasis nol. Jika dua rentang tanggal tumpang-tindih, catatan akses untuk hari yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang tanggal tersebut. Permintaan diizinkan hingga 2 rentang tanggal. |
dimensionFilter |
Filter dimensi memungkinkan Anda membatasi respons laporan untuk nilai dimensi tertentu yang cocok dengan filter. Misalnya, memfilter data akses satu pengguna. Untuk mempelajari lebih lanjut, lihat Dasar-Dasar Filter Dimensi untuk mengetahui contohnya. Metrik tidak dapat digunakan di filter ini. |
metricFilter |
Filter metrik memungkinkan Anda membatasi respons laporan pada nilai metrik tertentu yang cocok dengan filter. Filter metrik diterapkan setelah menggabungkan baris laporan, mirip dengan SQL yang memiliki klausa. Dimensi tidak dapat digunakan dalam filter ini. |
offset |
Jumlah baris dari baris awal. Baris pertama dihitung sebagai baris 0. Jika offset tidak ditentukan, maka diperlakukan sebagai 0. Jika offset nol, metode ini akan menampilkan halaman pertama hasil dengan entri Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
limit |
Jumlah baris untuk ditampilkan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API tersebut menampilkan maksimum 100.000 baris per permintaan, berapa pun jumlah yang Anda minta. API dapat menampilkan lebih sedikit baris daripada Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
timeZone |
Zona waktu permintaan ini jika ditentukan. Jika tidak ditentukan, zona waktu properti akan digunakan. Zona waktu permintaan digunakan untuk menafsirkan tanggal mulai & akhir laporan. Diformat sebagai string dari database Zona Waktu IANA (https://www.iana.org/time-zones); misalnya "America/New_York" atau "Asia/Tokyo". |
orderBys[] |
Menentukan cara baris diurutkan dalam respons. |
returnEntityQuota |
Mengalihkan apakah akan menampilkan status saat ini dari kuota Properti Analytics ini atau tidak. Kuota ditampilkan di AccessQuota. Untuk permintaan tingkat akun, kolom ini harus salah. |
Isi respons
Jika berhasil, isi respons memuat instance RunAccessReportResponse
.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit