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 ): معرّف شكل الجهاز، مثل هاتف
-
reportType (string ): نوع الخطأ يجب أن تتوافق القيمة مع إحدى القيم المحتملة في ErrorType .
-
issueId (string ): رقم التعريف الذي تمّ تعيين خطأ له. يجب أن تتوافق القيمة مع مكوّن {issue} في issue name .
-
deviceRamBucket (int64 ): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في حِزم (3 غيغابايت و4 غيغابايت وما إلى ذلك).
-
deviceSocMake (string ): ماركة نظام الجهاز الأساسي على الشريحة، مثل Samsung المرجع
-
deviceSocModel (string ): طراز نظام الجهاز الأساسي على الشريحة، مثل "Exynos 2100". المرجع
-
deviceCpuMake (string ): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) بالجهاز، مثل Qualcomm
-
deviceCpuModel (string ): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240".
-
deviceGpuMake (string ): يشير إلى الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
-
deviceGpuModel (string ): طراز وحدة معالجة الرسومات في الجهاز، مثل مالي
-
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
الحد الأقصى لحجم البيانات المعروضة إذا لم يتم تحديدها، سيتم عرض 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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eQueries error count metrics within a specified app and timeframe using flexible filtering and aggregation options.\u003c/p\u003e\n"],["\u003cp\u003eAllows specification of data slices via dimensions like API level, device model, error type, and more.\u003c/p\u003e\n"],["\u003cp\u003eSupports aggregation of key metrics including error report count and distinct users affected.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results, enabling retrieval of large datasets, and provides a continuation token for subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details querying metrics in a metric set via a POST request to a specific URL. The request requires a `name` path parameter and accepts a JSON body with fields like `timelineSpec`, `dimensions`, `metrics`, `pageSize`, `pageToken`, and `filter`. The response body includes `rows` of data and a `nextPageToken` for pagination. Authorization requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope. The request allows filtering and specifies supported dimensions and metrics.\n"],null,[]]