Method: vitals.lmkrate.query

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

درخواست HTTP

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

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

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

پارامترها
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 ): سطح 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

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

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

  • userPerceivedLmkRate ( google.type.Decimal ): درصدی از کاربران متمایز در دوره تجمع که حداقل یک LMK را در حین استفاده فعال از برنامه شما تجربه کرده اند (یک LMK درک شده توسط کاربر). اگر برنامه‌ای در حال نمایش فعالیت یا اجرای هر سرویس پیش‌زمینه باشد، در حال استفاده فعال در نظر گرفته می‌شود.
  • userPerceivedLmkRate7dUserWeighted ( google.type.Decimal ): مقدار متوسط رولینگ userPerceivedLmkRate در 7 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود.
  • userPerceivedLmkRate28dUserWeighted ( google.type.Decimal ): مقدار متوسط رولینگ userPerceivedLmkRate در 28 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود.
  • distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره تجمع که به عنوان مقدار عادی سازی برای معیارهای userPerceivedLmkRate استفاده شده اند. اگر کاربر در طول دوره تجمع از برنامه در پیش‌زمینه استفاده کرده باشد، در این معیار محاسبه می‌شود. باید مراقب بود که این تعداد بیشتر جمع نشود، زیرا ممکن است منجر به چندین بار شمارش کاربران شود. بسته به بزرگی مقدار، مقدار به نزدیکترین مضرب 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".

بدن پاسخگو

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

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

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

object ( MetricsRow )

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

nextPageToken

string

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

محدوده مجوز

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

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

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