Metrik Kümelerini Sorgulama

Her şeyi ayarladıktan sonra, metrik kümeleriyle ilgili meta verileri almak ve metriklerini sorgulamak için Google Play Developer Reporting API'ye istek gönderebilirsiniz.

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

Metrik kümesi meta verilerini alma

Aşağıdaki örnekte, kilitlenme oranı metriği için meta veriler, kurgusal bir uygulama olan com.example.app için alını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 aşağıdaki HTTP POST isteği, metrik kümesi içindeki belirli verileri almak için query uç noktasını kullanı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. Hangi toplama dönemlerinin desteklendiğiyle ilgili bir liste için lütfen her metrik kümesinin dokümanlarını inceleyin.

dimensions[]

string

Metriklerin dilimleneceği boyutlar. Hangi boyutların desteklendiğinin listesi için lütfen her metrik kümesinin belgelerini inceleyin.
metrics[]

string

Toplanacak metrikler.
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.

Yanıtları ele alma

Bir sunucu, geçerli alanlar içeren geçerli bir isteği işledikten sonra istenen verilerle birlikte bir HTTP 200 OK durum kodu gönderir. fields sorgu parametresinde bir hata varsa veya parametre başka bir şekilde geçersizse sunucu, kullanıcının alan seçimiyle ilgili neyin yanlış olduğunu bildiren bir hata mesajıyla birlikte bir HTTP 400 Bad Request durum kodu döndürür (örneğin, "Invalid field timeline_spec").

Yukarıdaki giriş bölümünde gösterilen yanıt örneğini aşağıda 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: Veri sayfalandırması için sorgu parametrelerini destekleyen API'lerde (ör. maxResults ve nextPageToken) her sorgunun sonuçlarını yönetilebilir bir boyuta düşürmek için bu parametreleri kullanın.