ডেটা এপিআই-এর ক্ষেত্রে নিম্নলিখিত সীমা ও কোটা প্রযোজ্য।
কোটা কীভাবে প্রযোজ্য হয়
Google Analytics Data API v1-এ করা সমস্ত অনুরোধের জন্য একটি Google Cloud প্রজেক্ট প্রয়োজন এবং এই পৃষ্ঠায় বর্ণিত কোটা প্রযোজ্য। কলিং প্রজেক্ট শনাক্ত করার জন্য ব্যবহৃত পদ্ধতি নির্বিশেষে কোটা খরচ হয়ে যায়, যার মধ্যে অন্তর্ভুক্ত রয়েছে:
- OAuth 2.0 ক্রেডেনশিয়াল দ্বারা অনুরোধগুলি প্রমাণীকৃত হয়েছে।
- শুধুমাত্র একটি এপিআই কী ব্যবহার করে অনুরোধগুলি প্রমাণীকৃত হয়।
কোটা এবং বিলিংয়ের উদ্দেশ্যে কোনো অনুরোধকে একটি নির্দিষ্ট গুগল ক্লাউড প্রজেক্টের সাথে যুক্ত করতে এপিআই কী ব্যবহার করা হয়। আপনার প্রজেক্টের ক্রেডেনশিয়াল বা এপিআই কী ব্যবহার করে করা সমস্ত এপিআই কল আপনার প্রজেক্টের এবং গুগল অ্যানালিটিক্স প্রপার্টির প্রযোজ্য কোটার আওতায় গণনা করা হবে।
কোটা বিভাগ
ডেটা এপিআই-এর তিনটি রিকোয়েস্ট কোটা ক্যাটাগরি রয়েছে: কোর, রিয়েলটাইম এবং ফানেল। কোর মেথডে করা এপিআই রিকোয়েস্টের জন্য কোর কোটা চার্জ করা হয়। রিয়েলটাইম মেথডে করা এপিআই রিকোয়েস্টের জন্য রিয়েলটাইম কোটা চার্জ করা হয়। প্রতিটি রিকোয়েস্ট শুধুমাত্র এক ধরনের কোটা ব্যবহার করে।
| কোটা বিভাগ | এপিআই পদ্ধতি |
|---|---|
| মূল | runReport , runPivotReport , batchRunReports , batchRunPivotReports , runAccessReport , getMetadata , checkCompatibility , createAudienceExports |
| রিয়েলটাইম | রানরিয়েলটাইমরিপোর্ট |
| ফানেল | রানফানেলরিপোর্ট |
অ্যানালিটিক্স সম্পত্তি কোটা
সকল অনুরোধই প্রপার্টি কোটা ব্যবহার করে।
| কোটার নাম | স্ট্যান্ডার্ড সম্পত্তি সীমা | অ্যানালিটিক্স ৩৬০ প্রপার্টি লিমিট |
|---|---|---|
| প্রতিদিন প্রতি প্রপার্টিতে কোর টোকেন | ২০০,০০০ | ২,০০০,০০০ |
| প্রতি ঘণ্টায় প্রতি সম্পত্তিতে কোর টোকেন | ৪০,০০০ | ৪০০,০০০ |
| প্রতি প্রজেক্টে, প্রতি প্রপার্টিতে, প্রতি ঘন্টায় কোর টোকেন | ১৪,০০০ | ১,৪০,০০০ |
| প্রতিটি প্রপার্টির জন্য মূল সমান্তরাল অনুরোধ | ১০ | ৫০ |
| প্রতি প্রজেক্টে, প্রতি প্রপার্টিতে, প্রতি ঘন্টায় কোর সার্ভার ত্রুটি | ১০ | ৫০ |
| প্রতিদিন প্রতি সম্পত্তির জন্য রিয়েলটাইম টোকেন | ২০০,০০০ | ২,০০০,০০০ |
| প্রতি সম্পত্তি প্রতি ঘন্টায় রিয়েলটাইম টোকেন | ৪০,০০০ | ৪০০,০০০ |
| প্রতি প্রজেক্ট, প্রতি প্রপার্টি, প্রতি ঘন্টায় রিয়েলটাইম টোকেন | ১৪,০০০ | ১,৪০,০০০ |
| প্রতিটি প্রপার্টির জন্য রিয়েলটাইম কনকারেন্ট রিকোয়েস্ট | ১০ | ৫০ |
| প্রতি প্রজেক্টে, প্রতি প্রপার্টিতে, প্রতি ঘন্টায় রিয়েলটাইম সার্ভার ত্রুটি | ১০ | ৫০ |
| প্রতিদিন প্রতি প্রপার্টির জন্য ফানেল টোকেন | ২০০,০০০ | ২,০০০,০০০ |
| প্রতি প্রপার্টি প্রতি ঘন্টায় ফানেল টোকেন | ৪০,০০০ | ৪০০,০০০ |
| প্রতি প্রজেক্ট, প্রতি প্রপার্টি, প্রতি ঘন্টায় ফানেল টোকেন | ১৪,০০০ | ১,৪০,০০০ |
| প্রতিটি প্রপার্টির জন্য ফানেল কনকারেন্ট রিকোয়েস্ট | ১০ | ৫০ |
| প্রতি প্রজেক্ট, প্রতি প্রপার্টি এবং প্রতি ঘন্টায় ফানেল সার্ভার ত্রুটি | ১০ | ৫০ |
- একই সাথে সম্পাদিত হওয়া অনুরোধের সংখ্যা দ্বারা যুগপৎ অনুরোধ পরিমাপ করা হয়। আপনার অনুরোধের যুগপৎতা কমাতে, অতিরিক্ত অনুরোধ পাঠানোর আগে পূর্ববর্তী অনুরোধগুলি সম্পূর্ণ হওয়ার জন্য অপেক্ষা করুন।
- সার্ভার এরর হলো ৫০০ এবং ৫০৩ কোড। সার্ভার এরর কোটা শুধুমাত্র তখনই চার্জ করা হয় যখন কোনো অনুরোধের ফলে সার্ভার এরর ঘটে। যখন কোনো প্রজেক্ট এবং প্রপার্টি জোড়ার জন্য সার্ভার এরর কোটা শেষ হয়ে যায়, তখন প্রজেক্ট থেকে প্রপার্টিতে করা সমস্ত অনুরোধ ব্লক করে দেওয়া হয়।
- প্রতিটি অনুরোধ 'Tokens Per Property Per Hour' এবং 'Tokens Per Project Per Property Per Hour' উভয়ের জন্যই কোটা ব্যবহার করে। এর মানে হলো, 'Tokens Per Project Per Property Per Hour' কোটা শেষ হওয়ার আগে 'Tokens Per Property Per Hour' কোটা শেষ হতে হলে একটি প্রপার্টিকে ৩টির বেশি প্রজেক্ট দ্বারা অ্যাক্সেস করতে হবে।
প্রতিটি প্রপার্টি প্রতি ঘন্টায় ১২০টি সম্ভাব্য থ্রেশহোল্ডযুক্ত অনুরোধ গ্রহণ করতে পারে। userAgeBracket , userGender , brandingInterest , audienceId , এবং audienceName ডাইমেনশনগুলো সম্ভাব্যভাবে থ্রেশহোল্ডযুক্ত। কোনো রিপোর্ট দেখছেন এমন কেউ যাতে স্বতন্ত্র ব্যবহারকারীদের জনসংখ্যাগত তথ্য বা আগ্রহ অনুমান করতে না পারেন, সেজন্য এই থ্রেশহোল্ডগুলো প্রয়োগ করা হয়।
সম্পত্তি টোকেন কোটা
Google Analytics Data API v1-এ প্রতিটি অনুরোধের জন্য টোকেন খরচ হয়। কতগুলো টোকেন খরচ হবে তা অনুরোধের জটিলতার উপর নির্ভর করে। যদিও বেশিরভাগ অনুরোধের জন্য ১০টি বা তার কম টোকেন খরচ হয়, তবে আরও জটিল অনুরোধের ক্ষেত্রে বেশি টোকেন খরচ হবে।
টোকেন ব্যবহারকে প্রভাবিত করে এমন কারণসমূহ
একটি অনুরোধের সঠিক টোকেন খরচ সেটি কার্যকর করার সময়েই নির্ধারিত হয়, ফলে আগে থেকে নির্ভুল হিসাব করা কঠিন হয়ে পড়ে। এই খরচ অনুরোধটি নিজে এবং গুগল অ্যানালিটিক্স প্রপার্টির অন্তর্নিহিত ডেটা সম্পর্কিত বিভিন্ন কারণের সমন্বয়ে প্রভাবিত হয়। এই কারণগুলোর ফলে খরচ বেশি হতে পারে:
- সারির সংখ্যা: আরও বেশি সংখ্যক সারির অনুরোধ করা হচ্ছে।
- মাত্রা ও মেট্রিকের সংখ্যা: অধিক সংখ্যক মাত্রা ও মেট্রিক অন্তর্ভুক্ত করা।
- ফিল্টারের জটিলতা: জটিল ফিল্টার এক্সপ্রেশনের ব্যবহার।
- তারিখের পরিসরের দৈর্ঘ্য: দীর্ঘতর তারিখের সময়কালের জন্য অনুসন্ধান করা।
- ডেটা কার্ডিনালিটি: উচ্চ কার্ডিনালিটি সম্পন্ন ডাইমেনশন (অনেকগুলো অনন্য মান, যেমন
pagePath, কাস্টম ডাইমেনশন) টোকেনের খরচ উল্লেখযোগ্যভাবে বাড়িয়ে দিতে পারে। - প্রপার্টি ইভেন্টের পরিমাণ: যে প্রপার্টিগুলোতে ইভেন্টের পরিমাণ বেশি, সেগুলোতে করা কোয়েরি কম ডেটাযুক্ত প্রপার্টির একই কোয়েরির চেয়ে বেশি টোকেন ব্যবহার করতে পারে।
টোকেন ব্যবহার পর্যবেক্ষণ
আপনার নির্দিষ্ট এপিআই কলগুলোর জন্য টোকেন খরচ নির্ধারণের সবচেয়ে কার্যকর উপায় হলো রিকোয়েস্ট বডিতে "returnPropertyQuota": true প্যারামিটারটি অন্তর্ভুক্ত করা। এরপর এপিআই রেসপন্সে PropertyQuota অবজেক্টটি অন্তর্ভুক্ত থাকবে, যেখানে সেই নির্দিষ্ট রিকোয়েস্টের জন্য ব্যবহৃত টোকেন এবং অবশিষ্ট কোটা ব্যালেন্সের বিস্তারিত বিবরণ দেওয়া থাকে।