Method: vitals.slowstartrate.query

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

طلب HTTP

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

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

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

المَعلمات
name

string

الحقل مطلوب. اسم المورد

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

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

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

  • slowStartRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين الذين واجهوا تأخُّرًا في بدء التشغيل خلال فترة التجميع
  • slowStartRate7dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ slowStartRate خلال آخر 7 أيام. يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم.
  • slowStartRate28dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ slowStartRate خلال آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم.
  • distinctUsers (google.type.Decimal): عدد المستخدمين المميّزين خلال فترة التجميع الذين تم استخدامهم كقيمة عادية للمقياس slowStartRate يتم احتساب المستخدم في هذا المقياس إذا تم تشغيل التطبيق على الجهاز. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف لـ 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

نص الاستجابة

رسالة الاستجابة لـ slowstartrate.query

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

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

object (MetricsRow)

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

string

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

نطاقات الأذونات

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

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

لمزيد من المعلومات، راجِع OAuth 2.0 Overview.