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): डिवाइस के जीपीयू का मेक, जैसे कि एआरएम.
  • deviceGpuModel (string): डिवाइस के जीपीयू का मॉडल, जैसे कि माली.
  • 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 देखें.