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

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

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

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

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

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

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

প্রতি-প্রকল্প কোটা	চ্যাট API পদ্ধতি	সীমা (প্রতি 60 সেকেন্ড)
প্রতি মিনিটে বার্তা লেখা হয়	spaces.messages.create spaces.messages.patch spaces.messages.delete	3000
বার্তা প্রতি মিনিটে পড়া হয়	spaces.messages.get spaces.messages.list	3000
সদস্যপদ প্রতি মিনিটে লিখে	spaces.members.create spaces.members.delete	300
সদস্যপদ প্রতি মিনিটে পড়ে	spaces.members.get spaces.members.list	3000
স্পেস প্রতি মিনিটে লিখে	spaces.setup spaces.create spaces.patch spaces.delete	60
প্রতি মিনিটে স্থান পড়ে	spaces.get spaces.list spaces.findDirectMessage	3000
সংযুক্তি প্রতি মিনিটে লেখা	media.upload	600
সংযুক্তি প্রতি মিনিটে পড়া হয়	spaces.messages.attachments.get media.download	3000
প্রতি মিনিটে প্রতিক্রিয়া লিখছে	spaces.messages.reactions.create spaces.messages.reactions.delete	600
প্রতিক্রিয়া প্রতি মিনিটে পড়ে	spaces.messages.reactions.list	3000

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

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

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

প্রতি-স্পেস কোটা	চ্যাট API পদ্ধতি	সীমা (প্রতি 60 সেকেন্ড)
প্রতি মিনিটে পড়া হয়	media.download spaces.get spaces.members.get spaces.members.list spaces.messages.get spaces.messages.list spaces.messages.attachments.get spaces.messages.reactions.list	900
প্রতি মিনিটে লেখে	media.upload spaces.delete spaces.patch spaces.messages.create (অতিরিক্ত সীমা আগত ওয়েবহুকের জন্য প্রযোজ্য) spaces.messages.delete spaces.messages.patch spaces.messages.reactions.delete	60
প্রতি মিনিটে প্রতিক্রিয়া লিখুন তৈরি করুন	spaces.messages.reactions.create	300
Google চ্যাটে ডেটা আমদানি করার সময় প্রতি মিনিটে বার্তা লেখা হয়	spaces.messages.create	600

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

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

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

প্রতি ব্যবহারকারী কোটা	চ্যাট API পদ্ধতি	সীমা (প্রতি 60 সেকেন্ড)
প্রতি মিনিটে পড়া হয়	customEmojis.get customEmojis.list	900
প্রতি মিনিটে লেখে	customEmojis.create customEmojis.delete	60

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

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

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

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

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

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

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

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

1. Google Chat API-কে একটি অনুরোধ করুন।
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 1 দ্বারা বৃদ্ধি করা হয়েছে।
• random_number_milliseconds হল 1,000 এর থেকে কম বা সমান মিলিসেকেন্ডের একটি এলোমেলো সংখ্যা। এটি এমন ঘটনাগুলি এড়াতে সাহায্য করে যেখানে অনেক ক্লায়েন্ট কিছু পরিস্থিতির দ্বারা সিঙ্ক্রোনাইজ করা হয় এবং সিঙ্ক্রোনাইজড তরঙ্গে অনুরোধ পাঠানোর জন্য একবারে পুনরায় চেষ্টা করুন। random_number_milliseconds মান প্রতিটি পুনরায় চেষ্টা করার অনুরোধের পরে পুনরায় গণনা করা হয়।
• maximum_backoff সাধারণত 32 বা 64 সেকেন্ড। উপযুক্ত মান ব্যবহারের ক্ষেত্রে নির্ভর করে।

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

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

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

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

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

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

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