Method: vitals.errors.reports.search

חיפוש בכל דוחות השגיאות שהתקבלו לגבי אפליקציה.

בקשת HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. משאב האב של הדוחות, שמציין את האפליקציה שעבורה הם התקבלו.

פורמט: apps/{app}

פרמטרים של שאילתה

פרמטרים
interval

object (DateTimeInterval)

אופציונלי. מרווח הזמן לחיפוש דוחות שגיאות. השעה של ההתחלה והסיום חייבת להיות עגולה, וצריך להשתמש ב-UTC כאזור זמן (או להשאיר את הערך ריק, ובמקרה כזה גם ישמש UTC).

אם מציינים ערך, יוחזרו רק דוחות שגיאות שהתרחשו במרווח הזמן הזה. אם לא מציינים מרווח זמן, המערכת משתמשת במרווח הזמן של 24 השעות האחרונות שהוגדר כברירת מחדל.
pageSize

integer

אופציונלי. מספר הדוחות המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה.

אם לא מציינים ערך, יוחזרו לכל היותר 50 דוחות. הערך המקסימלי הוא 100. ערכים גבוהים יותר יומרו ל-100.
pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של reports.search. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-reports.search חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.
filter

string

אופציונלי. פרדיקט בחירה לאחזור רק קבוצת משנה של הדוחות.

למידע בסיסי על סינון, אפשר לעיין ב-AIP-160.

** שמות שדות נתמכים:**

  • ‫apiLevel: תואם לדוחות שגיאות שהתרחשו רק בגרסאות Android המבוקשות (שצוינו כרמת API מספרית). לדוגמה: apiLevel = 28 OR apiLevel = 29.
  • ‫versionCode: התאמה לדוחות שגיאות שהתרחשו רק בקודי גרסאות האפליקציה המבוקשים. לדוגמה: versionCode = 123 OR versionCode = 456.
  • ‫deviceModel: תואם לבעיות שגיאה שהתרחשו במכשירים המבוקשים. לדוגמה: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • ‫deviceBrand: תואם לבעיות שגיאה שהתרחשו במותגי המכשירים המבוקשים. לדוגמה: ‎`deviceBrand = "Google".
  • ‫deviceType: תואם לדוחות שגיאות שהתרחשו בסוגי המכשירים המבוקשים. לדוגמה: deviceType = "PHONE".
  • ‫errorIssueType: מתאים רק לדוחות שגיאות מהסוגים המבוקשים. מועמדים מתאימים: CRASH, ANR, NON_FATAL. לדוגמה: errorIssueType = CRASH OR errorIssueType = ANR.
  • ‫errorIssueId: רק דוחות שגיאות ששייכים למזהי הבעיות של השגיאות המבוקשות. לדוגמה: errorIssueId = 1234 OR errorIssueId = 4567.
  • ‫errorReportId: תואם לדוחות שגיאות עם מזהה דוח השגיאות המבוקש. לדוגמה: errorReportId = 1234 OR errorReportId = 4567.
  • ‫appProcessState: התאמות לדוחות שגיאות לגבי מצב התהליך של אפליקציה, שמציינות אם האפליקציה פועלת בחזית (גלוי למשתמש) או ברקע. מועמדים מתאימים: FOREGROUND, BACKGROUND. לדוגמה: appProcessState = FOREGROUND.
  • ‫isUserPerceived: התאמות לדוחות שגיאות שהמשתמשים רואים. הוא לא מלווה באף אופרטור. לדוגמה: isUserPerceived.

** אופרטורים נתמכים:**

  • אופרטורים להשוואה: אופרטור ההשוואה היחיד שנתמך הוא שוויון. השדה שסיננתם חייב להופיע בצד ימין של ההשוואה.
  • אופרטורים לוגיים: אפשר להשתמש באופרטורים הלוגיים AND ו-OR כדי ליצור מסננים מורכבים לפי צורה נורמלית קוניונקטיבית (CNF), כלומר: צירופים של הפרדות. לאופרטור OR יש עדיפות על פני AND, ולכן אין צורך להשתמש בסוגריים כשיוצרים CNF.

האופרטור OR נתמך רק ליצירת דיסיונקציות שחלות על אותו שדה, למשל versionCode = 123 OR versionCode = ANR. ביטוי המסנן versionCode = 123 OR errorIssueType = ANR לא תקין.

** דוגמאות **

כמה ביטויי סינון תקינים: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תגובה עם רשימה מחולקת לדפים של דוחות שגיאות שתואמים לשאילתת החיפוש.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
שדות
errorReports[]

object (ErrorReport)

דוחות השגיאות שנמצאו.
nextPageToken

string

טוקן של דף לאחזור הדף הבא של הדוחות.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.