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에 해당하고 기기는 Build.DEVICE(예: google/coral)에 해당합니다.
  • deviceBrand(string): 사용자 기기 브랜드의 고유 식별자입니다(예: google).
  • deviceType(string): 사용자 기기의 유형(폼 팩터라고도 함)입니다(예: 휴대전화를 탭합니다.
  • countryCode (string): IP 주소를 기준으로 한 사용자 기기의 국가 또는 지역으로, 2자리 ISO-3166 코드로 표시됩니다 (예: 미국의 경우 US).
  • deviceRamBucket(int64): 기기의 RAM(MB), 버킷 단위(3GB, 4GB 등)입니다.
  • deviceSocMake(string): 기기의 기본 온칩 시스템(예: 삼성 참조
  • 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): 집계 기간에 백그라운드에 wakelock이 1시간 넘게 유지된 고유 사용자의 비율입니다.
  • 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 공개적으로 출시된 모든 Android 버전의 데이터를 선택합니다. 이는 기본값입니다. 위의 모든 측정기준을 지원합니다.
  • APP_TESTERS 테스터가 되기로 선택한 사용자의 데이터를 선택합니다. 위의 모든 측정기준을 지원합니다.
  • OS_BETA 출시된 Android 버전의 데이터를 제외하고 베타 Android 버전의 데이터만 선택합니다. 다음 측정기준만 지원됩니다.
  • versionCode (int64): 사용자 기기에서 실행 중이었던 앱의 버전입니다.

  • osBuild (string): 사용자 기기의 OS 빌드입니다. 예: 'T1B2.220916.004'.

응답 본문

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

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

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

object (MetricsRow)

반환된 데이터 행입니다.

nextPageToken

string

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

승인 범위

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

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.