मेट्रिक सेट के लिए क्वेरी करना

सब कुछ सेट अप करने के बाद, 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 लाइनें दिखेंगी. ज़्यादा से ज़्यादा वैल्यू 10,000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर,उसे 10,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) का इस्तेमाल करते हैं, उन पैरामीटर का इस्तेमाल करके हर क्वेरी के नतीजों को कम करें, ताकि उन्हें मैनेज किया जा सके.