Method: vitals.excessivewakeuprate.query

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

الزامی. نام منبع.

فرمت: apps/{app}/excessiveWakeupRateMetricSet

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش 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

اختیاری. معیارهایی برای تجمیع.

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

  • excessiveWakeupRate ( google.type.Decimal ): درصد کاربران متمایز در دوره تجمیع که بیش از ۱۰ بیدارباش در ساعت داشته‌اند.
  • تابع ( google.type.Decimal ) excessiveWakeupRate7dUserWeighted میانگین متحرک مقدار excessiveWakeupRate در ۷ روز گذشته را نمایش می‌دهد. مقادیر روزانه بر اساس تعداد کاربران مجزا در آن روز وزن‌دهی می‌شوند.
  • تابع ( google.type.Decimal ) excessiveWakeupRate28dUserWeighted میانگین متحرک مقدار excessiveWakeupRate در ۲۸ روز گذشته را نمایش می‌دهد. مقادیر روزانه بر اساس تعداد کاربران مجزا در آن روز وزن‌دهی می‌شوند.
  • distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره تجمیع که به عنوان مقدار نرمال‌سازی برای معیار excessiveWakeupRate استفاده شده‌اند. کاربری در این معیار شمارش می‌شود که برنامه‌اش در حال انجام کاری روی دستگاه باشد، یعنی نه فقط استفاده فعال در پیش‌زمینه، بلکه کار در پس‌زمینه نیز داشته باشد. باید دقت شود که این تعداد بیشتر تجمیع نشود، زیرا ممکن است منجر به شمارش چندین باره کاربران شود. مقدار به نزدیکترین مضرب ۱۰، ۱۰۰، ۱۰۰۰ یا ۱,۰۰۰,۰۰۰، بسته به بزرگی مقدار، گرد می‌شود.
filter

string

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

pageSize

integer

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

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

pageToken

string

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

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

userCohort

enum ( UserCohort )

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

بدنه پاسخ

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

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

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

object ( MetricsRow )

ردیف‌های داده بازگردانده شده.

nextPageToken

string

توکن ادامه برای دریافت صفحه بعدی داده‌ها.

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

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

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

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