Method: vitals.slowrenderingrate.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/*/slowRenderingRateMetricSet}: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}/slowRenderingRateMetricSet

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
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Trường
timelineSpec

object (TimelineSpec)

Không bắt buộc. Thông số kỹ thuật của 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. Do các hạn chế trước đây, múi giờ 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): phiên bản của ứng dụng đang chạy trên thiết bị của người dùng.
  • deviceModel (string): giá trị nhận dạng riêng biệt của kiểu thiết bị của người dùng. Giá trị nhận dạng có dạng "thương hiệu thiết bị/thiết bị", trong đó thương hiệu thiết bị tương ứng với Build.BRAND và thiết bị tương ứng với Build.DEVICE, ví dụ: google/coral.
  • deviceBrand (string): giá trị nhận dạng riêng biệt của thương hiệu thiết bị của người dùng, ví dụ: google.
  • deviceType (string): loại (còn gọi là hệ số hình thức) của thiết bị của người dùng, ví dụ: PHONE.
  • countryCode (string): quốc gia hoặc khu vực của thiết bị của người dùng dựa trên địa chỉ IP của họ, được biểu thị dưới dạng mã ISO-3166 gồm 2 chữ cái (ví dụ: US cho Hoa Kỳ).
  • 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 trên chip chính 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ợ:

  • slowRenderingRate20Fps (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp có tốc độ kết xuất chậm.
  • slowRenderingRate20Fps7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của slowRenderingRate20Fps trong 7 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày.
  • slowRenderingRate20Fps28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của slowRenderingRate20Fps trong 28 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày.
  • slowRenderingRate30Fps (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp có tốc độ kết xuất chậm.
  • slowRenderingRate30Fps7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của slowRenderingRate30Fps trong 7 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày.
  • slowRenderingRate30Fps28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của slowRenderingRate30Fps trong 28 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày.
  • distinctUsers (google.type.Decimal): Số lượng người dùng riêng biệt trong khoảng thời gian tổng hợp được dùng làm giá trị chuẩn hoá cho chỉ số slowRenderingRate20Fps/slowRenderingRate30Fps. Một người dùng được tính vào chỉ số này nếu ứng dụng của họ được khởi chạy trong thiết bị. 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ể khiến người dùng bị tính nhiều lần. Giá trị được làm tròn đến bội số gần nhất của 10, 100, 1.000 hoặc 1.000.000, tuỳ thuộc vào độ lớn của giá trị.
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 tiêu chuẩn 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.

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, tối đa 1.000 hàng sẽ được trả về. 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 đó. 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.

userCohort

enum (UserCohort)

Không bắt buộc. Chế độ xem người dùng để chọn. Dữ liệu đầu ra sẽ tương ứng với chế độ xem đã chọn. Giá trị được hỗ trợ duy nhất là OS_PUBLIC.

Nội dung phản hồi

Thông báo phản hồi cho slowrenderingrate.query.

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 dữ liệu đượ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ông tin khác, hãy xem OAuth 2.0 Overview.