Method: vitals.errors.issues.search

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

פורמט: apps/{app}

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

פרמטרים
interval

object (DateTimeInterval)

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

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

pageSize

integer

המספר המקסימלי של בעיות שגיאה שיש להחזיר. השירות עשוי להחזיר ערך נמוך יותר מהערך הזה.

אם לא צוין אחרת, יוחזרו עד 50 בעיות של שגיאות. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 יאולצו ל-1,000.

pageToken

string

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

במהלך העימוד, כל הפרמטרים האחרים שסיפקתם לבקשה חייבים להתאים לקריאה שסיפקה את אסימון הדף.

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. דוגמה: errorIssueType = CRASH OR errorIssueType = ANR
  • appProcessState: התאמה לבעיות של שגיאות במצב התהליך של אפליקציה, שמציינת אם האפליקציה פועלת בחזית (גלויה למשתמש) או ברקע. מועמדים תקינים: FOREGROUND, BACKGROUND. דוגמה: appProcessState = FOREGROUND
  • isUserPerceived: התאמה לבעיות של שגיאות שהשפיעו על המשתמשים. הוא לא מלווה באופרטורים. דוגמה: isUserPerceived

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

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

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

** דוגמאות **

מספר ביטויי סינון חוקיים: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

orderBy

string

מציין את השדה שישמש לקביעת סדר התוצאות.

** מאפיינים נתמכים:**

  • errorReportCount: בעיות סידור לפי מספר דוחות שגיאה.
  • distinctUsers: בעיות סידור לפי מספר המשתמשים הייחודיים שהושפעו.

** פעולות נתמכות:**

  • asc בסדר עולה.
  • desc כדי להציג את הערכים בסדר יורד.

פורמט: שדה ופעולה, למשל errorReportCount desc

הערה: בשלב זה יש תמיכה רק בשדה אחד בכל פעם.

גוף הבקשה

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

גוף התגובה

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

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

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

object (ErrorIssue)

נמצאו שגיאות.

nextPageToken

string

אסימון המשך לאחזור דף הנתונים הבא.

היקפי הרשאות

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

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.