Method: vitals.crashrate.query

Metrik kümesindeki metrikleri sorgular.

HTTP isteği

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}: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}/crashRateMetricSet

İ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 varsayılan ve desteklenen tek saat dilimi America/Los_Angeles'dır.
  • HOURLY: Metrikler saatlik aralıklarla toplanır. Varsayılan ve desteklenen tek saat dilimi UTC'dır.
dimensions[]

string

Metriklerin dilimleneceği 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:

  • crashRate (google.type.Decimal): Toplama döneminde en az bir kilitlenme yaşayan benzersiz kullanıcıların yüzdesi.
  • crashRate7dUserWeighted (google.type.Decimal): Son 7 gün içinde crashRate 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.
  • crashRate28dUserWeighted (google.type.Decimal): Son 28 gün içinde crashRate'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. SAATLİK ayrıntı düzeyinde desteklenmez.
  • userPerceivedCrashRate (google.type.Decimal): Toplama döneminde uygulamanızı aktif olarak kullanırken en az bir kilitlenme (kullanıcı tarafından algılanan kilitlenme) yaşayan farklı kullanıcıların yüzdesi. Herhangi bir etkinlik görüntüleyen veya ön plan hizmeti yürüten uygulamalar etkin kullanımda kabul edilir.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Son 7 gün içinde userPerceivedCrashRate 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. SAATLİK ayrıntı düzeyinde desteklenmez.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Son 28 gün içinde userPerceivedCrashRate'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. SAATLİK ayrıntı düzeyinde desteklenmez.
  • distinctUsers (google.type.Decimal): Toplama döneminde crashRate ve userPerceivedCrashRate metrikleri için normalleştirme değeri olarak kullanılan farklı kullanıcıların sayısı. Uygulamayı toplama döneminde etkin olarak kullanan kullanıcılar bu metriğe dahil edilir. Herhangi bir etkinlik görüntüleyen veya ön plan hizmeti yürüten uygulamalar etkin kullanımda kabul 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'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 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.

Desteklenen değerler:

  • OS_PUBLIC Herkese açık olarak yayınlanan tüm Android sürümlerindeki verileri seçmek için. Bu, varsayılan seçenektir. Yukarıdaki tüm boyutları destekler.
  • APP_TESTERS Test kullanıcısı olmayı kabul eden kullanıcıların verilerini seçmek için. Yukarıdaki tüm boyutları destekler.
  • OS_BETA Yayınlanan Android sürümlerindeki veriler hariç olmak üzere yalnızca Android'in beta sürümlerindeki verileri seçmek için. Yalnızca aşağıdaki boyutlar desteklenir:

  • versionCode (int64): Uygulamanın, kullanıcının cihazında çalışan sürümü.

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

Yanıt gövdesi

crashrate.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.