Method: vitals.crashrate.query

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

طلب HTTP

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

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

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

المَعلمات
name

string

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

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

نص الطلب

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

تمثيل 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 ويتجاوب الجهاز مع 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

المقاييس المطلوب تجميعها

المقاييس المتاحة:

  • crashRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين خلال فترة تجميع البيانات التي واجهوا عطلاً واحدًا على الأقل.
  • crashRate7dUserWeighted (google.type.Decimal): متوسّط قيمة التحرّك يبلغ crashRate في آخر 7 أيام. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم.
  • crashRate28dUserWeighted (google.type.Decimal): متوسّط قيمة التحرّك يبلغ crashRate في آخر 28 يومًا. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. غير معتمد بدرجة الدقة HOURLY.
  • userPerceivedCrashRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين خلال فترة تجميع البيانات التي واجهوا عطلاً واحدًا على الأقل أثناء استخدامهم لتطبيقك بشكل نشط (عُطل لاحظهم المستخدمون). يُعتبَر التطبيق قيد الاستخدام إذا كان يعرض أي نشاط أو ينفّذ أي خدمة في المقدّمة.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): متوسّط قيمة التحرّك يبلغ userPerceivedCrashRate في آخر 7 أيام. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. غير معتمد بدرجة الدقة HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): متوسّط قيمة التحرّك يبلغ userPerceivedCrashRate في آخر 28 يومًا. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. غير معتمد بدرجة الدقة HOURLY.
  • distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين في فترة التجميع التي تم استخدامها كقيمة تسوية للمقياسَين crashRate وuserPerceivedCrashRate. يتم احتساب المستخدِم في هذا المقياس في حال استخدام التطبيق بشكلٍ نشط خلال فترة تجميع البيانات. يُعتبَر التطبيق قيد الاستخدام إذا كان يعرض أي نشاط أو ينفّذ أي خدمة في المقدّمة. يجب الانتباه إلى عدم تجميع هذا العدد أكثر من ذلك، لأنّه قد يؤدي إلى احتساب عدد المستخدِمين عدّة مرات. ويتم تقريب القيمة إلى أقرب مضاعف للعدد 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".

نص الاستجابة

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

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

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

object (MetricsRow)

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

nextPageToken

string

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

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

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

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

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