Method: vitals.stuckbackgroundwakelockrate.query
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mengueri metrik dalam set metrik.
Permintaan HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query
URL 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 )
Spesifikasi parameter agregasi linimasa. Periode pengelompokan yang didukung:
DAILY : metrik diagregasi dalam interval tanggal kalender. Karena batasan historis, satu-satunya zona waktu yang didukung adalah America/Los_Angeles .
|
dimensions[] |
string
Dimensi untuk mengelompokkan 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 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, TELEPON.
countryCode (string ): negara atau wilayah perangkat pengguna berdasarkan alamat IP-nya, yang ditampilkan sebagai kode ISO-3166 2 huruf (mis. US untuk Amerika Serikat).
deviceRamBucket (int64 ): RAM perangkat, dalam MB, dalam bucket (3 GB, 4 GB, dll.).
deviceSocMake (string ): Merek system-on-chip utama perangkat, misalnya, Samsung. Referensi
deviceSocModel (string ): Model system-on-chip utama perangkat, misalnya, "Exynos 2100". Referensi
deviceCpuMake (string ): Merek CPU perangkat, misalnya, Qualcomm.
deviceCpuModel (string ): Model CPU perangkat, misalnya, "Kryo 240".
deviceGpuMake (string ): Pembuat 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 ): Kepadatan layar perangkat, misalnya, mdpi, hdpi.
|
metrics[] |
string
Metrik yang akan digabungkan. 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 bergerak 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 aplikasi melakukan pekerjaan apa pun di perangkat, yaitu tidak hanya penggunaan latar depan yang aktif, tetapi juga pekerjaan latar belakang. Anda harus berhati-hati agar tidak menggabungkan 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
Filter yang akan diterapkan ke data. Ekspresi pemfilteran mengikuti standar AIP-160 dan mendukung pemfilteran menurut kesetaraan semua dimensi perincian.
|
pageSize |
integer
Ukuran maksimum data yang ditampilkan. Jika tidak ditentukan, paling banyak 1.000 baris akan ditampilkan. Nilai maksimum adalah 100.000; nilai di atas 100.000 akan dikonversi menjadi 100.000.
|
pageToken |
string
Token halaman, 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.
|
userCohort |
enum (UserCohort )
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 lanjutan 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.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-26 UTC."],[[["Queries metrics related to background wakelocks in the specified app."],["Allows filtering data by dimensions like API level, device model, and country."],["Returns metrics such as the percentage of users with prolonged background wakelocks and distinct user counts."],["Supports pagination for retrieving large datasets."],["Requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope for authorization."]]],["This outlines how to query metrics for stuck background wakelock rates. Using a `POST` request to a specified URL, you must provide a `name` path parameter. The request body allows specifying `timelineSpec` for daily aggregations, `dimensions` for data slicing (like device model or country), and `metrics` for data to be collected (such as `stuckBgWakelockRate`). Additional parameters include `filter`, `pageSize`, `pageToken`, and `userCohort`. The response includes `rows` of data and a `nextPageToken` for pagination, requiring `https://www.googleapis.com/auth/playdeveloperreporting` authorization.\n"]]