Setelah menyiapkan semuanya, Anda dapat mengirim permintaan ke Google Play Developer Reporting API untuk mengambil metadata tentang kumpulan metrik dan membuat kueri metriknya.
Contoh kode berikut menunjukkan cara mengirim beberapa permintaan sederhana. Misalnya, metode di bawah menunjukkan cara mengambil berbagai metrik untuk aplikasi Anda. Ada beberapa parameter kueri yang dapat digunakan untuk mempersempit kueri Anda.
Mengambil metadata kumpulan metrik
Contoh berikut mengambil metadata untuk metrik rasio error yang ditetapkan untuk aplikasi fiktif, com.example.app.
Permintaan sederhana:
Permintaan GET HTTP ini menentukan parameter nama aplikasi dan menampilkan resource metrik lengkap yang terkait dengan aplikasi Anda.
GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet
Respons info metrik:
Responsnya mencakup kolom berikut yang terkait dengan kumpulan metrik:
{
"freshness_info": {
"freshness": [
"aggregation_period": "DAILY"
"latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
]
}
}
Menggunakan fitur kueri
Permintaan HTTP POST berikut untuk resource yang sama ini menggunakan endpoint query untuk mengambil data tertentu dari dalam set metrik.
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query
Dalam isi permintaan, teruskan opsi kueri untuk mengambil metrik berdasarkan kriteria tertentu.
{
"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"
}
Berikut adalah beberapa contoh tingkat koleksi:
| Kolom | |
|---|---|
timelineSpec |
Spesifikasi parameter agregasi linimasa. Periksa dokumentasi setiap kumpulan metrik untuk mengetahui daftar periode agregasi yang didukung. |
dimensions[] |
Dimensi untuk mengelompokkan metrik. Periksa dokumentasi setiap kumpulan metrik untuk mengetahui daftar dimensi apa yang didukung. |
metrics[] |
Metrik yang akan digabungkan. |
pageSize |
Ukuran maksimum data yang ditampilkan. Jika tidak ditentukan, maksimum 1.000 baris akan ditampilkan. Nilai maksimum adalah 100.000; nilai di atas 100.000 akan dikonversi menjadi 100.000. |
Menangani respons
Setelah server memproses permintaan valid yang mencakup kolom yang valid, server akan mengirimkan kembali kode status 200 OK HTTP, beserta data yang diminta. Jika parameter kueri fields memiliki error atau tidak valid, server akan menampilkan kode status HTTP 400 Bad Request, beserta pesan error yang memberi tahu pengguna apa yang salah dengan pemilihan kolomnya (misalnya, "Invalid field timeline_spec").
Berikut adalah contoh respons yang ditampilkan pada bagian pengantar di atas.
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query
Responsnya akan terlihat seperti ini:
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"
}
Catatan: Untuk API yang mendukung parameter kueri untuk penomoran halaman data (misalnya maxResults
dan nextPageToken), gunakan parameter tersebut untuk mengurangi hasil dari setiap
kueri ke ukuran yang dapat dikelola.