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

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

सीमाओं को कोटा यूनिट के हिसाब से तय किया जाता है. यह माप की एक ऐसी इकाई है जिससे Google Drive के संसाधनों के इस्तेमाल का पता चलता है.

Drive API के कोटे

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

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

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

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

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

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

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

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

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

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

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

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

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

ज़्यादा जानकारी के लिए, एजेंट टूल और एपीआई के लिए 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 कंसोल में, कोटा और सिस्टम की सीमाएं पेज से, कोटे में बदलाव करने का अनुरोध किया जा सकता है.

ज़्यादा जानने के लिए, ये लेख पढ़ें और वीडियो देखें:

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

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

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

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

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

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

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

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

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

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

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

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

• परफ़ॉर्मेंस बेहतर बनाना
• फ़ाइल और फ़ोल्डर की सीमाएं
• शेयर की गई ड्राइव में फ़ाइल और फ़ोल्डर की सीमाएं