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): نوع جهاز المستخدِم (المعروف أيضًا باسم شكل الجهاز)، مثل هاتف
  • ‫countryCode (string): البلد أو المنطقة التي يقع فيها جهاز المستخدِم استنادًا إلى عنوان IP الخاص به، ويتم تمثيلهما كرمز مكوّن من حرفَين وفقًا لمعيار ISO-3166 (مثل US للولايات المتحدة).
  • ‫deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في حِزم (3 غيغابايت و4 غيغابايت وما إلى ذلك).
  • ‫deviceSocMake (string): ماركة نظام الجهاز الأساسي على الشريحة، مثل Samsung المرجع
  • ‫deviceSocModel (string): طراز نظام الجهاز الأساسي على الشريحة، مثل ‫"Exynos 2100". المرجع
  • ‫deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) بالجهاز، مثل ‫Qualcomm
  • ‫deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل ‫"Kryo 240".
  • ‫deviceGpuMake (string): يشير إلى الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
  • ‫deviceGpuModel (string): طراز وحدة معالجة الرسومات في الجهاز، مثل مالي
  • ‫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 صف كحد أقصى. الحد الأقصى للقيمة هو 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.