Method: runReport

Menampilkan laporan yang disesuaikan dari data peristiwa Google Analytics Anda. Laporan berisi statistik yang berasal dari data yang dikumpulkan oleh kode pelacakan Google Analytics. Data yang ditampilkan dari API berupa tabel dengan kolom untuk dimensi dan metrik yang diminta. Metrik adalah pengukuran individual dari aktivitas pengguna di properti Anda, seperti pengguna aktif atau jumlah peristiwa. Dimensi mengelompokkan metrik di beberapa kriteria umum, seperti nama negara atau peristiwa.

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1alpha:runReport

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Kolom
entity

object (Entity)

Properti yang peristiwanya dilacak. Dalam permintaan batch, entitas ini harus tidak ditentukan atau konsisten dengan entitas tingkat batch.
dimensions[]

object (Dimension)

Dimensi yang diminta dan ditampilkan.
metrics[]

object (Metric)

Metrik yang diminta dan ditampilkan.
dateRanges[]

object (DateRange)

Rentang tanggal data untuk dibaca. Jika beberapa rentang tanggal diminta, setiap baris respons akan berisi indeks rentang tanggal berbasis nol. Jika dua rentang tanggal tumpang-tindih, data peristiwa untuk hari yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang tanggal tersebut. Dalam permintaan kelompok, dateRanges ini harus tidak ditentukan.
offset

string (int64 format)

Jumlah baris pada baris awal. Baris pertama dihitung sebagai baris 0.
limit

string (int64 format)

Jumlah baris yang akan ditampilkan. Jika parameter limit tidak ditentukan, 10.000 baris akan ditampilkan. API ini menampilkan maksimum 100.000 baris per permintaan, berapa pun jumlah yang Anda minta.
metricAggregations[]

enum (MetricAggregation)

Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris tempat dimensionValues ditetapkan ke "RESERVED_(MetricAggregation)".
dimensionFilter

object (FilterExpression)

Klausa filter dimensi. Dimensi harus diminta agar dapat digunakan dalam filter ini. Metrik tidak dapat digunakan dalam filter ini.
metricFilter

object (FilterExpression)

Klausa filter metrik. Diterapkan pada fase pasca agregasi, mirip dengan klausa SQL. Metrik harus diminta agar digunakan dalam filter ini. Dimensi tidak dapat digunakan dalam filter ini.
orderBys[]

object (OrderBy)

Menentukan cara baris diurutkan dalam respons.
currencyCode

string

Kode mata uang dalam format ISO4217, seperti "AED", "USD", "JPY". Jika kolom kosong, laporan akan menggunakan mata uang default entitas.
cohortSpec

object (CohortSpec)

Grup kelompok yang terkait dengan permintaan ini. Jika ada grup kelompok dalam permintaan, kolom 'kohor' dimensi kustom harus ada.
keepEmptyRows

boolean

Jika salah atau tidak ditentukan, tiap baris dengan semua metrik yang sama dengan 0 tidak akan ditampilkan. Jika true (benar), baris ini akan ditampilkan jika tidak dihapus secara terpisah oleh filter.
returnPropertyQuota

boolean

Mengalihkan apakah akan menampilkan status saat ini dari kuota Properti Analytics ini. Kuota ditampilkan di PropertyQuota.

Isi respons

Jika berhasil, isi respons memuat instance RunReportResponse.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics