Method: vitals.errors.reports.search

ค้นหารายงานข้อผิดพลาดทั้งหมดที่ได้รับสำหรับแอป

คำขอ HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search

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

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

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

string

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

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

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

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

object (DateTimeInterval)

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

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

integer

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

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

string

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

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุไว้ใน reports.search ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ
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
  • errorIssueId: แสดงผลเฉพาะรายงานข้อผิดพลาดที่เป็นของรหัสปัญหาข้อผิดพลาดที่ขอ ตัวอย่าง: errorIssueId = 1234 OR errorIssueId = 4567
  • errorReportId: แสดงผลเฉพาะรายงานข้อผิดพลาดที่มีรหัสรายงานข้อผิดพลาดที่ขอ ตัวอย่าง: errorReportId = 1234 OR errorReportId = 4567
  • appProcessState: แสดงผลรายงานข้อผิดพลาดเกี่ยวกับสถานะกระบวนการของแอป ซึ่งระบุว่าแอปทำงานอยู่เบื้องหน้า (ผู้ใช้มองเห็นได้) หรือเบื้องหลัง ค่าที่ใช้ได้: FOREGROUND, BACKGROUND ตัวอย่าง: appProcessState = FOREGROUND
  • isUserPerceived: แสดงผลรายงานข้อผิดพลาดที่ผู้ใช้รับรู้ โดยไม่มีโอเปอเรเตอร์ใดๆ ตัวอย่าง: isUserPerceived

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

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

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

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

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

เนื้อความของคำขอ

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

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

การตอบกลับพร้อมรายการรายงานข้อผิดพลาดแบบแบ่งหน้าซึ่งตรงกับคำค้นหา

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

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

object (ErrorReport)

รายงานข้อผิดพลาดที่พบ
nextPageToken

string

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

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

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

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

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