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