क्वेरी मेट्रिक सेट

सब कुछ सेट अप करने के बाद, मेट्रिक सेट के बारे में मेटाडेटा वापस पाने और उनकी मेट्रिक के बारे में क्वेरी करने के लिए, Google Play Developer Reporting API से अनुरोध भेजे जा सकते हैं.

कोड के इन नमूनों में कुछ आसान अनुरोध भेजने का तरीका बताया गया है. उदाहरण के लिए, नीचे दिए गए तरीकों से पता चलता है कि अपने ऐप्लिकेशन के लिए अलग-अलग मेट्रिक कैसे पाएं. क्वेरी के हिसाब से क्वेरी करने के लिए, क्वेरी के कुछ अलग-अलग पैरामीटर इस्तेमाल किए जा सकते हैं.

मेट्रिक सेट के मेटाडेटा को वापस लाया जा रहा है

इस उदाहरण में, एक काल्पनिक ऐप्लिकेशन com.example.app के लिए सेट की गई क्रैश रेट की मेट्रिक का मेटाडेटा दिया गया है.

आसान अनुरोध:

यह एचटीटीपी GET अनुरोध, ऐप्लिकेशन के नाम के पैरामीटर के बारे में बताता है. साथ ही, आपके ऐप्लिकेशन से जुड़ा पूरा मेट्रिक रिसॉर्स दिखाता है.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet

मेट्रिक की जानकारी का जवाब:

रिस्पॉन्स में, मेट्रिक सेट से जुड़े ये फ़ील्ड शामिल हैं:

{
  "freshness_info": {
    "freshness": [
      "aggregation_period": "DAILY"
      "latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
    ]
  }
}

क्वेरी सुविधा का इस्तेमाल करना

इस संसाधन के लिए, नीचे दिया गया एचटीटीपी POSTअनुरोध, मेट्रिक सेट से खास डेटा वापस पाने के लिए, query एंडपॉइंट का इस्तेमाल करता है.

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

अनुरोध के मुख्य हिस्से में, खास विकल्पों के आधार पर मेट्रिक को फिर से पाने के लिए, क्वेरी के विकल्पों को पास करें.

{
  "timeline_spec": {
    "aggregation_period": "DAILY"
    "start_time": { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
    "end_time": { year: "2021" month: "7" day: "3" time_zone: "America/Los_Angeles" }
   }
  "dimensions": ["apiLevel"]
  "metrics": ["errorReportCount", "distinctUsers"]
  "page_size": "10"
}

यहां कलेक्शन लेवल के कुछ उदाहरण दिए गए हैं:

फ़ील्ड
timelineSpec	object (TimelineSpec) टाइमलाइन के एग्रीगेशन पैरामीटर की जानकारी. इकट्ठा किए जाने वाले पीरियड के साथ काम करने वाली अवधियों की सूची देखने के लिए, कृपया हर मेट्रिक सेट के दस्तावेज़ देखें.
dimensions[]	string डाइमेंशन, जिनके हिसाब से मेट्रिक को बांटा जाता है. कौनसे डाइमेंशन काम करते हैं, इसकी सूची देखने के लिए कृपया हर मेट्रिक सेट के दस्तावेज़ देखें.
metrics[]	string कुल मेट्रिक.
pageSize	integer दिखाए गए डेटा का ज़्यादा से ज़्यादा साइज़. अगर कोई वैल्यू तय नहीं की गई है, तो ज़्यादा से ज़्यादा 1,000 लाइनें दिखाई जाएंगी. वैल्यू 1,00,000 से ज़्यादा नहीं होनी चाहिए. अगर वैल्यू 1,00,000 से ज़्यादा है, तो वैल्यू को 1,00,000 कर दिया जाएगा.

जवाबों को संभालना

जब सर्वर मान्य अनुरोध को प्रोसेस कर लेता है, जिसमें मान्य फ़ील्ड शामिल होते हैं, तब वह अनुरोध किए गए डेटा के साथ एचटीटीपी 200 OK स्टेटस कोड वापस भेजता है. अगर fields क्वेरी पैरामीटर में कोई गड़बड़ी है या वह गलत है, तो सर्वर एचटीटीपी 400 Bad Request स्टेटस कोड के साथ, उपयोगकर्ता को एक गड़बड़ी का मैसेज दिखाता है. इस मैसेज में, उपयोगकर्ता को उसके चुने गए फ़ील्ड के साथ क्या गड़बड़ी है (उदाहरण के लिए, "Invalid field timeline_spec") दी जाती है.

यह शुरुआती सेक्शन में जवाब का उदाहरण है.

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

जवाब कुछ ऐसा दिखेगा:

200 OK

{
  rows: [
    {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "20"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "100"},
        {metric: "distinctUsers" decimal_value: "57"},
      ]
    }, {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "21"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "123"},
        {metric: "distinctUsers" decimal_value: "65"},
      ]
    },
    ...
  ]
  next_page_token: "eW91IGhhdmUgdG9vIG11Y2ggZnJlZSB0aW1l"
}

ध्यान दें: डेटा पेज पर नंबर डालने के लिए क्वेरी पैरामीटर के साथ काम करने वाले एपीआई (उदाहरण के लिए, maxResults और nextPageToken) के लिए, उन पैरामीटर का इस्तेमाल करें, ताकि हर क्वेरी के नतीजों को मैनेज किए जा सकने वाले साइज़ में बदला जा सके.