Method: anomalies.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ناهنجاری ها را در هر یک از مجموعه داده ها فهرست می کند.
درخواست HTTP
GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/anomalies
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. برنامه والد که ناهنجاری برای آن شناسایی شد. قالب: برنامه‌ها/{app} |
پارامترهای پرس و جو
| پارامترها |
|---|
filter | string معیارهای فیلتر برای ناهنجاری ها برای راهنمایی اولیه فیلتر، لطفاً بررسی کنید: https://google.aip.dev/160 . توابع پشتیبانی شده: -
activeBetween(startTime, endTime) : اگر مشخص شده است، فقط ناهنجاری هایی را فهرست کنید که بین startTime (شامل) و endTime (انحصاری) فعال بوده اند. انتظار می رود هر دو پارامتر با رشته فرمت شده RFC-3339 مطابقت داشته باشند (به عنوان مثال 2012-04-21T11:30:00-04:00 ). افست های UTC پشتیبانی می شوند. هر دو startTime و endTime مقدار ویژه UNBOUNDED می پذیرند تا به ترتیب فواصل بدون کران پایین یا بالایی را نشان دهند. مثال ها:-
activeBetween("2021-04-21T11:30:00Z", "2021-07-21T00:00:00Z") -
activeBetween(UNBOUNDED, "2021-11-21T00:00:00-04:00") -
activeBetween("2021-07-21T00:00:00-04:00", UNBOUNDED)
|
pageSize | integer حداکثر اندازه داده های برگشتی اگر نامشخص باشد، حداکثر 10 ناهنجاری برگردانده می شود. حداکثر مقدار 100 است. مقادیر بالای 100 به 100 تبدیل می شوند. |
pageToken | string یک نشانه صفحه، دریافت شده از تماس قبلی ListErrorReports . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListErrorReports باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ با لیستی از ناهنجاری ها در مجموعه داده ها.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"anomalies": [
{
object (Anomaly)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
anomalies[] | object ( Anomaly ) ناهنجاری هایی که پیدا شد. |
nextPageToken | string کد ادامه برای واکشی صفحه بعدی داده ها. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/playdeveloperreporting
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists anomalies detected within any of the Google Play developer's datasets.\u003c/p\u003e\n"],["\u003cp\u003eFilter anomalies by activity timeframe, control the number of results returned, and navigate through pages using pagination.\u003c/p\u003e\n"],["\u003cp\u003eAnomalies are returned with details like their type, severity, affected dimensions, and relevant metrics, along with a token for retrieving further pages.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eGET\u003c/code\u003e HTTP method and requires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to list anomalies in datasets via an HTTP GET request to `https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/anomalies`. The `parent` path parameter specifies the app. Query parameters include `filter` for filtering anomalies by time, `pageSize` to control result quantity (max 100), and `pageToken` for pagination. The request body must be empty. The response returns a list of anomalies and a `nextPageToken` for further results. Authorization requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope.\n"],null,["# Method: anomalies.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAnomaliesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists anomalies in any of the datasets.\n\n### HTTP request\n\n`GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/anomalies`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Parent app for which anomalies were detected. Format: apps/{app} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Filtering criteria for anomalies. For basic filter guidance, please check: \u003chttps://google.aip.dev/160\u003e. **Supported functions:** - `activeBetween(startTime, endTime)`: If specified, only list anomalies that were active in between `startTime` (inclusive) and `endTime` (exclusive). Both parameters are expected to conform to an RFC-3339 formatted string (e.g. `2012-04-21T11:30:00-04:00`). UTC offsets are supported. Both `startTime` and `endTime` accept the special value `UNBOUNDED`, to signify intervals with no lower or upper bound, respectively. Examples: - `activeBetween(\"2021-04-21T11:30:00Z\", \"2021-07-21T00:00:00Z\")` - `activeBetween(UNBOUNDED, \"2021-11-21T00:00:00-04:00\")` - `activeBetween(\"2021-07-21T00:00:00-04:00\", UNBOUNDED)` |\n| `pageSize` | `integer` Maximum size of the returned data. If unspecified, at most 10 anomalies will be returned. The maximum value is 100; values above 100 will be coerced to 100. |\n| `pageToken` | `string` A page token, received from a previous `ListErrorReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListErrorReports` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse with a list of anomalies in datasets.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"anomalies\": [ { object (/play/developer/reporting/reference/rest/v1beta1/anomalies#Anomaly) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------|\n| `anomalies[]` | `object (`[Anomaly](/play/developer/reporting/reference/rest/v1beta1/anomalies#Anomaly)`)` Anomalies that were found. |\n| `nextPageToken` | `string` Continuation token to fetch the next page of data. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/playdeveloperreporting`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
