Mengkueri Set Metrik

Setelah menyiapkan semuanya, Anda dapat mengirim permintaan ke Google Play Developer Reporting API untuk mengambil metadata tentang set metrik dan mengkueri 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 berbeda yang dapat digunakan untuk mempersempit kueri Anda.

Mengambil metadata set metrik

Contoh berikut mengambil metadata untuk set 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:

Respons mencakup kolom berikut yang terkait dengan set 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

Di 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 beberapa contoh tingkat koleksi:

Kolom
timelineSpec	object (TimelineSpec) Spesifikasi parameter agregasi linimasa. Periksa dokumentasi setiap set metrik untuk mengetahui daftar periode agregasi yang didukung.
dimensions[]	string Dimensi untuk mengelompokkan metrik. Periksa dokumentasi setiap set metrik untuk mengetahui daftar dimensi yang didukung.
metrics[]	string Metrik yang akan digabungkan.
pageSize	integer Ukuran maksimum data yang ditampilkan. Jika tidak ditentukan, paling banyak 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 menyertakan kolom valid, server akan mengirimkan kembali kode status HTTP 200 OK, beserta data yang diminta. Jika parameter kueri fields mengalami 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 kolom mereka (misalnya, "Invalid field timeline_spec").

Berikut adalah contoh respons yang ditampilkan di bagian pendahuluan 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 setiap kueri ke ukuran yang dapat dikelola.