Method: vitals.stuckbackgroundwakelockrate.query
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Metrik kümesindeki metrikleri sorgular.
HTTP isteği
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
name |
string
Zorunlu. Kaynak adı. Biçim: apps/{app}/stuckBackgroundWakelockRateMetricSet
|
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"timelineSpec": {
object (TimelineSpec )
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort )
} |
Alanlar |
timelineSpec |
object (TimelineSpec )
Zaman çizelgesi toplama parametrelerinin belirtilmesi. Desteklenen toplama dönemleri:
DAILY : Metrikler, takvim tarihi aralıklarında toplanır. Geçmişe dayalı kısıtlamalar nedeniyle yalnızca America/Los_Angeles saat dilimi desteklenir.
|
dimensions[] |
string
Verileri dilimlemek için kullanılacak boyutlar. Desteklenen boyutlar:
apiLevel (string ): Kullanıcının cihazında çalışan Android'in API düzeyi (ör. 26.
versionCode (int64 ): Kullanıcının cihazında çalışan uygulama sürümü.
deviceModel (string ): Kullanıcının cihaz modelinin benzersiz tanımlayıcısı. Tanımlayıcının biçimi "deviceBrand/device" şeklindedir.Burada deviceBrand, Build.BRAND'e, device ise Build.DEVICE'a karşılık gelir (ör. google/coral).
deviceBrand (string ): Kullanıcının cihaz markasının benzersiz tanımlayıcısı (ör. google).
deviceType (string ): Kullanıcının cihazının türü (form faktörü olarak da bilinir), ör. TELEFON.
countryCode (string ): Kullanıcının IP adresine göre cihazının bulunduğu ülke veya bölge, 2 harfli ISO-3166 kodu olarak gösterilir (ör. ABD için US).
deviceRamBucket (int64 ): Cihazın MB cinsinden RAM'i (3 GB, 4 GB vb.).
deviceSocMake (string ): Cihazın birincil çip üzerinde sisteminin markası, ör. Samsung. Referans
deviceSocModel (string ): Cihazın birincil çip üzerinde sisteminin modeli, ör. "Exynos 2100". Referans
deviceCpuMake (string ): Cihazın CPU'sunun markası (ör. Qualcomm.
deviceCpuModel (string ): Cihazın CPU'sunun modeli (ör. "Kryo 240".
deviceGpuMake (string ): Cihazın GPU'sunun markası (ör. ARM.
deviceGpuModel (string ): Cihazın GPU'sunun modeli (ör. Mali.
deviceGpuVersion (string ): Cihazın GPU'sunun sürümü (ör. T750.
deviceVulkanVersion (string ): Cihazın Vulkan sürümü (ör. "4198400".
deviceGlEsVersion (string ): Cihazın OpenGL ES sürümü (ör. "196610".
deviceScreenSize (string ): Cihazın ekran boyutu (ör. NORMAL, LARGE.
deviceScreenDpi (string ): Cihazın ekran yoğunluğu (ör. mdpi, hdpi).
|
metrics[] |
string
Toplanacak metrikler. Desteklenen metrikler:
stuckBgWakelockRate (google.type.Decimal ): Toplama döneminde, arka planda 1 saatten uzun süre uyanık kalma kilidi tutan benzersiz kullanıcıların yüzdesi.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal ): Son 7 gün içinde stuckBgWakelockRate için hareketli ortalama değeri. Günlük değerler, o günkü farklı kullanıcı sayısına göre ağırlıklandırılır.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal ): Son 28 gün içinde stuckBgWakelockRate 'nin hareketli ortalama değeri. Günlük değerler, o günkü farklı kullanıcı sayısına göre ağırlıklandırılır.
distinctUsers (google.type.Decimal ): Toplama döneminde stuckBgWakelockRate metriği için normalleştirme değeri olarak kullanılan farklı kullanıcıların sayısı. Uygulama cihazda herhangi bir işlem yapıyorsa (ör. yalnızca etkin ön plan kullanımı değil, arka plan işlemleri de) kullanıcı bu metriğe dahil edilir. Bu sayının daha fazla toplanmamasına dikkat edilmelidir. Aksi takdirde kullanıcılar birden fazla kez sayılabilir. Değer, büyüklüğüne bağlı olarak en yakın 10, 100, 1.000 veya 1.000.000 katına yuvarlanır.
|
filter |
string
Verilere uygulanacak filtreler. Filtreleme ifadesi AIP-160 standardına uygundur ve tüm döküm boyutlarının eşitliğine göre filtrelemeyi destekler.
|
pageSize |
integer
Döndürülen verilerin maksimum boyutu. Belirtilmemişse en fazla 1.000 satır döndürülür. Maksimum değer 100.000'dir. 100.000'den büyük değerler 100.000'e zorlanır.
|
pageToken |
string
Önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalama yapılırken isteğe sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
|
userCohort |
enum (UserCohort )
Seçilecek kullanıcı görünümü. Çıkış verileri, seçilen görünüme karşılık gelir. Yalnızca OS_PUBLIC değeri desteklenir.
|
Yanıt gövdesi
stuckbackgroundwakelockrate.query
için yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"rows": [
{
object (MetricsRow )
}
],
"nextPageToken": string
} |
Alanlar |
rows[] |
object (MetricsRow )
Döndürülen veri satırları.
|
nextPageToken |
string
Verilerin sonraki sayfasını getirmek için devamlılık jetonu.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/playdeveloperreporting
Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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"]]