Method: publishers.items.queryMetrics

Membuat kueri metrik untuk item.

Permintaan HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama item yang metriknya akan dikueri. Format: publishers/{publisher}/items/{item}

Parameter kueri

Parameter
timeSpec

object (TimeSpec)

Wajib. Spesifikasi waktu untuk mengkueri set metrik.
metrics[]

string

Wajib. Metrik yang akan dikueri untuk set metrik.

Metrik yang didukung:

  • installs: Jumlah penginstalan item.
  • installs-7d: Jumlah penginstalan item dalam 7 hari terakhir.
  • uninstalls: Jumlah uninstal item.
  • users: Jumlah pengguna aktif harian item.
  • users-7d: Jumlah pengguna aktif item selama 7 hari.
  • impressions: Jumlah tayangan item di seluruh halaman beranda toko.
  • page-views: Jumlah kunjungan untuk halaman detail item.
dimensions[]

string

Opsional. Dimensi untuk mengelompokkan metrik. Maksimal satu dimensi yang dapat ditentukan.

Dimensi yang didukung:

  • os: Sistem operasi pengguna.
  • app-version: Versi item.
  • country: Negara pengguna.
  • install-source: Sumber penginstalan.
  • install-type: Jenis penginstalan (dari webstore, inline, atau lainnya).
  • language: Bahasa pengguna.
  • enabled: Jika item diaktifkan atau dinonaktifkan.
  • utm-campaign: Kampanye UTM pengguna.
  • utm-content: Konten UTM pengguna.
  • utm-medium: Media UTM pengguna.
  • utm-source: Sumber UTM pengguna.
  • utm-term: Istilah UTM pengguna.
pageSize

integer

Opsional. Jumlah maksimum baris yang akan ditampilkan. Jika tidak ditentukan, paling banyak 100 baris akan ditampilkan. Nilai maksimum adalah 1.000; Nilai di atas 1.000 akan dikonversi menjadi 1.000.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk permintaan harus sesuai dengan panggilan yang menyediakan token halaman.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk items.queryMetrics.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Kolom
metricRows[]

object (MetricRow)

Baris metrik.
nextPageToken

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

TimeSpec

Rentang tanggal untuk mengkueri metrik.

Representasi JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Kolom
firstDate

object (Date)

Opsional. Tanggal pertama (inklusif) dari spesifikasi waktu. Jika tidak ditetapkan, tidak ada batas bawah yang akan diterapkan.
lastDate

object (Date)

Opsional. Tanggal terakhir (inklusif) dari spesifikasi waktu. Jika tidak ditetapkan, tidak ada batas atas yang akan diterapkan.

Tanggal

Merepresentasikan tanggal kalender lengkap atau sebagian, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggalnya relatif terhadap Kalender Gregorian. Hal ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari selain nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam satu tahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

MetricRow

Satu baris nilai metrik dan dimensi.

Representasi JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Kolom
date

object (Date)

Tanggal data.
dimensionValues[]

string

Kolom nilai dimensi untuk baris.
metricValues[]

object (MetricValue)

Kolom metrik untuk baris.

MetricValue

Menampilkan nilai metrik tunggal

Representasi JSON 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Kolom
metric

string

Nama metrik
value

string (int64 format)

Nilai metrik.
uniqueUserCount

string (int64 format)

Jumlah pengguna unik yang terkait dengan metrik (jika ada).