- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- Cobalah!
Mengambil konten tugas laporan. Setelah meminta reportTasks.create
, Anda dapat mengambil konten laporan setelah laporan AKTIF. Metode ini akan menampilkan error jika status tugas laporan bukan ACTIVE
. Respons kueri akan menampilkan nilai baris & kolom tabel laporan.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
name |
Wajib. Nama sumber laporan. Format: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "offset": string, "limit": string } |
Kolom | |
---|---|
offset |
Opsional. Jumlah baris dari baris awal dalam laporan. Baris pertama dihitung sebagai baris 0. Saat melakukan paging, permintaan pertama tidak menentukan offset; atau yang setara, menyetel offset ke 0; permintaan pertama menampilkan Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
limit |
Opsional. Jumlah baris yang akan ditampilkan dari laporan. 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 baris lebih sedikit daripada Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
Isi respons
Isi laporan yang sesuai dengan tugas laporan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
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. |
metadata |
Metadata untuk laporan. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
Metadata respons yang membawa informasi tambahan tentang konten laporan.
Representasi JSON |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Kolom | |
---|---|
dataLossFromOtherRow |
Jika true (benar), menunjukkan beberapa bucket kombinasi dimensi digabungkan ke baris "(other)". Hal ini dapat terjadi pada laporan kardinalitas tinggi. Parameter metadata dataLossFromOtherRow diisi berdasarkan tabel data gabungan yang digunakan dalam laporan. Parameter akan diisi secara akurat, apa pun filter dan batasnya dalam laporan. Misalnya, baris (other) dapat dihapus dari laporan karena permintaan berisi filter di sessionSource = google. Parameter ini akan tetap diisi jika ada hilangnya data dari baris lain dalam data gabungan input yang digunakan untuk membuat laporan ini. Untuk mempelajari lebih lanjut, lihat artikel Tentang baris (other) dan sampling data. |
schemaRestrictionResponse |
Menjelaskan pembatasan skema yang secara aktif diterapkan dalam membuat laporan ini. Untuk mempelajari lebih lanjut, lihat Pengelolaan akses dan batasan data. |
currencyCode |
Kode mata uang yang digunakan dalam laporan ini. Ditujukan untuk digunakan dalam memformat metrik mata uang seperti Kode mata uang adalah encoding string jenis mata uang dari standar ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217); misalnya "USD", "EUR", "JPY". Untuk mempelajari lebih lanjut, lihat https://support.google.com/analytics/answer/9796179. |
timeZone |
Zona waktu properti saat ini. Ditujukan untuk digunakan untuk menafsirkan dimensi berbasis waktu seperti |
emptyReason |
Jika alasan kosong ditentukan, laporan akan kosong karena alasan ini. |
subjectToThresholding |
Jika |
SchemaRestrictionResponse
Pembatasan skema yang secara aktif diterapkan dalam pembuatan laporan ini. Untuk mempelajari lebih lanjut, lihat Pengelolaan akses dan batasan data.
Representasi JSON |
---|
{
"activeMetricRestrictions": [
{
object ( |
Kolom | |
---|---|
activeMetricRestrictions[] |
Semua batasan diterapkan secara aktif dalam pembuatan laporan. Misalnya, |
ActiveMetricRestriction
Metrik secara aktif dibatasi dalam membuat laporan.
Representasi JSON |
---|
{
"restrictedMetricTypes": [
enum ( |
Kolom | |
---|---|
restrictedMetricTypes[] |
Alasan pembatasan metrik ini. |
metricName |
Nama metrik yang dibatasi. |
RestrictedMetricType
Kategori data yang mungkin tidak dapat Anda lihat di properti GA4 tertentu.
Enum | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Jenis tidak ditentukan. |
COST_DATA |
Metrik biaya seperti adCost . |
REVENUE_DATA |
Metrik pendapatan seperti purchaseRevenue . |