Method: anomalies.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מציג חריגות בכל אחד ממערכי הנתונים.
בקשת HTTP
GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/anomalies
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\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)."]]
