Method: vitals.stuckbackgroundwakelockrate.query

यह मेट्रिक सेट में मौजूद मेट्रिक के बारे में क्वेरी करता है.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. संसाधन का नाम.

फ़ॉर्मैट: apps/{app}/stuckBackgroundWakelockRateMetricSet

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

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): डिवाइस के जीपीयू का मेक, जैसे कि 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

ज़रूरी नहीं. कुल मेट्रिक.

इस्तेमाल की जा सकने वाली मेट्रिक:

  • stuckBgWakelockRate (google.type.Decimal): एग्रीगेशन की अवधि में, उन यूनीक उपयोगकर्ताओं का प्रतिशत जिन्होंने बैकग्राउंड में एक घंटे से ज़्यादा समय तक वेकलॉक को चालू रखा.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): पिछले सात दिनों में stuckBgWakelockRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): पिछले 28 दिनों में stuckBgWakelockRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
  • distinctUsers (google.type.Decimal): एग्रीगेशन की अवधि में यूनीक उपयोगकर्ताओं की संख्या. इनका इस्तेमाल stuckBgWakelockRate मेट्रिक के लिए सामान्य बनाने वाली वैल्यू के तौर पर किया गया था. अगर ऐप्लिकेशन, डिवाइस पर कोई काम कर रहा है, तो उपयोगकर्ता को इस मेट्रिक में शामिल किया जाता है. इसका मतलब है कि सिर्फ़ फ़ोरग्राउंड में ऐप्लिकेशन का इस्तेमाल करने वाले उपयोगकर्ता ही नहीं, बल्कि बैकग्राउंड में ऐप्लिकेशन का इस्तेमाल करने वाले उपयोगकर्ता भी शामिल किए जाते हैं. इस संख्या को और न बढ़ाएं, क्योंकि इससे उपयोगकर्ताओं को कई बार गिना जा सकता है. वैल्यू को 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 वैल्यू का इस्तेमाल किया जा सकता है.

जवाब का मुख्य भाग

stuckbackgroundwakelockrate.query के लिए जवाब का मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
rows[]

object (MetricsRow)

डेटा की दिखाई गई पंक्तियां.
nextPageToken

string

डेटा का अगला पेज फ़ेच करने के लिए, जारी रखने का टोकन.

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.