Method: vitals.lmkrate.query

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

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
name

string

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

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

متن درخواست

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

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

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

سنجه‌های پشتیبانی‌شده:

  • userPerceivedLmkRate (google.type.Decimal): درصد کاربران متمایز در دوره تجمیع که حداقل یک LMK را درحین استفاده فعال از برنامه شما تجربه کرده‌اند (LMK دیده‌شده توسط کاربر). اگر برنامه‌ای فعالیتی را نمایش دهد یا سرویس پیش‌زمینه‌ای را اجرا کند، درحال استفاده فعال درنظر گرفته می‌شود.
  • ‫userPerceivedLmkRate7dUserWeighted (google.type.Decimal): مقدار میانگین متحرک userPerceivedLmkRate در ۷ روز گذشته. مقادیر روزانه براساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند.
  • ‫userPerceivedLmkRate28dUserWeighted (google.type.Decimal): مقدار میانگین ​​متحرک userPerceivedLmkRate در ۲۸ روز گذشته. مقادیر روزانه براساس تعداد کاربران متمایز در آن روز وزن‌دهی می‌شوند.
  • distinctUsers (google.type.Decimal): تعداد کاربران متمایز در دوره تجمیع که به‌عنوان مقدار نرمال‌سازی برای سنجه‌های userPerceivedLmkRate استفاده شده است. اگر کاربری درطول دوره انبوهش از برنامه در پیش‌زمینه استفاده کرده باشد، در این سنجه محاسبه می‌شود. باید دقت شود که این تعداد بیشتر از این تجمیع نشود، زیرا ممکن است باعث شود کاربران چندین بار شمرده شوند. مقدار به نزدیک‌ترین مضرب ۱۰، ۱۰۰، ۱۰۰۰، یا ۱۰۰۰۰۰۰ گرد می‌شود که به بزرگی مقدار بستگی دارد.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

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

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

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

  • ‫osBuild (string): ساخت سیستم‌عامل دستگاه کاربر، برای مثال، «T1B2.220916.004».

بدنه پاسخ

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

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

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

object (MetricsRow)

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

string

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

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

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

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

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