Method: vitals.errors.issues.search

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

פורמט: apps/{app}

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

פרמטרים
interval

object (DateTimeInterval)

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

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

integer

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

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