Method: vitals.lmkrate.query

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

طلب HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/lmkRateMetricSet}:query

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

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

المَعلمات
name

string

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

التنسيق: apps/{app}/lmkRateMetricSet

نص الطلب

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

تمثيل 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): مستوى واجهة برمجة التطبيقات (API) لنظام التشغيل 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) للجهاز، بالميغابايت، في مجموعات (مثلاً 1024 لذاكرة الوصول العشوائي من 1 إلى 1.5 غيغابايت، و4096 لذاكرة الوصول العشوائي من 4 إلى 6 غيغابايت)
  • deviceSocMake (string): الشركة المصنّعة لنظام الجهاز الأساسي على شريحة واحدة، مثلاً Samsung Reference
  • deviceSocModel (string): طراز نظام الجهاز الأساسي على شريحة واحدة، مثلاً "Exynos 2100" Reference
  • deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) للجهاز، مثلاً Qualcomm
  • deviceCpuModel (string): طراز وحدة المعالجة المركزية للجهاز، مثلاً "Kryo 240"
  • deviceGpuMake (string): الشركة المصنّعة لوحدة معالجة الرسومات (GPU) للجهاز، مثلاً ARM
  • deviceGpuModel (string): طراز وحدة معالجة الرسومات للجهاز، مثلاً Mali
  • deviceGpuVersion (string): إصدار وحدة معالجة الرسومات للجهاز، مثلاً T750
  • deviceVulkanVersion (string): إصدار Vulkan للجهاز، مثلاً "4198400"
  • deviceGlEsVersion (string): إصدار OpenGL ES للجهاز، مثلاً "196610"
  • deviceScreenSize (string): حجم شاشة الجهاز، مثلاً NORMAL أو LARGE
  • deviceScreenDpi (string): كثافة شاشة الجهاز، مثلاً mdpi أو hdpi
metrics[]

string

اختياريّ. المقاييس المطلوب تجميعها

المقاييس المسموح بها:

  • userPerceivedLmkRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل من نوع "إغلاق التطبيقات بسبب نقص الذاكرة" (LMK) أثناء استخدامهم تطبيقك بنشاط (عطل LMK لاحظه المستخدِم) يُعتبر التطبيق قيد الاستخدام بنشاط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.
  • userPerceivedLmkRate7dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ userPerceivedLmkRate خلال آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم.
  • userPerceivedLmkRate28dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ userPerceivedLmkRate خلال آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم.
  • distinctUsers (google.type.Decimal): عدد المستخدمين المميّزين في فترة التجميع الذين تم استخدامهم كقيمة عادية لمقاييس userPerceivedLmkRate يتم احتساب المستخدِم في هذا المقياس إذا كان يستخدم التطبيق في المقدّمة خلال فترة التجميع. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

القيم المسموح بها:

  • OS_PUBLIC: لاختيار البيانات من جميع إصدارات Android التي تم إطلاقها علنًا وهذا هو الخيار التلقائي. يسمح هذا الخيار باستخدام جميع السمات أعلاه.
  • APP_TESTERS: لاختيار البيانات من المستخدِمين الذين وافقوا على أن يكونوا مختبِرين يسمح هذا الخيار باستخدام جميع السمات أعلاه.
  • OS_BETA: لاختيار البيانات من إصدارات Android التجريبية فقط، باستثناء البيانات من إصدارات Android التي تم إطلاقها لا يُسمح إلا بالسمات التالية:

  • versionCode (int64): إصدار التطبيق الذي كان قيد التشغيل على جهاز المستخدِم

  • osBuild (string): إصدار نظام التشغيل لجهاز المستخدِم، مثلاً "T1B2.220916.004".

نص الاستجابة

رسالة الاستجابة لطلب lmkrate.query

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

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

object (MetricsRow)

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

string

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

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

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

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

لمزيد من المعلومات، راجِع OAuth 2.0 Overview.