การค้นหาชุดเมตริก

หลังจากที่ตั้งค่าทุกอย่างแล้ว คุณสามารถส่งคําขอไปยัง Google Play Developer Reporting API เพื่อเรียกข้อมูลเมตาเกี่ยวกับชุดเมตริกและค้นหาเมตริกของเมตริกได้

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีส่งคําขอแบบง่าย 2-3 รายการ เช่น วิธีการด้านล่างแสดงวิธีเรียกข้อมูลเมตริกต่างๆ สําหรับแอป มีพารามิเตอร์การค้นหาต่างๆ ที่ใช้เพื่อจํากัดการค้นหาให้แคบลงได้

กําลังเรียกข้อมูลเมตาชุดเมตริก

ตัวอย่างต่อไปนี้จะเรียกข้อมูลเมตาสําหรับเมตริกอัตราการขัดข้องที่ตั้งไว้สําหรับแอปพลิเคชันในนิยาย com.example.app

คําของ่ายๆ

คําขอ HTTP GET นี้ระบุพารามิเตอร์ชื่อแอปพลิเคชันและแสดงผลทรัพยากรเมตริกแบบเต็มที่เชื่อมโยงกับแอปพลิเคชัน

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet

การตอบสนองต่อข้อมูลเมตริก:

การตอบกลับประกอบด้วยช่องต่อไปนี้ที่เกี่ยวข้องกับชุดเมตริก

{
  "freshness_info": {
    "freshness": [
      "aggregation_period": "DAILY"
      "latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
    ]
  }
}

การใช้ฟีเจอร์การค้นหา

คําขอ HTTP POSTต่อไปนี้สําหรับทรัพยากรเดียวกันนี้ใช้ปลายทาง query เพื่อดึงข้อมูลที่ต้องการจากชุดเมตริก

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

ในเนื้อหาคําขอ ให้ส่งตัวเลือกคําค้นหาเพื่อเรียกเมตริกตามเกณฑ์ที่ระบุ

{
  "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"
}

ตัวอย่างระดับคอลเล็กชันมีดังนี้

ช่อง
timelineSpec	object (TimelineSpec) ข้อกําหนดของพารามิเตอร์การรวมไทม์ไลน์ โปรดดูเอกสารประกอบเกี่ยวกับชุดเมตริกแต่ละชุดเพื่อดูรายการระยะเวลาการรวม
dimensions[]	string มิติข้อมูลสําหรับแบ่งเมตริก โปรดดูเอกสารเกี่ยวกับมิติข้อมูลที่รองรับในชุดเอกสารของชุดเมตริกแต่ละชุด
metrics[]	string เมตริกที่จะรวม
pageSize	integer ขนาดสูงสุดของข้อมูลที่แสดงผล หากไม่ระบุ ระบบจะแสดงผลไม่เกิน 1, 000 แถว ค่าสูงสุดคือ 100,000 ส่วนค่าที่มากกว่า 100,000 จะถูกบังคับให้เป็น 100,000

การจัดการคําตอบ

หลังจากที่เซิร์ฟเวอร์ประมวลผลคําขอที่ถูกต้องที่มีช่องที่ถูกต้องแล้ว เซิร์ฟเวอร์จะส่งรหัสสถานะ HTTP 200 OK กลับมาพร้อมกับข้อมูลที่ขอ หากพารามิเตอร์การค้นหา fields มีข้อผิดพลาดหรือไม่ถูกต้อง เซิร์ฟเวอร์จะแสดงรหัสสถานะ HTTP 400 Bad Request พร้อมกับข้อความแสดงข้อผิดพลาดที่บอกให้ผู้ใช้ทราบว่าช่องที่เลือกมีอะไรผิดพลาด (เช่น "Invalid field timeline_spec")

ต่อไปนี้เป็นตัวอย่างคําตอบที่แสดงในส่วนบทนํา

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

การตอบกลับจะมีลักษณะดังนี้

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

หมายเหตุ: สําหรับ API ที่รองรับพารามิเตอร์การค้นหาสําหรับการใส่เลขหน้าข้อมูล (เช่น maxResults และ nextPageToken) ให้ใช้พารามิเตอร์เหล่านั้นเพื่อลดผลลัพธ์ของการค้นหาแต่ละรายการเป็นขนาดที่จัดการได้