Method: vitals.errors.issues.search

Tìm kiếm tất cả các vấn đề về lỗi mà báo cáo đã được nhóm.

Yêu cầu HTTP

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorIssues: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 các vấn đề về lỗi, cho biết ứng dụng mà bạn nhận được các vấn đề đó.

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

Tham số truy vấn

Thông số
interval

object (DateTimeInterval)

Khoảng thời gian để tìm kiếm các vấn đề về 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 vấn đề về lỗi có báo cáo lỗi liên quan 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 vấn đề lỗi 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, tối đa 50 vấn đề lỗi sẽ được trả về. Giá trị tối đa là 1000; các giá trị lớn hơn 1000 sẽ được chuyển đổi thành 1000.
pageToken

string

Mã thông báo trang nhận được từ một lệnh gọi 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 yêu cầu 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 các vấn đề. Số lượng vấn đề lỗi được trả về sẽ chỉ phản ánh những trường hợp trùng khớp với bộ lọc.

Để 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 vấn đề về 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 vấn đề về 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 vấn đề về 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 vấn đề về 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.
  • appProcessState: So khớp các vấn đề về lỗi ở 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 vấn đề về 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 errorIssueType = ANR không phải là bộ lọc 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)
orderBy

string

Chỉ định một trường sẽ được dùng để sắp xếp kết quả.

** Các phương diện được hỗ trợ:**

  • errorReportCount: Sắp xếp các vấn đề về đơn đặt hàng theo số lượng báo cáo lỗi.
  • distinctUsers: Sắp xếp vấn đề theo số lượng người dùng riêng biệt chịu ảnh hưởng.

** Các thao tác được hỗ trợ:**

  • asc cho thứ tự tăng dần.
  • desc cho thứ tự giảm dần.

Định dạng: Một trường và một thao tác, ví dụ: errorReportCount desc

Lưu ý: mỗi lần chỉ hỗ trợ một trường.
sampleErrorReportLimit

integer

Không bắt buộc. Số lượng báo cáo lỗi mẫu cần trả về cho mỗi ErrorIssue. Nếu bạn không chỉ định, hệ thống sẽ sử dụng giá trị 0. Lưu ý: hiện chỉ hỗ trợ 0 và 1.

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 các vấn đề được phân trang khớp với yêu cầu.

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 
{
  "errorIssues": [
    {
      object (ErrorIssue)
    }
  ],
  "nextPageToken": string
}
Trường
errorIssues[]

object (ErrorIssue)

ErrorIssues that were found.
nextPageToken

string

Mã thông báo tiếp tục để tìm nạp trang dữ liệu 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.