Method: vitals.errors.issues.search

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

בקשת HTTP

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

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

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

פרמטרים
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, NON_FATAL. דוגמה: 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

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

integer

אופציונלי. מספר דוחות השגיאות לדוגמה שיוחזרו לכל ErrorIssue. אם לא צוין ערך, המערכת תשתמש בערך 0. הערה: נכון לעכשיו, המערכת תומכת רק בערכים 0 ו-1.

גוף הבקשה

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

גוף התשובה

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

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

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

object (ErrorIssue)

שגיאה: בעיות שנמצאו.
nextPageToken

string

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

היקפי הרשאה

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

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

מידע נוסף זמין במאמר בנושא OAuth 2.0 Overview.