Method: vitals.errors.reports.search

Tìm kiếm tất cả báo cáo lỗi nhận được cho một ứng dụng.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Tài nguyên mẹ của báo cáo, cho biết ứng dụng mà báo cáo được nhận.

Định dạng: apps/{app}

Tham số truy vấn

Thông số
interval

object (DateTimeInterval)

Khoảng thời gian ngày giờ để tìm kiếm báo cáo lỗi. Cả thời gian bắt đầu và thời gian kết thúc đều phải được căn chỉnh theo giờ và sử dụng UTC làm múi giờ (hoặc để trống, trong trường hợp đó, UTC cũng sẽ được sử dụng).

Nếu được đặt, chỉ những báo cáo lỗi xảy ra trong khoảng thời gian đó mới được trả về. Nếu bạn không chỉ định, hệ thống sẽ sử dụng khoảng thời gian mặc định là 24 giờ qua.

pageSize

integer

Số lượng báo cáo tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này.

Nếu không chỉ định, hệ thống sẽ trả về tối đa 50 báo cáo. Giá trị tối đa là 100; các giá trị lớn hơn 100 sẽ được chuyển đổi thành 100.

pageToken

string

Mã thông báo trang nhận được từ một lệnh gọi reports.search trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho reports.search phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

filter

string

Một vị từ lựa chọn để chỉ truy xuất một tập hợp con của báo cáo.

Để biết thông tin cơ bản về việc lọc, vui lòng xem AIP-160.

** Tên trường được hỗ trợ:

  • apiLevel: Chỉ khớp với các báo cáo lỗi xảy ra trong các phiên bản Android được yêu cầu (được chỉ định là cấp độ API dạng số). Ví dụ: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Chỉ so khớp các báo cáo lỗi xảy ra trong mã phiên bản ứng dụng được yêu cầu. Ví dụ: versionCode = 123 OR versionCode = 456.
  • deviceModel: Trùng khớp với các vấn đề về lỗi xảy ra trong các thiết bị được yêu cầu. Ví dụ: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: Trùng khớp với các vấn đề về lỗi xảy ra ở các thương hiệu thiết bị được yêu cầu. Ví dụ: `deviceBrand = "Google".
  • deviceType: Trùng khớp với các báo cáo lỗi xảy ra ở các loại thiết bị được yêu cầu. Ví dụ: deviceType = "PHONE".
  • errorIssueType: Chỉ so khớp các báo cáo lỗi thuộc loại được yêu cầu. Các ứng viên hợp lệ: CRASH, ANR, NON_FATAL. Ví dụ: errorIssueType = CRASH OR errorIssueType = ANR.
  • errorIssueId: Chỉ so khớp các báo cáo lỗi thuộc mã vấn đề lỗi được yêu cầu. Ví dụ: errorIssueId = 1234 OR errorIssueId = 4567.
  • errorReportId: So khớp báo cáo lỗi với mã báo cáo lỗi được yêu cầu. Ví dụ: errorReportId = 1234 OR errorReportId = 4567.
  • appProcessState: So khớp các báo cáo lỗi về trạng thái quy trình của một ứng dụng, cho biết liệu ứng dụng có chạy ở nền trước (người dùng nhìn thấy) hay nền sau. Ứng viên hợp lệ: FOREGROUND, BACKGROUND. Ví dụ: appProcessState = FOREGROUND.
  • isUserPerceived: Trùng khớp với các báo cáo lỗi mà người dùng nhận thấy. Không có toán tử nào đi kèm. Ví dụ: isUserPerceived.

** Các toán tử được hỗ trợ:**

  • Toán tử so sánh: Toán tử so sánh duy nhất được hỗ trợ là toán tử bằng. Trường được lọc phải xuất hiện ở bên trái của phép so sánh.
  • Toán tử logic: Bạn có thể dùng toán tử logic ANDOR để tạo bộ lọc phức tạp theo dạng chuẩn kết hợp (CNF), tức là phép tuyển chọn của phép tuyển chọn. Toán tử OR có mức độ ưu tiên cao hơn AND nên bạn không cần dùng dấu ngoặc đơn khi tạo CNF.

Toán tử OR chỉ được hỗ trợ để tạo các phép tách biệt áp dụng cho cùng một trường, ví dụ: versionCode = 123 OR versionCode = ANR. Biểu thức bộ lọc versionCode = 123 OR errorIssueType = ANR không hợp lệ.

** Ví dụ **

Một số biểu thức lọc hợp lệ: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi bằng danh sách báo cáo lỗi phân trang khớp với cụm từ tìm kiếm.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
Trường
errorReports[]

object (ErrorReport)

Các báo cáo lỗi đã tìm thấy.

nextPageToken

string

Mã thông báo trang để tìm nạp trang báo cáo tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.