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 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. |"]]