Method: vitals.crashrate.query

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

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

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

JSON के काेड में दिखाना
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
फ़ील्ड
timelineSpec

object (TimelineSpec)

ज़रूरी नहीं. टाइमलाइन के डेटा एग्रीगेशन पैरामीटर की जानकारी.

डेटा इकट्ठा करने की अवधि:

  • DAILY: मेट्रिक को कैलेंडर की तारीख के हिसाब से एग्रीगेट किया जाता है. पुरानी सीमाओं की वजह से, डिफ़ॉल्ट और सिर्फ़ इस्तेमाल किया जा सकने वाला टाइमज़ोन America/Los_Angeles है.
  • HOURLY: मेट्रिक को हर घंटे के अंतराल में एग्रीगेट किया जाता है. डिफ़ॉल्ट और सिर्फ़ इस्तेमाल किया जा सकने वाला टाइमज़ोन UTC है.
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): डिवाइस के जीपीयू का मेक, जैसे कि 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

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

इस्तेमाल की जा सकने वाली मेट्रिक:

  • crashRate (google.type.Decimal): एग्रीगेशन की अवधि में, कम से कम एक बार क्रैश की गड़बड़ी का सामना करने वाले यूनीक उपयोगकर्ताओं का प्रतिशत.
  • crashRate7dUserWeighted (google.type.Decimal): पिछले सात दिनों में crashRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है.
  • crashRate28dUserWeighted (google.type.Decimal): पिछले 28 दिनों में crashRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है. हर घंटे के हिसाब से डेटा अपडेट करने की सुविधा के साथ काम नहीं करता.
  • userPerceivedCrashRate (google.type.Decimal): एग्रीगेशन की अवधि में, ऐप्लिकेशन का इस्तेमाल करने वाले उन लोगों का प्रतिशत जिन्होंने कम से कम एक क्रैश का सामना किया. इसे यूज़र-पर्सीव्ड क्रैश कहा जाता है. किसी ऐप्लिकेशन को तब सक्रिय माना जाता है, जब वह कोई गतिविधि दिखा रहा हो या किसी फ़ोरग्राउंड सेवा को लागू कर रहा हो.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): पिछले सात दिनों में userPerceivedCrashRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है. हर घंटे के हिसाब से डेटा अपडेट करने की सुविधा के साथ काम नहीं करता.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): पिछले 28 दिनों में userPerceivedCrashRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेट किया जाता है. हर घंटे के हिसाब से डेटा अपडेट करने की सुविधा के साथ काम नहीं करता.
  • distinctUsers (google.type.Decimal): एग्रीगेशन की अवधि में, उन यूनीक उपयोगकर्ताओं की संख्या जिन्हें crashRate और userPerceivedCrashRate मेट्रिक के लिए सामान्य बनाने वाली वैल्यू के तौर पर इस्तेमाल किया गया था. अगर कोई उपयोगकर्ता, एग्रीगेशन की अवधि के दौरान ऐप्लिकेशन का इस्तेमाल करता है, तो उसे इस मेट्रिक में शामिल किया जाता है. किसी ऐप्लिकेशन को तब सक्रिय माना जाता है, जब वह कोई गतिविधि दिखा रहा हो या किसी फ़ोरग्राउंड सेवा को लागू कर रहा हो. इस संख्या को और न बढ़ाएं, क्योंकि इससे उपयोगकर्ताओं को कई बार गिना जा सकता है. वैल्यू को 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 Android के सार्वजनिक तौर पर रिलीज़ किए गए सभी वर्शन से डेटा चुनने के लिए. यह डिफ़ॉल्ट रूप से होता है. ऊपर दिए गए सभी डाइमेंशन के साथ काम करता है.
  • APP_TESTERS उन उपयोगकर्ताओं का डेटा चुनने के लिए जिन्होंने टेस्टर बनने के लिए ऑप्ट-इन किया है. ऊपर दिए गए सभी डाइमेंशन के साथ काम करता है.
  • OS_BETA सिर्फ़ Android के बीटा वर्शन से डेटा चुनने के लिए. इसमें Android के रिलीज़ किए गए वर्शन का डेटा शामिल नहीं होता. सिर्फ़ इन डाइमेंशन का इस्तेमाल किया जा सकता है:
  • versionCode (int64): उपयोगकर्ता के डिवाइस पर चल रहे ऐप्लिकेशन का वर्शन.

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

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

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

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

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

object (MetricsRow)

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

nextPageToken

string

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

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

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

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

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