Method: vitals.errors.counts.query

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

בקשת HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{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 של המכשיר, במגה-בייט, בדליים (3GB,‏ 4GB וכו').
  • ‫deviceSocMake (string): יצרן המערכת הראשית על שבב של המכשיר, למשל Samsung. חומרי עזר
  • ‫deviceSocModel (string): הדגם של המערכת הראשית על שבב (SoC) של המכשיר, לדוגמה, Exynos 2100. חומרי עזר
  • ‫deviceCpuMake (string): יצרן המעבד של המכשיר, למשל Qualcomm.
  • ‫deviceCpuModel (string): דגם המעבד (CPU) של המכשיר, למשל, Kryo 240.
  • ‫deviceGpuMake (string): סוג ה-GPU של המכשיר, למשל ARM.
  • ‫deviceGpuModel (string): הדגם של ה-GPU של המכשיר, למשל Mali.
  • ‫deviceGpuVersion (string): גרסת המעבד הגרפי של המכשיר, למשל 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 שורות. הערך המקסימלי הוא 100,000. ערכים גבוהים יותר יומרו ל-100,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.