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): الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
  • ‫deviceGpuModel (string): طراز وحدة معالجة الرسومات في الجهاز، مثل Mali.
  • ‫deviceGpuVersion (string): إصدار وحدة معالجة الرسومات في الجهاز، مثل 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): الشريحة المئوية الـ 90 لاستخدام الذاكرة للصور النقطية.
  • ‫bitmapMemoryUsageP95 (google.type.Decimal): الشريحة المئوية الخامسة والتسعون لاستخدام ذاكرة الصورة النقطية
  • ‫bitmapMemoryUsageP99 (google.type.Decimal): الشريحة المئوية الـ 99 لاستخدام ذاكرة الصورة النقطية
  • ‫distinctUsers (google.type.Decimal): عدد المستخدمين المميّزين الذين تم الإبلاغ عن مقاييس الذاكرة لهم خلال فترة التجميع يجب الحرص على عدم تجميع هذا العدد بشكل أكبر، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.
filter

string

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

integer

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

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