Method: vitals.stuckbackgroundwakelockrate.query

طلب البحث عن المقاييس في مجموعة المقاييس

طلب HTTP

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

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

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

المَعلمات
name

string

مطلوبة. اسم المورد.

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل 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 ويتجاوب الجهاز مع Build.DEVICE، على سبيل المثال، google/coral.
  • deviceBrand (string): معرّف فريد للعلامة التجارية لجهاز المستخدم، مثل google
  • deviceType (string): نوع جهاز المستخدم (يُعرف أيضًا باسم شكل الجهاز)، على سبيل المثال الهاتف.
  • countryCode (string): بلد أو منطقة جهاز المستخدم استنادًا إلى عنوان IP الخاص بجهازه، ويتم تمثيله برمز ISO-3166 مكوّن من حرفَين (مثل US للولايات المتحدة).
  • deviceRamBucket (int64): ذاكرة الوصول العشوائي للجهاز، بالميغابايت، في الحِزم (3 غيغابايت، 4 غيغابايت، إلخ).
  • deviceSocMake (string): تصميم شريحة النظام الأساسي على الجهاز، على سبيل المثال Samsung. المراجع
  • deviceSocModel (string): طراز الجهاز الأساسي على الرقاقة، مثل "Exynos 2100". المراجع
  • deviceCpuMake (string): تصميم وحدة المعالجة المركزية (CPU) للجهاز، على سبيل المثال Qualcomm.
  • deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240".
  • deviceGpuMake (string): تصميم وحدة معالجة الرسومات للجهاز، على سبيل المثال ذراع التحكم في الصوت
  • deviceGpuModel (string): طراز وحدة معالجة الرسومات للجهاز، مثل مالي.
  • deviceGpuVersion (string): إصدار وحدة معالجة الرسومات (GPU)، على سبيل المثال، T750.
  • deviceVulkanVersion (string): إصدار Vulkan للجهاز، على سبيل المثال "4198400".
  • deviceGlEsVersion (string): إصدار OpenGL ES من الجهاز، على سبيل المثال، "196610".
  • deviceScreenSize (string): حجم شاشة الجهاز، على سبيل المثال عادي، كبير.
  • 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 أو 1000 أو 1000000، بناءً على حجم القيمة.
filter

string

الفلاتر المراد تطبيقها على البيانات يتّبع تعبير الفلترة معيار AIP-160 ويدعم الفلترة حسب التساوي لجميع سمات التقسيم.

pageSize

integer

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

في حال عدم تحديد هذا الحقل، سيتم عرض 1, 000 صف على الأكثر. الحد الأقصى للقيمة هو 100,000، وسيتم فرض القيم التي تزيد عن 100,000 لتصبح 100,000.

pageToken

string

رمز مميّز للصفحة تم استلامه من مكالمة سابقة قم بإدخاله لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة في الطلب مع الاستدعاء الذي أدّى إلى تقديم الرمز المميّز للصفحة.

userCohort

enum (UserCohort)

طريقة عرض المستخدم المطلوب اختيارها. ستتوافق بيانات الإخراج مع العرض المحدد.

القيم المسموح بإدراجها هي:

  • OS_PUBLIC لاختيار بيانات من جميع إصدارات Android التي تم طرحها بشكلٍ علني وهذا هو الخيار التلقائي. تدعم جميع الأبعاد المذكورة أعلاه.
  • APP_TESTERS لاختيار بيانات من المستخدمين الذين وافقوا على أن يكونوا مختبِرين. تدعم جميع الأبعاد المذكورة أعلاه.
  • OS_BETA لاختيار البيانات من إصدارات Android التجريبية فقط، باستثناء البيانات من إصدارات Android التي تم إطلاقها. تتوفّر السمات التالية فقط:
  • versionCode (int64): إصدار التطبيق الذي كان قيد التشغيل على جهاز المستخدم.

  • osBuild (string): إصدار نظام التشغيل لجهاز المستخدم، على سبيل المثال، "T1B2.220916.004".

نص الاستجابة

رسالة الرد على stuckbackgroundwakelockrate.query.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
الحقول
rows[]

object (MetricsRow)

تم عرض صفوف البيانات.

nextPageToken

string

الرمز المميّز للمتابعة لجلب الصفحة التالية من البيانات.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.