Metrik Kümelerini Sorgulama

Her şeyi ayarladıktan sonra Google Play Developer Reporting API'ye istek göndererek metrik gruplarıyla ilgili meta verileri alabilir ve metriklerini sorgulayabilirsiniz.

Aşağıdaki kod örneklerinde birkaç basit isteğin nasıl gönderileceği gösterilmektedir. Örneğin, aşağıdaki yöntemler uygulamanız için çeşitli metrikleri nasıl alacağınızı gösterir. Sorgunuzu daraltmak için kullanılabilecek birkaç farklı sorgu parametresi vardır.

Metrik grubu meta verileri alınıyor

Aşağıdaki örnekte, kurgusal bir uygulama olan com.example.app için kilitlenme oranı metrik grubunun meta verileri alınmaktadır.

Basit istek:

Bu HTTP GET isteği, uygulama adı parametresini belirtir ve uygulamanızla ilişkili tam metrik kaynağını döndürür.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet

Metrik bilgisi yanıtı:

Yanıt, metrik grubuyla ilgili aşağıdaki alanları içerir:

{
  "freshness_info": {
    "freshness": [
      "aggregation_period": "DAILY"
      "latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
    ]
  }
}

Sorgu özelliğini kullanma

Aynı kaynak için yapılan aşağıdaki HTTP POSTisteğinde, metrik grubundan belirli verileri almak için query uç noktası kullanılmıştır.

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

İstek gövdesinde, belirli ölçütlere göre metrikleri almak için sorgu seçeneklerini iletin.

{
  "timeline_spec": {
    "aggregation_period": "DAILY"
    "start_time": { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
    "end_time": { year: "2021" month: "7" day: "3" time_zone: "America/Los_Angeles" }
   }
  "dimensions": ["apiLevel"]
  "metrics": ["errorReportCount", "distinctUsers"]
  "page_size": "10"
}

Aşağıda, koleksiyon düzeyinde bazı örnekler verilmiştir:

Alanlar
timelineSpec	object (TimelineSpec) Zaman çizelgesi toplama parametrelerinin belirtilmesi. Desteklenen toplama dönemlerinin listesi için lütfen her metrik grubunun belgelerini inceleyin.
dimensions[]	string Metriklerin dilimleneceği boyutlar. Desteklenen boyutların listesi için lütfen her metrik grubunun belgelerini inceleyin.
metrics[]	string Toplanacak metrikler.
pageSize	integer Döndürülen verilerin maksimum boyutu. Belirtilmezse en fazla 1.000 satır döndürülür. Maksimum değer 10.000'dir. 10.000'in üzerindeki değerler 10.000'e zorlanır.

Yanıtları işleme

Sunucu, geçerli alanlar içeren geçerli bir isteği işledikten sonra istenen verilerle birlikte HTTP 200 OK durum kodunu döndürür. fields sorgu parametresinde bir hata varsa veya parametre herhangi bir şekilde geçersizse sunucu, HTTP 400 Bad Request durum koduyla birlikte, kullanıcıya alan seçimiyle ilgili neyin yanlış olduğunu açıklayan bir hata mesajı döndürür (ör. "Invalid field timeline_spec").

Yukarıdaki giriş bölümünde gösterilen yanıt örneğini burada bulabilirsiniz.

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

Yanıt şu şekilde görünür:

200 OK

{
  rows: [
    {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "20"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "100"},
        {metric: "distinctUsers" decimal_value: "57"},
      ]
    }, {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "21"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "123"},
        {metric: "distinctUsers" decimal_value: "65"},
      ]
    },
    ...
  ]
  next_page_token: "eW91IGhhdmUgdG9vIG11Y2ggZnJlZSB0aW1l"
}

Not: Verilerin sayfalara ayrılması için sorgu parametrelerini (ör. maxResults ve nextPageToken) destekleyen API'lerde, her sorgunun sonuçlarını yönetilebilir bir boyuta indirmek için bu parametreleri kullanın.