Method: vitals.crashrate.query

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

คำขอ HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อทรัพยากร

รูปแบบ: apps/{app}/crashRateMetricSet

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
ช่อง
timelineSpec

object (TimelineSpec)

ข้อกำหนดของพารามิเตอร์การรวมไทม์ไลน์

ระยะเวลาการรวมที่รองรับ:

  • DAILY: ระบบจะรวบรวมเมตริกตามช่วงวันที่ในปฏิทิน เนื่องจากข้อจำกัดที่ผ่านมา เขตเวลาเริ่มต้นและรองรับเฉพาะเขตเวลา America/Los_Angeles เท่านั้น
  • HOURLY: ระบบจะรวบรวมเมตริกเป็นรายชั่วโมง เขตเวลาเริ่มต้นและรองรับเฉพาะเขตเวลา UTC
dimensions[]

string

มิติข้อมูลที่จะใช้แบ่งเมตริก

มิติข้อมูลที่รองรับ:

  • apiLevel (string): ระดับ API ของ Android ที่ทำงานในอุปกรณ์ของผู้ใช้ เช่น 26.
  • versionCode (int64): เวอร์ชันของแอปที่ทำงานในอุปกรณ์ของผู้ใช้
  • deviceModel (string): ตัวระบุที่ไม่ซ้ำกันสำหรับรุ่นอุปกรณ์ของผู้ใช้ รูปแบบของตัวระบุคือ "deviceBrand/device" โดย deviceBrand ตรงกับ Build.BRAND และอุปกรณ์สอดคล้องกับ Build.DEVICE เช่น google/coral
  • deviceBrand (string): ตัวระบุที่ไม่ซ้ำกันสำหรับแบรนด์อุปกรณ์ของผู้ใช้ เช่น google
  • deviceType (string): ประเภท (หรือที่เรียกว่ารูปแบบของอุปกรณ์) ของอุปกรณ์ของผู้ใช้ เช่น โทรศัพท์
  • countryCode (string): ประเทศหรือภูมิภาคในอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สำหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์ หน่วยเป็น MB ในที่เก็บข้อมูล (3GB, 4GB ฯลฯ)
  • deviceSocMake (string): แบรนด์หลักของระบบวงจรรวมบนชิปของอุปกรณ์ เช่น Samsung ข้อมูลอ้างอิง
  • deviceSocModel (string): รุ่นของระบบหลักบนชิปของอุปกรณ์ เช่น "Exynos 2100" ข้อมูลอ้างอิง
  • deviceCpuMake (string): ยี่ห้อ CPU ของอุปกรณ์ เช่น Qualcomm
  • deviceCpuModel (string): รุ่นของ CPU ของอุปกรณ์ เช่น "Kryo 240"
  • deviceGpuMake (string): ยี่ห้อของ GPU ของอุปกรณ์ เช่น เปิดระบบ
  • deviceGpuModel (string): รุ่น GPU ของอุปกรณ์ เช่น มาลี
  • deviceGpuVersion (string): เวอร์ชัน GPU ของอุปกรณ์ เช่น T750
  • deviceVulkanVersion (string): เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
  • deviceGlEsVersion (string): เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
  • deviceScreenSize (string): ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ขนาดใหญ่
  • deviceScreenDpi (string): ความหนาแน่นของหน้าจออุปกรณ์ เช่น mdpi, hdpi
metrics[]

string

เมตริกที่จะรวม

เมตริกที่รองรับ:

  • crashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวมที่พบการขัดข้องอย่างน้อย 1 ครั้ง
  • crashRate7dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ยต่อเนื่อง crashRate ใน 7 วันที่ผ่านมา ค่ารายวันจะถ่วงน้ำหนักด้วยจำนวนผู้ใช้ที่ไม่ซ้ำกันในแต่ละวัน
  • crashRate28dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ยต่อเนื่อง crashRate ในช่วง 28 วันที่ผ่านมา ค่ารายวันจะถ่วงน้ำหนักด้วยจำนวนผู้ใช้ที่ไม่ซ้ำกันในแต่ละวัน ไม่รองรับแบบละเอียดเป็น HOURLY
  • userPerceivedCrashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำในช่วงเวลาการรวมที่พบการขัดข้องอย่างน้อย 1 ครั้งขณะที่ใช้แอปอยู่ (การขัดข้องที่ผู้ใช้รับรู้) ระบบจะถือว่าแอปอยู่ระหว่างการใช้งานหากแอปแสดงกิจกรรมหรือให้บริการที่ทำงานอยู่เบื้องหน้า
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ยต่อเนื่อง userPerceivedCrashRate ใน 7 วันที่ผ่านมา ค่ารายวันจะถ่วงน้ำหนักด้วยจำนวนผู้ใช้ที่ไม่ซ้ำกันในแต่ละวัน ไม่รองรับแบบละเอียดเป็น HOURLY
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ยต่อเนื่อง userPerceivedCrashRate ในช่วง 28 วันที่ผ่านมา ค่ารายวันจะถ่วงน้ำหนักด้วยจำนวนผู้ใช้ที่ไม่ซ้ำกันในแต่ละวัน ไม่รองรับแบบละเอียดเป็น HOURLY
  • distinctUsers (google.type.Decimal): จํานวนผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวมที่ใช้เป็นค่าการปรับให้เป็นมาตรฐานสำหรับเมตริก crashRate และ userPerceivedCrashRate ระบบจะนับผู้ใช้ในเมตริกนี้หากผู้ใช้ใช้แอปอย่างต่อเนื่องระหว่างระยะเวลาการรวบรวมข้อมูล ระบบจะถือว่าแอปอยู่ระหว่างการใช้งานหากแอปแสดงกิจกรรมหรือให้บริการที่ทำงานอยู่เบื้องหน้า โปรดอย่ารวมจำนวนนี้เพิ่มเติมอย่างรอบคอบ เนื่องจากอาจส่งผลให้ระบบนับผู้ใช้หลายครั้ง ระบบจะปัดเศษค่าเป็นจำนวนทวีคูณที่ใกล้เคียงที่สุดระหว่าง 10, 100, 1,000 หรือ 1,000,000 โดยขึ้นอยู่กับขนาดของค่า
filter

string

ตัวกรองที่จะใช้กับข้อมูล นิพจน์การกรองเป็นไปตามมาตรฐาน AIP-160 และรองรับการกรองตามมิติข้อมูลรายละเอียดทั้งหมดเท่าๆ กัน

pageSize

integer

ขนาดสูงสุดของข้อมูลที่ส่งคืน

หากไม่ระบุ ระบบจะแสดงผลแถวไม่เกิน 1, 000 แถว ค่าสูงสุดคือ 100,000 และค่าที่เกิน 100,000 จะถูกเปลี่ยนให้เป็น 100,000

pageToken

string

โทเค็นหน้าที่ได้รับจากการโทรครั้งก่อน ระบุสิ่งนี้เพื่อเรียกหน้าถัดไป

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุในคำขอต้องตรงกับการเรียกที่ระบุโทเค็นของหน้า

userCohort

enum (UserCohort)

มุมมองผู้ใช้เพื่อเลือก ข้อมูลเอาต์พุตจะสอดคล้องกับข้อมูลพร็อพเพอร์ตี้ที่เลือก

ค่าที่รองรับ

  • OS_PUBLIC เพื่อเลือกข้อมูลจาก Android เวอร์ชันที่เผยแพร่แบบสาธารณะทั้งหมด โดยตัวเลือกนี้คือค่าเริ่มต้น รองรับมิติข้อมูลข้างต้นทั้งหมด
  • APP_TESTERS เพื่อเลือกข้อมูลจากผู้ใช้ที่เลือกรับเป็นผู้ทดสอบ รองรับมิติข้อมูลข้างต้นทั้งหมด
  • OS_BETA หากต้องการเลือกข้อมูลจาก Android เวอร์ชันเบต้าเท่านั้น ให้ยกเว้นข้อมูลจาก Android เวอร์ชันที่เผยแพร่ รองรับเฉพาะมิติข้อมูลต่อไปนี้
  • versionCode (int64): เวอร์ชันของแอปที่ทำงานในอุปกรณ์ของผู้ใช้

  • osBuild (string): บิลด์ของระบบปฏิบัติการของอุปกรณ์ของผู้ใช้ เช่น "T1B2.220916.004"

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ crashrate.query

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
ช่อง
rows[]

object (MetricsRow)

แถวของข้อมูลที่แสดงผล

nextPageToken

string

โทเค็นต่อเนื่องเพื่อดึงข้อมูลหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/playdeveloperreporting

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0