Method: vitals.crashrate.query
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
معیارهای موجود در مجموعه معیارها را جستجو میکند.
درخواست HTTP
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query
این URL از سینتکس Transcoding در 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 ): سطح 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 اختیاری. معیارهایی برای تجمیع. معیارهای پشتیبانی شده: -
crashRate ( google.type.Decimal ): درصد کاربران متمایز در دوره تجمیع که حداقل یک خرابی را تجربه کردهاند. -
crashRate7dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار crashRate در ۷ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران متمایز در آن روز وزندهی میشوند. -
crashRate28dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار crashRate در ۲۸ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران مجزا در آن روز وزندهی میشوند. در جزئیات HOURLY پشتیبانی نمیشود. -
userPerceivedCrashRate ( google.type.Decimal ): درصد کاربران متمایز در دوره تجمیع که حداقل یک خرابی را در حین استفاده فعال از برنامه شما تجربه کردهاند (خرابی درک شده توسط کاربر). یک برنامه در صورت نمایش هرگونه فعالیت یا اجرای هرگونه سرویس پیشزمینه، در حال استفاده فعال در نظر گرفته میشود. -
userPerceivedCrashRate7dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار userPerceivedCrashRate در ۷ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران متمایز در آن روز وزندهی میشوند. در جزئیات HOURLY پشتیبانی نمیشود. -
userPerceivedCrashRate28dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار userPerceivedCrashRate در ۲۸ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران مجزا در آن روز وزندهی میشوند. در جزئیات HOURLY پشتیبانی نمیشود. -
distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره تجمیع که به عنوان مقدار نرمالسازی برای معیارهای crashRate و userPerceivedCrashRate استفاده شدهاند. یک کاربر در صورتی در این معیار شمارش میشود که در طول دوره تجمیع به طور فعال از برنامه استفاده کرده باشد. یک برنامه در صورتی که فعالیتی را نمایش دهد یا سرویسی را در پیشزمینه اجرا کند، در حال استفاده فعال در نظر گرفته میشود. باید دقت شود که این تعداد بیشتر تجمیع نشود، زیرا ممکن است منجر به شمارش چندین باره کاربران شود. مقدار بسته به بزرگی مقدار، به نزدیکترین مضرب 10، 100، 1000 یا 1000000 گرد میشود.
|
filter | string اختیاری. فیلترهایی برای اعمال روی دادهها. عبارت فیلترینگ از استاندارد AIP-160 پیروی میکند و از فیلتر کردن بر اساس برابری تمام ابعاد تفکیک پشتیبانی میکند. |
pageSize | integer اختیاری. حداکثر اندازه داده برگشتی. اگر مشخص نشود، حداکثر ۱۰۰۰ ردیف برگردانده میشود. حداکثر مقدار ۱۰۰۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰۰۰ به ۱۰۰۰۰۰ محدود میشوند. |
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-04-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-04-22 بهوقت ساعت هماهنگ جهانی."],[],["This outlines how to query metrics in a crash rate metric set via a POST request to a specific URL. The request body requires parameters like `timelineSpec` for aggregation periods, `dimensions` to segment metrics (e.g., `apiLevel`, `deviceModel`), and `metrics` to define data points (e.g., `crashRate`). Filters, `pageSize`, `pageToken`, and `userCohort` options are available. The response includes `rows` of metric data and `nextPageToken` for pagination, and it uses OAuth 2.0 authorization.\n"]]
