Method: vitals.errors.issues.search

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

Yêu cầu HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{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 đơn đăng ký mà các lỗi đó đã nhận được.

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

Tham số truy vấn

Thông số
interval

object (DateTimeInterval)

Khoảng thời gian ngày cho các vấn đề về lỗi tìm kiếm. Cả điểm bắt đầu và kết thúc đều phải 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 này, UTC cũng sẽ được sử dụng).

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

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, 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ị buộc thành 1000.

pageToken

string

Mã thông báo trang, nhận được từ cuộc 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 thông 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 thuộc tính lựa chọn để chỉ truy xuất một nhóm nhỏ vấn đề. Số lượng 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ề tính năng lọc, vui lòng xem AIP-160.

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

  • apiLevel: Chỉ so khớp các vấn đề 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 đề 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: So khớp các vấn đề lỗi xảy ra trên các thiết bị được yêu cầu. Ví dụ: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: So khớp các vấn đề 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: So khớp các vấn đề lỗi xảy ra trên 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 đề lỗi thuộc loại được yêu cầu. Ứng viên hợp lệ: CRASH, ANR. Ví dụ: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: So khớp các vấn đề lỗi trên trạng thái xử lý của một ứng dụng, cho biết ứng dụng đó chạy ở nền trước (người dùng nhìn thấy) hay nền. Ứng viên hợp lệ: FOREGROUND, BACKGROUND. Ví dụ: appProcessState = FOREGROUND.
  • isUserPerceived: So khớp các vấn đề về lỗi mà người dùng nhận thấy. Không đi kèm với bất kỳ toán tử nào. Ví dụ: isUserPerceived.

** 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ử so sánh bằng. Trường đã lọc phải xuất hiện ở bên trái phép so sánh.
  • Toán tử logic: Bạn có thể dùng các toán tử logic ANDOR để tạo các bộ lọc phức tạp theo dạng chuẩn liên kết (CNF), tức là liên từ phân tách. Toán tử OR được ưu tiên hơn AND, vì vậy, bạn không cần sử dụng dấu ngoặc đơn khi tạo CNF.

Toán tử OR chỉ được hỗ trợ để tạo các phân 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: Vấn đề về đơn đặt hàng theo số lượng báo cáo lỗi.
  • distinctUsers: Vấn đề về đơn đặt hàng theo số lượng người dùng riêng biệt bị ả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 toán tử, ví dụ: errorReportCount desc

Lưu ý: hiện tại mỗi lần chúng tôi chỉ hỗ trợ một trường.

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
}
Các trường
errorIssues[]

object (ErrorIssue)

Đã tìm thấy các vấn đề lỗi.

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 Tổng quan về OAuth 2.0.