Method: vitals.anrrate.query

• درخواست HTTP
• پارامترهای مسیر
• درخواست بدنه
  • نمایش JSON
• بدنه پاسخ
  • نمایش JSON
• دامنه‌های مجوز

معیارهای موجود در مجموعه معیارها را جستجو می‌کند.

درخواست HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/anrRateMetricSet}:query

این URL از سینتکس Transcoding در 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 ): سطح API اندروید که روی دستگاه کاربر اجرا می‌شد، مثلاً ۲۶. versionCode ( int64 ): نسخه‌ای از برنامه که روی دستگاه کاربر در حال اجرا بود. deviceModel ( string ): شناسه منحصر به فرد مدل دستگاه کاربر. شکل شناسه 'deviceBrand/device' است، که در آن deviceBrand معادل Build.BRAND و device معادل Build.DEVICE است، مثلاً google/coral. deviceBrand ( string ): شناسه منحصر به فرد برند دستگاه کاربر، مثلاً google. deviceType ( string ): نوع (همچنین به عنوان فاکتور فرم شناخته می‌شود) دستگاه کاربر، مثلاً PHONE. countryCode ( string ): کشور یا منطقه دستگاه کاربر بر اساس آدرس IP او، که به صورت یک کد دو حرفی ISO-3166 نمایش داده می‌شود (مثلاً US برای ایالات متحده). deviceRamBucket ( int64 ): رم دستگاه، بر حسب مگابایت، در دسته‌ها (۳ گیگابایت، ۴ گیگابایت و غیره). deviceSocMake ( string ): سازنده‌ی سیستم-روی-تراشه اصلی دستگاه، مثلاً سامسونگ. مرجع deviceSocModel ( string ): مدل سیستم روی تراشه اصلی دستگاه، مثلاً "Exynos 2100". مرجع deviceCpuMake ( string ): سازنده‌ی پردازنده‌ی دستگاه، مثلاً کوالکام. 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 ): اندازه صفحه نمایش دستگاه، مثلاً معمولی، بزرگ. deviceScreenDpi ( string ): تراکم صفحه نمایش دستگاه، مثلاً mdpi، hdpi.
metrics[]	string اختیاری. معیارهایی برای تجمیع. معیارهای پشتیبانی شده: anrRate ( google.type.Decimal ): درصد کاربران متمایز در دوره تجمیع که حداقل یک ANR را تجربه کرده‌اند. anrRate7dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار anrRate در ۷ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران مجزا در آن روز وزن‌دهی می‌شوند. در جزئیات HOURLY پشتیبانی نمی‌شود. anrRate28dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار anrRate در ۲۸ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران مجزا در آن روز وزن‌دهی می‌شوند. در جزئیات HOURLY پشتیبانی نمی‌شود. userPerceivedAnrRate ( google.type.Decimal ): درصد کاربران متمایز در دوره تجمیع که حداقل یک ANR درک شده توسط کاربر را تجربه کرده‌اند. ANRهای درک شده توسط کاربر در حال حاضر از نوع «ارسال ورودی» هستند. userPerceivedAnrRate7dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار userPerceivedAnrRate در ۷ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند. در جزئیات HOURLY پشتیبانی نمی‌شود. userPerceivedAnrRate28dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار userPerceivedAnrRate در ۲۸ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند. در HOURLY پشتیبانی نمی‌شود. distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره تجمیع که به عنوان مقدار نرمال‌سازی برای معیارهای anrRate و userPerceivedAnrRate استفاده شده‌اند. کاربری در این معیار شمارش می‌شود که در طول دوره تجمیع از برنامه در پیش‌زمینه استفاده کرده باشد. باید دقت شود که این تعداد بیشتر تجمیع نشود، زیرا ممکن است منجر به شمارش چندین باره کاربران شود. مقدار بسته به بزرگی مقدار، به نزدیکترین مضرب 10، 100، 1000 یا 1000000 گرد می‌شود.
filter	string اختیاری. فیلترهایی برای اعمال روی داده‌ها. عبارت فیلترینگ از استاندارد AIP-160 پیروی می‌کند و از فیلتر کردن بر اساس برابری تمام ابعاد تفکیک پشتیبانی می‌کند.
pageSize	integer اختیاری. حداکثر اندازه داده برگشتی. اگر مشخص نشود، حداکثر ۱۰۰۰ ردیف برگردانده می‌شود. حداکثر مقدار ۱۰۰۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰۰۰ به ۱۰۰۰۰۰ محدود می‌شوند.
pageToken	string اختیاری. یک توکن صفحه، که از فراخوانی قبلی دریافت شده است. برای بازیابی صفحه بعدی، این توکن را ارائه دهید. هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به درخواست باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.
userCohort	enum ( UserCohort ) اختیاری. نمای کاربر برای انتخاب. داده‌های خروجی با نمای انتخاب شده مطابقت خواهند داشت. مقادیر پشتیبانی شده: OS_PUBLIC برای انتخاب داده‌ها از تمام نسخه‌های اندروید که به صورت عمومی منتشر شده‌اند. این مقدار پیش‌فرض است. از تمام ابعاد فوق پشتیبانی می‌کند. APP_TESTERS برای انتخاب داده‌ها از کاربرانی که برای آزمایش انتخاب شده‌اند. از تمام ابعاد فوق پشتیبانی می‌کند. OS_BETA برای انتخاب داده‌ها فقط از نسخه‌های بتا اندروید، به استثنای داده‌های نسخه‌های منتشر شده اندروید. فقط ابعاد زیر پشتیبانی می‌شوند: versionCode ( int64 ): نسخه‌ای از برنامه که روی دستگاه کاربر در حال اجرا بود. osBuild ( string ): نسخه سیستم عامل دستگاه کاربر، مثلاً "T1B2.220916.004".

بدنه پاسخ

پیام پاسخ برای anrrate.query .

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON
{ "rows": [ { object (MetricsRow) } ], "nextPageToken": string }

فیلدها
rows[]	object ( MetricsRow ) ردیف‌های داده بازگردانده شده.
nextPageToken	string توکن ادامه برای دریافت صفحه بعدی داده‌ها.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

• https://www.googleapis.com/auth/playdeveloperreporting

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .