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 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 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

POSTPermintaan HTTP 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 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 10.000; nilai di atas 10.000 akan dikonversi menjadi 10.000.

Menangani respons

Setelah server memproses permintaan valid yang menyertakan kolom yang valid, server akan mengirimkan kembali kode status HTTP 200 OK, bersama dengan data yang diminta. Jika parameter kueri fields mengalami error atau tidak valid, server akan menampilkan kode status HTTP 400 Bad Request bersama dengan pesan error yang memberi tahu pengguna tentang masalahnya dengan pemilihan kolom (misalnya, "Invalid field timeline_spec").

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