Method: vitals.errors.counts.query
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/errorCountMetricSet}:query
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
必需。资源名称。 格式:apps/{app}/errorCountMetricSet
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"timelineSpec": {
object (TimelineSpec )
},
"dimensions": [
string
],
"metrics": [
string
],
"pageSize": integer,
"pageToken": string,
"filter": string
} |
字段 |
timelineSpec |
object (TimelineSpec )
时间轴聚合参数的规范。 支持的汇总周期:
DAILY :指标按日历日期间隔进行汇总。默认时区也是唯一受支持的时区是 America/Los_Angeles 。
|
dimensions[] |
string
用于细分数据的维度。 支持的维度:
apiLevel (string ):用户设备上运行的 Android API 级别,例如 26.
versionCode (int64 ):用户设备型号的唯一标识符。标识符的格式为“deviceBrand/device”,其中 deviceBrand 对应于 Build.BRAND,device 对应于 Build.DEVICE,例如 google/coral。
deviceModel (string ):用户设备型号的唯一标识符。
deviceType (string ):设备的外形规格标识符,例如 PHONE。
reportType (string ):错误类型。该值应与 ErrorType 中的某个可能值相对应。
issueId (string ):分配给错误的 ID。该值应与 issue name 的 {issue} 部分相对应。
deviceRamBucket (int64 ):设备的 RAM,以 MB 为单位,以分桶方式表示(3GB、4GB 等)。
deviceSocMake (string ):设备主芯片组的制造商,例如 Samsung。参考文档
deviceSocModel (string ):设备主芯片的型号,例如 “Exynos 2100”。参考文档
deviceCpuMake (string ):设备 CPU 的品牌,例如 Qualcomm。
deviceCpuModel (string ):设备 CPU 的型号,例如 “Kryo 240”。
deviceGpuMake (string ):设备 GPU 的制造商,例如 ARM。
deviceGpuModel (string ):设备的 GPU 型号,例如 马里。
deviceGpuVersion (string ):设备的 GPU 版本,例如 T750。
deviceVulkanVersion (string ):设备的 Vulkan 版本,例如 “4198400”。
deviceGlEsVersion (string ):设备的 OpenGL ES 版本,例如 “196610”。
deviceScreenSize (string ):设备的屏幕尺寸,例如 NORMAL、LARGE。
deviceScreenDpi (string ):设备的屏幕密度,例如 mdpi、hdpi。
|
metrics[] |
string
要聚合的指标。 支持的指标:
errorReportCount (google.type.Decimal ):针对某个应用收到的各个错误报告的绝对数量。
distinctUsers (google.type.Decimal ):已收到报告的不同用户的数量。请务必注意,不要进一步汇总此数量,否则可能会导致用户被多次统计。此值不会舍入,但可能只是一个近似值。
|
pageSize |
integer
返回的数据的大小上限。 如果未指定,则最多返回 1, 000 行。最大值为 100000;大于 100000 的值会强制转换为 100000。
|
pageToken |
string
从之前的调用接收的页面令牌。利用其进行后续页面检索。 进行分页时,提供给请求的所有其他参数必须与提供页面令牌的调用相一致。
|
filter |
string
要应用于数据的过滤条件。过滤表达式遵循 AIP-160 标准,支持按所有细分维度的相等性进行过滤,还支持:
isUserPerceived (string ):表示错误是否为用户感知到的错误,取值为 USER_PERCEIVED 或 NOT_USER_PERCEIVED。
|
响应正文
错误计数查询响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"rows": [
{
object (MetricsRow )
}
],
"nextPageToken": string
} |
字段 |
rows[] |
object (MetricsRow )
返回的行数。
|
nextPageToken |
string
用于获取下一页数据的延续令牌。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/playdeveloperreporting
如需了解详情,请参阅 OAuth 2.0 Overview。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eQueries error count metrics within a specified app and timeframe using flexible filtering and aggregation options.\u003c/p\u003e\n"],["\u003cp\u003eAllows specification of data slices via dimensions like API level, device model, error type, and more.\u003c/p\u003e\n"],["\u003cp\u003eSupports aggregation of key metrics including error report count and distinct users affected.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results, enabling retrieval of large datasets, and provides a continuation token for subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details querying metrics in a metric set via a POST request to a specific URL. The request requires a `name` path parameter and accepts a JSON body with fields like `timelineSpec`, `dimensions`, `metrics`, `pageSize`, `pageToken`, and `filter`. The response body includes `rows` of data and a `nextPageToken` for pagination. Authorization requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope. The request allows filtering and specifies supported dimensions and metrics.\n"],null,[]]