Method: vitals.errors.reports.search

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

פורמט: apps/{app}

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

פרמטרים
interval

object (DateTimeInterval)

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

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

integer

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

אם לא מציינים, יוחזרו לכל היותר 50 דוחות. הערך המקסימלי הוא 100. ערכים מעל 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.