Method: vitals.slowstartrate.query
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
معیارهای موجود در مجموعه معیارها را جستجو میکند.
درخواست HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/slowStartRateMetricSet}:query
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها |
|---|
name | string الزامی. نام منبع. فرمت: apps/{app}/slowStartRateMetricSet |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"timelineSpec": {
object (TimelineSpec)
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort)
} |
| فیلدها |
|---|
timelineSpec | object ( TimelineSpec ) اختیاری. مشخصات پارامترهای تجمیع جدول زمانی. دورههای تجمیع پشتیبانیشده: -
DAILY : معیارها در فواصل زمانی تقویمی تجمیع میشوند. با توجه به محدودیتهای تاریخی، تنها منطقه زمانی پشتیبانیشده America/Los_Angeles است.
|
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 اختیاری. معیارهایی برای تجمیع. معیارهای پشتیبانی شده: -
slowStartRate ( google.type.Decimal ): درصد کاربران متمایز در دوره تجمیع که شروع کندی داشتهاند. -
slowStartRate7dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار slowStartRate در ۷ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران متمایز در آن روز وزندهی میشوند. -
slowStartRate28dUserWeighted ( google.type.Decimal ): میانگین متحرک مقدار slowStartRate در ۲۸ روز گذشته. مقادیر روزانه بر اساس تعداد کاربران متمایز در آن روز وزندهی میشوند. -
distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره تجمیع که به عنوان مقدار نرمالسازی برای معیار slowStartRate استفاده شدهاند. یک کاربر در صورتی در این معیار شمارش میشود که برنامهاش در دستگاه اجرا شده باشد. باید دقت شود که این تعداد بیشتر تجمیع نشود، زیرا ممکن است منجر به شمارش چندین باره کاربران شود. مقدار به نزدیکترین مضرب ۱۰، ۱۰۰، ۱۰۰۰ یا ۱,۰۰۰,۰۰۰، بسته به بزرگی مقدار، گرد میشود.
|
filter | string اختیاری. فیلترهایی برای اعمال روی دادهها. عبارت فیلترینگ از استاندارد AIP-160 پیروی میکند و از فیلتر کردن بر اساس برابری تمام ابعاد تفکیک پشتیبانی میکند. |
pageSize | integer اختیاری. حداکثر اندازه داده برگشتی. اگر مشخص نشود، حداکثر ۱۰۰۰ ردیف برگردانده میشود. حداکثر مقدار ۱۰۰۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰۰۰ به ۱۰۰۰۰۰ محدود میشوند. |
pageToken | string اختیاری. یک توکن صفحه، که از فراخوانی قبلی دریافت شده است. برای بازیابی صفحه بعدی، این توکن را ارائه دهید. هنگام صفحهبندی، تمام پارامترهای دیگر ارائه شده به درخواست باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند. |
userCohort | enum ( UserCohort ) اختیاری. نمای کاربر برای انتخاب. دادههای خروجی با نمای انتخاب شده مطابقت خواهند داشت. تنها مقدار پشتیبانی شده OS_PUBLIC است. |
بدنه پاسخ
پیام پاسخ برای slowstartrate.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 from a metric set using a `POST` request to a specified URL. The request body requires parameters like `timelineSpec` for aggregation periods, `dimensions` to segment data (e.g., API level, device model), and `metrics` to define what data to retrieve (e.g., slowStartRate, distinctUsers). It also supports filtering, pagination (`pageSize`, `pageToken`), and specifying a `userCohort`. The response contains data `rows` and a `nextPageToken` for subsequent pages. The request requires authorization through an OAuth scope.\n"]]