Her şeyi ayarladıktan sonra, metrik gruplarıyla ilgili meta verileri almak ve metriklerini sorgulamak için Google Play Developer Reporting API'ye istek gönderebilirsiniz.
Aşağıdaki kod örnekleri, birkaç basit isteğin nasıl gönderileceğini gösterir. Ö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 kümesi meta verilerini alma
Aşağıdaki örnekte, com.example.app kurgusal bir uygulama için ayarlanan kilitlenme oranı metriğinin 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 bilgileri 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 POSTisteği, metrik kümesinden 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 |
Zaman çizelgesi toplama parametrelerinin spesifikasyonu. Desteklenen toplama dönemlerinin listesi için lütfen her metrik grubunun belgelerini inceleyin. |
dimensions[] |
Metriklerin bölüneceği boyutlar. Desteklenen boyutların listesini görmek için lütfen her metrik grubunun belgelerini inceleyin. |
metrics[] |
Toplanacak metrikler. |
pageSize |
Döndürülen verilerin maksimum boyutu. Belirtilmemesi halinde 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ı işleme
Bir sunucu geçerli alanlar içeren geçerli bir istek işledikten sonra, istenen verilerle birlikte HTTP 200 OK durum kodunu geri gönderir. fields sorgu parametresinde bir hata varsa veya başka bir nedenle geçersizse sunucu, kullanıcıya alan seçimiyle ilgili sorunu belirten bir hata mesajıyla birlikte (ör. "Invalid field timeline_spec") HTTP 400 Bad Request durum kodu döndürür.
Yukarıdaki tanıtım bölümünde gösterilen yanıt örneği aşağıda verilmiştir.
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query
Yanıt aşağıdaki gibi olacaktı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ırma için sorgu parametrelerini (ör. maxResults ve nextPageToken) destekleyen API'lerde bu parametreleri kullanarak her sorgunun sonuçlarını yönetilebilir bir boyuta indirebilirsiniz.