Method: vitals.errors.counts.query

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

طلب HTTP

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

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

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

المَعلمات
name

string

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

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

نص الطلب

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

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

object (TimelineSpec)

مواصفات مَعلمات تجميع المخطط الزمني.

فترات تجميع البيانات المسموح بها:

  • DAILY: يتم تجميع المقاييس في فواصل تواريخ التقويم. المنطقة الزمنية التلقائية والوحيدة هي America/Los_Angeles.
dimensions[]

string

الأبعاد لتقسيم البيانات حسبها.

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

  • apiLevel (string): مستوى واجهة برمجة التطبيقات في نظام التشغيل Android الذي كان يعمل على جهاز المستخدم، مثلاً 26.
  • versionCode (int64): معرّف فريد لطراز جهاز المستخدم شكل المعرّف هو "deviceBrand/device"، حيث يتوافق deviceBrand مع Build.BRAND ويتجاوب الجهاز مع Build.DEVICE، على سبيل المثال، google/coral.
  • deviceModel (string): معرّف فريد لطراز جهاز المستخدم
  • deviceType (string): معرّف شكل الجهاز، مثل الهاتف.
  • reportType (string): نوع الخطأ. يجب أن تتوافق القيمة مع إحدى القيم المحتملة في ErrorType.
  • isUserPerceived (string): تشير إلى ما إذا كان تم ملاحظة المستخدم للخطأ، USER_PERCEIVED أو NOT_USER_PERCEIVED.
  • issueId (string): المعرّف الذي تم تعيين خطأ له. يجب أن تتوافق القيمة مع المكوِّن {issue} في issue name.
  • 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

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

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

  • errorReportCount (google.type.Decimal): العدد المطلق لتقارير الأخطاء الفردية التي تم استلامها لأحد التطبيقات.
  • distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين الذين تم تلقي تقاريرهم. يجب الانتباه إلى عدم تجميع هذا العدد أكثر من ذلك، لأنّه قد يؤدي إلى احتساب عدد المستخدِمين عدّة مرات. هذه القيمة ليست تقريبية، ولكنها قد تكون تقريبية.
pageSize

integer

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

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

pageToken

string

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

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

filter

string

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

نص الاستجابة

عدد الأخطاء هو ردّ طلب البحث.

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

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

object (MetricsRow)

تم عرض الصفوف.

nextPageToken

string

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

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

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

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

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