Method: vitals.errors.reports.search
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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
AND và OR để 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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eSearches all error reports received for a specific application within a specified timeframe.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by various criteria, such as Android version, app version code, device model, and error type.\u003c/p\u003e\n"],["\u003cp\u003eReturns a paginated list of error reports matching the search query, including details about each error.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines how to search for app error reports via an HTTP GET request to `https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search`. The `parent` path parameter specifies the app. Query parameters include `interval` for date ranges, `pageSize` for report limits (max 100), `pageToken` for pagination, and `filter` for narrowing results by criteria like `apiLevel`, `versionCode`, or `errorIssueType`. The request body is empty, and the response body contains a paginated list of `errorReports` and a `nextPageToken`.\n"],null,[]]