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 ويتجاوب الجهاز مع Build.DEVICE، على سبيل المثال، google/coral.
deviceBrand (string ): معرّف فريد للعلامة التجارية لجهاز المستخدم، مثل google
deviceType (string ): نوع جهاز المستخدم (يُعرف أيضًا باسم شكل الجهاز)، على سبيل المثال الهاتف.
countryCode (string ): بلد أو منطقة جهاز المستخدم استنادًا إلى عنوان IP الخاص بجهازه، ويتم تمثيله برمز ISO-3166 مكوّن من حرفَين (مثل US للولايات المتحدة).
deviceRamBucket (int64 ): ذاكرة الوصول العشوائي للجهاز، بالميغابايت، في الحِزم (3 غيغابايت، 4 غيغابايت، إلخ).
deviceSocMake (string ): تصميم شريحة النظام الأساسي على الجهاز، على سبيل المثال Samsung. المراجع
deviceSocModel (string ): طراز الجهاز الأساسي على الرقاقة، مثل "Exynos 2100". المراجع
deviceCpuMake (string ): تصميم وحدة المعالجة المركزية (CPU) للجهاز، على سبيل المثال Qualcomm.
deviceCpuModel (string ): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240".
deviceGpuMake (string ): تصميم وحدة معالجة الرسومات للجهاز، على سبيل المثال ذراع التحكم في الصوت
deviceGpuModel (string ): طراز وحدة معالجة الرسومات للجهاز، مثل مالي.
deviceGpuVersion (string ): إصدار وحدة معالجة الرسومات (GPU)، على سبيل المثال، T750.
deviceVulkanVersion (string ): إصدار Vulkan للجهاز، على سبيل المثال "4198400".
deviceGlEsVersion (string ): إصدار OpenGL ES من الجهاز، على سبيل المثال، "196610".
deviceScreenSize (string ): حجم شاشة الجهاز، على سبيل المثال عادي، كبير.
deviceScreenDpi (string ): كثافة شاشة الجهاز، على سبيل المثال، mdpi أو hdpi
|
metrics[] |
string
المقاييس المطلوب تجميعها المقاييس المتاحة:
anrRate (google.type.Decimal ): النسبة المئوية للمستخدمين المختلفين خلال فترة تجميع البيانات التي واجهوا خطأ ANR واحدًا على الأقل
anrRate7dUserWeighted (google.type.Decimal ): متوسّط قيمة التحرّك يبلغ anrRate في آخر 7 أيام. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. غير معتمد بدرجة الدقة HOURLY.
anrRate28dUserWeighted (google.type.Decimal ): متوسّط قيمة التحرّك يبلغ anrRate في آخر 28 يومًا. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. غير معتمد بدرجة الدقة HOURLY.
userPerceivedAnrRate (google.type.Decimal ): النسبة المئوية للمستخدمين المختلفين خلال فترة تجميع البيانات التي واجهوا خطأ ANR واحدًا على الأقل من الأخطاء الملحوظة. إنّ أخطاء ANR التي لاحظها المستخدمون هي حاليًا ضمن النوع "إرسال الإدخال".
userPerceivedAnrRate7dUserWeighted (google.type.Decimal ): متوسّط قيمة التحرّك يبلغ userPerceivedAnrRate في آخر 7 أيام. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. غير معتمد بدرجة الدقة HOURLY.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal ): متوسّط قيمة التحرّك يبلغ userPerceivedAnrRate في آخر 28 يومًا. ويتم احتساب القيم اليومية من خلال عدد المستخدمين المختلفين في اليوم. لا . بدقة HOURLY.
distinctUsers (google.type.Decimal ): عدد المستخدمين المختلفين في فترة التجميع التي تم استخدامها كقيمة تسوية للمقياسَين anrRate وuserPerceivedAnrRate . يتم احتساب المستخدِم في هذا المقياس إذا كان قد استخدم التطبيق في المقدّمة خلال فترة تجميع البيانات. يجب الانتباه إلى عدم تجميع هذا العدد أكثر من ذلك، لأنّه قد يؤدي إلى احتساب عدد المستخدِمين عدّة مرات. ويتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1000 أو 1000000، بناءً على حجم القيمة.
|
filter |
string
الفلاتر المراد تطبيقها على البيانات يتّبع تعبير الفلترة معيار AIP-160 ويدعم الفلترة حسب التساوي لجميع سمات التقسيم.
|
pageSize |
integer
الحد الأقصى لحجم البيانات المعروضة. في حال عدم تحديد هذا الحقل، سيتم عرض 1, 000 صف على الأكثر. الحد الأقصى للقيمة هو 100,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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-11-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-11-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Queries ANR metrics within a specified timeframe, sliced by dimensions like API level, device model, and country."],["Allows filtering data based on dimension equality and supports pagination for large datasets."],["Requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope for authorization."],["The request body accepts parameters for timeline specification, dimensions, metrics, filter, and more to refine the query."],["The response provides rows of data corresponding to the requested metrics and dimensions, along with a pagination token for accessing further results."]]],["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"]]