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)
จุดเริ่มต้นของชั่วโมงที่เกิดเหตุการณ์ล่าสุดในรายงานข้อผิดพลาดนี้ ใช้ 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)
เวอร์ชันของระบบปฏิบัติการที่เกิดเหตุการณ์ในรายงานข้อผิดพลาดนี้
|
appVersion |
object (AppVersion)
เวอร์ชันแอปที่เกิดเหตุการณ์ในรายงานข้อผิดพลาดนี้
|
vcsInformation |
string
ข้อมูลระบบควบคุมเวอร์ชันจาก BUNDLE-METADATA/version-control-info.textproto หรือ META-INF/version-control-info.textproto ของ App Bundle หรือ APK ตามลำดับ
|
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
|
เมธอด |
|
|
ค้นหารายงานข้อผิดพลาดทั้งหมดที่ได้รับสำหรับแอป |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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. |"]]
