Method: vitals.crashrate.query
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mengirim kueri metrik dalam kumpulan metrik.
Permintaan HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query
URL ini menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
name |
string
Wajib. Nama resource. Format: apps/{app}/crashRateMetricSet
|
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, zona waktu default dan satu-satunya yang didukung adalah America/Los_Angeles.
HOURLY: metrik diagregasi dalam interval per jam. Zona waktu default dan satu-satunya yang didukung adalah UTC.
|
dimensions[] |
string
Opsional. Dimensi untuk membagi metrik. Dimensi yang didukung:
apiLevel (string): API level 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, 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 (3 GB, 4 GB, dll.).
deviceSocMake (string): Merek sistem-on-chip utama perangkat, misalnya, Samsung. Referensi
deviceSocModel (string): Model sistem-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): Merek 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:
crashRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu error.
crashRate7dUserWeighted (google.type.Decimal): Nilai rata-rata bergulir crashRate dalam 7 hari terakhir. Nilai harian diberi bobot berdasarkan jumlah pengguna unik untuk hari tersebut.
crashRate28dUserWeighted (google.type.Decimal): Nilai rata-rata bergulir crashRate dalam 28 hari terakhir. Nilai harian diberi bobot berdasarkan jumlah pengguna unik untuk hari tersebut. Tidak didukung dalam granularitas HOURLY.
userPerceivedCrashRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu error saat mereka aktif menggunakan aplikasi Anda (error yang dirasakan pengguna). Aplikasi dianggap aktif digunakan jika menampilkan aktivitas atau menjalankan layanan latar depan apa pun.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Nilai rata-rata bergulir userPerceivedCrashRate dalam 7 hari terakhir. Nilai harian diberi bobot berdasarkan jumlah pengguna unik untuk hari tersebut. Tidak didukung dalam granularitas HOURLY.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Nilai rata-rata bergulir userPerceivedCrashRate dalam 28 hari terakhir. Nilai harian diberi bobot berdasarkan jumlah pengguna unik untuk hari tersebut. Tidak didukung dalam granularitas HOURLY.
distinctUsers (google.type.Decimal): Jumlah pengguna unik dalam periode agregasi yang digunakan sebagai nilai normalisasi untuk metrik crashRate dan userPerceivedCrashRate. Pengguna dihitung dalam metrik ini jika mereka menggunakan aplikasi secara aktif selama periode agregasi. Aplikasi dianggap aktif digunakan jika menampilkan aktivitas atau menjalankan layanan latar depan apa pun. 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
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. Nilai yang didukung:
|
Isi respons
Pesan respons untuk crashrate.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 2026-04-22 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 2026-04-22 UTC."],[],["This document details how to query crash rate metrics using a POST request to `https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query`. The request requires a `name` path parameter. The request body specifies `timelineSpec`, `dimensions` (e.g., `apiLevel`, `deviceModel`), `metrics` (e.g., `crashRate`, `distinctUsers`), optional `filter`, `pageSize`, `pageToken`, and `userCohort`. The response contains `rows` of metric data and a `nextPageToken` for pagination. Requires OAuth scope `https://www.googleapis.com/auth/playdeveloperreporting`.\n"]]