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

Google Drive API एक शेयर की गई सेवा है. इसलिए, हम इस पर कोटा और सीमाएं लागू करते हैं. ऐसा इसलिए किया जाता है, ताकि सभी उपयोगकर्ता इसका सही तरीके से इस्तेमाल कर सकें और Google Workspace सिस्टम की परफ़ॉर्मेंस को सुरक्षित रखा जा सके.

सीमाएं, कोटा यूनिट के हिसाब से तय की जाती हैं. यह एक ऐब्स्ट्रैक्ट यूनिट है, जिससे Google Drive के रिसॉर्स के इस्तेमाल को मापा जाता है.

Drive API के लिए अनुरोध करने की सीमा

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

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

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

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

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

इस्तेमाल करने की सीमा का टाइप सीमा
हर प्रोजेक्ट के लिए हर मिनट 10,00,000 कोटा यूनिट
हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर मिनट 3,25,000 कोटा यूनिट
हर प्रोजेक्ट के लिए हर दिन 1 टीबी

अगर आपने कोटे से ज़्यादा अनुरोध किए हैं, तो आपको 403: User rate limit exceeded एचटीटीपी स्टेटस कोड वाला जवाब मिलेगा. Drive के बैकएंड पर, दर की सीमा की अतिरिक्त जांच करने पर भी 429: Rate limit exceeded जवाब जनरेट हो सकता है. अगर ऐसा होता है, तो आपको एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करना चाहिए. इसके बाद, कुछ समय बाद फिर से कोशिश करें.

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

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

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

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

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

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

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

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

हर अनुरोध के लिए इस्तेमाल की गई कोटा यूनिट की संख्या, कॉल किए गए तरीके के हिसाब से अलग-अलग होती है. इस टेबल में, हर तरीके के लिए कोटा यूनिट के इस्तेमाल के बारे में बताया गया है:

कार्रवाई कोटा इकाईयाँ
आइटम पढ़ना, जैसे कि files.get 5
सूची में शामिल आइटम, जैसे कि files.list 100
files.download जैसे आइटम डाउनलोड करें 200
files.update जैसे आइटम में बदलाव करना 50
अन्य कार्रवाइयां, जैसे कि files.generateIds 5

अतिरिक्त सीमाएँ

Drive API का इस्तेमाल करते समय, ये पाबंदियां लागू होती हैं:

  • Google Workspace के उपयोगकर्ता, 'मेरी ड्राइव' और सभी शेयर की गई ड्राइव के बीच हर दिन सिर्फ़ 750 जीबी डेटा अपलोड कर सकते हैं. यह सीमा, कॉपी पर भी लागू होती है.

  • 750 जीबी की सीमा तक पहुंचने वाले या 750 जीबी से बड़ी फ़ाइल अपलोड करने वाले उपयोगकर्ता, 24 घंटे तक कोई और फ़ाइल अपलोड या कॉपी नहीं कर सकते.

  • उपयोगकर्ता ज़्यादा से ज़्यादा 5 टीबी की फ़ाइल अपलोड कर सकते हैं. हालांकि, सीमा से ज़्यादा साइज़ वाली सिर्फ़ पहली फ़ाइल अपलोड की जा सकती है. उपयोगकर्ता ज़्यादा से ज़्यादा 750 जीबी की फ़ाइल कॉपी कर सकते हैं.

  • सूचना का चैनल खोलते समय दिए गए पते पर भेजी गई सूचनाएं, आपके कोटे की सीमाओं में नहीं गिनी जाती हैं. हालांकि, changes.watch, channels.stop, और files.watch तरीकों से किए गए कॉल, आपके कोटा में गिने जाते हैं.

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

  • आपके Google Workspace खाते के टाइप के आधार पर, Drive के स्टोरेज की अन्य सीमाएं भी लागू होती हैं.

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

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

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

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

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

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

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

कीमत

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

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

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

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

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

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

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

Drive के एमसीपी कोटे

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

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

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

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

इस्तेमाल करने की सीमा का टाइप सीमा
हर प्रोजेक्ट के लिए हर मिनट 3,25,000
हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर मिनट 10,00,000

ड्राइव के एमसीपी टूलसेट के कोटे

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

एंडपॉइंट टूल क्वेरी की लागत

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

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