Method: vitals.anrrate.query

يطلب هذا الإجراء المقاييس في مجموعة المقاييس.

طلب HTTP

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

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

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

المعلمات
name

string

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

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

نص الطلب

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

تمثيل JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
الحقول
timelineSpec

object (TimelineSpec)

اختياريّ. تحديد مَعلمات تجميع المخطّط الزمني

فترات التجميع المتاحة:

  • يتم تجميع مقاييس DAILY في فواصل زمنية لتاريخ التقويم. بسبب القيود السابقة، تكون المنطقة الزمنية التلقائية والمتاحة فقط هي America/Los_Angeles.
  • HOURLY: يتم تجميع المقاييس على فواصل زمنية مدتها ساعة واحدة. UTC هي المنطقة الزمنية التلقائية والوحيدة المتوافقة.
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. المرجع
  • ‫deviceSocModel (string): طراز نظام الجهاز الأساسي على الشريحة، مثل "Exynos 2100". المرجع
  • ‫deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) في الجهاز، مثل Qualcomm
  • ‫deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240"
  • ‫deviceGpuMake (string): يشير إلى الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل 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

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

المقاييس المتوافقة:

  • anrRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل.
  • ‫anrRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة anrRate خلال آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة HOURLY.
  • ‫anrRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ anrRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة HOURLY.
  • userPerceivedAnrRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا خطأ ANR لاحظه المستخدم واحدًا على الأقل. في الوقت الحالي، تشمل أخطاء ANR التي لاحظها المستخدمون تلك التي تخص نوع "إرسال الإدخال".
  • ‫userPerceivedAnrRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة userPerceivedAnrRate خلال آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
  • ‫userPerceivedAnrRate28dUserWeighted (google.type.Decimal): متوسط التحرُّك لقيمة userPerceivedAnrRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. لا . متاحة بدقة على مستوى الساعة.
  • distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقياسَين anrRate وuserPerceivedAnrRate. يتم احتساب المستخدم في هذا المقياس إذا استخدم التطبيق في المقدّمة خلال فترة التجميع. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.
filter

string

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

integer

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

إذا لم يتم تحديدها، سيتم عرض 1, 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".

نص الاستجابة

رسالة الردّ على anrrate.query

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

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

object (MetricsRow)

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

string

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.