Method: vitals.errors.counts.query

Truy vấn các chỉ số trong tập hợp chỉ số.

Yêu cầu HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên tài nguyên.

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "filter": string
}
Trường
timelineSpec

object (TimelineSpec)

Quy cách của các thông số tổng hợp dòng thời gian.

Khoảng thời gian tổng hợp được hỗ trợ:

  • DAILY: các chỉ số được tổng hợp theo khoảng thời gian ngày dương lịch. Múi giờ mặc định và duy nhất được hỗ trợ là America/Los_Angeles.
dimensions[]

string

Phương diện để phân chia dữ liệu.

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

  • apiLevel (string): cấp độ API của Android đang chạy trên thiết bị của người dùng, ví dụ: 26.
  • versionCode (int64): giá trị nhận dạng duy nhất của mẫu thiết bị mà người dùng sử dụng. Mã nhận dạng có dạng "deviceBrand/device", trong đó deviceBrand tương ứng với Build.BRAND và device tương ứng với Build.DEVICE, ví dụ: google/coral.
  • deviceModel (string): giá trị nhận dạng duy nhất của mẫu thiết bị mà người dùng sử dụng.
  • deviceType (string): giá trị nhận dạng kiểu dáng của thiết bị, ví dụ: ĐIỆN THOẠI.
  • reportType (string): loại lỗi. Giá trị này phải tương ứng với một trong các giá trị có thể có trong ErrorType.
  • issueId (string): mã nhận dạng được chỉ định cho một lỗi. Giá trị này phải tương ứng với thành phần {issue} của issue name.
  • deviceRamBucket (int64): RAM của thiết bị, tính bằng MB, theo nhóm (3 GB, 4 GB, v.v.).
  • deviceSocMake (string): Thương hiệu của hệ thống trên vi mạch chính của thiết bị, ví dụ: Samsung. Tài liệu tham khảo
  • deviceSocModel (string): Mẫu hệ thống trên vi mạch chính của thiết bị, ví dụ: "Exynos 2100". Tài liệu tham khảo
  • deviceCpuMake (string): Thương hiệu CPU của thiết bị, ví dụ: Qualcomm.
  • deviceCpuModel (string): Mẫu CPU của thiết bị, ví dụ: "Kryo 240".
  • deviceGpuMake (string): Nhà sản xuất GPU của thiết bị, ví dụ: ARM.
  • deviceGpuModel (string): Mô hình GPU của thiết bị, ví dụ: Mali.
  • deviceGpuVersion (string): Phiên bản GPU của thiết bị, ví dụ: T750.
  • deviceVulkanVersion (string): Phiên bản Vulkan của thiết bị, ví dụ: "4198400".
  • deviceGlEsVersion (string): Phiên bản OpenGL ES của thiết bị, ví dụ: "196610".
  • deviceScreenSize (string): Kích thước màn hình của thiết bị, ví dụ: BÌNH THƯỜNG, LỚN.
  • deviceScreenDpi (string): Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi.
metrics[]

string

Các chỉ số cần tổng hợp.

Các chỉ số được hỗ trợ:

  • errorReportCount (google.type.Decimal): Số lượng tuyệt đối của từng báo cáo lỗi mà ứng dụng đã nhận được.
  • distinctUsers (google.type.Decimal): Số lượng người dùng riêng biệt mà bạn đã nhận được báo cáo. Bạn phải cẩn thận để không tổng hợp thêm số lượt này, vì điều đó có thể khiến người dùng được tính nhiều lần. Giá trị này không được làm tròn, nhưng có thể là giá trị ước tính.
pageSize

integer

Kích thước tối đa của dữ liệu được trả về.

Nếu không chỉ định, tối đa 1.000 hàng sẽ được trả về. Giá trị tối đa là 100000; các giá trị lớn hơn 100000 sẽ được chuyển đổi thành 100000.

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

Bộ lọc để áp dụng cho dữ liệu. Biểu thức lọc tuân theo tiêu chuẩn AIP-160 và hỗ trợ lọc theo sự bình đẳng của tất cả các phương diện phân tích và:

  • isUserPerceived (string): cho biết lỗi có phải do người dùng nhận thấy hay không, USER_PERCEIVED hoặc NOT_USER_PERCEIVED.

Nội dung phản hồi

Lỗi phản hồi truy vấn số lượng.

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

object (MetricsRow)

Số hàng được trả về.

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.