Method: vitals.bitmapmemoryusage.query

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

בקשת HTTP

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

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

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

פרמטרים
name

string

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

Format: apps/{app}/bitmapMemoryUsageMetricSet

גוף הבקשה

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

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

object (TimelineSpec)

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

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

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

string

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

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

  • ‫apiLevel (string): רמת ה-API של Android שפועלת במכשיר של המשתמש, למשל 26.
  • ‫versionCode (int64): גרסת האפליקציה שפעלה במכשיר של המשתמש.
  • ‫deviceModel (string): המזהה הייחודי של דגם המכשיר של המשתמש. המזהה הוא בפורמט "deviceBrand/device", כאשר deviceBrand תואם ל-Build.BRAND ו-device תואם ל-Build.DEVICE, לדוגמה, google/coral.
  • deviceBrand (string): מזהה ייחודי של מותג המכשיר של המשתמש, למשל google.
  • ‫deviceType (string): סוג המכשיר של המשתמש (נקרא גם Form Factor), למשל PHONE.
  • ‫countryCode (string): המדינה או האזור של מכשיר המשתמש על סמך כתובת ה-IP שלו, שמיוצגים כקוד ISO-3166 בן 2 אותיות (למשל, US לארצות הברית).
  • deviceRamBucket (int64): זיכרון ה-RAM של המכשיר, ב-MB, בקטגוריות (3GB,‏ 4GB וכו').
  • 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.
  • processName (string): שם התהליך שפעל, למשל com.example.app.
  • ‫appState (string): מצב האפליקציה כשהזיכרון נאסף, למשל FOREGROUND.
metrics[]

string

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

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

  • ‫bitmapMemoryUsageP50 (google.type.Decimal): האחוזון ה-50 של השימוש בזיכרון של מפת הסיביות.
  • ‫bitmapMemoryUsageP75 (google.type.Decimal): אחוזון 75 של השימוש בזיכרון של מפת הסיביות (bitmap).
  • ‫bitmapMemoryUsageP90 (google.type.Decimal): האחוזון ה-90 של השימוש בזיכרון של מפת סיביות.
  • bitmapMemoryUsageP95 (google.type.Decimal): אחוזון 95 של השימוש בזיכרון של מפת הסיביות.
  • ‫bitmapMemoryUsageP99 (google.type.Decimal): האחוזון ה-99 של השימוש בזיכרון של מפת הסיביות (bitmap).
  • ‫distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים שדווחו לגביהם מדדי זיכרון במהלך תקופת הצבירה. חשוב לא לצבור את הספירה הזו עוד יותר, כי זה עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 10, 100, 1,000 או 1,000,000, בהתאם לגודל הערך.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

אופציונלי. תצוגת המשתמש שצריך לבחור. נתוני הפלט יתאימו לתצוגה שנבחרה. הערך הנתמך היחיד הוא OS_PUBLIC.

גוף התשובה

הודעת התשובה של bitmapmemoryusage.query.

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

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

object (MetricsRow)

שורות נתונים שהוחזרו.
nextPageToken

string

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

היקפי הרשאות

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

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

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