ব্যবহারের সীমা

যেহেতু গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই একটি শেয়ার্ড সার্ভিস, তাই সকল ব্যবহারকারী যেন এটি ন্যায্যভাবে ব্যবহার করে এবং গুগল ওয়ার্কস্পেসের সার্বিক পারফরম্যান্স সুরক্ষিত থাকে, তা নিশ্চিত করতে আমরা কোটা ও সীমাবদ্ধতা প্রয়োগ করি।

আপনি কোটা অতিক্রম করলে, একটি 429: Too many requests HTTP স্ট্যাটাস কোড রেসপন্স পাবেন। Google Workspace Events API ব্যাকএন্ডে অতিরিক্ত রেট লিমিট চেকের কারণেও একই এরর রেসপন্স তৈরি হতে পারে। এই এররটি ঘটলে, একটি এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম ব্যবহার করুন এবং পরে আবার চেষ্টা করুন। যতক্ষণ আপনি নিচের টেবিলগুলোতে তালিকাভুক্ত প্রতি-মিনিটের কোটার মধ্যে থাকবেন, ততক্ষণ প্রতিদিন আপনার করা রিকোয়েস্টের সংখ্যার কোনো সীমা নেই।

প্রকল্প-ভিত্তিক কোটা

প্রকল্প-ভিত্তিক কোটা একটি গুগল ক্লাউড প্রকল্পের জন্য কোয়েরির হার সীমিত করে, এবং একারণে তা প্রতিটি কোটার জন্য নির্দিষ্ট গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই মেথড কলকারী একটিমাত্র অ্যাপের ক্ষেত্রে প্রযোজ্য হয়।

নিম্নলিখিত সারণীতে প্রকল্প-ভিত্তিক কোয়েরি সীমা বিস্তারিতভাবে দেওয়া আছে। আপনি গুগল ক্লাউড কনসোলের কোটা পৃষ্ঠাতেও এই সীমাগুলো খুঁজে পেতে পারেন।

প্রকল্প-ভিত্তিক কোটা	গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই পদ্ধতি	সীমা
প্রতি মিনিটে লেখে	Subscriptions.create Subscriptions.patch Subscriptions.delete Subscriptions.reactivate	৬০০
প্রতি ব্যবহারকারী প্রতি মিনিটে লেখে	Subscriptions.create Subscriptions.patch Subscriptions.delete Subscriptions.reactivate	১০০
প্রতি মিনিটে পঠন	Subscriptions.get Subscriptions.list	৬০০
প্রতি ব্যবহারকারী প্রতি মিনিটে পঠন সংখ্যা	Subscriptions.get Subscriptions.list	১০০

সময়-ভিত্তিক কোটা ত্রুটি সমাধান করুন

সমস্ত সময়-ভিত্তিক ত্রুটির (প্রতি X মিনিটে সর্বোচ্চ N সংখ্যক অনুরোধ) ক্ষেত্রে, আমরা সুপারিশ করি যে আপনার কোড যেন এক্সেপশনটি ক্যাচ করে এবং একটি ট্রাঙ্কেটেড এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে, যাতে আপনার ডিভাইসগুলো অতিরিক্ত লোড তৈরি না করে।

এক্সপোনেনশিয়াল ব্যাকঅফ হলো নেটওয়ার্ক অ্যাপ্লিকেশনগুলির জন্য একটি আদর্শ ত্রুটি পরিচালনা কৌশল। একটি এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম একটি সর্বোচ্চ ব্যাকঅফ সময় পর্যন্ত, অনুরোধগুলির মধ্যে সূচকীয়ভাবে ক্রমবর্ধমান অপেক্ষার সময় ব্যবহার করে অনুরোধগুলি পুনরায় চেষ্টা করে। যদি অনুরোধগুলি তখনও অসফল হয়, তবে অনুরোধটি সফল না হওয়া পর্যন্ত সময়ের সাথে সাথে অনুরোধগুলির মধ্যে বিলম্ব বাড়ানো গুরুত্বপূর্ণ।

উদাহরণ অ্যালগরিদম

একটি এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম অনুরোধগুলোকে সূচকীয় হারে পুনরায় চেষ্টা করে, এবং একটি সর্বোচ্চ ব্যাকঅফ সময় পর্যন্ত পুনরায় চেষ্টার মধ্যবর্তী অপেক্ষার সময় বাড়িয়ে দেয়। উদাহরণস্বরূপ:

1. গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই-তে একটি অনুরোধ পাঠান।
2. অনুরোধটি ব্যর্থ হলে, 1 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন।
3. অনুরোধটি ব্যর্থ হলে, 2 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন।
4. অনুরোধটি ব্যর্থ হলে, 4 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন।
5. এবং এভাবেই চলতে থাকে, একটি maximum_backoff সময় পর্যন্ত।
6. একটি নির্দিষ্ট সর্বোচ্চ সংখ্যক বার পর্যন্ত অপেক্ষা করতে ও পুনরায় চেষ্টা করতে থাকুন, কিন্তু দুটি চেষ্টার মধ্যবর্তী অপেক্ষার সময়কাল বাড়াবেন না।

যেখানে:

• অপেক্ষার সময় হলো min(((2^n)+random_number_milliseconds), maximum_backoff) , যেখানে প্রতিটি ইটারেশন (অনুরোধ)-এর জন্য n মান ১ করে বৃদ্ধি পায়।
• random_number_milliseconds হলো ১,০০০ বা তার কম মিলিসেকেন্ডের একটি র‍্যান্ডম সংখ্যা। এটি এমন পরিস্থিতি এড়াতে সাহায্য করে যেখানে অনেক ক্লায়েন্ট কোনো একটি কারণে সিনক্রোনাইজড হয়ে যায় এবং সবাই একযোগে পুনরায় চেষ্টা করে, অর্থাৎ সিনক্রোনাস তরঙ্গে অনুরোধ পাঠায়। প্রতিটি পুনঃপ্রচেষ্টার অনুরোধের পর random_number_milliseconds এর মান পুনরায় গণনা করা হয়।
• maximum_backoff সাধারণত ৩২ বা ৬৪ সেকেন্ড হয়ে থাকে। এর উপযুক্ত মান ব্যবহারের ধরনের ওপর নির্ভর করে।

ক্লায়েন্ট maximum_backoff সময়টিতে পৌঁছানোর পরেও পুনরায় চেষ্টা চালিয়ে যেতে পারে। এই সময়ের পরে পুনরায় চেষ্টার জন্য ব্যাকঅফ সময় আর বাড়ানোর প্রয়োজন নেই। উদাহরণস্বরূপ, যদি কোনো ক্লায়েন্ট ৬৪ সেকেন্ডের maximum_backoff সময় ব্যবহার করে, তবে এই মানে পৌঁছানোর পর ক্লায়েন্টটি প্রতি ৬৪ সেকেন্ড পর পর পুনরায় চেষ্টা করতে পারে। একটি নির্দিষ্ট পর্যায়ে, ক্লায়েন্টদের অনির্দিষ্টকালের জন্য পুনরায় চেষ্টা করা থেকে বিরত রাখা উচিত।

পুনরায় চেষ্টার মধ্যবর্তী অপেক্ষার সময় এবং পুনরায় চেষ্টার সংখ্যা আপনার ব্যবহারের ধরণ এবং নেটওয়ার্ক অবস্থার উপর নির্ভর করে।

প্রকল্প-ভিত্তিক কোটা বৃদ্ধির জন্য অনুরোধ করুন

আপনার প্রকল্পের রিসোর্স ব্যবহারের উপর নির্ভর করে, আপনি কোটা সমন্বয়ের জন্য অনুরোধ করতে চাইতে পারেন। একটি সার্ভিস অ্যাকাউন্ট দ্বারা করা এপিআই কলগুলোকে একটি একক অ্যাকাউন্ট হিসেবে বিবেচনা করা হয়। সমন্বয়কৃত কোটার জন্য আবেদন করলেই যে তা অনুমোদিত হবে, এমন কোনো নিশ্চয়তা নেই। যে কোটা সমন্বয়ের অনুরোধগুলো কোটার পরিমাণ উল্লেখযোগ্যভাবে বৃদ্ধি করবে, সেগুলো অনুমোদিত হতে বেশি সময় লাগতে পারে।

সব প্রোজেক্টের কোটা এক নয়। সময়ের সাথে সাথে আপনার গুগল ক্লাউডের ব্যবহার বাড়ার সাথে সাথে আপনার কোটার পরিমাণও বৃদ্ধি করার প্রয়োজন হতে পারে। যদি আপনি ভবিষ্যতে ব্যবহারের উল্লেখযোগ্য বৃদ্ধি প্রত্যাশা করেন, তবে আপনি গুগল ক্লাউড কনসোলের 'Quotas & System Limits' পেজ থেকে আগে থেকেই কোটা সমন্বয়ের জন্য অনুরোধ করতে পারেন।

আরও জানতে, নিম্নলিখিত উৎসগুলো দেখুন:

• কোটা সমন্বয় সম্পর্কে
• আপনার কোটার ব্যবহার এবং সীমা দেখুন
• উচ্চতর কোটা সীমার জন্য অনুরোধ করুন