Method: vitals.errors.reports.search

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
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: תואם לדוחות שגיאות מהסוגים המבוקשים בלבד. מועמדים תקינים: JAVA_CRASH, NATIVE_CRASH, ANR. דוגמה: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH
  • errorIssueId: תואם לדוחות שגיאות השייכים רק למזהי הבעיות המבוקשים. דוגמה: errorIssueId = 1234 OR errorIssueId = 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.