Method: vitals.stuckbackgroundwakelockrate.query

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

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

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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): उपयोगकर्ता के डिवाइस का टाइप (इसे फ़ॉर्म फ़ैक्टर भी कहा जाता है). उदाहरण के लिए, PHONE.
  • countryCode (string): उपयोगकर्ता के आईपी पते के आधार पर, उसके डिवाइस का देश या इलाका.इसे दो अक्षरों वाले ISO-3166 कोड के तौर पर दिखाया जाता है. जैसे, अमेरिका के लिए US.
  • deviceRamBucket (int64): डिवाइस की रैम, एमबी में.इसे बकेट में दिखाया जाता है. जैसे, 1-1.5 जीबी के लिए 1024, 4-6 जीबी के लिए 4096.
  • 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 लाख के सबसे नज़दीकी मल्टीपल में राउंड किया जाता है. यह वैल्यू की मैग्नीट्यूड पर निर्भर करता है.
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.