REST Resource: vitals.errors.reports
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: ErrorReport
앱에 대해 수신된 오류 보고서입니다.
이러한 보고서는 심각한 오류 조건이 감지될 때 Android 플랫폼 코드에 의해 생성됩니다. 여러 사용자의 동일한 신고는 중복 제거되고 하나의 ErrorReport로 통합됩니다.
필요한 권한: 이 리소스에 액세스하려면 호출 사용자에게 앱에 대한 앱 정보 보기 (읽기 전용) 권한이 있어야 합니다.
JSON 표현 |
{
"name": string,
"type": enum (ErrorType ),
"reportText": string,
"issue": string,
"eventTime": string,
"deviceModel": {
object (DeviceModelSummary )
},
"osVersion": {
object (OsVersion )
},
"appVersion": {
object (AppVersion )
},
"vcsInformation": string
} |
필드 |
name |
string
보고서의 리소스 이름입니다. 형식: apps/{app}/{report}
|
type |
enum (ErrorType )
이 보고서가 생성된 오류의 유형입니다.
|
reportText |
string
오류 보고서의 텍스트 표현입니다. 이러한 텍스트 보고서는 플랫폼에서 생성됩니다. 그런 다음 보고서가 정리되고 필터링되어 잠재적으로 민감한 정보가 삭제됩니다. 형식이 비교적 안정적이지만 완전히 머신 소비를 위한 것은 아니며 보고서에서 정보를 파싱하려는 시스템을 중단할 수 있는 미묘한 형식 변경이 없을 것이라고 보장할 수 없습니다.
|
issue |
string
이 보고서와 연결된 문제입니다. 참고: 이 리소스는 현재 알파 버전입니다. 문제 그룹화가 변경되어 유사하지만 더 최근의 오류 보고서가 다른 문제에 할당될 수 있습니다.
|
eventTime |
string (Timestamp format)
이 오류 보고서의 최신 이벤트가 발생한 시간의 시작입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30" 입니다.
|
deviceModel |
object (DeviceModelSummary )
이 오류 보고서의 이벤트가 발생한 기기 모델입니다.
|
osVersion |
object (OsVersion )
이 오류 보고서의 이벤트가 발생한 OS 버전입니다.
|
appVersion |
object (AppVersion )
이 오류 보고서의 이벤트가 발생한 앱 버전입니다.
|
vcsInformation |
string
App Bundle 또는 APK의 BUNDLE-METADATA/version-control-info.textproto 또는 META-INF/version-control-info.textproto에서 가져온 버전 관리 시스템 정보입니다.
|
DeviceModelSummary
JSON 표현 |
{
"deviceId": {
object (DeviceId )
},
"marketingName": string,
"deviceUri": string
} |
필드 |
deviceId |
object (DeviceId )
기기의 식별자입니다.
|
marketingName |
string
기기의 표시 이름입니다.
|
deviceUri |
string
Play 기기 카탈로그의 기기 링크입니다.
|
DeviceId
JSON 표현 |
{
"buildBrand": string,
"buildDevice": string
} |
필드 |
buildBrand |
string
Build.BRAND 값입니다.
|
buildDevice |
string
Build.DEVICE 값입니다.
|
메서드 |
|
앱에 대해 수신된 모든 오류 보고서를 검색합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eErrorReport resources provide insights into potentially fatal errors detected in Android apps, including details like the error type, time, and device information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need \u003cem\u003eView app information (read-only)\u003c/em\u003e permission to access ErrorReports and can use the search method to find reports for a specific app.\u003c/p\u003e\n"],["\u003cp\u003eErrorReports include summaries of the device model and OS version associated with the error, aiding in identifying problematic device configurations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eissue\u003c/code\u003e field links reports to specific known problems but is in Alpha and subject to change as the grouping logic evolves.\u003c/p\u003e\n"],["\u003cp\u003eDevice information is provided through DeviceId and DeviceModelSummary objects, detailing the device brand, model, and marketing name.\u003c/p\u003e\n"]]],["The provided content outlines the structure and details of `ErrorReport` resources, which are generated by the Android platform upon detecting app errors. Key information includes the error `type`, `reportText`, associated `issue`, `eventTime`, and the `deviceModel`, `osVersion`, and `appVersion` involved. The `DeviceModelSummary` details a device's `deviceId`, `marketingName`, and a link to the device. `DeviceId` contains `buildBrand` and `buildDevice`. `ErrorReport` resources are searchable, but require *View app information* permission.\n"],null,["# REST Resource: vitals.errors.reports\n\n- [Resource: ErrorReport](#ErrorReport)\n - [JSON representation](#ErrorReport.SCHEMA_REPRESENTATION)\n- [DeviceModelSummary](#DeviceModelSummary)\n - [JSON representation](#DeviceModelSummary.SCHEMA_REPRESENTATION)\n- [DeviceId](#DeviceId)\n - [JSON representation](#DeviceId.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ErrorReport\n---------------------\n\nAn error report received for an app.\n\nThere reports are produced by the Android platform code when a (potentially fatal) error condition is detected. Identical reports from many users will be deduplicated and coalesced into a single ErrorReport.\n\n**Required permissions** : to access this resource, the calling user needs the *View app information (read-only)* permission for the app.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"type\": enum (/play/developer/reporting/reference/rest/v1beta1/ErrorType), \"reportText\": string, \"issue\": string, \"eventTime\": string, \"deviceModel\": { object (/play/developer/reporting/reference/rest/v1beta1/vitals.errors.reports#DeviceModelSummary) }, \"osVersion\": { object (/play/developer/reporting/reference/rest/v1beta1/OsVersion) }, \"appVersion\": { object (/play/developer/reporting/reference/rest/v1beta1/AppVersion) }, \"vcsInformation\": string } ``` |\n\n| Fields ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name of the report. Format: apps/{app}/{report} |\n| `type` | `enum (`[ErrorType](/play/developer/reporting/reference/rest/v1beta1/ErrorType)`)` Type of the error for which this report was generated. |\n| `reportText` | `string` Textual representation of the error report. These textual reports are produced by the platform. The reports are then sanitized and filtered to remove any potentially sensitive information. Although their format is fairly stable, they are not entirely meant for machine consumption and we cannot guarantee that there won't be subtle changes to the formatting that may break systems trying to parse information out of the reports. |\n| `issue` | `string` The issue this report was associated with. **Please note:** this resource is currently in Alpha. There could be changes to the issue grouping that would result in similar but more recent error reports being assigned to a different issue. |\n| `eventTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Start of the hour during which the latest event in this error report occurred. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `deviceModel` | `object (`[DeviceModelSummary](/play/developer/reporting/reference/rest/v1beta1/vitals.errors.reports#DeviceModelSummary)`)` A device model on which an event in this error report occurred on. |\n| `osVersion` | `object (`[OsVersion](/play/developer/reporting/reference/rest/v1beta1/OsVersion)`)` The OS version on which an event in this error report occurred on. |\n| `appVersion` | `object (`[AppVersion](/play/developer/reporting/reference/rest/v1beta1/AppVersion)`)` The app version on which an event in this error report occurred on. |\n| `vcsInformation` | `string` Version control system information from BUNDLE-METADATA/version-control-info.textproto or META-INF/version-control-info.textproto of the app bundle or APK, respectively. |\n\nDeviceModelSummary\n------------------\n\nSummary of a device\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deviceId\": { object (/play/developer/reporting/reference/rest/v1beta1/vitals.errors.reports#DeviceId) }, \"marketingName\": string, \"deviceUri\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceId` | `object (`[DeviceId](/play/developer/reporting/reference/rest/v1beta1/vitals.errors.reports#DeviceId)`)` Identifier of the device. |\n| `marketingName` | `string` Display name of the device. |\n| `deviceUri` | `string` Link to the device in Play Device Catalog. |\n\nDeviceId\n--------\n\nIdentifier of a device.\n\n| JSON representation |\n|---------------------------------------------------------|\n| ``` { \"buildBrand\": string, \"buildDevice\": string } ``` |\n\n| Fields ||\n|---------------|---------------------------------|\n| `buildBrand` | `string` Value of Build.BRAND. |\n| `buildDevice` | `string` Value of Build.DEVICE. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|-------------------------------------------------|\n| ### [search](/play/developer/reporting/reference/rest/v1beta1/vitals.errors.reports/search) | Searches all error reports received for an app. |"]]