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 ويتوافق 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. Reference
  • deviceSocModel (string): طراز المنظومة على رقاقة الأساسية للجهاز، مثل "Exynos 2100". Reference
  • deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) في الجهاز، مثل Qualcomm.
  • ‫deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240".
  • ‫deviceGpuMake (string): الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
  • ‫deviceGpuModel (string): طراز وحدة معالجة الرسومات في الجهاز، مثل Mali.
  • ‫deviceGpuVersion (string): إصدار وحدة معالجة الرسومات في الجهاز، مثل 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 صف كحد أقصى. الحد الأقصى للقيمة هو 10,000، وسيتم فرض القيم التي تزيد عن 10,000 على 10,000.
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.