Method: vitals.stuckbackgroundwakelockrate.query

يتم الاستعلام عن المقاييس في مجموعة المقاييس.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
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): مستوى واجهة برمجة التطبيقات لنظام التشغيل 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 (مثلاً US للولايات المتحدة)
  • deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في مجموعات (3 غيغابايت و4 غيغابايت وما إلى ذلك)
  • deviceSocMake (string): الشركة المصنّعة لنظام الجهاز الأساسي على شريحة واحدة، مثلاً Samsung Reference
  • deviceSocModel (string): طراز نظام الجهاز الأساسي على شريحة واحدة، مثلاً "Exynos 2100" Reference
  • 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

اختياريّ. المقاييس المطلوب تجميعها

المقاييس المسموح بها:

  • 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

اختياريّ. الحد الأقصى لحجم البيانات المعروضة

إذا لم يتم تحديدها، سيتم عرض 1000 صف كحد أقصى. الحد الأقصى للقيمة هو 100000، وسيتم فرض القيمة 100000 على القيم التي تزيد عن 100000.
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.