Method: vitals.anrrate.query
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يطلب هذا الإجراء المقاييس في مجموعة المقاييس.
طلب HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/anrRateMetricSet}:query
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات |
name |
string
مطلوب. اسم المورد التنسيق: apps/{app}/anrRateMetricSet
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل 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
المقاييس التي سيتم تجميعها المقاييس المتوافقة:
anrRate (google.type.Decimal ): النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل.
-
anrRate7dUserWeighted (google.type.Decimal ): متوسط القيمة المتحركة لـ anrRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
-
anrRate28dUserWeighted (google.type.Decimal ): قيمة المتوسط المتحرّك لـ anrRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
userPerceivedAnrRate (google.type.Decimal ): النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل من الأخطاء التي لاحظها المستخدمون. في الوقت الحالي، تشمل أخطاء ANR التي لاحظها المستخدمون تلك التي تخص نوع "إرسال الإدخال".
-
userPerceivedAnrRate7dUserWeighted (google.type.Decimal ): متوسط القيمة المتحرّكة لـ userPerceivedAnrRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
-
userPerceivedAnrRate28dUserWeighted (google.type.Decimal ): متوسط التحرُّك لقيمة userPerceivedAnrRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. لا . متاحة بدقة HOURLY.
-
distinctUsers (google.type.Decimal ): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقياسَين anrRate وuserPerceivedAnrRate . يتم احتساب المستخدم في هذا المقياس إذا استخدم التطبيق في المقدّمة خلال فترة التجميع. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.
|
filter |
string
الفلاتر التي سيتم تطبيقها على البيانات يتّبع تعبير الفلترة معيار AIP-160 ويتيح الفلترة حسب المساواة بين جميع سمات التقسيم.
|
pageSize |
integer
الحد الأقصى لحجم البيانات المعروضة إذا لم يتم تحديدها، سيتم عرض 1, 000 صف كحد أقصى. الحدّ الأقصى للقيمة هو 100,000، وسيتم فرض القيمة 100,000 على القيم التي تتجاوز هذا الحدّ.
|
pageToken |
string
رمز مميز للصفحة تم استلامه من طلب سابق قدِّم هذه السلسلة لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة في الطلب مع الطلب الذي قدّم رمز الصفحة.
|
userCohort |
enum (UserCohort )
عرض المستخدم المطلوب اختياره ستتطابق بيانات الإخراج مع طريقة العرض المحدّدة. القيم المسموح بها:
|
نص الاستجابة
رسالة الردّ على السؤال anrrate.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 ANR metrics within a specified timeframe, sliced by dimensions like API level, device model, and country.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering data based on dimension equality and supports pagination for large datasets.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe request body accepts parameters for timeline specification, dimensions, metrics, filter, and more to refine the query.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides rows of data corresponding to the requested metrics and dimensions, along with a pagination token for accessing further results.\u003c/p\u003e\n"]]],["This outlines how to query metrics for ANR (Application Not Responding) rates. A `POST` request is made to a specific URL, with the app's resource name provided as a path parameter. The request body specifies parameters including `timelineSpec`, `dimensions`, `metrics`, `filter`, `pageSize`, `pageToken`, and `userCohort` to customize the query. The `userCohort` parameter allows you to query `OS_PUBLIC`, `APP_TESTERS` and `OS_BETA` user data. The response contains `rows` of metric data and a `nextPageToken` for pagination.\n"],null,[]]