Method: vitals.excessivewakeuprate.query
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/excessiveWakeupRateMetricSet}:query
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
必需。资源名称。 格式:apps/{app}/excessiveWakeupRateMetricSet
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"timelineSpec": {
object (TimelineSpec )
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort )
} |
字段 |
timelineSpec |
object (TimelineSpec )
时间轴聚合参数的规范。 支持的汇总周期:
DAILY :指标按日历日期间隔进行汇总。由于历史限制,唯一支持的时区是 America/Los_Angeles 。
|
dimensions[] |
string
用于细分数据的维度。 支持的维度:
apiLevel (string ):用户设备上运行的 Android API 级别,例如 26.
versionCode (int64 ):用户设备上运行的应用版本。
deviceModel (string ):用户设备型号的唯一标识符。标识符的格式为“deviceBrand/device”,其中 deviceBrand 对应于 Build.BRAND,device 对应于 Build.DEVICE,例如 google/coral。
deviceBrand (string ):用户设备品牌的唯一标识符,例如 google。
deviceType (string ):用户设备的类型(也称为设备规格),例如 PHONE。
countryCode (string ):用户设备的国家/地区(根据其 IP 地址确定),以 2 字母 ISO-3166 代码表示(例如,美国为“US”)。
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
要聚合的指标。 支持的指标:
excessiveWakeupRate (google.type.Decimal ):汇总期内每小时唤醒次数超过 10 次的不同用户所占的百分比。
excessiveWakeupRate7dUserWeighted (google.type.Decimal ):过去 7 天内 excessiveWakeupRate 的滚动平均值。每日值会根据当天的唯一身份用户数进行加权。
excessiveWakeupRate28dUserWeighted (google.type.Decimal ):过去 28 天内 excessiveWakeupRate 的滚动平均值。每日值会根据当天的唯一身份用户数进行加权。
distinctUsers (google.type.Decimal ):汇总周期内作为 excessiveWakeupRate 指标的归一化值的不同用户数。如果用户的应用在设备上执行任何工作(即不仅是活跃的前台使用,还包括后台工作),则该用户会计入此指标。请务必注意,不要进一步汇总此数量,否则可能会导致用户被多次统计。该值会舍入为最接近的 10、100、1,000 或 1,000,000 的倍数,具体取决于该值的大小。
|
filter |
string
要应用于数据的过滤条件。过滤表达式遵循 AIP-160 标准,并支持按所有细分维度的相等性进行过滤。
|
pageSize |
integer
返回的数据的大小上限。 如果未指定,则最多返回 1, 000 行。最大值为 100000;大于 100000 的值会强制转换为 100000。
|
pageToken |
string
从之前的调用接收的页面令牌。利用其进行后续页面检索。 进行分页时,提供给请求的所有其他参数必须与提供页面令牌的调用相一致。
|
userCohort |
enum (UserCohort )
要选择的用户视图。输出数据将与所选视图相对应。唯一支持的值是 OS_PUBLIC 。
|
响应正文
excessivewakeuprate.query
的响应消息。
如果成功,响应正文将包含结构如下的数据:
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 Excessive Wakeup Rate metrics for your app, providing insights into wakeups per hour for distinct users.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by dimensions like API level, version code, device model, country, and more.\u003c/p\u003e\n"],["\u003cp\u003eAggregates metrics such as excessive wakeup rate, daily and rolling averages, and distinct user counts.\u003c/p\u003e\n"],["\u003cp\u003eSupports data slicing by dimensions and filtering using the AIP-160 standard for granular analysis.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,[]]