Method: vitals.anonrssandswapmemoryusage.query

تُرسل طلبات بحث عن المقاييس في مجموعة المقاييس.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
name

string

الحقل مطلوب. * اسم المورد

Format: apps/{app}/anonRssAndSwapMemoryUsageMetricSet

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل 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

اختيارية: * المقاييس المطلوب تجميعها

المقاييس المتاحة:

  • ‫anonRssAndSwapMemoryUsageP50 (google.type.Decimal): الشريحة المئوية الخمسون لاستخدام الذاكرة المجهولة RSS ومساحة الإبدال
  • ‫anonRssAndSwapMemoryUsageP75 (google.type.Decimal): الشريحة المئوية الخامسة والسبعون لاستخدام ذاكرة RSS المجهولة ومساحة الإبدال
  • ‫anonRssAndSwapMemoryUsageP90 (google.type.Decimal): الشريحة المئوية التسعون لاستخدام الذاكرة المجهولة RSS ومساحة الإبدال
  • ‫anonRssAndSwapMemoryUsageP95 (google.type.Decimal): الشريحة المئوية الخامسة والتسعون لاستخدام الذاكرة المجهولة RSS ومساحة الإبدال
  • ‫anonRssAndSwapMemoryUsageP99 (google.type.Decimal): الشريحة المئوية الـ 99 لاستخدام الذاكرة المجهولة RSS ومساحة الإبدال
  • ‫distinctUsers (google.type.Decimal): عدد المستخدمين المميّزين الذين تم الإبلاغ عن مقاييس الذاكرة لهم خلال فترة التجميع يجب الحرص على عدم تجميع هذا العدد بشكل أكبر، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.
filter

string

اختيارية: * Filters to apply to data. يتّبع تعبير الفلترة معيار AIP-160 ويتيح الفلترة حسب تساوي جميع سمات التقسيم.
pageSize

integer

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

إذا لم يتم تحديدها، سيتم عرض 1000 صف كحد أقصى. الحد الأقصى للقيمة هو 10,000، وسيتم فرض القيم التي تزيد عن 10,000 على 10,000.
pageToken

string

اختيارية: * رمز مميّز للصفحة، يتم تلقّيه من طلب سابق. يجب تقديم هذه القيمة لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة للطلب مع الطلب الذي قدّم رمز الصفحة المميّز.
userCohort

enum (UserCohort)

اختيارية: * طريقة عرض المستخدمين التي تريد اختيارها ستتوافق بيانات الناتج مع العرض المحدّد. القيمة الوحيدة المسموح بها هي OS_PUBLIC.

نص الاستجابة

رسالة الردّ على anonrssandswapmemoryusage.query

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
الحقول
rows[]

object (MetricsRow)

* صفوف البيانات التي تم عرضها
nextPageToken

string

‫* رمز مميّز للمتابعة من أجل جلب الصفحة التالية من البيانات

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.