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 lại.

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

Tham 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à các vấn đề về lỗi được nhận.

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

Tham số truy vấn

Tham số
interval

object (DateTimeInterval)

Không bắt buộc. Khoảng thời gian ngày giờ để 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 bạn đặt chính sách này, hệ thống sẽ chỉ trả về các vấn đề về lỗi có báo cáo lỗi được liên kết 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.
pageSize

integer

Không bắt buộc. Số lượng tối đa các vấn đề về lỗi 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 vấn đề về lỗi. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ bị ép buộc thành 1000.
pageToken

string

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

Không bắt buộc. Một vị từ lựa chọn để chỉ truy xuất một nhóm con các vấn đề. Số lượt đếm trong các vấn đề về lỗi được trả về sẽ chỉ phản ánh những lần xuất hiện khớp với bộ lọc.

Để biết thông tin cơ bản về việc 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 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 bằng số). Ví dụ: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Chỉ khớp với 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: 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 vấn đề về 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 vấn đề về 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.
  • appProcessState: Khớp với các vấn đề về lỗi trên 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 vấn đề về 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 nhau. 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 các 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 kết (CNF), tức là các liên kết của các 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 errorIssueType = ANR không phải là một 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

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

** Các tham số được hỗ trợ:**

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

** 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 ý: hiện tại, 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 tại, hệ thống chỉ hỗ trợ giá 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 phân trang các vấn đề 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 đã tìm thấy.
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ông tin khác, hãy xem OAuth 2.0 Overview.