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) ได้ เช่น การเชื่อมคำที่แยกกัน ตัวดำเนินการ OR มีลำดับความสำคัญสูงกว่า AND จึงไม่จำเป็นต้องใช้วงเล็บเมื่อสร้าง CNF

ระบบรองรับโอเปอเรเตอร์ OR เฉพาะการสร้างการแยกที่ใช้กับฟิลด์เดียวกัน เช่น 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)

ข้อผิดพลาดปัญหาที่พบ
nextPageToken

string

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

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

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

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

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