Method: vitals.excessivewakeuprate.query
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/excessiveWakeupRateMetricSet}:query
URL은 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 ): 기기의 화면 크기입니다(예: 보통, 대형
deviceScreenDpi (string ): 기기의 화면 밀도(예: mdpi, hdpi)
|
metrics[] |
string
집계할 측정항목입니다. 지원되는 측정항목:
excessiveWakeupRate (google.type.Decimal ): 집계 기간에 시간당 10회가 넘는 wakeup이 발생한 순 사용자 비율입니다.
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개의 행이 반환됩니다. 최댓값은 100,000이며, 100,000을 초과하는 값은 100,000으로 변환됩니다.
|
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를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\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,[]]