Method: vitals.stuckbackgroundwakelockrate.query

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

درخواست HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

URL از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
name

string

ضروری. نام منبع

قالب: apps/{app}/stuckBackgroundWakelockRateMetricSet

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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 اندروید که در دستگاه کاربر اجرا می شد، به عنوان مثال، 26.
  • versionCode ( int64 ): نسخه ای از برنامه که در دستگاه کاربر در حال اجرا بود.
  • deviceModel ( string ): شناسه منحصر به فرد مدل دستگاه کاربر. شکل شناسه «deviceBrand/device» است، که در آن deviceBrand با Build.BRAND و دستگاه مربوط به Build.DEVICE است، به عنوان مثال، google/coral.
  • deviceBrand ( string ): شناسه منحصر به فرد برند دستگاه کاربر، به عنوان مثال، google.
  • deviceType ( string ): نوع (همچنین به عنوان فاکتور فرم شناخته می شود) دستگاه کاربر، به عنوان مثال، PHONE.
  • countryCode ( string ): کشور یا منطقه دستگاه کاربر بر اساس آدرس IP وی که به صورت کد ISO-3166 2 حرفی نشان داده شده است (مثلاً ایالات متحده برای ایالات متحده).
  • deviceRamBucket ( int64 ): رم دستگاه، در مگابایت، در سطل (3 گیگابایت، 4 گیگابایت و غیره).
  • deviceSocMake ( string ): ساخت سیستم روی تراشه اصلی دستگاه، به عنوان مثال، سامسونگ. ارجاع
  • deviceSocModel ( string ): مدل سیستم روی تراشه اصلی دستگاه، به عنوان مثال، "Exynos 2100". ارجاع
  • deviceCpuMake ( string ): ساخت CPU دستگاه، به عنوان مثال، Qualcomm.
  • deviceCpuModel ( string ): مدل CPU دستگاه، به عنوان مثال، "Kryo 240".
  • deviceGpuMake ( string ): ساخته شده از GPU دستگاه، به عنوان مثال، ARM.
  • deviceGpuModel ( string ): مدل GPU دستگاه، به عنوان مثال، مالی.
  • deviceGpuVersion ( string ): نسخه GPU دستگاه، به عنوان مثال، T750.
  • deviceVulkanVersion ( string ): نسخه Vulkan دستگاه، به عنوان مثال، "4198400".
  • deviceGlEsVersion ( string ): نسخه OpenGL ES دستگاه، به عنوان مثال، "196610".
  • deviceScreenSize ( string ): اندازه صفحه دستگاه، به عنوان مثال، NORMAL، LARGE.
  • deviceScreenDpi ( string ): تراکم صفحه دستگاه، به عنوان مثال، mdpi، hdpi.
metrics[]

string

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

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

  • stuckBgWakelockRate ( google.type.Decimal ): درصدی از کاربران متمایز در دوره انباشتگی که یک wakelock در پس‌زمینه برای بیش از 1 ساعت نگه داشته‌اند.
  • stuckBgWakelockRate7dUserWeighted ( google.type.Decimal ): مقدار متوسط ​​رولینگ stuckBgWakelockRate در 7 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود.
  • stuckBgWakelockRate28dUserWeighted ( google.type.Decimal ): مقدار متوسط ​​رول stuckBgWakelockRate در 28 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود.
  • distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره انباشتگی که به عنوان مقدار عادی سازی برای متریک stuckBgWakelockRate استفاده شده اند. اگر کاربر در حال انجام هر کاری بر روی دستگاه باشد، به عنوان مثال، نه تنها استفاده از پیش زمینه فعال، بلکه کار پس‌زمینه را نیز انجام دهد، در این معیار محاسبه می‌شود. باید مراقب بود که این تعداد بیشتر جمع نشود، زیرا ممکن است منجر به چندین بار شمارش کاربران شود. بسته به بزرگی مقدار، مقدار به نزدیکترین مضرب 10، 100، 1000 یا 1000000 گرد می شود.
filter

string

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

pageSize

integer

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

اگر نامشخص باشد، حداکثر 1000 ردیف برگردانده می شود. حداکثر مقدار 100000 است. مقادیر بالای 100000 به 100000 اجباری می شود.

pageToken

string

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

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

userCohort

enum ( UserCohort )

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

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

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

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

  • osBuild ( string ): ساخت سیستم عامل دستگاه کاربر، به عنوان مثال، "T1B2.220916.004".

بدن پاسخگو

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

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

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

object ( MetricsRow )

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

nextPageToken

string

کد ادامه برای واکشی صفحه بعدی داده ها.

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.