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): طراز وحدة معالجة الرسومات (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

اختياريّ. * المقاييس التي سيتم تجميعها

المقاييس المتوافقة:

  • 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

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

pageSize

integer

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

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

pageToken

string

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

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

userCohort

enum (UserCohort)

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

نص الاستجابة

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

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

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

object (MetricsRow)

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

nextPageToken

string

* Continuation token to fetch the next page of data.

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

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

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

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