Method: vitals.stuckbackgroundwakelockrate.query

Metrik kümesindeki metrikleri sorgular.

HTTP isteği

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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 gövdesi, aşağıdaki yapıyla birlikte veriler 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 spesifikasyonu.

Desteklenen toplama dönemleri:

  • DAILY: Metrikler takvim tarih aralıkları olarak toplanır. Geçmişteki kısıtlamalar nedeniyle yalnızca America/Los_Angeles saat dilimi desteklenir.
dimensions[]

string

Verilerin kesileceği boyutlardır.

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ı biçimi "deviceBrand/device" şeklindedir.Burada deviceBrand, Build.BRAND değerine, cihaz ise Build.DEVICE değerine karşılık gelir (ör. google/mercan).
  • 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 cihazının, IP adresine göre ülke veya bölge.2 harfli ISO-3166 kodu (ör. ABD için US) olarak gösterilir.
  • deviceRamBucket (int64): Cihazın MB cinsinden RAM'i (3 GB, 4 GB vb.).
  • deviceSocMake (string): Cihazın birincil çip üzerindeki sisteminin markası, ör. Samsung Referans
  • deviceSocModel (string): Cihazın birincil çip üzerindeki sisteminin modeli, ör. "Exynos 2100". Referans
  • deviceCpuMake (string): Cihazın CPU'su, ör. Qualcomm.
  • deviceCpuModel (string): Cihazın CPU modeli, ör. "Kryo 240".
  • deviceGpuMake (string): Cihazın GPU'sunun markası, ör. ETKİNLEŞTİR.
  • deviceGpuModel (string): Cihazın GPU modeli, ör. Mali.
  • deviceGpuVersion (string): Cihazın GPU 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, BÜYÜK.
  • 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 boyunca uyanık kalma kilidi olan farklı kullanıcıların yüzdesi.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Son 7 gündeki hareketli ortalama stuckBgWakelockRate değeri. Günlük değerler, o güne ait farklı kullanıcıların sayısına göre ağırlıklandırılır.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Son 28 gün içindeki hareketli ortalama stuckBgWakelockRate değeri. Günlük değerler, o güne ait farklı kullanıcıların 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ıdır. Uygulama, cihazda yalnızca etkin ön plan kullanımında değil, arka planda da çalışma yapıyorsa bu metrikte sayılır. Bu sayı, kullanıcıların birden çok kez sayılmasına neden olabileceğinden bu sayının toplanmamasına dikkat edilmelidir. Değer, değerin büyüklüğüne bağlı olarak 10, 100, 1.000 veya 1.000.000'un en yakın katına yuvarlanır.
filter

string

Verilere uygulanacak filtreler. Filtreleme ifadesi, AIP-160 standardına uyar 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'in üzerindeki değerler 100.000'e zorlanır.

pageToken

string

Önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bu kodu sağlayın.

Sayfalara ayırma sırasında, 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.

Desteklenen değerler:

  • OS_PUBLIC Herkese açık olarak yayınlanan tüm Android sürümlerinden veri seçmek için. Bu varsayılan seçenektir. Yukarıdaki boyutların tümünü destekler.
  • APP_TESTERS Test kullanıcısı olmayı seçen kullanıcıların verilerini seçmek için. Yukarıdaki boyutların tümünü destekler.
  • OS_BETA Yalnızca beta Android sürümlerinden veri seçmek için, yayınlanan Android sürümlerinin verilerini hariç tutun. Yalnızca aşağıdaki boyutlar desteklenir:
  • versionCode (int64): Kullanıcının cihazında çalışan uygulama sürümü.

  • osBuild (string): Kullanıcının cihazının işletim sistemi derlemesi, ör. "T1B2.220916.004".

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

Sonraki veri sayfasını getirmek için devam jetonu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.