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

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

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

চ্যাট এপিআই পদ্ধতিতে একাধিক কোটার ধরণ প্রযোজ্য হতে পারে: প্রতি-প্রজেক্ট, প্রতি-স্পেস এবং প্রতি-ব্যবহারকারী কোটা।

প্রতি প্রকল্পের কোটা

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

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

প্রতি প্রকল্পের কোটা	চ্যাট এপিআই পদ্ধতি	সীমা (প্রতি ৬০ সেকেন্ডে)
প্রতি মিনিটে বার্তা লেখার সংখ্যা	spaces.messages.create spaces.messages.patch spaces.messages.delete	৩০০০
প্রতি মিনিটে বার্তা পঠনের সংখ্যা	spaces.messages.get spaces.messages.list	৩০০০
সদস্যপদ প্রতি মিনিটে লেখার হার	spaces.members.create spaces.members.delete	৩০০
প্রতি মিনিটে সদস্যপদ পঠন	spaces.members.get spaces.members.list	৩০০০
প্রতি মিনিটে লেখার স্থান	spaces.setup spaces.create spaces.patch spaces.delete	৬০
প্রতি মিনিটে স্থান পাঠ	spaces.get spaces.list spaces.findDirectMessage	৩০০০
সংযুক্তি প্রতি মিনিটে লেখার সংখ্যা	media.upload	৬০০
সংযুক্তি প্রতি মিনিটে পাঠ করে	spaces.messages.attachments.get media.download	৩০০০
প্রতি মিনিটে প্রতিক্রিয়া লেখার হার	spaces.messages.reactions.create spaces.messages.reactions.delete	৬০০
প্রতি মিনিটে প্রতিক্রিয়ার মান	spaces.messages.reactions.list	৩০০০

প্রতি-স্থান কোটা

প্রতি-স্পেস কোটা একটি নির্দিষ্ট স্থানে প্রশ্নের হার সীমিত করে এবং সেই স্থানে কাজ করা সমস্ত চ্যাট অ্যাপের মধ্যে ভাগ করা হয় যা প্রতিটি কোটার জন্য তালিকাভুক্ত চ্যাট API পদ্ধতিগুলিকে কল করে।

নিম্নলিখিত টেবিলে প্রতি-স্পেস কোয়েরির সীমার বিবরণ দেওয়া হয়েছে:

প্রতি-স্থান কোটা	চ্যাট এপিআই পদ্ধতি	সীমা (প্রতি সেকেন্ডে)
প্রতি সেকেন্ডে পঠন	media.download spaces.get spaces.members.get spaces.members.list spaces.messages.get spaces.messages.list spaces.messages.attachments.get spaces.messages.reactions.list	১৫
প্রতি সেকেন্ডে লেখা হয়	media.upload spaces.delete spaces.patch spaces.messages.create ( আগত ওয়েবহুকের ক্ষেত্রে অতিরিক্ত সীমা প্রযোজ্য) spaces.messages.delete spaces.messages.patch spaces.messages.reactions.delete	১
প্রতি সেকেন্ডে প্রতিক্রিয়া লেখা তৈরি করুন	spaces.messages.reactions.create	৫
Google Chat-এ ডেটা আমদানি করার সময় প্রতি সেকেন্ডে বার্তা লেখা হয়	spaces.messages.create	১০

প্রতি ব্যবহারকারীর কোটা

একজন Google চ্যাট ব্যবহারকারীর জন্য প্রতি-ব্যবহারকারী কোটা প্রশ্নের হার সীমিত করে। প্রশ্নগুলি সমস্ত চ্যাট অ্যাপের সাথে সম্পর্কিত যা ব্যবহারকারীর পক্ষে ( ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে) একটি চ্যাট API পদ্ধতি কল করে।

নিম্নলিখিত টেবিলে প্রতি ব্যবহারকারীর প্রশ্নের সীমার বিবরণ দেওয়া হল:

প্রতি ব্যবহারকারী কোটা	চ্যাট এপিআই পদ্ধতি	সীমা (প্রতি সেকেন্ডে)
প্রতি সেকেন্ডে পঠন	customEmojis.get customEmojis.list	১৫
প্রতি সেকেন্ডে লেখা হয়	customEmojis.create customEmojis.delete	১

অতিরিক্ত ব্যবহারের সীমা

GROUP_CHAT অথবা SPACE ধরণের স্পেস তৈরির জন্য অতিরিক্ত কোটা সীমা রয়েছে ( spaces.create অথবা spaces.setup পদ্ধতি ব্যবহার করে)। প্রতি মিনিটে ৩৫টির কম স্পেস এবং প্রতি ঘন্টায় ৮০০টি স্পেস তৈরি করুন। DIRECT_MESSAGE ধরণের স্পেসগুলিতে এই অতিরিক্ত কোটা সীমা প্রযোজ্য নয়।

একই স্থানকে লক্ষ্য করে উচ্চ API ট্র্যাফিক অতিরিক্ত অভ্যন্তরীণ সীমা তৈরি করতে পারে যা কোটা পৃষ্ঠায় দৃশ্যমান নয়।

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

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

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

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

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

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

কোথায়:

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

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

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

প্রতি প্রকল্পের কোটা বৃদ্ধির অনুরোধ করুন

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

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

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

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