REST Resource: vitals.errors.reports
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: ErrorReport
Nhận được báo cáo lỗi cho một ứng dụng.
Các báo cáo này được tạo ra bởi mã nền tảng Android khi phát hiện thấy một điều kiện lỗi (có thể gây ra lỗi nghiêm trọng). Các báo cáo giống hệt nhau của nhiều người dùng sẽ được loại bỏ trùng lặp và hợp nhất thành một ErrorReport duy nhất.
Quyền bắt buộc: để truy cập vào tài nguyên này, người dùng gọi cần có quyền Xem thông tin ứng dụng (chỉ có thể đọc) cho ứng dụng.
Biểu diễn dưới dạng JSON |
{
"name": string,
"type": enum (ErrorType ),
"reportText": string,
"issue": string,
"eventTime": string,
"deviceModel": {
object (DeviceModelSummary )
},
"osVersion": {
object (OsVersion )
},
"appVersion": {
object (AppVersion )
},
"vcsInformation": string
} |
Trường |
name |
string
Tên tài nguyên của báo cáo. Định dạng: apps/{app}/{report}
|
type |
enum (ErrorType )
Loại lỗi mà báo cáo này được tạo ra.
|
reportText |
string
Nội dung trình bày bằng văn bản của báo cáo lỗi. Nền tảng sẽ tạo ra những báo cáo dạng văn bản này. Sau đó, các báo cáo sẽ được làm sạch và lọc để loại bỏ mọi thông tin có thể nhạy cảm. Mặc dù định dạng của các báo cáo này khá ổn định, nhưng chúng không hoàn toàn dành cho máy móc sử dụng và chúng tôi không thể đảm bảo rằng sẽ không có những thay đổi nhỏ về định dạng có thể làm hỏng các hệ thống đang cố gắng phân tích thông tin từ các báo cáo.
|
issue |
string
Vấn đề mà báo cáo này liên quan đến. Xin lưu ý: tài nguyên này hiện đang ở giai đoạn Alpha. Có thể có những thay đổi đối với việc nhóm vấn đề, dẫn đến việc các báo cáo lỗi tương tự nhưng gần đây hơn được chỉ định cho một vấn đề khác.
|
eventTime |
string (Timestamp format)
Thời điểm bắt đầu của giờ mà sự kiện gần đây nhất trong báo cáo lỗi này xảy ra. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30" .
|
deviceModel |
object (DeviceModelSummary )
Mẫu thiết bị mà sự kiện trong báo cáo lỗi này đã xảy ra.
|
osVersion |
object (OsVersion )
Phiên bản hệ điều hành mà sự kiện trong báo cáo lỗi này xảy ra.
|
appVersion |
object (AppVersion )
Phiên bản ứng dụng mà sự kiện trong báo cáo lỗi này xảy ra.
|
vcsInformation |
string
Thông tin về hệ thống kiểm soát phiên bản từ BUNDLE-METADATA/version-control-info.textproto hoặc META-INF/version-control-info.textproto của gói ứng dụng hoặc APK, tương ứng.
|
DeviceModelSummary
Thông tin tóm tắt về thiết bị
Biểu diễn dưới dạng JSON |
{
"deviceId": {
object (DeviceId )
},
"marketingName": string,
"deviceUri": string
} |
Trường |
deviceId |
object (DeviceId )
Giá trị nhận dạng của thiết bị.
|
marketingName |
string
Tên hiển thị của thiết bị.
|
deviceUri |
string
Đường liên kết đến thiết bị trong Danh mục thiết bị trên Play.
|
DeviceId
Giá trị nhận dạng của một thiết bị.
Biểu diễn dưới dạng JSON |
{
"buildBrand": string,
"buildDevice": string
} |
Trường |
buildBrand |
string
Giá trị của Build.BRAND.
|
buildDevice |
string
Giá trị của Build.DEVICE.
|
Phương thức |
|
Tìm kiếm tất cả báo cáo lỗi nhận được cho một ứng dụng. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]