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): डिवाइस के जीपीयू का मेक, जैसे कि एआरएम.
  • deviceGpuModel (string): डिवाइस के जीपीयू का मॉडल, जैसे कि माली.
  • 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 देखें.