Method: vitals.stuckbackgroundwakelockrate.query

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

בקשת HTTP

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

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

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

פרמטרים
name

string

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

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

גוף הבקשה

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

ייצוג 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): הסוג (שנקרא גם גורם צורה) של המכשיר של המשתמש, למשל, PHONE.
  • ‫countryCode (string): המדינה או האזור של המכשיר של המשתמש על סמך כתובת ה-IP שלו, שמיוצגים כקוד ISO-3166 עם 2 אותיות (למשל US לארצות הברית).
  • ‫deviceRamBucket (int64): RAM של המכשיר, ב-MB, בדליים (למשל, 1024 ל-‎1-1.5GB, ‏ 4096 ל-‎4-6GB).
  • ‫deviceSocMake (string): יצרן המערכת הראשית על שבב (SoC) של המכשיר, למשל 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

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

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

  • ‫stuckBgWakelockRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהאפליקציה שלהם חסמה מצב שינה ברקע למשך יותר משעה.
  • ‫stuckBgWakelockRate7dUserWeighted (google.type.Decimal): ערך הממוצע הנע של stuckBgWakelockRate ב-7 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • ‫stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ערך הממוצע הנע של stuckBgWakelockRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • ‫distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים בתקופת הצבירה ששימשו כערך נורמליזציה למדד stuckBgWakelockRate. משתמש נספר במדד הזה אם האפליקציה ביצעה פעולה כלשהי במכשיר, כלומר לא רק שימוש פעיל בחזית אלא גם פעולות ברקע. חשוב להיזהר ולא לצבור את הספירה הזו, כי זה עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 10, 100, 1,000 או 1,000,000, בהתאם לגודל הערך.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

גוף התשובה

הודעת תגובה ל-stuckbackgroundwakelockrate.query.

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

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

object (MetricsRow)

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

string

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

היקפי הרשאות

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

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

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