Method: vitals.slowstartrate.query

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

درخواست HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/slowStartRateMetricSet}:query

نشانی وب از نحو تراتبدیل 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): سطح میانای برنامه‌سازی کاربردی 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.
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 مراجعه کنید.