Method: vitals.stuckbackgroundwakelockrate.query

Mengirim kueri metrik dalam kumpulan metrik.

Permintaan HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource.

Format: apps/{app}/stuckBackgroundWakelockRateMetricSet

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Kolom
timelineSpec

object (TimelineSpec)

Opsional. Spesifikasi parameter agregasi linimasa.

Periode agregasi yang didukung:

  • DAILY: metrik diagregasi dalam interval tanggal kalender. Karena batasan historis, satu-satunya zona waktu yang didukung adalah America/Los_Angeles.
dimensions[]

string

Opsional. Dimensi untuk membagi data.

Dimensi yang didukung:

  • apiLevel (string): level API Android yang berjalan di perangkat pengguna, misalnya, 26.
  • versionCode (int64): versi aplikasi yang berjalan di perangkat pengguna.
  • deviceModel (string): ID unik model perangkat pengguna. Bentuk ID-nya adalah 'deviceBrand/device', dengan deviceBrand sesuai dengan Build.BRAND dan device sesuai dengan Build.DEVICE, misalnya, google/coral.
  • deviceBrand (string): ID unik merek perangkat pengguna, misalnya, google.
  • deviceType (string): jenis (juga dikenal sebagai faktor bentuk) perangkat pengguna, misalnya, PHONE.
  • countryCode (string): negara atau wilayah perangkat pengguna berdasarkan alamat IP-nya, yang direpresentasikan sebagai kode ISO-3166 2 huruf (misalnya, US untuk Amerika Serikat).
  • deviceRamBucket (int64): RAM perangkat, dalam MB, dalam bucket (misalnya, 1024 untuk 1-1,5 GB, 4096 untuk 4-6 GB).
  • deviceSocMake (string): Buatan sistem-on-chip utama perangkat, misalnya, Samsung. Referensi
  • deviceSocModel (string): Model sistem-on-chip utama perangkat, misalnya, "Exynos 2100". Referensi
  • deviceCpuMake (string): Buatan CPU perangkat, misalnya, Qualcomm.
  • deviceCpuModel (string): Model CPU perangkat, misalnya, "Kryo 240".
  • deviceGpuMake (string): Buatan GPU perangkat, misalnya, ARM.
  • deviceGpuModel (string): Model GPU perangkat, misalnya, Mali.
  • deviceGpuVersion (string): Versi GPU perangkat, misalnya, T750.
  • deviceVulkanVersion (string): Versi Vulkan perangkat, misalnya, "4198400".
  • deviceGlEsVersion (string): Versi OpenGL ES perangkat, misalnya, "196610".
  • deviceScreenSize (string): Ukuran layar perangkat, misalnya, NORMAL, LARGE.
  • deviceScreenDpi (string): Kerapatan layar perangkat, misalnya, mdpi, hdpi.
metrics[]

string

Opsional. Metrik yang akan diagregasi.

Metrik yang didukung:

  • stuckBgWakelockRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang memiliki wakelock yang ditahan di latar belakang selama lebih dari 1 jam.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Nilai rata-rata bergulir stuckBgWakelockRate dalam 7 hari terakhir. Nilai harian diberi bobot berdasarkan jumlah pengguna unik untuk hari tersebut.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Nilai rata-rata bergulir stuckBgWakelockRate dalam 28 hari terakhir. Nilai harian diberi bobot berdasarkan jumlah pengguna unik untuk hari tersebut.
  • distinctUsers (google.type.Decimal): Jumlah pengguna unik dalam periode agregasi yang digunakan sebagai nilai normalisasi untuk metrik stuckBgWakelockRate. Pengguna dihitung dalam metrik ini jika aplikasinya melakukan pekerjaan apa pun di perangkat, yaitu tidak hanya penggunaan latar depan aktif, tetapi juga pekerjaan latar belakang. Anda harus berhati-hati agar tidak mengagregasi jumlah ini lebih lanjut, karena dapat menyebabkan pengguna dihitung beberapa kali. Nilai dibulatkan ke kelipatan terdekat dari 10, 100, 1.000, atau 1.000.000, bergantung pada besarnya nilai.
filter

string

Opsional. Filter yang akan diterapkan ke data. Ekspresi pemfilteran mengikuti standar AIP-160 dan mendukung pemfilteran berdasarkan kesetaraan semua dimensi perincian.
pageSize

integer

Opsional. Ukuran maksimum data yang ditampilkan.

Jika tidak ditentukan, maksimal 1.000 baris akan ditampilkan. Nilai maksimum adalah 100.000; nilai di atas 100.000 akan dikonversi menjadi 100.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 disediakan untuk permintaan harus sesuai dengan panggilan yang memberikan token halaman.
userCohort

enum (UserCohort)

Opsional. Tampilan pengguna yang akan dipilih. Data output akan sesuai dengan tampilan yang dipilih. Satu-satunya nilai yang didukung adalah OS_PUBLIC.

Isi respons

Pesan respons untuk stuckbackgroundwakelockrate.query.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Kolom
rows[]

object (MetricsRow)

Baris data yang ditampilkan.
nextPageToken

string

Token kelanjutan untuk mengambil halaman data berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/playdeveloperreporting

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.