Method: vitals.errors.counts.query

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

בקשת HTTP

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

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

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

פרמטרים
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 והמכשיר מתאים ל-Build.DEVICE. למשל, google/coral.
  • deviceModel (string): מזהה ייחודי של דגם המכשיר של המשתמש.
  • deviceType (string): מזהה של גורם הצורה של המכשיר, למשל, טלפון.
  • reportType (string): סוג השגיאה. הערך צריך להתאים לאחד מהערכים האפשריים ב-ErrorType.
  • isUserPerceived (string): מציין אם השגיאה השפיעה על המשתמשים, USER_PERCEIVED או NOT_USER_PERCEIVED.
  • issueId (string): המזהה שהוקצה לו שגיאה. הערך צריך להתאים לרכיב {issue} של issue name.
  • deviceRamBucket (int64): RAM של המכשיר, ב-MB, בקטגוריות (3GB , 4GB וכו').
  • deviceSocMake (string): סוג המערכת על שבב (SoC) הראשי של המכשיר, למשל, Samsung. חומרי עזר
  • deviceSocModel (string): דגם המערכת על שבב (SoC) הראשית של המכשיר, למשל, "Exynos 2100". חומרי עזר
  • deviceCpuMake (string): סוג המעבד (CPU) של המכשיר, למשל, Qualcomm.
  • deviceCpuModel (string): דגם המעבד של המכשיר, למשל, "Kryo 240".
  • deviceGpuMake (string): סוג ה-GPU של המכשיר, למשל, דריכה.
  • deviceGpuModel (string): דגם ה-GPU של המכשיר, למשל, מאלי.
  • deviceGpuVersion (string): גרסת ה-GPU של המכשיר, למשל, T750.
  • deviceVulkanVersion (string): גרסת Vulkan של המכשיר, למשל, '4198400'
  • deviceGlEsVersion (string): גרסת OpenGL ES של המכשיר, למשל, "196610".
  • deviceScreenSize (string): גודל המסך של המכשיר, למשל, רגילה, גדול.
  • deviceScreenDpi (string): דחיסות המסך של המכשיר, למשל mdpi, hdpi.
metrics[]

string

מדדים לצבירה.

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

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

integer

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

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

pageToken

string

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

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

filter

string

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

גוף התגובה

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

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

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

object (MetricsRow)

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

nextPageToken

string

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

היקפי הרשאות

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

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

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