Method: vitals.crashrate.query
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يطلب هذا الإجراء المقاييس في مجموعة المقاييس.
طلب HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم المورد التنسيق: apps/{app}/crashRateMetricSet
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"timelineSpec": {
object (TimelineSpec)
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort)
} |
| الحقول |
timelineSpec |
object (TimelineSpec)
تحديد مَعلمات تجميع المخطّط الزمني فترات التجميع المتاحة:
DAILY: يتم تجميع المقاييس في فواصل زمنية لتاريخ التقويم. بسبب القيود السابقة، تكون المنطقة الزمنية التلقائية والمتاحة فقط هي America/Los_Angeles.HOURLY: يتم تجميع المقاييس على فواصل زمنية مدتها ساعة واحدة. UTC هي المنطقة الزمنية التلقائية والوحيدة المتاحة.
|
dimensions[] |
string
السمات التي سيتم تقسيم المقاييس حسبها. السمات المتوافقة:
-
apiLevel (string): مستوى واجهة برمجة التطبيقات لنظام التشغيل Android الذي كان يعمل على جهاز المستخدم، على سبيل المثال: 26.
-
versionCode (int64): إصدار التطبيق الذي كان يعمل على جهاز المستخدم.
-
deviceModel (string): معرّف فريد لطراز جهاز المستخدم. يكون شكل المعرّف هو deviceBrand/device، حيث يتوافق deviceBrand مع Build.BRAND ويتوافق device مع Build.DEVICE، على سبيل المثال google/coral.
-
deviceBrand (string): معرّف فريد للعلامة التجارية لجهاز المستخدِم، مثل google.
-
deviceType (string): نوع جهاز المستخدِم (المعروف أيضًا باسم شكل الجهاز)، مثل هاتف
-
countryCode (string): البلد أو المنطقة التي يقع فيها جهاز المستخدِم استنادًا إلى عنوان IP الخاص به، ويتم تمثيلهما كرمز مكوّن من حرفَين وفقًا لمعيار ISO-3166 (مثل US للولايات المتحدة).
-
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
المقاييس التي سيتم تجميعها المقاييس المتوافقة:
crashRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل.-
crashRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة crashRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
-
crashRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ crashRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
userPerceivedCrashRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا عُطلاً واحدًا على الأقل أثناء استخدامهم تطبيقك بشكل نشط (عُطل لاحظه المستخدم). يُعتبَر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.-
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة userPerceivedCrashRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
-
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ userPerceivedCrashRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
-
distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقياسَين crashRate وuserPerceivedCrashRate. يتم احتساب المستخدم في هذا المقياس إذا كان يستخدم التطبيق بشكلٍ نشط خلال فترة التجميع. يُعتبَر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.
|
filter |
string
الفلاتر التي سيتم تطبيقها على البيانات يتّبع تعبير الفلترة معيار AIP-160 ويتيح الفلترة حسب المساواة بين جميع سمات التقسيم.
|
pageSize |
integer
الحد الأقصى لحجم البيانات المعروضة إذا لم يتم تحديدها، سيتم عرض 1, 000 صف كحد أقصى. الحدّ الأقصى للقيمة هو 100,000، وسيتم فرض القيمة 100,000 على القيم التي تتجاوز هذا الحدّ.
|
pageToken |
string
رمز مميز للصفحة تم استلامه من طلب سابق قدِّم هذه السلسلة لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة في الطلب مع الطلب الذي قدّم رمز الصفحة.
|
userCohort |
enum (UserCohort)
عرض المستخدم المطلوب اختياره ستتطابق بيانات الإخراج مع طريقة العرض المحدّدة. القيم المسموح بها:
|
نص الاستجابة
رسالة الردّ على السؤال crashrate.query
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل 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 the Crash Rate metric set to analyze app stability across dimensions like API level, device model, and country.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering data by specific dimensions and supports daily or hourly aggregation periods with corresponding timezones.\u003c/p\u003e\n"],["\u003cp\u003eReturns crash rate metrics, including overall crash rate, user-perceived crash rate, and distinct user counts.\u003c/p\u003e\n"],["\u003cp\u003eOffers optional pagination for large datasets and requires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],["This document details how to query crash rate metrics using a POST request to `https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query`. The request requires a `name` path parameter. The request body specifies `timelineSpec`, `dimensions` (e.g., `apiLevel`, `deviceModel`), `metrics` (e.g., `crashRate`, `distinctUsers`), optional `filter`, `pageSize`, `pageToken`, and `userCohort`. The response contains `rows` of metric data and a `nextPageToken` for pagination. Requires OAuth scope `https://www.googleapis.com/auth/playdeveloperreporting`.\n"],null,[]]
