Method: vitals.errors.counts.query
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
name |
string
필수입니다. 리소스 이름입니다. 형식: apps/{app}/errorCountMetricSet
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"timelineSpec": {
object (TimelineSpec )
},
"dimensions": [
string
],
"metrics": [
string
],
"pageSize": integer,
"pageToken": string,
"filter": string
} |
필드 |
timelineSpec |
object (TimelineSpec )
타임라인 집계 매개변수의 사양입니다. 지원되는 집계 기간:
DAILY : 측정항목이 캘린더 날짜 간격으로 집계됩니다. 기본적으로 지원되는 유일한 시간대는 America/Los_Angeles 입니다.
|
dimensions[] |
string
데이터를 분류할 측정기준입니다. 지원되는 측정기준:
apiLevel (string ): 사용자 기기에서 실행된 Android의 API 수준입니다(예: 26.
versionCode (int64 ): 사용자 기기 모델의 고유 식별자입니다. 식별자 형식은 'deviceBrand/device'입니다. 여기서 deviceBrand는 Build.BRAND에 해당하고 device는 Build.DEVICE에 해당합니다(예: google/coral).
deviceModel (string ): 사용자 기기 모델의 고유 식별자입니다.
deviceType (string ): 기기 폼 팩터의 식별자입니다(예: PHONE.
reportType (string ): 오류 유형입니다. 값은 ErrorType 의 가능한 값 중 하나에 상응해야 합니다.
issueId (string ): 오류가 할당된 ID입니다. 값은 issue name 의 {issue} 구성요소에 상응해야 합니다.
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
집계할 측정항목입니다. 지원되는 측정항목:
errorReportCount (google.type.Decimal ): 앱에 대해 수신된 개별 오류 보고서의 절대 수입니다.
distinctUsers (google.type.Decimal ): 보고서가 수신된 순 사용자의 수입니다. 사용자가 여러 번 집계될 수 있으므로 이 수치를 더 집계하지 않도록 주의해야 합니다. 이 값은 반올림되지 않지만 근사치일 수 있습니다.
|
pageSize |
integer
반환된 데이터의 최대 크기입니다. 지정하지 않으면 최대 1, 000개의 행이 반환됩니다. 최댓값은 100,000이며, 100,000을 초과하는 값은 100,000으로 변환됩니다.
|
pageToken |
string
이전 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 요청에 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.
|
filter |
string
데이터에 적용할 필터입니다. 필터링 표현식은 AIP-160 표준을 따르며 모든 분류 측정기준의 동일성으로 필터링을 지원합니다.
isUserPerceived (string ): 오류가 사용자에게 인식되는지 여부를 나타냅니다(USER_PERCEIVED 또는 NOT_USER_PERCEIVED).
|
응답 본문
오류 개수를 쿼리 응답합니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
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 error count metrics within a specified app and timeframe, allowing for filtering and aggregation by various dimensions.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes a POST request to \u003ccode\u003ehttps://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query\u003c/code\u003e with the app's resource name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires a request body specifying the timeline, dimensions, metrics, and optional filtering criteria for the query.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes rows of aggregated metrics data and a token for pagination if necessary.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization necessitates the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This outlines querying metrics from a metric set via a `POST` request to a specified URL, utilizing gRPC Transcoding. The request requires a `name` path parameter and a body containing `timelineSpec`, `dimensions`, and `metrics` for data aggregation. Optional parameters include `pageSize`, `pageToken`, and `filter`. The response returns rows of metric data and a `nextPageToken` for pagination, with results being filtered by specified dimensions and metrics. Authorization requires the `playdeveloperreporting` OAuth scope.\n"],null,[]]