Method: vitals.crashrate.query

object (TimelineSpec)

اختیاری. مشخصات پارامترهای تجمیع خط زمان.

دوره‌های انبوهش پشتیبانی‌شده:

• DAILY: سنجه‌ها در فواصل تاریخ تقویم تجمیع می‌شوند. به‌دلیل محدودیت‌های تاریخی، منطقه زمانی پیش‌فرض و تنها منطقه زمانی پشتیبانی‌شده America/Los_Angeles است.
• ‫HOURLY: سنجه‌ها در بازه‌های ساعتی تجمیع می‌شوند. منطقه زمانی پیش‌فرض و تنها منطقه زمانی پشتیبانی‌شده UTC است.

string

اختیاری. ابعادی که سنجه‌ها براساس آن‌ها تقسیم می‌شوند.

ابعاد پشتیبانی‌شده:

• apiLevel (string): سطح میانای برنامه‌سازی کاربردی Android که در دستگاه کاربر درحال اجرا بود، برای مثال، ۲۶.
• 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): RAM دستگاه، به مگابایت، در دسته‌ها (مثلاً ۱۰۲۴ برای ۱ تا ۱٫۵ گیگابایت، ۴۰۹۶ برای ۴ تا ۶ گیگابایت).
• deviceSocMake (string): سازنده سیستم روی تراشه اصلی دستگاه، مثلاً Samsung. مرجع
• deviceSocModel (string): مدل سیستم روی تراشه اصلی دستگاه، برای مثال «Exynos 2100». مرجع
• deviceCpuMake (string): سازنده CPU دستگاه، مثلاً Qualcomm.
• ‫deviceCpuModel (string): مدل CPU دستگاه، برای مثال «Kryo 240».
• deviceGpuMake (string): سازنده GPU دستگاه، مثلاً ARM.
• deviceGpuModel (string): مدل GPU دستگاه، مثلاً Mali.
• deviceGpuVersion (string): نسخه GPU دستگاه، مثلاً T750.
• deviceVulkanVersion (string): نسخه Vulkan دستگاه، برای مثال «۴۱۹۸۴۰۰».
• ‫deviceGlEsVersion (string): نسخه OpenGL ES دستگاه، برای مثال «۱۹۶۶۱۰».
• ‫deviceScreenSize (string): اندازه صفحه‌نمایش دستگاه، مثلاً NORMAL (معمولی)، LARGE (بزرگ).
• ‫deviceScreenDpi (string): تراکم صفحه‌نمایش دستگاه، مثلاً mdpi،‏ hdpi.

string

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

سنجه‌های پشتیبانی‌شده:

• ‫crashRate (google.type.Decimal): درصد کاربران متمایز در دوره تجمیع که حداقل یک خرابی را تجربه کرده‌اند.
• ‫crashRate7dUserWeighted (google.type.Decimal): مقدار میانگین متحرک crashRate در ۷ روز گذشته. مقادیر روزانه براساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند.
• ‫crashRate28dUserWeighted (google.type.Decimal): مقدار میانگین ​​متحرک crashRate در ۲۸ روز گذشته. مقادیر روزانه براساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند. در دانه‌بندی «ساعتی» پشتیبانی نمی‌شود.
• ‫userPerceivedCrashRate (google.type.Decimal): درصد کاربران متمایز در دوره تجمیع که حداقل یک خرابی را درحین استفاده فعال از برنامه‌تان تجربه کرده‌اند (خرابی مشهود برای کاربر). اگر برنامه‌ای فعالیتی را نمایش دهد یا سرویس پیش‌زمینه‌ای را اجرا کند، درحال استفاده فعال درنظر گرفته می‌شود.
• ‫userPerceivedCrashRate7dUserWeighted (google.type.Decimal): مقدار میانگین متحرک userPerceivedCrashRate در ۷ روز گذشته. مقادیر روزانه براساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند. در دانه‌بندی «ساعتی» پشتیبانی نمی‌شود.
• ‫userPerceivedCrashRate28dUserWeighted (google.type.Decimal): مقدار میانگین ​​متحرک userPerceivedCrashRate در ۲۸ روز گذشته. مقادیر روزانه براساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند. در دانه‌بندی «ساعتی» پشتیبانی نمی‌شود.
• ‫distinctUsers (google.type.Decimal): تعداد کاربران متمایز در دوره انبوهش که به‌عنوان مقدار نرمال‌سازی برای سنجه‌های crashRate و userPerceivedCrashRate استفاده شده است. اگر کاربری درطول دوره تجمیع به‌طور فعال از برنامه استفاده کرده باشد، در این سنجه محاسبه می‌شود. اگر برنامه‌ای فعالیتی را نمایش دهد یا سرویس پیش‌زمینه‌ای را اجرا کند، درحال استفاده فعال درنظر گرفته می‌شود. باید دقت شود که این تعداد بیشتر از این تجمیع نشود، زیرا ممکن است باعث شود کاربران چندین بار شمرده شوند. مقدار به نزدیک‌ترین مضرب ۱۰، ۱۰۰، ۱۰۰۰، یا ۱۰۰۰۰۰۰ گرد می‌شود که به بزرگی مقدار بستگی دارد.

string

اختیاری. فیلترهایی که باید بر داده‌ها اعمال شود. عبارت فیلتر از استاندارد AIP-160 پیروی می‌کند و از فیلتر کردن براساس برابری همه ابعاد تفکیک پشتیبانی می‌کند.

integer

اختیاری. حداکثر اندازه داده‌های برگردانده‌شده.

اگر مشخص نشده باشد، حداکثر ۱۰۰۰ ردیف برگردانده می‌شود. حداکثر مقدار ۱۰٬۰۰۰ است؛ مقادیر بالاتر از ۱۰٬۰۰۰ به ۱۰٬۰۰۰ تبدیل خواهد شد.

string

اختیاری. یک توکن صفحه، که از تماس قبلی دریافت شده است. برای بازیابی صفحه بعدی، این را ارائه دهید.

هنگام صفحه‌بندی، همه پارامترهای دیگری که برای درخواست ارائه شده‌اند باید با فراخوانی‌ای که کد صفحه را ارائه کرده است مطابقت داشته باشند.

enum (UserCohort)

اختیاری. نمای کاربر برای انتخاب. داده‌های خروجی با نمای انتخاب‌شده مطابقت خواهد داشت.

مقادیر پشتیبانی‌شده:

• OS_PUBLIC برای انتخاب داده‌ها از همه نسخه‌های Android که به‌طور عمومی منتشر شده‌اند. این گزینه پیش‌فرض است. از همه ابعاد بالا پشتیبانی می‌کند.
• APP_TESTERS برای انتخاب داده‌های کاربرانی که موافقت کرده‌اند آزمونگر باشند. از همه ابعاد بالا پشتیبانی می‌کند.
• OS_BETA برای انتخاب داده‌ها فقط از نسخه‌های بتای Android، به‌استثنای داده‌های نسخه‌های منتشرشده Android. فقط ابعاد زیر پشتیبانی می‌شود:

• versionCode (int64): نسخه برنامه‌ای که در دستگاه کاربر درحال اجرا بوده است.

• ‫osBuild (string): ساخت سیستم‌عامل دستگاه کاربر، برای مثال، «T1B2.220916.004».