Method: vitals.excessivewakeuprate.query
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
यह मेट्रिक सेट में मौजूद मेट्रिक के लिए क्वेरी करता है.
एचटीटीपी अनुरोध
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/excessiveWakeupRateMetricSet}:query
यह यूआरएल, 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 ): उपयोगकर्ता के डिवाइस का देश या इलाका. यह जानकारी, उपयोगकर्ता के आईपी पते के आधार पर तय की जाती है. इसे दो अक्षरों वाले ISO-3166 कोड के तौर पर दिखाया जाता है. उदाहरण के लिए, अमेरिका के लिए US.
deviceRamBucket (int64 ): डिवाइस की रैम, एमबी में, बकेट में (3 जीबी, 4 जीबी वगैरह).
deviceSocMake (string ): डिवाइस के मुख्य सिस्टम-ऑन-चिप का मैन्युफ़ैक्चरर. उदाहरण के लिए, Samsung. रेफ़रंस
deviceSocModel (string ): डिवाइस के प्राइमरी सिस्टम-ऑन-चिप का मॉडल. उदाहरण के लिए, "Exynos 2100" प्रोसेसर का इस्तेमाल किया गया है. रेफ़रंस
deviceCpuMake (string ): डिवाइस के सीपीयू का मैन्युफ़ैक्चरर. उदाहरण के लिए, Qualcomm.
deviceCpuModel (string ): डिवाइस के सीपीयू का मॉडल, जैसे कि "Kryo 240" का इस्तेमाल किया गया है.
deviceGpuMake (string ): डिवाइस के जीपीयू का मेक, जैसे कि एआरएम.
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 की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
excessiveWakeupRate28dUserWeighted (google.type.Decimal ): पिछले 28 दिनों में excessiveWakeupRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
distinctUsers (google.type.Decimal ): एग्रीगेशन की अवधि में यूनीक उपयोगकर्ताओं की संख्या. इनका इस्तेमाल excessiveWakeupRate मेट्रिक के लिए सामान्य बनाने वाली वैल्यू के तौर पर किया गया था. अगर किसी उपयोगकर्ता के डिवाइस पर ऐप्लिकेशन कोई काम कर रहा है, तो उसकी गिनती इस मेट्रिक में की जाती है. इसका मतलब है कि सिर्फ़ फ़ोरग्राउंड में ऐप्लिकेशन का इस्तेमाल करने वाले उपयोगकर्ता ही नहीं, बल्कि बैकग्राउंड में ऐप्लिकेशन का इस्तेमाल करने वाले उपयोगकर्ता भी शामिल हैं. इस संख्या को और न बढ़ाएं, क्योंकि इससे उपयोगकर्ताओं को कई बार गिना जा सकता है. वैल्यू को 10, 100, 1,000 या 10,00,000 के सबसे नज़दीकी मल्टीपल में बदला जाता है. यह वैल्यू की मैग्नीट्यूड पर निर्भर करता है.
|
filter |
string
डेटा पर लागू किए जाने वाले फ़िल्टर. फ़िल्टर करने का एक्सप्रेशन, AIP-160 स्टैंडर्ड के मुताबिक होता है. साथ ही, यह सभी ब्रेकडाउन डाइमेंशन की समानता के हिसाब से फ़िल्टर करने की सुविधा देता है.
|
pageSize |
integer
जवाब में मिले डेटा का ज़्यादा से ज़्यादा साइज़. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 1,000 लाइनें दिखेंगी. इसकी ज़्यादा से ज़्यादा वैल्यू 1,00,000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर, उसे 1,00,000 में बदल दिया जाएगा.
|
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 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-07-26 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-07-26 (UTC) को अपडेट किया गया."],[[["\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,[]]