- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- RunPivotReportRequest
- Cobalah!
Menampilkan beberapa laporan pivot dalam sebuah batch. Semua laporan harus untuk Properti GA4 yang sama.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
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. Properti ini harus ditentukan untuk batch. Properti dalam RunPivotReportRequest mungkin tidak ditentukan atau konsisten dengan properti ini. Contoh: properties/1234 |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"requests": [
{
object ( |
Kolom | |
---|---|
requests[] |
Permintaan individual. Setiap permintaan memiliki respons laporan pivot terpisah. Setiap permintaan batch diizinkan hingga 5 permintaan. |
Isi respons
Respons batch yang berisi beberapa laporan pivot.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"pivotReports": [
{
object ( |
Kolom | |
---|---|
pivotReports[] |
Respons individual. Setiap respons memiliki permintaan laporan pivot terpisah. |
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
RunPivotReportRequest
Permintaan untuk menghasilkan laporan pivot.
Representasi JSON |
---|
{ "property": string, "dimensions": [ { object ( |
Kolom | |
---|---|
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. Dalam permintaan batch, properti ini tidak boleh ditentukan atau sesuai dengan properti level batch. Contoh: properties/1234 |
dimensions[] |
Dimensi yang diminta. Semua dimensi yang ditentukan harus digunakan oleh salah satu dari berikut: dimensionExpression, dimensionFilter, pivot, orderBys. |
metrics[] |
Metrik diminta, setidaknya satu metrik harus ditentukan. Semua metrik yang ditentukan harus digunakan oleh salah satu dari berikut ini: metric_expression, metricFilter, orderBys. |
dateRanges[] |
Rentang tanggal untuk mengambil data peristiwa untuk laporan. Jika beberapa rentang tanggal ditentukan, data peristiwa dari setiap rentang tanggal akan digunakan dalam laporan. Dimensi khusus dengan nama kolom "dateRange" dapat disertakan dalam nama kolom Pivot; jika disertakan, laporan akan membandingkan berbagai rentang tanggal. Dalam permintaan kelompok, |
pivots[] |
Menjelaskan format visual dimensi laporan dalam kolom atau baris. Penyatuan fieldNames (nama dimensi) di semua pivot harus merupakan subkumpulan nama dimensi yang ditentukan dalam Dimensi. Tidak ada dua pivot yang dapat berbagi dimensi. Dimensi hanya terlihat jika muncul dalam pivot. |
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. |
currencyCode |
Kode mata uang dalam format ISO4217, seperti "AED", "USD", "JPY". Jika kolomnya kosong, laporan akan menggunakan mata uang default properti. |
cohortSpec |
Grup kelompok yang dikaitkan dengan permintaan ini. Jika ada grup kelompok dalam permintaan, dimensi 'kohor' harus ada. |
keepEmptyRows |
Jika salah (false) atau tidak ditentukan, setiap baris dengan semua metrik yang sama dengan 0 tidak akan ditampilkan. Jika true (benar), baris tersebut akan ditampilkan jika tidak dihapus secara terpisah oleh filter. Terlepas dari setelan Misalnya, jika properti tidak pernah mencatat peristiwa |
returnPropertyQuota |
Mengalihkan apakah akan menampilkan status saat ini dari kuota Properti Analytics ini. Kuota ditampilkan di PropertyQuota. |
comparisons[] |
Opsional. Konfigurasi perbandingan yang diminta dan ditampilkan. Permintaan ini memerlukan kolom perbandingan dan dimensi perbandingan agar dapat menerima kolom perbandingan dalam respons. |