Method: vitals.anrrate.query
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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/*/anrRateMetricSet}: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}/anrRateMetricSet
|
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
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort )
} |
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. Do các hạn chế trước đây, múi giờ mặc định và duy nhất được hỗ trợ là America/Los_Angeles .
HOURLY : các chỉ số được tổng hợp theo khoảng thời gian tính theo giờ. Múi giờ mặc định và duy nhất được hỗ trợ là UTC .
|
dimensions[] |
string
Các phương diện để phân chia chỉ số. 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 ứ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 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.
deviceBrand (string ): giá trị nhận dạng duy nhấ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à kiểu dáng) thiết bị của người dùng, ví dụ: ĐIỆN THOẠI.
countryCode (string ): quốc gia hoặc khu vực của thiết bị mà người dùng đang sử 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 ): 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ợ:
anrRate (google.type.Decimal ): Tỷ lệ phần trăm số người dùng riêng biệt trong khoảng thời gian tổng hợp gặp phải ít nhất một lỗi ANR.
anrRate7dUserWeighted (google.type.Decimal ): Giá trị trung bình luân phiên của anrRate 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. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
anrRate28dUserWeighted (google.type.Decimal ): Giá trị trung bình luân phiên của anrRate 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. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
userPerceivedAnrRate (google.type.Decimal ): Tỷ lệ phần trăm số người dùng riêng biệt trong khoảng thời gian tổng hợp gặp phải ít nhất một lỗi ANR mà người dùng nhận thấy. Lỗi ANR mà người dùng nhận thấy hiện là lỗi thuộc loại "Gửi dữ liệu đầu vào".
userPerceivedAnrRate7dUserWeighted (google.type.Decimal ): Giá trị trung bình luân phiên của userPerceivedAnrRate 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. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal ): Giá trị trung bình luân phiên của userPerceivedAnrRate 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. Không . được hỗ trợ ở mức độ chi tiết THEO GIỜ.
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 các chỉ số anrRate và userPerceivedAnrRate . Một người dùng được tính vào chỉ số này nếu họ sử dụng ứng dụng ở nền trước trong khoảng thời gian tổng hợp. Bạn không được tổng hợp thêm số lượt này vì có thể khiến người dùng được 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
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.
|
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à 100.000; các giá trị lớn hơn 100.000 sẽ được chuyển đổi thành 100.000.
|
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.
|
userCohort |
enum (UserCohort )
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ợ:
|
Nội dung phản hồi
Thông báo phản hồi cho anrrate.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êm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eQueries ANR metrics within a specified timeframe, sliced by dimensions like API level, device model, and country.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering data based on dimension equality and supports pagination for large datasets.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe request body accepts parameters for timeline specification, dimensions, metrics, filter, and more to refine the query.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides rows of data corresponding to the requested metrics and dimensions, along with a pagination token for accessing further results.\u003c/p\u003e\n"]]],["This outlines how to query metrics for ANR (Application Not Responding) rates. A `POST` request is made to a specific URL, with the app's resource name provided as a path parameter. The request body specifies parameters including `timelineSpec`, `dimensions`, `metrics`, `filter`, `pageSize`, `pageToken`, and `userCohort` to customize the query. The `userCohort` parameter allows you to query `OS_PUBLIC`, `APP_TESTERS` and `OS_BETA` user data. The response contains `rows` of metric data and a `nextPageToken` for pagination.\n"],null,[]]