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) للجهاز، بالميغابايت، في حِزم (مثل 1024 لـ 1 إلى 1.5 غيغابايت، و4096 لـ 4 إلى 6 غيغابايت).
  • 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

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

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

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

integer

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

إذا لم يتم تحديدها، سيتم عرض 1, 000 صف كحد أقصى. الحد الأقصى للقيمة هو 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.