REST Resource: vitals.errors.reports
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: ErrorReport
گزارش خطا برای یک برنامه دریافت شد.
زمانی که یک وضعیت خطا (بالقوه کشنده) شناسایی می شود، گزارش هایی توسط کد پلت فرم اندروید تولید می شود. گزارش های یکسان از بسیاری از کاربران کپی شده و در یک ErrorReport ادغام می شوند.
مجوزهای مورد نیاز : برای دسترسی به این منبع، کاربر تماس گیرنده به مجوز View app (فقط خواندنی) برای برنامه نیاز دارد.
| نمایندگی 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 نام منبع گزارش قالب: برنامه‌ها/{app}/{گزارش} |
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 بسته نرم افزاری یا APK. |
DeviceModelSummary
| نمایندگی JSON |
|---|
{
"deviceId": {
object (DeviceId)
},
"marketingName": string,
"deviceUri": string
} |
| فیلدها |
|---|
deviceId | object ( DeviceId ) شناسه دستگاه |
marketingName | string نام نمایشی دستگاه |
deviceUri | string پیوند به دستگاه در کاتالوگ دستگاه Play. |
شناسه دستگاه
| نمایندگی JSON |
|---|
{
"buildBrand": string,
"buildDevice": string
} |
| فیلدها |
|---|
buildBrand | string ارزش Build.BRAND. |
buildDevice | string ارزش Build.DEVICE. |
روش ها |
|---|
| تمام گزارش های خطای دریافتی برای یک برنامه را جستجو می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
