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/v1beta1/{name=apps/*/errorCountMetricSet}:query

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

Tham số đường dẫn

Tham 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 với 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)

Không bắt buộc. Quy cách về các tham 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

Không bắt buộc. Các phương diện để phân đoạn 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): mã nhận dạng duy nhất của kiểu thiết bị của người dùng. Định dạng của mã nhận dạng là "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): mã nhận dạng duy nhất của kiểu thiết bị của người dùng.
  • deviceType (string): mã nhận dạng của hệ số hình thức của thiết bị, ví dụ: PHONE.
  • 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 gán 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): Nhà sản xuất hệ thống chính trên chip của thiết bị, ví dụ: Samsung. Tham khảo
  • deviceSocModel (string): Kiểu hệ thống trên chip chính của thiết bị, ví dụ: "Exynos 2100". Tham khảo
  • deviceCpuMake (string): Nhà sản xuất CPU của thiết bị, ví dụ: Qualcomm.
  • deviceCpuModel (string): Kiể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): Kiểu 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ụ: NORMAL, LARGE.
  • deviceScreenDpi (string): Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi.
metrics[]

string

Không bắt buộc. 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 các báo cáo lỗi riêng lẻ đã nhận được cho một ứng dụng.
  • distinctUsers (google.type.Decimal): Số lượng người dùng riêng biệt mà báo cáo đã được nhận. Bạn phải cẩn thận để không tổng hợp thêm số lượng này, vì điều đó có thể dẫn đến việc người dùng bị tính nhiều lần. Giá trị này không được làm tròn, nhưng có thể là giá trị gần đúng.
pageSize

integer

Không bắt buộc. Kích thước tối đa của dữ liệu được trả về.

Nếu không chỉ định, hệ thống sẽ trả về tối đa 1.000 hàng. Giá trị tối đa là 100.000; các giá trị trên 100.000 sẽ bị ép buộc thành 100.000.

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 đó. Hãy 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. Các bộ lọc cần áp dụng cho dữ liệu. Biểu thức bộ lọc tuân theo AIP-160 và hỗ trợ lọc theo sự bằng nhau 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 là lỗi mà 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

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

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)

Các 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.