Method: anomalies.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه البطاقة القيم الشاذة في أيّ من مجموعات البيانات.
طلب HTTP
GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/anomalies
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. تطبيق الأهل الذي تم رصد القيم الشاذة فيه التنسيق: apps/{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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
