Method: vitals.errors.reports.search

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

คำขอ HTTP

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{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 สามารถใช้สร้างตัวกรองที่ซับซ้อนตามรูปแบบปกติแบบร่วม (Conjunctive Normal Form หรือ 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