Method: vitals.errors.issues.search

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

คำขอ HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{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 ตัวอย่างเช่น 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 ช่องเท่านั้น

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

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

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

ตอบกลับด้วยรายการปัญหาที่ใส่เลขหน้าซึ่งตรงกับคำขอ

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

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

object (ErrorIssue)

พบปัญหาข้อผิดพลาด

nextPageToken

string

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

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

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

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

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