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

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

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

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

প্রোজেক্ট-প্রতি কোটা

প্রতিটি প্রোজেক্টের কোটা Google Cloud প্রোজেক্টের জন্য কোয়েরির রেট সীমিত করে এবং তাই প্রতিটি কোটার জন্য নির্দিষ্ট Chat API পদ্ধতি কল করা একটি Chat অ্যাপের ক্ষেত্রে প্রযোজ্য হয়।

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

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

Chat API পদ্ধতি

সীমা (প্রতি ৬০ সেকেন্ডে)

প্রতি মিনিটে মেসেজ লেখার সংখ্যা

spaces.messages.create

spaces.messages.patch

spaces.messages.delete

৩০০০

প্রতি মিনিটে মেসেজ পড়ার সংখ্যা

spaces.messages.get

spaces.messages.list

৩০০০

প্রতি মিনিটে মেসেজ সার্চ

spaces.messages.search

৩০০

মেম্বারশিপ প্রতি মিনিটে রাইট করে

spaces.members.create

spaces.members.delete

৩০০

প্রতি মিনিটে মেম্বারশিপ রিড

spaces.members.get

spaces.members.list

৩০০০

প্রতি মিনিটে স্পেস রাইট

spaces.setup

spaces.create

spaces.patch

spaces.delete

60

প্রতি মিনিটে স্পেস রিড

spaces.get

spaces.list

spaces.findDirectMessage

spaces.search

৩০০০

স্পেস সার্চ প্রতি মিনিটে রিড করে (অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ছাড়া)

spaces.search

৩০০

প্রতি মিনিটে অ্যাটাচমেন্ট রাইট

media.upload

600

অ্যাটাচমেন্ট প্রতি মিনিটে পড়ে

spaces.messages.attachments.get

media.download

৩০০০

প্রতি মিনিটে প্রতিক্রিয়া লেখার সংখ্যা

spaces.messages.reactions.create

spaces.messages.reactions.delete

600

প্রতি মিনিটে প্রতিক্রিয়া পড়ার সংখ্যা

spaces.messages.reactions.list

৩০০০

CustomEmoji প্রতি মিনিটে যতগুলি মেসেজ লিখতে পারে

customEmojis.create

customEmojis.delete

600

CustomEmoji প্রতি মিনিটে যতবার পড়া হয়েছে

customEmojis.get

customEmojis.list

৩০০০

প্রতি মিনিটে বিভাগ লেখার সংখ্যা

users.sections.create

users.sections.delete

users.sections.patch

users.sections.position

users.sections.items.move

600

প্রতি মিনিটে যতগুলি বিভাগ পড়া হয়েছে

users.sections.list

users.sections.items.list

৩০০০

প্রতি মিনিটে উপলভ্যতার রিড

users.availability.get

৩০০০

প্রতি মিনিটে উপলভ্য রাইট

users.availability.update

users.availability.markAsActive

users.availability.markAsAway

users.availability.markAsDoNotDisturb

৩০০০

প্রতি মিনিটে রিড স্টেট রাইট

users.spaces.updateSpaceReadState

users.spaces.threads.updateThreadReadState

৩০০০

প্রতি মিনিটে রিড স্টেট রিড

users.spaces.getSpaceReadState

users.spaces.threads.getThreadReadState

৩০০০

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

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

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

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

Chat 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

15

প্রতি সেকেন্ডে রাইট

media.upload

spaces.delete

spaces.patch

spaces.messages.create (ইনকামিং ওয়েবহুকের ক্ষেত্রে অতিরিক্ত সীমা প্রযোজ্য)

spaces.messages.delete

spaces.messages.patch

spaces.messages.reactions.delete

1

প্রতি সেকেন্ডে প্রতিক্রিয়া তৈরি করার সংখ্যা

spaces.messages.reactions.create

5

Google Chat-এ ডেটা ইমপোর্ট করার সময় প্রতি সেকেন্ডে মেসেজ লেখার সংখ্যা

spaces.messages.create

10

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

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

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

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

Chat API পদ্ধতি

সীমা (প্রতি সেকেন্ডে)

প্রতি সেকেন্ডে CustomEmoji রাইট

customEmojis.create

customEmojis.delete

1

প্রতি সেকেন্ডে CustomEmoji রিড

customEmojis.get

customEmojis.list

15

প্রতি সেকেন্ডে রাইট

users.sections.create

users.sections.delete

users.sections.patch

users.sections.position

users.sections.items.move

users.availability.update

users.availability.markAsActive

users.availability.markAsAway

users.availability.markAsDoNotDisturb

1

প্রতি সেকেন্ডে রিড

users.sections.list

users.sections.items.list

users.availability.get

15

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

একই স্পেসকে টার্গেট করা হাই API ট্রাফিক অতিরিক্ত ইন্টার্নাল সীমা ট্রিগার করতে পারে যা কোটা পৃষ্ঠায় দেখা যায় না।

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

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

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

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

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

  1. Google Chat API-তে অনুরোধ করুন।
  2. অনুরোধটি ব্যর্থ হলে, ১ + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি আবার চেষ্টা করুন।
  3. অনুরোধটি ব্যর্থ হলে, ২ + 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 টাইম ব্যবহার করে, তাহলে এই ভ্যালুতে পৌঁছানোর পরে, ক্লায়েন্ট প্রতি ৬৪ সেকেন্ডে আবার চেষ্টা করতে পারবে। কোনও এক সময়, ক্লায়েন্টদের অনির্দিষ্টকাল ধরে আবার চেষ্টা করা থেকে বিরত রাখতে হবে।

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

প্রোজেক্ট-পিছু কোটা বাড়ানোর অনুরোধ করা

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

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

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

Chat MCP সার্ভার কোটা

Chat MCP সার্ভার কোয়েরি খরচ বরাদ্দকরণ মেট্রিক ব্যবহার করে। নিম্নলিখিত সারণীতে প্রতিটি Chat MCP সার্ভার পদ্ধতির জন্য কোয়েরি খরচ বিভাগ অনুসারে বিস্তারিতভাবে দেখানো হয়েছে:

Chat MCP কোটা

দুই ধরনের কোটা এনফোর্স করা হয়:

  • প্রতি মিনিটে প্রতি প্রোজেক্টে: এটি হল এক মিনিটের জন্য আপনার Google Cloud প্রোজেক্টে কোয়েরির খরচ।

  • প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট: এটি হল আপনার Google Cloud প্রোজেক্টের জন্য এক মিনিটের কোয়েরি খরচ যা যেকোনও একজন নির্দিষ্ট ব্যবহারকারী ব্যবহার করতে পারবেন।

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

ব্যবহারের সীমার ধরন কোয়েরির খরচ
প্রতি প্রোজেক্টে প্রতি মিনিটে ৩,০০০ ঘণ্টা
প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট ৩০০

Chat MCP টুলসেট কোটা

নিম্নলিখিত সারণীতে প্রতিটি chatmcp.googleapis.com টুলসেটের জন্য কোয়েরি খরচের বিবরণ দেওয়া হয়েছে:

এন্ডপয়েন্ট

টুল

কোয়েরির খরচ

/mcp/v1

list_messages

1

search_conversations

10

search_messages

10

send_message

10

আরও তথ্যের জন্য, Chat MCP API রেফারেন্স দেখুন।