หลังจากที่ตั้งค่าทุกอย่างแล้ว คุณสามารถส่งคําขอไปยัง 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 |
ข้อกําหนดของพารามิเตอร์การรวมไทม์ไลน์ โปรดดูเอกสารประกอบเกี่ยวกับชุดเมตริกแต่ละชุดเพื่อดูรายการระยะเวลาการรวม |
dimensions[] |
มิติข้อมูลสําหรับแบ่งเมตริก โปรดดูเอกสารเกี่ยวกับมิติข้อมูลที่รองรับในชุดเอกสารของชุดเมตริกแต่ละชุด |
metrics[] |
เมตริกที่จะรวม |
pageSize |
ขนาดสูงสุดของข้อมูลที่แสดงผล หากไม่ระบุ ระบบจะแสดงผลไม่เกิน 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) ให้ใช้พารามิเตอร์เหล่านั้นเพื่อลดผลลัพธ์ของการค้นหาแต่ละรายการเป็นขนาดที่จัดการได้