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: จับคู่รายงานข้อผิดพลาดของประเภทที่ขอเท่านั้น ตัวเลือกที่ถูกต้อง: JAVA_CRASH, NATIVE_CRASH, ANR ตัวอย่างเช่น errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH
  • errorIssueId: จับคู่รายงานข้อผิดพลาดของรหัสปัญหาข้อผิดพลาดที่ขอเท่านั้น ตัวอย่างเช่น errorIssueId = 1234 OR errorIssueId = 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