Method: vitals.crashrate.query
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 |
name |
string
필수 항목입니다. 리소스 이름입니다. 형식: apps/{app}/crashRateMetricSet
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| JSON 표현 |
{
"timelineSpec": {
object (TimelineSpec)
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort)
} |
| 필드 |
timelineSpec |
object (TimelineSpec)
선택사항입니다. 타임라인 집계 매개변수의 사양입니다. 지원되는 집계 기간:
DAILY: 측정항목이 달력 날짜 간격으로 집계됩니다. 기존 제약으로 인해 기본 시간대이자 유일하게 지원되는 시간대는 America/Los_Angeles입니다.HOURLY: 측정항목이 시간별 간격으로 집계됩니다. 기본 시간대이자 유일하게 지원되는 시간대는 UTC입니다.
|
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 모델(예: Mali)deviceGpuVersion(string): 기기의 GPU 버전(예: T750)deviceVulkanVersion(string): 기기의 Vulkan 버전(예: '4198400')deviceGlEsVersion(string): 기기의 OpenGL ES 버전(예: '196610')deviceScreenSize(string): 기기의 화면 크기(예: NORMAL, LARGE)deviceScreenDpi(string): 기기의 화면 밀도(예: mdpi, hdpi)
|
metrics[] |
string
선택사항입니다. 집계할 측정항목입니다. 지원되는 측정항목:
crashRate (google.type.Decimal): 집계 기간에 비정상 종료를 한 번 이상 경험한 순 사용자의 비율입니다.crashRate7dUserWeighted (google.type.Decimal): 지난 7일간의 crashRate 이동 평균 값입니다. 일일 값은 해당 일의 순 사용자 수로 가중치가 부여됩니다.crashRate28dUserWeighted (google.type.Decimal): 지난 28일간의 crashRate 이동 평균 값입니다. 일일 값은 해당 일의 순 사용자 수로 가중치가 부여됩니다. HOURLY 세부사항에서는 지원되지 않습니다.userPerceivedCrashRate (google.type.Decimal): 집계 기간에 앱을 활발히 사용하는 동안 비정상 종료 (사용자 인식 비정상 종료)를 한 번 이상 경험한 순 사용자의 비율입니다. 앱은 활동을 표시하거나 포그라운드 서비스를 실행하는 경우 활성 사용 상태로 간주됩니다.userPerceivedCrashRate7dUserWeighted (google.type.Decimal): 지난 7일간의 userPerceivedCrashRate 이동 평균 값입니다. 일일 값은 해당 일의 순 사용자 수로 가중치가 부여됩니다. HOURLY 세부사항에서는 지원되지 않습니다.userPerceivedCrashRate28dUserWeighted (google.type.Decimal): 지난 28일간의 userPerceivedCrashRate 이동 평균 값입니다. 일일 값은 해당 일의 순 사용자 수로 가중치가 부여됩니다. HOURLY 세부사항에서는 지원되지 않습니다.distinctUsers (google.type.Decimal): 집계 기간에 crashRate 및 userPerceivedCrashRate 측정항목의 정규화 값으로 사용된 순 사용자 수입니다. 사용자가 집계 기간에 앱을 활발히 사용한 경우 이 측정항목에 사용자가 집계됩니다. 앱은 활동을 표시하거나 포그라운드 서비스를 실행하는 경우 활성 사용 상태로 간주됩니다. 이 개수는 사용자가 여러 번 집계될 수 있으므로 추가로 집계하지 않도록 주의해야 합니다. 값의 크기에 따라 가장 가까운 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)
선택사항입니다. 선택할 사용자 뷰입니다. 출력 데이터는 선택한 뷰에 해당합니다. 지원 값:
|
응답 본문
crashrate.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 계열사의 등록 상표입니다.
최종 업데이트: 2026-04-22(UTC)
[null,null,["최종 업데이트: 2026-04-22(UTC)"],[],["This document details how to query crash rate metrics using a POST request to `https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query`. The request requires a `name` path parameter. The request body specifies `timelineSpec`, `dimensions` (e.g., `apiLevel`, `deviceModel`), `metrics` (e.g., `crashRate`, `distinctUsers`), optional `filter`, `pageSize`, `pageToken`, and `userCohort`. The response contains `rows` of metric data and a `nextPageToken` for pagination. Requires OAuth scope `https://www.googleapis.com/auth/playdeveloperreporting`.\n"]]