Method: vitals.bitmapmemoryusage.query

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

درخواست HTTP

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

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

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

پارامترها
name

string

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

Format: apps/{app}/bitmapMemoryUsageMetricSet

متن درخواست

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

نمایش 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): حافظه دسترسی تصادفی دستگاه، به مگابایت، در دسته‌ها (۳ گیگابایت، ۴ گیگابایت، و غیره).
  • 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.
  • ‫processName (string): نام فرایندی که درحال اجرا بود، برای مثال com.example.app.
  • ‫appState (string): وضعیت برنامه هنگام جمع‌آوری حافظه، برای مثال FOREGROUND (پیش‌زمینه).
metrics[]

string

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

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

  • ‫bitmapMemoryUsageP50 (google.type.Decimal): صدک ۵۰ استفاده از حافظه بیت‌مپ.
  • ‫bitmapMemoryUsageP75 (google.type.Decimal): هفتادوپنجمین صدک استفاده از حافظه بیت‌مپ.
  • ‫bitmapMemoryUsageP90 (google.type.Decimal): صدک ۹۰ استفاده از حافظه بیت‌مپ.
  • ‫bitmapMemoryUsageP95 (google.type.Decimal): صدک ۹۵ استفاده از حافظه بیت‌مپ.
  • ‫bitmapMemoryUsageP99 (google.type.Decimal): صدک ۹۹ استفاده از حافظه بیت‌مپ.
  • distinctUsers (google.type.Decimal): تعداد کاربران متمایزی که سنجه‌های حافظه برای آن‌ها درطول دوره انبوهش گزارش شده است. باید دقت شود که این تعداد بیشتر از این تجمیع نشود، زیرا ممکن است باعث شود کاربران چندین بار شمرده شوند. مقدار به نزدیک‌ترین مضرب ۱۰، ۱۰۰، ۱۰۰۰، یا ۱۰۰۰۰۰۰ گرد می‌شود که به بزرگی مقدار بستگی دارد.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

بدنه پاسخ

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

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

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

object (MetricsRow)

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

string

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

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

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

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

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