इस्तेमाल करने की सीमा

इस एपीआई को इस्तेमाल करने की सीमाएं 1 मई, 2026 को अपडेट की गई थीं. जिन Google Cloud प्रोजेक्ट ने नवंबर 2025 से अप्रैल 2026 के बीच इस एपीआई का इस्तेमाल किया है उनके लिए, इस्तेमाल का कोटा पहले जैसा ही रहेगा. 1 मई, 2026 को या इसके बाद बनाए गए क्लाउड प्रोजेक्ट पर, नए एपीआई कोटा लागू होंगे.

ज़्यादा जानकारी के लिए, एजेंट टूल और एपीआई के लिए Google Workspace का स्टैंडर्ड मॉडल लेख पढ़ें. इसमें टाइमलाइन भी शामिल है.

इस बारे में पूरी जानकारी पाने के लिए, Google Workspace डेवलपर के लिए एजेंट टूल और सुरक्षा से जुड़े अपडेट देखें.

Gmail API के इस्तेमाल करने की सीमाएं तय होती हैं. इन सीमाओं के तहत, एपीआई के तरीकों को कॉल करने की दर सीमित होती है. सीमाएं, कोटा यूनिट के हिसाब से तय की जाती हैं. यह मेज़रमेंट की एक ऐसी यूनिट है जो Gmail के संसाधनों के इस्तेमाल को दिखाती है.

Gmail API के कोटा

Gmail API दो तरह के कोटा लागू करता है:

• हर मिनट, हर प्रोजेक्ट के लिए: यह कोटे की उन यूनिट की संख्या है जिनका इस्तेमाल आपका Google Cloud प्रोजेक्ट, एक मिनट में कर सकता है.

• हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में इस्तेमाल की जा सकने वाली कोटा यूनिट: यह कोटा यूनिट की वह संख्या है जिसे कोई उपयोगकर्ता आपके क्लाउड प्रोजेक्ट में इस्तेमाल कर सकता है. इस सीमा से यह पक्का करने में मदद मिलती है कि आपके उपयोगकर्ताओं के बीच, इस्तेमाल का सही बंटवारा हो.

यहां दी गई टेबल में, इन सीमाओं के बारे में बताया गया है:

इस्तेमाल करने की सीमा का टाइप	सीमा
हर प्रोजेक्ट के लिए हर मिनट	12,00,000 कोटा यूनिट
हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या	6,000 कोटा यूनिट

सीमा से जुड़ी गड़बड़ियों को ठीक करने के बारे में जानकारी पाने के लिए, गड़बड़ियां ठीक करना लेख पढ़ें.

रोज़ की बिलिंग सीमा

हर दिन हर प्रोजेक्ट के लिए तय की गई इस सीमा से, यह तय होता है कि आपके Google Cloud प्रोजेक्ट के लिए, 24 घंटे की अवधि में ज़्यादा से ज़्यादा कितनी कोटा यूनिट इस्तेमाल की जा सकती हैं. इसके बाद, शुल्क लागू होते हैं.

इस थ्रेशोल्ड के अंदर इस्तेमाल करने पर, कोई अतिरिक्त शुल्क नहीं लिया जाता. साथ ही, आपके Google Cloud खाते से कोई शुल्क नहीं लिया जाता. Google, साल 2026 के आखिर में बिलिंग की पूरी जानकारी शेयर करेगा. साथ ही, कोई भी बदलाव लागू होने से कम से कम 90 दिन पहले इसकी सूचना देगा.

इस रोज़ाना की थ्रेशोल्ड सीमा को बढ़ाने का अनुरोध नहीं किया जा सकता.

नीचे दी गई टेबल में, इस सीमा के बारे में बताया गया है:

थ्रेशोल्ड की सीमा का टाइप	सीमा
हर दिन, हर प्रोजेक्ट के लिए	8,00,00,000 कोटा यूनिट

ज़्यादा जानकारी के लिए, एजेंट टूल और एपीआई के लिए Google Workspace का स्टैंडर्ड मॉडल देखें.

हर तरीके के लिए कोटे का इस्तेमाल

हर अनुरोध के लिए, कोटा की कितनी इकाइयां इस्तेमाल की जाती हैं, यह इस बात पर निर्भर करता है कि आपने कौनसा तरीका कॉल किया है और क्वेरी पैरामीटर क्या हैं. नीचे दी गई टेबल में, हर तरीके के लिए कोटा यूनिट के इस्तेमाल की जानकारी दी गई है:

तरीका	कोटा इकाईयाँ
drafts.create	10
drafts.delete	10
drafts.get	20 (format के full, raw या html होने पर 60)
drafts.list	5
drafts.send	100
drafts.update	15
getProfile	1
history.list	2
labels.create	5
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	20 (format के full, raw या html होने पर 60)
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	40 (format के full होने पर 120)
threads.list	10
threads.modify	10
threads.trash	20
threads.untrash	10
watch	100

Gmail API का इस्तेमाल करने पर, हर ईमेल मैसेज के लिए 500 लोगों की सीमा भी होती है.

समय के हिसाब से तय किए गए कोटे से जुड़ी गड़बड़ियां ठीक करना

समय के आधार पर होने वाली सभी गड़बड़ियों (X मिनट में ज़्यादा से ज़्यादा N अनुरोध) के लिए, हमारा सुझाव है कि आपका कोड अपवाद को पकड़े और ट्रंकेटेड एक्स्पोनेंशियल बैकऑफ़ का इस्तेमाल करे. इससे यह पक्का किया जा सकेगा कि आपके डिवाइसों पर ज़्यादा लोड न पड़े.

एक्स्पोनेंशियल बैकऑफ़, नेटवर्क ऐप्लिकेशन के लिए गड़बड़ी को ठीक करने की एक स्टैंडर्ड रणनीति है. एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों के बीच इंतज़ार के समय को बढ़ाकर, अनुरोधों को फिर से भेजता है. यह समय, बैकऑफ़ के लिए तय किए गए ज़्यादा से ज़्यादा समय तक बढ़ाया जाता है. अगर अनुरोध अब भी पूरे नहीं हो पा रहे हैं, तो यह ज़रूरी है कि अनुरोधों के बीच का समय तब तक बढ़ाया जाए, जब तक कि अनुरोध पूरा न हो जाए.

एल्गोरिदम का उदाहरण

एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को एक्स्पोनेंशियल तरीके से फिर से भेजता है. इससे, अनुरोधों को फिर से भेजने के बीच इंतज़ार का समय बढ़ जाता है. यह समय, बैकऑफ़ के लिए तय किए गए ज़्यादा से ज़्यादा समय तक बढ़ सकता है. उदाहरण के लिए:

1. Gmail 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 सेकंड में फिर से कोशिश कर सकता है. एक समय के बाद, क्लाइंट को बार-बार कोशिश करने से रोका जाना चाहिए.

फिर से कोशिश करने के बीच का इंतज़ार का समय और फिर से कोशिश करने की संख्या, आपके इस्तेमाल के उदाहरण और नेटवर्क की स्थितियों पर निर्भर करती है.

कीमत

Gmail API का इस्तेमाल, बिना किसी अतिरिक्त शुल्क के किया जा सकता है. कोटा अनुरोध की सीमाओं से ज़्यादा अनुरोध करने पर, साल 2026 के आखिर में आपके Google Cloud बिलिंग खाते से शुल्क लिया जाएगा. ज़्यादा जानकारी के लिए, एजेंट टूल और एपीआई के लिए Google Workspace का स्टैंडर्ड मॉडल देखें.

कोटा बढ़ाने का अनुरोध करना

अपने प्रोजेक्ट के संसाधनों के इस्तेमाल के आधार पर, कोटा में बदलाव करने का अनुरोध किया जा सकता है. सेवा खाते से किए गए एपीआई कॉल को एक ही खाते से किए गए कॉल माना जाता है. कोटा में बदलाव करने के लिए आवेदन करने से, मंज़ूरी मिलने की गारंटी नहीं मिलती. कोटा में बदलाव करने के ऐसे अनुरोधों को मंज़ूरी मिलने में ज़्यादा समय लग सकता है जिनसे कोटा की वैल्यू में काफ़ी बढ़ोतरी हो सकती है.

सभी प्रोजेक्ट के लिए कोटा एक जैसा नहीं होता. समय के साथ Google Cloud का इस्तेमाल बढ़ने पर, आपको कोटे की वैल्यू बढ़ाने की ज़रूरत पड़ सकती है. अगर आपको लगता है कि आने वाले समय में आपके इस्तेमाल में काफ़ी बढ़ोतरी होगी, तो Google Cloud console में कोटा और सिस्टम की सीमाएं पेज पर जाकर, कोटा में बदलाव करने का अनुरोध किया जा सकता है.

ज़्यादा जानने के लिए, ये लेख पढ़ें:

• कोटा अडजस्टमेंट के बारे में जानकारी
• अपने कोटे के इस्तेमाल और सीमाओं की जानकारी देखना
• कोटा बढ़ाने का अनुरोध करना

Gmail के एमसीपी सर्वर का कोटा

Gmail का एमसीपी सर्वर, क्वेरी की लागत तय करने वाली मेट्रिक का इस्तेमाल करता है. यहां दी गई टेबल में, Gmail एमसीपी सर्वर के हर तरीके के लिए, क्वेरी की लागत की जानकारी सेक्शन के हिसाब से दी गई है:

Gmail एमसीपी कोटा

सर्वर, दो तरह के कोटा लागू करता है:

• हर मिनट, हर क्लाउड प्रोजेक्ट के लिए: यह आपके क्लाउड प्रोजेक्ट के लिए, एक मिनट की क्वेरी की लागत है.

• हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या: यह आपके क्लाउड प्रोजेक्ट के लिए, एक मिनट में की जाने वाली क्वेरी की लागत है. इसे कोई भी उपयोगकर्ता इस्तेमाल कर सकता है.

यहां दी गई टेबल में, इन कोटा के बारे में बताया गया है:

इस्तेमाल करने की सीमा का टाइप	क्वेरी की लागत
हर प्रोजेक्ट के लिए हर मिनट	12,00,000
हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या	6,000

Gmail के एमसीपी टूलसेट के कोटे

इस टेबल में, हर 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 एमसीपी एपीआई का संदर्भ देखें.

मिलते-जुलते विषय

• बैच अनुरोध
• परफ़ॉर्मेंस से जुड़ी सलाह
• ईमेल भेजने और पाने की सीमाएं
• Google Workspace में Gmail से ईमेल भेजने की सीमाएं