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

Google Sheets API एक शेयर की गई सेवा है. हम सभी उपयोगकर्ताओं के लिए, Google Workspace सिस्टम की परफ़ॉर्मेंस को बेहतर बनाए रखने के लिए, कोटा और सीमाएं लागू करते हैं.

सीमाएं

Sheets API में, एपीआई अनुरोध के लिए साइज़ की कोई तय सीमा नहीं होती. हालांकि, ऐसा हो सकता है कि उपयोगकर्ताओं को प्रोसेसिंग के अलग-अलग कॉम्पोनेंट से जुड़ी सीमाओं का सामना करना पड़े. इन कॉम्पोनेंट को Google Sheets कंट्रोल नहीं करता. अनुरोधों को तेज़ी से प्रोसेस करने के लिए, हमारा सुझाव है कि पेलोड का साइज़ ज़्यादा से ज़्यादा 2 एमबी हो.

Sheets API के लिए, एक मिनट में किए जा सकने वाले अनुरोधों की सीमा तय की गई है. यह सीमा हर मिनट रीफ़िल होती है. उदाहरण के लिए, हर प्रोजेक्ट के लिए हर मिनट में 300 बार पढ़ने का अनुरोध किया जा सकता है. अगर आपका ऐप्लिकेशन एक मिनट में 350 अनुरोध भेजता है, तो अतिरिक्त 50 अनुरोध कोटे से ज़्यादा हो जाते हैं. इससे 429: Too many requests एचटीटीपी स्टेटस कोड जनरेट होता है. अगर ऐसा होता है, तो आपको एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करना चाहिए. एक मिनट बाद, अनुरोधों को फिर से पूरा किया जा सकता है.

यहां दी गई टेबल में अनुरोधों की सीमाओं के बारे में बताया गया है:

कोटा
अनुरोधों को पढ़ सकता है	हर प्रोजेक्ट के लिए हर मिनट 300 हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या 60
अनुरोध लिखना	हर प्रोजेक्ट के लिए हर मिनट 300 हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या 60

फ़ाइल की सीमाओं के बारे में जानने के लिए, Google Drive में स्टोर की जा सकने वाली फ़ाइलें लेख पढ़ें.

व्यवहार और सीमाएं

Sheets API का इस्तेमाल करते समय, इन बातों का ध्यान रखें. साथ ही, उन सीमाओं के बारे में जानें जिनका असर आपके कोटे पर पड़ता है:

• स्प्रेडशीट से डेटा पाने के लिए किए गए कॉल को रीड अनुरोध कहा जाता है. जैसे, get या search. स्प्रेडशीट में बदलाव करने वाले किसी भी तरीके को राइट रिक्वेस्ट कहा जाता है. जैसे, update, clear या copyTo.

• उपयोगकर्ता एक साथ कई अनुरोध सबमिट कर सकते हैं. हालांकि, ऐसा तब ही किया जा सकता है, जब वे कोटा की सीमा के अंदर हों. हर बैच अनुरोध को, इस्तेमाल करने की सीमा के हिसाब से एक एपीआई अनुरोध के तौर पर गिना जाता है. इसमें कोई भी उप-अनुरोध शामिल है.

• सभी Sheets अनुरोधों को एक साथ लागू किया जाता है. इसका मतलब है कि अगर कोई अनुरोध मान्य नहीं है, तो पूरा अपडेट पूरा नहीं होगा. साथ ही, (संभावित रूप से निर्भर) कोई भी बदलाव लागू नहीं होगा.

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

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

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

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

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

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

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

1. Google Sheets 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 में एक की बढ़ोतरी होगी.
• random_number_milliseconds, 1,000 से कम या इसके बराबर मिलीसेकंड की कोई रैंडम संख्या है. इससे ऐसे मामलों से बचने में मदद मिलती है जिनमें कई क्लाइंट किसी स्थिति के हिसाब से सिंक हो जाते हैं और सभी एक साथ फिर से कोशिश करते हैं. इससे सिंक की गई लहरों में अनुरोध भेजे जाते हैं. अनुरोध को फिर से भेजने के बाद, random_number_milliseconds की वैल्यू फिर से कैलकुलेट की जाती है.
• maximum_backoff की अवधि आम तौर पर 32 या 64 सेकंड होती है. सही वैल्यू, इस्तेमाल के उदाहरण पर निर्भर करती है.

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

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

कीमत

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

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

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

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

ज़्यादा जानने के लिए, यहां दिए गए संसाधन देखें:

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

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

Sheets का एमसीपी सर्वर, पढ़ने और लिखने के अनुरोध की मेट्रिक का इस्तेमाल करता है. यहां दी गई टेबल में, हर सेक्शन के हिसाब से Sheets MCP सर्वर के हर तरीके के लिए कोटे और क्वेरी की लागत के बारे में बताया गया है:

Sheets के एमसीपी कोटा

दो तरह के कोटे लागू किए जाते हैं:

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

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

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

कोटा
अनुरोधों को पढ़ सकता है	हर प्रोजेक्ट के लिए हर मिनट 300 हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या 60
अनुरोध लिखना	हर प्रोजेक्ट के लिए हर मिनट 300 हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या 60

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

यहां दी गई टेबल में, हर sheetsmcp.googleapis.com टूलसेट के लिए क्वेरी की लागत की जानकारी दी गई है:

एंडपॉइंट	टूल	क्वेरी की लागत
/mcp/v1	get_values	पढ़ने का 1 अनुरोध
	get_spreadsheet	पढ़ने का 1 अनुरोध
	update_spreadsheet	लिखने का 1 अनुरोध
	update_values	लिखने का 1 अनुरोध
	update_formulas	लिखने का 1 अनुरोध
	insert_dimension	लिखने का 1 अनुरोध

ज़्यादा जानकारी के लिए, Sheets MCP API का रेफ़रंस देखें.

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

• डेवलपर मेटाडेटा सेव करने की सीमाएं
• बैच अनुरोध
• परफ़ॉर्मेंस बेहतर करना