এই ডকুমেন্টটি Google Analytics রিপোর্টিং API v4 এর জন্য রিসোর্স ভিত্তিক কোটা সিস্টেম বর্ণনা করে, যা শুধুমাত্র Analytics 360 গ্রাহকদের জন্য উপলব্ধ। API-এ প্রয়োগ করা সীমার সম্পূর্ণ সেটের জন্য API সীমা এবং কোটা দেখুন।
ভূমিকা
শেয়ার্ড রিসোর্সের প্রাপ্যতা এবং নির্ভরযোগ্যতা নিশ্চিত করতে, অ্যানালিটিক্স রিপোর্টিং এপিআই অ্যাক্সেস করে এমন প্রতিটি প্রোজেক্ট সীমা এবং কোটা সাপেক্ষে। বড় ডেটাসেট অনুসন্ধান করার সময়, অ্যানালিটিক্স রিপোর্টিং API দ্বারা স্যাম্পলিং নিযুক্ত করা হতে পারে, যা আপনার ডেটার ফলাফলকে প্রভাবিত করতে পারে।
রিসোর্স ভিত্তিক কোটা সিস্টেম হল একটি নতুন কোটা সিস্টেম যা Analytics 360 অ্যাকাউন্টগুলিকে অ্যানালিটিক্স রিপোর্টিং API ব্যবহার করার সময় উচ্চতর স্যাম্পলিং থ্রেশহোল্ডগুলিকে সক্ষম করবে৷ এই সিস্টেমটি ঐচ্ছিক এবং ভিউ এবং প্রোজেক্টে স্থাপিত বিদ্যমান সীমা থেকে স্বাধীন, যেমন Google API কনসোলের কোটা পৃষ্ঠায় রিপোর্ট করা হয়েছে।
সম্পদ ভিত্তিক কোটা
সব অনুরোধ সমান তৈরি করা হয় না; কিছু অনুরোধ গণনাগতভাবে অন্যদের তুলনায় অনেক বেশি ব্যয়বহুল। সম্পদ ভিত্তিক কোটা সিস্টেমটি বিশ্লেষণ রিপোর্টিং পরিকাঠামো রক্ষা করার সময় নমুনার উচ্চ থ্রেশহোল্ড সমর্থন করার জন্য ডিজাইন করা হয়েছে।
প্রতিটি সম্পত্তি কোয়েরি সম্পদ টোকেন একটি সেট পরিমাণ বরাদ্দ করা হবে. API ক্লায়েন্ট আপেক্ষিক ক্যোয়ারী রিসোর্স টোকেনের বিনিময়ে নমুনা নেওয়ার একটি উচ্চ থ্রেশহোল্ড পেতে API অনুরোধে একটি ঐচ্ছিক ক্ষেত্র যোগ করতে পারে। একটি গণনাগতভাবে আরও ব্যয়বহুল অনুরোধের জন্য আরও টোকেন প্রয়োজন হবে।
স্যাম্পলিং থ্রেশহোল্ড
Google Analytics API v4 ব্যবহার করে ডেটার জন্য অনুরোধগুলি অনুরোধ করা তারিখের সীমার (প্রপার্টি লেভেলে) জন্য সেশনের সংখ্যার উপর ভিত্তি করে নিম্নলিখিত সাধারণ নমুনা থ্রেশহোল্ডের সাপেক্ষে:
- অ্যানালিটিক্স স্ট্যান্ডার্ড: 500k সেশন
- Analytics 360: 1M সেশন
- সম্পদ ভিত্তিক কোটা ব্যবহার করে Analytics 360: 100M সেশন
সম্পদ ভিত্তিক কোটা সক্ষম করুন
একটি প্রদত্ত অনুরোধের জন্য সংস্থান ভিত্তিক কোটা সক্ষম করতে, API কলটিতে batchGet পদ্ধতিতে ঐচ্ছিক ক্ষেত্র useResourceQuotas অন্তর্ভুক্ত করতে হবে।
{
"reportRequests": [{object(ReportRequest)}],
"useResourceQuotas": boolean,
}
উদাহরণ স্বরূপ:
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2017-06-15",
"endDate":"2017-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}],
"useResourceQuotas": true
}
কোয়েরি রিসোর্স খরচ প্রতিক্রিয়া ক্ষেত্র
batchGet পদ্ধতিতে প্রতিটি কলের জন্য, প্রতিক্রিয়াতে একটি queryCost ক্ষেত্র থাকবে।
{
"reports": [{ object(Report) }],
"queryCost": number
}
queryCost ক্ষেত্রটি একটি পূর্ণসংখ্যা যা batchGet অনুরোধে সমস্ত ReportRequests এর মোট সম্পদ খরচের প্রতিনিধিত্ব করে। উদাহরণ স্বরূপ:
{
"reports": [
{
"columnHeader": {...},
"data": {
"rows": [...]
}
}
],
"queryCost": 1337
}
কোটা বরাদ্দ
Analytics 360 প্রপার্টি কোটা
- সম্পত্তি প্রতি প্রতিদিন 100,000 ক্যোয়ারী খরচ ইউনিট.
- প্রতি ঘন্টায় 25,000 ক্যোয়ারী খরচ ইউনিট প্রতি সম্পত্তি.
আপনি যদি আপনার কোটা সীমা অতিক্রম করেন তাহলে আপনি একটি RESOURCE_EXHAUSTED ত্রুটি পাবেন৷ বিস্তারিত জানার জন্য ত্রুটি প্রতিক্রিয়া দেখুন.
খরচের হিসাব
একটি অনুরোধের খরচ সমানুপাতিক:
- তারিখ ব্যাপ্তির আকার।
- ভিউ এর মধ্যে হিট সংখ্যা.
- অনুরোধ করা মাত্রার মূলত্ব।
- অনুরোধ করা মাত্রা এবং মেট্রিক্সের সংখ্যা।
- সেগমেন্ট এবং ফিল্টার সংজ্ঞা জটিলতা.
- অনুরোধ করা তথ্যের প্রক্রিয়াকরণের স্থিতি (আজকের ডেটা অনুরোধ করা গতকালের ডেটার অনুরোধের চেয়ে বেশি ব্যয়বহুল)।
- কোয়েরি টাইম ইম্পোর্ট ডাইমেনশন এবং মেট্রিক্সের উপস্থিতি।
API সীমা এবং ব্যবহার
রিসোর্স ভিত্তিক কোটা সিস্টেমের পাশাপাশি, APIগুলিকে Analytics API v4-এর সীমা এবং কোটা দ্বারাও নিয়ন্ত্রিত করা হয়।
মন্তব্য
-
queryCostপ্রতিক্রিয়া ক্ষেত্র একটি অনুরোধের গণনামূলক খরচ প্রতিনিধিত্ব করে। এটি একটি আর্থিক খরচ নয়, এবং API ব্যবহার করার জন্য বিনামূল্যে। - ইনট্রাডে এবং নির্দিষ্ট কিছু ঐতিহাসিক ডেটা (1+ বছর পুরানো) রিপোর্টগুলি এখনও নমুনার সাপেক্ষে হতে পারে,
useResourceQuotasসেটিং নির্বিশেষে। - যদি একটি উচ্চতর নমুনা থ্রেশহোল্ড একটি অনুরোধের জন্য সন্তুষ্ট না হতে পারে, তাহলে রিসোর্স কোটা টোকেন কাটা হবে না (স্যাম্পল রেসপন্সে সবসময় শূন্য রিসোর্স কোটা খরচ থাকে)।
- একটি প্রতিবেদনে নমুনাযুক্ত ডেটা থাকে যদি ক্ষেত্রগুলি
samplesReadCounts,samplingSpaceSizesপ্রতিক্রিয়াতে উপস্থিত থাকে।
আপনার প্রকল্পের ব্যবহারের সীমা দেখতে বা পরিবর্তন করতে, বা আপনার কোটা বৃদ্ধির অনুরোধ করতে, নিম্নলিখিতগুলি করুন:
- আপনার যদি আপনার প্রকল্পের জন্য ইতিমধ্যে একটি বিলিং অ্যাকাউন্ট না থাকে, তাহলে একটি তৈরি করুন৷
- API কনসোলে API লাইব্রেরির সক্ষম APIs পৃষ্ঠায় যান এবং তালিকা থেকে একটি API নির্বাচন করুন।
- কোটা-সম্পর্কিত সেটিংস দেখতে এবং পরিবর্তন করতে, কোটা নির্বাচন করুন। ব্যবহারের পরিসংখ্যান দেখতে, ব্যবহার নির্বাচন করুন।