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): डिवाइस की रैम, एमबी में, बकेट में (उदाहरण के लिए, 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): डिवाइस की स्क्रीन का साइज़, जैसे कि सामान्य, बड़ा.
  • 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 लाइनें दिखेंगी. ज़्यादा से ज़्यादा वैल्यू 10,000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर, उसे 10,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 देखें.