REST Resource: vitals.stuckbackgroundwakelockrate

المورد: StuckBackgroundWakelockRateMetricSet

مورد أحادي يمثّل مجموعة مقاييس "أقفال التنبيه في الخلفية العالقة"

تحتوي مجموعة المقاييس هذه على بيانات مدة قفل التنبيه في PowerManager مدمَجة مع بيانات حالة العملية لإنتاج مقياس موحّد مستقل عن أعداد المستخدمين.

فترات التجميع المسموح بها:

  • DAILY: يتم تجميع المقاييس في فواصل زمنية حسب التاريخ. بسبب القيود السابقة، المنطقة الزمنية الوحيدة المسموح بها هي America/Los_Angeles.

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

  • 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، حسب حجم القيمة.

السمات المسموح بها:

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

الأذونات المطلوبة: للوصول إلى هذا المورد، يجب أن يتوفّر لدى المستخدم الذي يجري الطلب إذن عرض معلومات التطبيق (للقراءة فقط) للتطبيق.

تمثيل JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
الحقول
name

string

المعرّف. اسم المورد

التنسيق: apps/{app}/stuckBackgroundWakelockRateMetricSet
freshnessInfo

object (FreshnessInfo)

ملخّص عن سرعة توفُّر البيانات في هذا المورد

الطُرق

get

 يصف خصائص مجموعة المقاييس.

query

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