Method: vitals.stuckbackgroundwakelockrate.query

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.