Method: vitals.errors.issues.search

ค้นหาปัญหาข้อผิดพลาดทั้งหมดที่มีการจัดกลุ่มรายงาน

คำขอ HTTP

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorIssues:search

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

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

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

string

ต้องระบุ ทรัพยากรหลักของปัญหาข้อผิดพลาด ซึ่งระบุแอปพลิเคชันที่ได้รับปัญหาข้อผิดพลาด

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

พารามิเตอร์การค้นหา

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

object (DateTimeInterval)

ไม่บังคับ ช่วงวันที่และเวลาที่จะค้นหาปัญหาข้อผิดพลาด ทั้งวันที่เริ่มต้นและวันที่สิ้นสุดต้องตรงกับชั่วโมงและใช้ UTC เป็นเขตเวลา (หรือว่างเปล่า ในกรณีนี้ระบบจะใช้ UTC ด้วย)

หากตั้งค่าไว้ ระบบจะแสดงผลเฉพาะปัญหาข้อผิดพลาดที่มีรายงานข้อผิดพลาดที่เกี่ยวข้องซึ่งเกิดขึ้นในช่วงเวลาดังกล่าว หากไม่ระบุ ระบบจะใช้ช่วงเวลาเริ่มต้นเป็น 24 ชั่วโมงที่ผ่านมา
pageSize

integer

ไม่บังคับ จำนวนปัญหาข้อผิดพลาดสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้

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

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป

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

string

ไม่บังคับ เพรดิเคตการเลือกเพื่อดึงข้อมูลเฉพาะชุดย่อยของปัญหา จำนวนในปัญหาข้อผิดพลาดที่แสดงผลจะแสดงเฉพาะเหตุการณ์ที่ตรงกับตัวกรอง

โปรดดูข้อมูลพื้นฐานเกี่ยวกับการกรองได้ที่ AIP-160

** ชื่อฟิลด์ที่รองรับ**

  • apiLevel: ตรงกับปัญหาข้อผิดพลาดที่เกิดขึ้นใน Android เวอร์ชันที่ขอ (ระบุเป็นระดับ API ตัวเลข) เท่านั้น ตัวอย่าง: apiLevel = 28 OR apiLevel = 29
  • versionCode: ตรงกับปัญหาข้อผิดพลาดที่เกิดขึ้นในรหัสเวอร์ชันของแอปที่ขอเท่านั้น ตัวอย่าง: versionCode = 123 OR versionCode = 456
  • deviceModel: ตรงกับปัญหาข้อผิดพลาดที่เกิดขึ้นในอุปกรณ์ที่ขอ ตัวอย่าง: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: ตรงกับปัญหาข้อผิดพลาดที่เกิดขึ้นในยี่ห้ออุปกรณ์ที่ขอ ตัวอย่าง: `deviceBrand = "Google"
  • deviceType: ตรงกับปัญหาข้อผิดพลาดที่เกิดขึ้นในประเภทอุปกรณ์ที่ขอ ตัวอย่าง: deviceType = "PHONE"
  • errorIssueType: ตรงกับปัญหาข้อผิดพลาดประเภทที่ขอเท่านั้น ค่าที่ใช้ได้: CRASH, ANR, NON_FATAL ตัวอย่าง: errorIssueType = CRASH OR errorIssueType = ANR
  • appProcessState: ตรงกับปัญหาข้อผิดพลาดในสถานะกระบวนการของแอป ซึ่งบ่งบอกว่าแอปทำงานอยู่เบื้องหน้า (ผู้ใช้มองเห็นได้) หรือเบื้องหลัง ค่าที่ใช้ได้: FOREGROUND, BACKGROUND ตัวอย่าง: appProcessState = FOREGROUND
  • isUserPerceived: ตรงกับปัญหาข้อผิดพลาดที่ผู้ใช้รับรู้ โดยไม่มีโอเปอเรเตอร์ใดๆ ตัวอย่าง: isUserPerceived

** โอเปอเรเตอร์ที่รองรับ**

  • โอเปอเรเตอร์การเปรียบเทียบ: โอเปอเรเตอร์การเปรียบเทียบที่รองรับมีเพียงความเท่ากันเท่านั้น ฟิลด์ที่กรองต้องปรากฏทางด้านซ้ายของการเปรียบเทียบ
  • โอเปอเรเตอร์ตรรกะ: คุณใช้โอเปอเรเตอร์ตรรกะ AND และ OR เพื่อสร้างตัวกรองที่ซับซ้อนตามรูปแบบปกติแบบเชื่อม (CNF) ได้ เช่น การเชื่อมของ disjunction โอเปอเรเตอร์ OR มีลำดับความสำคัญสูงกว่า AND จึงไม่จำเป็นต้องใช้วงเล็บเมื่อสร้าง CNF

ระบบรองรับโอเปอเรเตอร์ OR เพื่อสร้าง disjunction ที่ใช้กับฟิลด์เดียวกันเท่านั้น เช่น versionCode = 123 OR errorIssueType = ANR ไม่ใช่ตัวกรองที่ถูกต้อง

** ตัวอย่าง **

นิพจน์การกรองที่ถูกต้องบางส่วนมีดังนี้ * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)
orderBy

string

ไม่บังคับ ระบุฟิลด์ที่จะใช้ในการจัดลำดับผลลัพธ์

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

  • errorReportCount: จัดลำดับปัญหาตามจำนวนรายงานข้อผิดพลาด
  • distinctUsers: จัดลำดับปัญหาตามจำนวนผู้ใช้ที่ไม่ซ้ำกันที่ได้รับผลกระทบ

** การดำเนินการที่รองรับ**

  • asc สำหรับการจัดลำดับจากน้อยไปมาก
  • desc สำหรับการจัดลำดับจากมากไปน้อย

รูปแบบ: ฟิลด์และการดำเนินการ เช่น errorReportCount desc

หมายเหตุ: ปัจจุบันรองรับเพียง 1 ฟิลด์ต่อครั้ง
sampleErrorReportLimit

integer

ไม่บังคับ จำนวนรายงานข้อผิดพลาดตัวอย่างที่จะแสดงผลต่อ ErrorIssue หากไม่ระบุ ระบบจะใช้ 0 หมายเหตุ: ปัจจุบันรองรับเฉพาะ 0 และ 1

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

เนื้อหาของคำขอต้องว่างเปล่า

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

การตอบกลับพร้อมรายการปัญหาที่ตรงกับคำขอแบบแบ่งหน้า

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

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

object (ErrorIssue)

ErrorIssue ที่พบ
nextPageToken

string

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview