Method: vitals.lmkrate.query

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. रिसॉर्स का नाम.

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

अनुरोध का मुख्य हिस्सा

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

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. Reference
  • deviceSocModel (string): डिवाइस के प्राइमरी सिस्टम-ऑन-चिप का मॉडल. उदाहरण के लिए, "Exynos 2100". Reference
  • 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

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

इन मेट्रिक के लिए सहायता उपलब्ध है:

  • userPerceivedLmkRate (google.type.Decimal): एग्रीगेशन पीरियड में, अलग-अलग उपयोगकर्ताओं का वह प्रतिशत जिन्होंने आपके ऐप्लिकेशन का इस्तेमाल करते समय, कम से कम एक बार एलएमके (यूज़र-पर्सीव्ड एलएमके) वाली गड़बड़ी का सामना किया. किसी ऐप्लिकेशन को तब सक्रिय माना जाता है, जब वह कोई गतिविधि दिखा रहा हो या किसी फ़ोरग्राउंड सेवा को लागू कर रहा हो.
  • userPerceivedLmkRate7dUserWeighted (google.type.Decimal): पिछले सात दिनों में userPerceivedLmkRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के अलग-अलग उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
  • userPerceivedLmkRate28dUserWeighted (google.type.Decimal): पिछले 28 दिनों में userPerceivedLmkRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के अलग-अलग उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
  • distinctUsers (google.type.Decimal): एग्रीगेशन पीरियड में, अलग-अलग उपयोगकर्ताओं की संख्या. इसका इस्तेमाल, userPerceivedLmkRate मेट्रिक के लिए सामान्य बनाने वाली वैल्यू के तौर पर किया जाता है. इस मेट्रिक में किसी उपयोगकर्ता की गिनती तब की जाती है, जब उसने एग्रीगेशन पीरियड के दौरान, ऐप्लिकेशन का इस्तेमाल फ़ोरग्राउंड में किया हो. इस संख्या को आगे एग्रीगेट नहीं किया जाना चाहिए. ऐसा करने पर, उपयोगकर्ताओं की गिनती एक से ज़्यादा बार हो सकती है. वैल्यू को 10, 100, 1,000 या 10,00,000 के सबसे नज़दीकी मल्टीपल में राउंड किया जाता है. यह वैल्यू के मैग्नीट्यूड पर निर्भर करता है.
filter

string

ज़रूरी नहीं. डेटा पर लागू करने के लिए फ़िल्टर. फ़िल्टर करने का एक्सप्रेशन, AIP-160 स्टैंडर्ड के मुताबिक होता है. साथ ही, यह सभी ब्रेकडाउन डाइमेंशन की समानता के हिसाब से फ़िल्टर करने की सुविधा देता है.
pageSize

integer

ज़रूरी नहीं. दिखाए जाने वाले डेटा का ज़्यादा से ज़्यादा साइज़.

अगर इसे तय नहीं किया जाता है, तो ज़्यादा से ज़्यादा 1,000 लाइनें दिखाई जाएंगी. ज़्यादा से ज़्यादा वैल्यू 1,00,000 हो सकती है. 1,00,000 से ज़्यादा वैल्यू को 1,00,000 पर सेट कर दिया जाएगा.
pageToken

string

ज़रूरी नहीं. पेज टोकन, जो पिछले कॉल से मिला है. अगला पेज पाने के लिए, इसे उपलब्ध कराएं.

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

enum (UserCohort)

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

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

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

  • versionCode (int64): ऐप्लिकेशन का वह वर्शन जो उपयोगकर्ता के डिवाइस पर चल रहा था.

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

जवाब का मुख्य हिस्सा

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

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

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

object (MetricsRow)

डेटा की दिखाई गई लाइनें.
nextPageToken

string

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

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

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

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

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