Method: vitals.bitmapmemoryusage.query

يتم الاستعلام عن المقاييس في مجموعة المقاييس.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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 الذي كان يعمل على جهاز المستخدِم، مثلاً 26
  • 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) للجهاز، بالميغابايت، في مجموعات (3 غيغابايت و4 غيغابايت وما إلى ذلك)
  • 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 للجهاز، مثلاً "4198400"
  • deviceGlEsVersion (string): إصدار OpenGL ES للجهاز، مثلاً "196610"
  • 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): عدد المستخدمين المميّزين الذين تم الإبلاغ عن مقاييس الذاكرة لهم خلال فترة التجميع يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.
filter

string

اختياريّ. الفلاتر المطلوب تطبيقها على البيانات يتّبع تعبير الفلترة معيار AIP-160 ويسمح بالفلترة حسب المساواة في جميع سمات التقسيم.
pageSize

integer

اختياريّ. الحد الأقصى لحجم البيانات المعروضة

إذا لم يتم تحديد هذه المَعلمة، سيتم عرض 1, 000 صف كحد أقصى. الحد الأقصى للقيمة هو 100,000، وسيتم فرض القيمة 100,000 على القيم التي تزيد عن ذلك.
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.