Method: vitals.errors.counts.query

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

طلب HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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 ويتطابق device مع Build.DEVICE، مثلاً google/coral
  • deviceModel (string): معرّف فريد لطراز جهاز المستخدِم
  • deviceType (string): معرّف شكل الجهاز، مثلاً PHONE
  • reportType (string): نوع الخطأ يجب أن تتطابق القيمة مع إحدى القيم الممكنة في ErrorType.
  • issueId (string): المعرّف الذي تم تعيينه للخطأ يجب أن تتطابق القيمة مع مكوّن {issue} من issue name.
  • deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في مجموعات (3 غيغابايت و4 غيغابايت وما إلى ذلك)
  • 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

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

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

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

integer

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

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

string

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

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

string

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

  • isUserPerceived (string): يشير إلى ما إذا كان الخطأ مرئيًا للمستخدِم أم لا، USER_PERCEIVED أو NOT_USER_PERCEIVED

نص الاستجابة

استجابة طلب البحث عن أعداد الأخطاء

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

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

object (MetricsRow)

الصفوف المعروضة
nextPageToken

string

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

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

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

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

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