Method: vitals.excessivewakeuprate.query
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يطلب هذا الإجراء المقاييس في مجموعة المقاييس.
طلب HTTP
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/excessiveWakeupRateMetricSet}:query
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات |
name |
string
مطلوب. اسم المورد التنسيق: apps/{app}/excessiveWakeupRateMetricSet
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل 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 ): نوع جهاز المستخدِم (المعروف أيضًا باسم شكل الجهاز)، مثل هاتف
-
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 ): طراز وحدة معالجة الرسومات في الجهاز، مثل مالي
-
deviceGpuVersion (string ): إصدار وحدة معالجة الرسومات في الجهاز، مثل T750.
-
deviceVulkanVersion (string ): إصدار Vulkan للجهاز، مثل "4198400".
deviceGlEsVersion (string ): إصدار OpenGL ES على الجهاز، مثل "196610".
deviceScreenSize (string ): حجم شاشة الجهاز، مثل NORMAL, LARGE.
-
deviceScreenDpi (string ): كثافة الشاشة على الجهاز، مثل mdpi وhdpi
|
metrics[] |
string
المقاييس التي سيتم تجميعها المقاييس المتوافقة:
-
excessiveWakeupRate (google.type.Decimal ): النسبة المئوية للمستخدمين المختلفين في فترة التجميع الذين تم تنشيط أجهزتهم أكثر من 10 مرات في الساعة.
-
excessiveWakeupRate7dUserWeighted (google.type.Decimal ): متوسط التحرّك لقيمة excessiveWakeupRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
-
excessiveWakeupRate28dUserWeighted (google.type.Decimal ): قيمة المتوسط المتحرّك لـ excessiveWakeupRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
distinctUsers (google.type.Decimal ): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقياس excessiveWakeupRate . يتم احتساب المستخدم في هذا المقياس إذا كان التطبيق ينفّذ أي عمل على الجهاز، أي ليس فقط الاستخدام النشط في المقدّمة ولكن أيضًا العمل في الخلفية. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 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 .
|
نص الاستجابة
رسالة الردّ على السؤال excessivewakeuprate.query
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"rows": [
{
object (MetricsRow )
}
],
"nextPageToken": string
} |
الحقول |
rows[] |
object (MetricsRow )
صفوف البيانات التي تم عرضها
|
nextPageToken |
string
رمز مميز للمتابعة من أجل جلب الصفحة التالية من البيانات.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/playdeveloperreporting
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eQueries the excessive wakeup rate metrics, providing insights into app background activity and potential battery drain.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by dimensions like API level, device model, and country code for targeted analysis.\u003c/p\u003e\n"],["\u003cp\u003eAggregates metrics like excessive wakeup rate and distinct users over daily periods, with customizable pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope for access.\u003c/p\u003e\n"]]],["This outlines how to query metrics from a metric set using a `POST` request to a specified URL. The request includes a resource `name` parameter within the URL. The request body, in JSON format, defines `timelineSpec`, `dimensions`, `metrics`, `filter`, `pageSize`, `pageToken`, and `userCohort`. These specify data aggregation, slicing, metrics to retrieve, data filtering, and result pagination. The response body includes `rows` of data and a `nextPageToken` for subsequent data retrieval, with authorization required via an OAuth scope.\n"],null,[]]