ডেটা এপিআই-এর ক্ষেত্রে নিম্নলিখিত সীমা ও কোটা প্রযোজ্য।
কোটা কীভাবে প্রযোজ্য হয়
Google Analytics Data API v1-এ করা সমস্ত অনুরোধের জন্য একটি Google Cloud প্রজেক্ট প্রয়োজন এবং এই পৃষ্ঠায় বর্ণিত কোটা প্রযোজ্য। কলিং প্রজেক্ট শনাক্ত করার জন্য ব্যবহৃত পদ্ধতি নির্বিশেষে কোটা খরচ হয়ে যায়, যার মধ্যে অন্তর্ভুক্ত রয়েছে:
- OAuth 2.0 ক্রেডেনশিয়াল দ্বারা অনুরোধগুলি প্রমাণীকৃত হয়েছে।
- শুধুমাত্র একটি এপিআই কী ব্যবহার করে অনুরোধগুলি প্রমাণীকৃত হয়।
কোটা এবং বিলিংয়ের উদ্দেশ্যে কোনো অনুরোধকে একটি নির্দিষ্ট গুগল ক্লাউড প্রজেক্টের সাথে যুক্ত করতে এপিআই কী ব্যবহার করা হয়। আপনার প্রজেক্টের ক্রেডেনশিয়াল বা এপিআই কী ব্যবহার করে করা সমস্ত এপিআই কল আপনার প্রজেক্টের এবং গুগল অ্যানালিটিক্স প্রপার্টির প্রযোজ্য কোটার আওতায় গণনা করা হবে।
কোটা বিভাগ
ডেটা এপিআই-এর চারটি অনুরোধ কোটা বিভাগ রয়েছে: কোর, রিয়েলটাইম, ফানেল এবং চ্যাট।
কোর মেথডগুলিতে করা এপিআই অনুরোধের জন্য কোর কোটা চার্জ করা হয়। রিয়েলটাইম মেথডগুলিতে করা এপিআই অনুরোধের জন্য রিয়েলটাইম কোটা চার্জ করা হয়। ফানেল মেথডগুলিতে করা এপিআই অনুরোধের জন্য ফানেল কোটা চার্জ করা হয়। চ্যাট মেথডগুলিতে করা এপিআই অনুরোধের জন্য চ্যাট কোটা চার্জ করা হয়। প্রতিটি অনুরোধ শুধুমাত্র এক ধরনের কোটা ব্যবহার করে।
| কোটা বিভাগ | এপিআই পদ্ধতি |
|---|---|
| মূল | runReport , runPivotReport , batchRunReports , batchRunPivotReports , runAccessReport , getMetadata , checkCompatibility , createAudienceExports |
| রিয়েলটাইম | রানরিয়েলটাইমরিপোর্ট |
| ফানেল | রানফানেলরিপোর্ট |
| চ্যাট | properties.chat |
অ্যানালিটিক্স সম্পত্তি কোটা
সকল অনুরোধই প্রপার্টি কোটা ব্যবহার করে।
| কোটার নাম | স্ট্যান্ডার্ড সম্পত্তি সীমা | অ্যানালিটিক্স ৩৬০ প্রপার্টি লিমিট |
|---|---|---|
| প্রতিদিন প্রতি প্রপার্টিতে কোর টোকেন | ২০০,০০০ | ২,০০০,০০০ |
| প্রতি ঘণ্টায় প্রতি সম্পত্তিতে কোর টোকেন | ৪০,০০০ | ৪০০,০০০ |
| প্রতি প্রজেক্টে, প্রতি প্রপার্টিতে, প্রতি ঘন্টায় কোর টোকেন | ১৪,০০০ | ১,৪০,০০০ |
| প্রতিটি প্রপার্টির জন্য মূল সমান্তরাল অনুরোধ | ১০ | ৫০ |
| প্রতি প্রজেক্টে, প্রতি প্রপার্টিতে, প্রতি ঘন্টায় কোর সার্ভার ত্রুটি | ১০ | ৫০ |
| প্রতিদিন প্রতি সম্পত্তির জন্য রিয়েলটাইম টোকেন | ২০০,০০০ | ২,০০০,০০০ |
| প্রতি সম্পত্তি প্রতি ঘন্টায় রিয়েলটাইম টোকেন | ৪০,০০০ | ৪০০,০০০ |
| প্রতি প্রজেক্ট, প্রতি প্রপার্টি, প্রতি ঘন্টায় রিয়েলটাইম টোকেন | ১৪,০০০ | ১,৪০,০০০ |
| প্রতিটি প্রপার্টির জন্য রিয়েলটাইম কনকারেন্ট রিকোয়েস্ট | ১০ | ৫০ |
| প্রতি প্রজেক্টে, প্রতি প্রপার্টিতে, প্রতি ঘন্টায় রিয়েলটাইম সার্ভার ত্রুটি | ১০ | ৫০ |
| প্রতিদিন প্রতি প্রপার্টির জন্য ফানেল টোকেন | ২০০,০০০ | ২,০০০,০০০ |
| প্রতি প্রপার্টি প্রতি ঘন্টায় ফানেল টোকেন | ৪০,০০০ | ৪০০,০০০ |
| প্রতি প্রজেক্ট, প্রতি প্রপার্টি, প্রতি ঘন্টায় ফানেল টোকেন | ১৪,০০০ | ১,৪০,০০০ |
| প্রতিটি প্রপার্টির জন্য ফানেল কনকারেন্ট রিকোয়েস্ট | ১০ | ৫০ |
| প্রতি প্রজেক্ট, প্রতি প্রপার্টি এবং প্রতি ঘন্টায় ফানেল সার্ভার ত্রুটি | ১০ | ৫০ |
| প্রতিদিন প্রতি প্রপার্টির জন্য চ্যাট টোকেন | ৩৭,৫০,০০০ | ৩৭,৫০,০০০ |
| প্রতি প্রপার্টি প্রতি ঘন্টায় চ্যাট টোকেন | ৫০০,০০০ | ৫০০,০০০ |
- একই সাথে সম্পাদিত হওয়া অনুরোধের সংখ্যা দ্বারা যুগপৎ অনুরোধ পরিমাপ করা হয়। আপনার অনুরোধের যুগপৎতা কমাতে, অতিরিক্ত অনুরোধ পাঠানোর আগে পূর্ববর্তী অনুরোধগুলি সম্পূর্ণ হওয়ার জন্য অপেক্ষা করুন।
- সার্ভার এরর হলো ৫০০ এবং ৫০৩ কোড। সার্ভার এরর কোটা শুধুমাত্র তখনই চার্জ করা হয় যখন কোনো অনুরোধের ফলে সার্ভার এরর হয়। যখন কোনো প্রজেক্ট এবং প্রপার্টি জোড়ার জন্য সার্ভার এরর কোটা শেষ হয়ে যায়, তখন প্রজেক্ট থেকে প্রপার্টিতে করা সমস্ত অনুরোধ ব্লক করে দেওয়া হয়। এরর রেসপন্সের সম্পূর্ণ তালিকার জন্য, এরর রেসপন্স দেখুন।
- প্রতিটি অনুরোধ '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-এ প্রতিটি অনুরোধের জন্য টোকেন খরচ হয়। কতগুলো টোকেন খরচ হবে তা অনুরোধের জটিলতার উপর নির্ভর করে। যদিও বেশিরভাগ অনুরোধের জন্য ১০ বা তার কম টোকেন খরচ হয়, তবে আরও জটিল অনুরোধের (যেমন Analytics Advisor chat কোয়েরি) জন্য বেশি টোকেন খরচ হয়।
টোকেন ব্যবহারকে প্রভাবিত করে এমন কারণসমূহ
একটি অনুরোধের সঠিক টোকেন খরচ সেটি কার্যকর করার সময়েই নির্ধারিত হয়, ফলে আগে থেকে নির্ভুল হিসাব করা কঠিন হয়ে পড়ে। এই খরচ অনুরোধটি নিজে এবং গুগল অ্যানালিটিক্স প্রপার্টির অন্তর্নিহিত ডেটা সম্পর্কিত বিভিন্ন কারণের সমন্বয়ে প্রভাবিত হয়। এই কারণগুলোর ফলে খরচ বেশি হতে পারে:
- সারির সংখ্যা: আরও বেশি সংখ্যক সারির অনুরোধ করা হচ্ছে।
- মাত্রা ও মেট্রিকের সংখ্যা: অধিক সংখ্যক মাত্রা ও মেট্রিক অন্তর্ভুক্ত করা।
- ফিল্টারের জটিলতা: জটিল ফিল্টার এক্সপ্রেশনের ব্যবহার।
- তারিখের পরিসরের দৈর্ঘ্য: দীর্ঘতর তারিখের সময়কালের জন্য অনুসন্ধান করা।
- ডেটা কার্ডিনালিটি: উচ্চ কার্ডিনালিটি সম্পন্ন ডাইমেনশন (অনেকগুলো অনন্য মান, যেমন
pagePath, কাস্টম ডাইমেনশন) টোকেনের খরচ উল্লেখযোগ্যভাবে বাড়িয়ে দিতে পারে। - প্রপার্টি ইভেন্টের পরিমাণ: যে প্রপার্টিগুলোতে ইভেন্টের পরিমাণ বেশি, সেগুলোতে করা কোয়েরি কম ডেটাযুক্ত প্রপার্টির একই কোয়েরির চেয়ে বেশি টোকেন ব্যবহার করতে পারে।
টোকেন ব্যবহার পর্যবেক্ষণ
আপনার নির্দিষ্ট এপিআই কলগুলোর জন্য টোকেন খরচ নির্ধারণের সবচেয়ে কার্যকর উপায় হলো রিকোয়েস্ট বডিতে "returnPropertyQuota": true প্যারামিটারটি অন্তর্ভুক্ত করা। এরপর এপিআই রেসপন্সে PropertyQuota অবজেক্টটি অন্তর্ভুক্ত থাকবে, যেখানে সেই নির্দিষ্ট রিকোয়েস্টের জন্য ব্যবহৃত টোকেন এবং অবশিষ্ট কোটা ব্যালেন্সের বিস্তারিত বিবরণ দেওয়া থাকে।
চ্যাট টোকেন ব্যবহার এবং পর্যবেক্ষণ
অ্যানালিটিক্স অ্যাডভাইজর chat অনুরোধের ক্ষেত্রে, টোকেনগুলো মডেলের গণনা, যুক্তি এবং অন্তর্নিহিত ডেটা পুনরুদ্ধারের খরচকে প্রতিনিধিত্ব করে। চ্যাট টোকেনের ব্যবহার নিম্নলিখিত বিষয়গুলো দ্বারা প্রভাবিত হয়:
- অনুসন্ধান ও বিশ্লেষণমূলক পরিধি: অনুরোধকৃত বিশ্লেষণের জটিলতা ও ব্যাপকতা।
- মডেলের ইনপুট ও আউটপুট টোকেন: প্রক্রিয়াকৃত প্রাসঙ্গিক ডেটার পরিমাণ এবং উৎপন্ন প্রতিক্রিয়া বিবরণ।
- চিন্তন প্রতীক: প্রাপ্ত ফলাফল সংশ্লেষণ করার জন্য প্রয়োজনীয় যুক্তির আদর্শ ধাপসমূহ।
- কার্য সম্পাদন বিলম্ব: একাধিক ধাপে তথ্য অনুসন্ধানের জন্য প্রয়োজনীয় প্রক্রিয়াকরণের সময়।
চ্যাট টোকেন ব্যবহার নিরীক্ষণ করতে, আপনার ChatRequest এ "returnPropertyQuota": true সেট করুন। প্রতিক্রিয়াটিতে PropertyChatQuota অবজেক্টটি অন্তর্ভুক্ত থাকবে, যেখানে tokensPerDay এবং tokensPerHour ফিল্ডগুলিতে ব্যবহৃত এবং অবশিষ্ট ব্যালেন্স দেখানো হবে।