REST Resource: vitals.errors.reports
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
リソース: ErrorReport
アプリで受信したエラーレポート。
これらのレポートは、Android プラットフォーム コードによって、致命的なエラー状態が検出されたときに生成されます。多くのユーザーから同じレポートが送信された場合、重複排除が行われ、1 つの 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)
このエラーレポートの最新のイベントが発生した時間の開始時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「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
Google Play デバイス カタログのデバイスへのリンク。
|
DeviceId
JSON 表現 |
{
"buildBrand": string,
"buildDevice": string
} |
フィールド |
buildBrand |
string
Build.BRAND の値。
|
buildDevice |
string
Build.DEVICE の値。
|
メソッド |
|
アプリで受信したすべてのエラー レポートを検索します。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\u003cp\u003eErrorReport resource provides details on errors detected within an Android app, including the error type, a textual description, the time of occurrence, and associated device and app information.\u003c/p\u003e\n"],["\u003cp\u003eError reports from multiple users encountering the same error are combined into a single ErrorReport for analysis.\u003c/p\u003e\n"],["\u003cp\u003eDeviceModelSummary encapsulates information about the device on which an error occurred, like its identifier, marketing name, and a Play Device Catalog link.\u003c/p\u003e\n"],["\u003cp\u003eDeviceId uniquely identifies a device based on its build brand and device properties.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the \u003ccode\u003esearch\u003c/code\u003e method to retrieve and analyze error reports for their app.\u003c/p\u003e\n"]]],["Error reports detail app errors, coalescing identical reports. Access requires *View app information* permission. Key data includes error `type`, `reportText`, associated `issue`, `eventTime`, and device/OS/app versions. Reports are linked to `DeviceModelSummary`, featuring `deviceId`, `marketingName`, and `deviceUri`. The device is identified by `buildBrand` and `buildDevice`. A search method is available to view all reports received for an app.\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/v1alpha1/ErrorType), \"reportText\": string, \"issue\": string, \"eventTime\": string, \"deviceModel\": { object (/play/developer/reporting/reference/rest/v1alpha1/vitals.errors.reports#DeviceModelSummary) }, \"osVersion\": { object (/play/developer/reporting/reference/rest/v1alpha1/OsVersion) }, \"appVersion\": { object (/play/developer/reporting/reference/rest/v1alpha1/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/v1alpha1/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/v1alpha1/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/v1alpha1/OsVersion)`)` The OS version on which an event in this error report occurred on. |\n| `appVersion` | `object (`[AppVersion](/play/developer/reporting/reference/rest/v1alpha1/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/v1alpha1/vitals.errors.reports#DeviceId) }, \"marketingName\": string, \"deviceUri\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceId` | `object (`[DeviceId](/play/developer/reporting/reference/rest/v1alpha1/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/v1alpha1/vitals.errors.reports/search) | Searches all error reports received for an app. |"]]