Method: vitals.errors.counts.query

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

בקשת HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query

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

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

פרמטרים
name

string

חובה. שם המשאב

פורמט: apps/{app}/errorCountMetricSet

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "filter": string
}
שדות
timelineSpec

object (TimelineSpec)

אופציונלי. מפרט של הפרמטרים לצבירת נתונים בציר הזמן.

תקופות צבירה נתמכות:

  • ‫DAILY: המדדים נצברים במרווחים של תאריכים קלנדריים. אזור הזמן שמוגדר כברירת מחדל והיחיד שנתמך הוא America/Los_Angeles.
dimensions[]

string

אופציונלי. מאפיינים שלפיהם אפשר לפלח את הנתונים.

מידות נתמכות:

  • ‫apiLevel (string): רמת ה-API של Android שפועלת במכשיר של המשתמש, למשל 26.
  • ‫versionCode (int64): המזהה הייחודי של דגם המכשיר של המשתמש. המזהה הוא בפורמט "deviceBrand/device", כאשר deviceBrand תואם ל-Build.BRAND ו-device תואם ל-Build.DEVICE, לדוגמה, google/coral.
  • ‫deviceModel (string): המזהה הייחודי של דגם המכשיר של המשתמש.
  • ‫deviceType (string): מזהה של גורם הצורה של המכשיר, למשל PHONE.
  • ‫reportType (string): סוג השגיאה. הערך צריך להתאים לאחד מהערכים האפשריים ב-ErrorType.
  • issueId (string): המזהה שהוקצה לשגיאה. הערך צריך להתאים לרכיב {issue} של issue name.
  • ‫deviceRamBucket (int64): זיכרון RAM של המכשיר, ב-MB, בקטגוריות (למשל, 1024 ל-1-1.5GB, ‏ 4096 ל-4-6GB).
  • deviceSocMake (string): יצרן המערכת על שבב (SoC) הראשית של המכשיר, למשל Samsung. קובץ עזר
  • deviceSocModel (string): דגם המערכת על שבב (SoC) הראשית של המכשיר, למשל "Exynos 2100". קובץ עזר
  • deviceCpuMake (string): יצרן המעבד (CPU) של המכשיר, למשל Qualcomm.
  • ‫deviceCpuModel (string): דגם המעבד (CPU) של המכשיר, למשל "Kryo 240".
  • deviceGpuMake (string): יצרן ה-GPU של המכשיר, למשל ARM.
  • deviceGpuModel (string): דגם ה-GPU של המכשיר, למשל Mali.
  • deviceGpuVersion (string): גרסת המעבד הגרפי (GPU) של המכשיר, למשל T750.
  • deviceVulkanVersion (string): גרסת Vulkan של המכשיר, למשל "4198400".
  • ‫deviceGlEsVersion (string): גרסת OpenGL ES של המכשיר, למשל "196610".
  • deviceScreenSize (string): גודל המסך של המכשיר, למשל: NORMAL,‏ LARGE.
  • ‫deviceScreenDpi (string): צפיפות המסך של המכשיר, למשל mdpi,‏ hdpi.
metrics[]

string

אופציונלי. המדדים לצבירה.

מדדים נתמכים:

  • ‫errorReportCount (google.type.Decimal): מספר מוחלט של דוחות שגיאות נפרדים שהתקבלו לגבי אפליקציה.
  • ‫distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים שהתקבלו מהם דוחות. חשוב לא לצבור את הספירה הזו עוד יותר, כי זה עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך הזה לא מעוגל, אבל יכול להיות שהוא משוער.
pageSize

integer

אופציונלי. הגודל המקסימלי של הנתונים שמוחזרים.

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

string

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

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

string

אופציונלי. מסננים שאפשר להחיל על הנתונים. ביטוי הסינון תואם לתקן AIP-160, ואפשר לסנן לפי שוויון של כל מאפייני הפירוט וגם:

  • ‫isUserPerceived (string): מציין אם השגיאה נתפסת על ידי המשתמש או לא, USER_PERCEIVED או NOT_USER_PERCEIVED.

גוף התשובה

תגובה לשאילתה על מספר השגיאות.

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

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

object (MetricsRow)

שורות שהוחזרו.
nextPageToken

string

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.