Method: vitals.crashrate.query

Metrik kümesindeki metrikleri sorgular.

HTTP isteği

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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 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 varsayılan ve tek desteklenen saat dilimi: America/Los_Angeles.
  • HOURLY: Metrikler saatlik aralıklarla toplanır. Varsayılan ve tek desteklenen saat dilimi: UTC.
dimensions[]

string

Metriklerin ayrılacağı 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ı 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:

  • crashRate (google.type.Decimal): Toplama döneminde, en az bir kilitlenme yaşayan farklı kullanıcıların yüzdesi.
  • crashRate7dUserWeighted (google.type.Decimal): Son 7 gündeki hareketli ortalama crashRate 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.
  • crashRate28dUserWeighted (google.type.Decimal): Son 28 gün içindeki hareketli ortalama crashRate 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. HOURLY ayrıntı düzeyinde desteklenmiyor.
  • userPerceivedCrashRate (google.type.Decimal): Toplama döneminde, uygulamanızı etkin olarak kullandıkları sırada en az bir kilitlenme yaşayan farklı kullanıcıların yüzdesi (kullanıcı tarafından algılanan kilitlenme). Herhangi bir etkinlik görüntüleyen veya herhangi bir ön plan hizmeti yürüten uygulamalar etkin kullanımda olarak kabul edilir.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Son 7 gündeki hareketli ortalama userPerceivedCrashRate 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. HOURLY ayrıntı düzeyinde desteklenmiyor.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Son 28 gün içindeki hareketli ortalama userPerceivedCrashRate 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. HOURLY ayrıntı düzeyinde desteklenmiyor.
  • 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ı. Kullanıcı, toplama döneminde uygulamayı etkin bir şekilde kullanmışsa bu metrikte sayılır. Herhangi bir etkinlik görüntüleyen veya herhangi bir ön plan hizmeti yürüten uygulamalar etkin kullanımda olarak kabul edilir. 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

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

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.