মেট্রিক সেট জিজ্ঞাসা করা

আপনি সবকিছু সেট আপ করার পরে, আপনি মেট্রিক সেট সম্পর্কে মেটাডেটা পুনরুদ্ধার করতে এবং তাদের মেট্রিক্স জিজ্ঞাসা করতে Google Play বিকাশকারী রিপোর্টিং API এ অনুরোধ পাঠাতে পারেন৷

নিম্নলিখিত কোড নমুনাগুলি দেখায় কিভাবে কয়েকটি সহজ অনুরোধ পাঠাতে হয়। উদাহরণস্বরূপ, নীচের পদ্ধতিগুলি আপনাকে দেখায় কিভাবে আপনার অ্যাপের জন্য বিভিন্ন মেট্রিক্স পুনরুদ্ধার করতে হয়। কিছু ভিন্ন ক্যোয়ারী প্যারামিটার আছে যা আপনার ক্যোয়ারী সংকীর্ণ করতে ব্যবহার করা যেতে পারে।

মেট্রিক সেট মেটাডেটা পুনরুদ্ধার করা হচ্ছে

নিম্নলিখিত উদাহরণটি একটি কাল্পনিক অ্যাপ্লিকেশনের জন্য ক্র্যাশ রেট মেট্রিক সেটের মেটাডেটা পুনরুদ্ধার করে, com.example.app ।

সহজ অনুরোধ:

এই HTTP 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" }
    ]
  }
}

ক্যোয়ারী বৈশিষ্ট্য ব্যবহার করে

এই একই সংস্থানের জন্য নিম্নলিখিত HTTP 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 ফেরত ডেটার সর্বাধিক আকার। অনির্দিষ্ট থাকলে, সর্বাধিক 1000টি সারি ফেরত দেওয়া হবে। সর্বোচ্চ মান হল 100,000; 100,000 এর উপরে মান 100,000 তে জোর করা হবে।

হ্যান্ডলিং প্রতিক্রিয়া

একটি সার্ভার বৈধ ক্ষেত্রগুলি সহ একটি বৈধ অনুরোধ প্রক্রিয়া করার পরে, এটি অনুরোধ করা ডেটা সহ একটি HTTP 200 OK স্ট্যাটাস কোড ফেরত পাঠায়৷ যদি fields ক্যোয়ারী প্যারামিটারে একটি ত্রুটি থাকে বা অন্যথায় অবৈধ হয়, সার্ভারটি একটি HTTP 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"
}

দ্রষ্টব্য: ডাটা পেজিনেশনের জন্য ক্যোয়ারী প্যারামিটার সমর্থন করে এমন APIগুলির জন্য ( maxResults এবং nextPageToken , উদাহরণস্বরূপ), প্রতিটি কোয়েরির ফলাফলগুলিকে একটি পরিচালনাযোগ্য আকারে কমাতে সেই প্যারামিটারগুলি ব্যবহার করুন৷