Method: vitals.stuckbackgroundwakelockrate.query

측정항목 세트의 측정항목을 쿼리합니다.

HTTP 요청

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수입니다. 리소스 이름입니다.

형식: apps/{app}/stuckBackgroundWakelockRateMetricSet

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

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

집계할 측정항목입니다.

지원되는 측정항목:

  • stuckBgWakelockRate (google.type.Decimal): 집계 기간에 백그라운드에서 1시간 이상 wakelock이 유지된 순 사용자 비율입니다.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): 지난 7일 동안의 stuckBgWakelockRate 이동 평균 값입니다. 일일 값은 해당 날짜의 순 사용자 수에 따라 가중치가 부여됩니다.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): 지난 28일 동안의 stuckBgWakelockRate 이동 평균 값입니다. 일일 값은 해당 날짜의 순 사용자 수에 따라 가중치가 부여됩니다.
  • distinctUsers (google.type.Decimal): 집계 기간의 순 사용자 수로, stuckBgWakelockRate 측정항목의 정규화 값으로 사용되었습니다. 앱이 기기에서 작업을 수행한 경우(즉, 활성 포그라운드 사용뿐만 아니라 백그라운드 작업도 포함) 사용자가 이 측정항목에 포함됩니다. 사용자가 여러 번 집계될 수 있으므로 이 수치를 더 집계하지 않도록 주의해야 합니다. 값의 크기에 따라 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입니다.

응답 본문

stuckbackgroundwakelockrate.query의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
필드
rows[]

object (MetricsRow)

반환된 데이터 행입니다.
nextPageToken

string

데이터의 다음 페이지를 가져오는 연속 토큰입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/playdeveloperreporting

자세한 내용은 OAuth 2.0 Overview를 참조하세요.