Method: vitals.errors.reports.search

string

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

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

object (DateTimeInterval)

Không bắt buộc. Khoảng thời gian ngày để 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 đó, hệ thống cũng sẽ sử dụng UTC).

Nếu bạn đặt, hệ thống sẽ chỉ trả về các báo cáo lỗi xảy ra trong khoảng thời gian đó. 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.

integer

Không bắt buộc. 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 bạn 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ị trên 100 sẽ bị ép thành 100.

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi reports.search trước đó. Cung cấp mã 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.

string

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

Để biết thông tin cơ bản về cách lọc, vui lòng kiểm tra 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 bằng số). Ví dụ: apiLevel = 28 OR apiLevel = 29.
• versionCode: Chỉ khớp với 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: 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: Khớp với các vấn đề về lỗi xảy ra trong các thương hiệu thiết bị được yêu cầu. Ví dụ: `deviceBrand = "Google".
• deviceType: Khớp với các báo cáo lỗi xảy ra trong các loại thiết bị được yêu cầu. Ví dụ: deviceType = "PHONE".
• errorIssueType: Chỉ khớp với các báo cáo lỗi thuộc cá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ỉ khớp với các báo cáo lỗi thuộc mã vấn đề về lỗi được yêu cầu. Ví dụ: errorIssueId = 1234 OR errorIssueId = 4567.
• errorReportId: Khớp với các báo cáo lỗi có mã báo cáo lỗi được yêu cầu. Ví dụ: errorReportId = 1234 OR errorReportId = 4567.
• appProcessState: Khớp với 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 một ứng dụng có chạy ở nền trước (người dùng nhìn thấy) hay nền sau. Các ứng viên hợp lệ: FOREGROUND, BACKGROUND. Ví dụ: appProcessState = FOREGROUND.
• isUserPerceived: Khớp với các báo cáo lỗi mà người dùng nhận thấy. Trường này không đi kèm với bất kỳ toán tử nào. 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 ở phía bên trái của phép so sánh.
• Toán tử logic: Bạn có thể sử dụng toán tử logic AND và OR để xây dựng các bộ lọc phức tạp theo dạng chuẩn liên hợp (CNF), tức là các liên kết của phép tuyển. Toán tử OR có mức độ ưu tiên cao hơn AND nên bạn không cần sử dụng dấu ngoặc đơn khi xây dựng CNF.

Toán tử OR chỉ được hỗ trợ để xây dựng các phép tuyển á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)