Method: vitals.excessivewakeuprate.query

मेट्रिक सेट में मेट्रिक को क्वेरी करता है.

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

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/excessiveWakeupRateMetricSet}:query

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

पाथ के पैरामीटर

पैरामीटर
name

string

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

फ़ॉर्मैट: ऐप्लिकेशन/{app}/exessiveWakeupRate MetricsSet

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

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

जेएसओएन के काेड में दिखाना
{
  "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 से जुड़ा होता है और डिवाइस, Build.DEVICE से जुड़ा होता है, उदाहरण के लिए, google/coral.
  • deviceBrand (string): उपयोगकर्ता के डिवाइस ब्रैंड का यूनीक आइडेंटिफ़ायर, उदाहरण के लिए, Google.
  • deviceType (string): उपयोगकर्ता के डिवाइस का टाइप (इसे डिवाइस का नाप या आकार भी कहा जाता है), उदाहरण, फ़ोन.
  • countryCode (string): उपयोगकर्ता के आईपी पते के आधार पर उसके डिवाइस का देश या इलाका, जिसे दो अक्षर वाले ISO-3166 कोड के तौर पर दिखाया जाता है (उदाहरण के लिए, अमेरिका के लिए अमेरिका).
  • deviceRamBucket (int64): डिवाइस की रैम, एमबी में, बकेट में (3 जीबी, 4 जीबी वगैरह).
  • deviceSocMake (string): डिवाइस के प्राइमरी सिस्टम-ऑन-चिप का डिज़ाइन. उदाहरण के लिए, Samsung. रेफ़रंस
  • deviceSocModel (string): डिवाइस के प्राइमरी सिस्टम-ऑन-चिप का मॉडल, जैसे कि "Exynos 2100". रेफ़रंस
  • deviceCpuMake (string): डिवाइस का सीपीयू, उदाहरण के लिए, गुणवत्ता
  • deviceCpuModel (string): डिवाइस के सीपीयू का मॉडल, उदाहरण के लिए, "Kryo 240".
  • deviceGpuMake (string): डिवाइस के जीपीयू का डिज़ाइन, उदाहरण के लिए, ARM.
  • deviceGpuModel (string): डिवाइस के जीपीयू का मॉडल, उदाहरण, माली.
  • deviceGpuVersion (string): डिवाइस के जीपीयू वर्शन, जैसे कि T750 पर चलते हैं.
  • deviceVulkanVersion (string): डिवाइस का Vulkan वर्शन, जैसे कि "41,98,400".
  • deviceGlEsVersion (string): डिवाइस का OpenGL ES वर्शन, जैसे कि "196610 में".
  • deviceScreenSize (string): डिवाइस के स्क्रीन साइज़, जैसे कि सामान्य, बड़ा.
  • 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 से ज़्यादा है, तो उसे 10,0000 तक सीमित कर दिया जाएगा.

pageToken

string

किसी पिछले कॉल पर मिला पेज टोकन. अगला पेज वापस पाने के लिए यह विकल्प दें.

पेज पर नंबर दिखाते समय, अनुरोध को दिए गए अन्य सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जिससे पेज टोकन दिया गया था.

userCohort

enum (UserCohort)

चुनने के लिए उपयोगकर्ता व्यू. आउटपुट डेटा, चुने गए व्यू के मुताबिक होगा.

इस्तेमाल की जा सकने वाली वैल्यू:

  • OS_PUBLIC सार्वजनिक रूप से रिलीज़ किए गए सभी Android वर्शन का डेटा चुनने के लिए. यह डिफ़ॉल्ट रूप से होता है. ऊपर दिए गए सभी डाइमेंशन के साथ काम करता है.
  • APP_TESTERS उन उपयोगकर्ताओं का डेटा चुनने के लिए जिन्होंने टेस्टर बनने के लिए ऑप्ट-इन किया है. ऊपर दिए गए सभी डाइमेंशन के साथ काम करता है.
  • OS_BETA सिर्फ़ Android के बीटा वर्शन का डेटा चुनने के लिए, रिलीज़ किए गए Android वर्शन का डेटा शामिल न करें. सिर्फ़ नीचे दिए गए डाइमेंशन इस्तेमाल किए जा सकते हैं:
  • versionCode (int64): ऐप्लिकेशन का वह वर्शन जो उपयोगकर्ता के डिवाइस पर चल रहा था.

  • osBuild (string): उपयोगकर्ता के डिवाइस का ओएस बिल्ड. उदाहरण के लिए, "T1B2.220916.004".

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

excessivewakeuprate.query के लिए जवाब.

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

जेएसओएन के काेड में दिखाना
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
rows[]

object (MetricsRow)

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

nextPageToken

string

डेटा के अगले पेज को फ़ेच करने के लिए, कंटिन्यूशन टोकन.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

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