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

১ মে, ২০২৬ থেকে এই API-এর ব্যবহারের সীমা আপডেট করা হয়েছে। যেসব Google Cloud প্রোজেক্ট নভেম্বর ২০২৫ থেকে এপ্রিল ২০২৬-এর মধ্যে এই API ব্যবহার করেছে, সেগুলি আগে থেকে সেট করা কোটা অনুযায়ী ব্যবহার করা চালিয়ে যেতে পারবে। ১ মে, ২০২৬ বা তার পরে তৈরি করা ক্লাউড প্রোজেক্টের ক্ষেত্রে নতুন API কোটা প্রযোজ্য হবে।

টাইমলাইন সহ আরও তথ্যের জন্য, এজেন্ট টুল ও API-এর জন্য Google Workspace-এর স্ট্যান্ডার্ডাইজড মডেল দেখুন।

সম্পূর্ণ ঘোষণা দেখতে, Google Workspace ডেভেলপারদের জন্য এজেন্ট টুল ও নিরাপত্তা আপডেট দেখুন।

Gmail API-এর ব্যবহারের সীমা আছে যা আপনি যে হারে API পদ্ধতি কল করতে পারেন তা সীমাবদ্ধ করে। সীমা কোটা ইউনিট হিসেবে সংজ্ঞায়িত করা হয়, যা Gmail রিসোর্স ব্যবহারকে প্রতিনিধিত্ব করে এমন একটি বিমূর্ত পরিমাপের একক।

Gmail API কোটা

Gmail API দুই ধরনের কোটা প্রয়োগ করে:

• প্রতি মিনিটে প্রতি প্রোজেক্ট: এটি হল কোটা ইউনিটের সংখ্যা যা আপনার Google Cloud প্রোজেক্ট এক মিনিটে ব্যবহার করতে পারে।

• প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট: এটি হল কোটা ইউনিটের সংখ্যা যা আপনার ক্লাউড প্রোজেক্টে যেকোনও একজন নির্দিষ্ট ব্যবহারকারী ব্যবহার করতে পারবেন। এই সীমা আপনার ব্যবহারকারীদের মধ্যে ব্যবহারের ন্যায্য ডিস্ট্রিবিউশন নিশ্চিত করতে সাহায্য করে।

নিচের সারণীতে এই সীমা সম্পর্কে বিস্তারিত তথ্য দেওয়া হয়েছে:

ব্যবহারের সীমার ধরন	সীমা
প্রতি মিনিটে প্রতি প্রোজেক্টে	১,২০০,০০০ কোটা ইউনিট
প্রতি প্রোজেক্টে প্রতি ব্যবহারকারীর জন্য প্রতি মিনিটে	৬,০০০ কোটা ইউনিট

সীমা সংক্রান্ত সমস্যা ম্যানেজ করার ব্যাপারে আরও জানতে, সমস্যার সমাধান করুন দেখুন।

দৈনিক বিলিং থ্রেশহোল্ড

এই প্রতিদিন প্রতি প্রোজেক্ট সীমা, চার্জ প্রযোজ্য হওয়ার আগে ২৪ ঘণ্টার মধ্যে আপনার Google Cloud প্রোজেক্ট ব্যবহার করতে পারে এমন কোটা ইউনিটের সর্বাধিক সংখ্যা নির্ধারণ করে।

এই থ্রেশহোল্ডের নিচে ব্যবহার করলে অতিরিক্ত চার্জ দিতে হয় না এবং আপনার Google Cloud অ্যাকাউন্টে বিল করা হয় না। Google ২০২৬ সালের শেষের দিকে বিলিং সংক্রান্ত সম্পূর্ণ বিবরণ শেয়ার করবে এবং কোনও পরিবর্তন কার্যকর হওয়ার অন্তত ৯০ দিন আগে বিজ্ঞপ্তি দেবে।

আপনি এই দৈনিক থ্রেশহোল্ড সীমা বাড়ানোর অনুরোধ করতে পারবেন না।

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

থ্রেশহোল্ডের সীমার ধরন	সীমা
প্রতি প্রোজেক্টে প্রতিদিন	৮০,০০০,০০০ কোটা ইউনিট

আরও তথ্যের জন্য, এজেন্ট টুল ও API-এর জন্য Google Workspace-এর স্ট্যান্ডার্ডাইজড মডেল দেখুন।

প্রতিটি পদ্ধতি অনুযায়ী কোটার ব্যবহার

প্রতিটি অনুরোধে কত কোটা ইউনিট খরচ হবে তা নির্ভর করে আপনি কোন পদ্ধতি কল করছেন এবং কোয়েরি প্যারামিটারের উপর। নিম্নলিখিত সারণীতে প্রতিটি পদ্ধতির জন্য কোটা ইউনিট ব্যবহারের বিবরণ দেওয়া হয়েছে:

পদ্ধতি	বরাদ্দ ইউনিট
drafts.create	10
drafts.delete	10
drafts.get	২০ (format-এর মান full, raw বা html হলে ৬০)
drafts.list	5
drafts.send	100
drafts.update	15
getProfile	1
history.list	2
labels.create	৫
labels.delete	5
labels.get	1
labels.list	1
labels.update	5
messages.attachments.get	20
messages.batchDelete	50
messages.batchModify	50
messages.delete	10
messages.get	২০ (format-এর মান full, raw বা html হলে ৬০)
messages.import	25
messages.insert	25
messages.list	5
messages.modify	5
messages.send	100
messages.trash	20
messages.untrash	5
settings.delegates.create	100
settings.delegates.delete	5
settings.delegates.get	1
settings.delegates.list	1
settings.filters.create	5
settings.filters.delete	5
settings.filters.get	1
settings.filters.list	1
settings.forwardingAddresses.create	100
settings.forwardingAddresses.delete	5
settings.forwardingAddresses.get	1
settings.forwardingAddresses.list	1
settings.getAutoForwarding	1
settings.getImap	1
settings.getPop	1
settings.getVacation	1
settings.sendAs.create	100
settings.sendAs.delete	5
settings.sendAs.get	1
settings.sendAs.list	1
settings.sendAs.update	100
settings.sendAs.verify	100
settings.updateAutoForwarding	5
settings.updateImap	5
settings.updatePop	100
settings.updateVacation	5
stop	50
threads.delete	20
threads.get	৪০ (format-এর মান full হলে ১২০)
threads.list	10
threads.modify	10
threads.trash	20
threads.untrash	10
watch	100

Gmail API ব্যবহার করার সময়, প্রতিটি ইমেল মেসেজে প্রাপকের সংখ্যা ৫০০-এর বেশি হতে পারবে না।

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

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

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

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

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

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

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

দাম

Gmail API-এর সব স্ট্যান্ডার্ড ব্যবহার অতিরিক্ত কোনও খরচ ছাড়াই উপলভ্য। কোটা অনুরোধের সীমা অতিক্রম করলে ২০২৬ সালের শেষের দিকে আপনার Google Cloud বিলিং অ্যাকাউন্টে চার্জ করা হবে। আরও তথ্যের জন্য, এজেন্ট টুল ও API-এর জন্য Google Workspace-এর স্ট্যান্ডার্ডাইজড মডেল দেখুন।

কোটা বাড়ানোর অনুরোধ করা

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

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

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

• কোটা অ্যাডজাস্টমেন্ট সম্পর্কে
• আপনার কোটার ব্যবহার ও সীমা দেখুন
• আরও বেশি কোটা সীমার জন্য অনুরোধ করুন

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

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

Gmail MCP কোটা

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

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

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

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

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

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

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

এন্ডপয়েন্ট	টুল	কোয়েরির খরচ
/mcp/v1	create_draft	10
	get_thread	40
	label_message	10
	label_thread	10
	list_drafts	5
	list_labels	1
	search_threads	10
	unlabel_message	10
	unlabel_thread	10

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

সম্পর্কিত বিষয়

• ব্যাচ অনুরোধ
• পারফর্ম্যান্স সংক্রান্ত পরামর্শ
• মেল পাঠানো ও পাওয়ার সীমা
• Google Workspace-এ Gmail পাঠানোর সীমা