Google Drive API एक शेयर की गई सेवा है. इसलिए, हम इस पर कोटा और सीमाएं लागू करते हैं. ऐसा इसलिए किया जाता है, ताकि सभी उपयोगकर्ता इसका सही तरीके से इस्तेमाल कर सकें और Google Workspace सिस्टम की परफ़ॉर्मेंस को सुरक्षित रखा जा सके.
सीमाएं, कोटा यूनिट के हिसाब से तय की जाती हैं. यह माप की एक ऐसी इकाई है जो Google Drive के संसाधन के इस्तेमाल को दिखाती है.
Drive API के कोटा
तीन तरह के कोटे लागू किए जाते हैं:
हर प्रोजेक्ट के लिए हर मिनट: यह कोटे की उन इकाइयों की संख्या है जिनका इस्तेमाल आपका Google Cloud प्रोजेक्ट एक मिनट में कर सकता है.
हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में: यह कोटा यूनिट की वह संख्या है जिसका इस्तेमाल कोई उपयोगकर्ता आपके Cloud प्रोजेक्ट में कर सकता है. इस सीमा का मकसद, यह पक्का करने में आपकी मदद करना है कि आपके उपयोगकर्ताओं के बीच, स्टोरेज का सही तरीके से बंटवारा हो.
हर प्रोजेक्ट के लिए हर दिन: इससे पता चलता है कि आपका Google Cloud प्रोजेक्ट, शुल्क लागू होने से पहले 24 घंटे की अवधि में ज़्यादा से ज़्यादा कितने बाइट का डेटा भेज सकता है.
यहां दी गई टेबल में, इन सीमाओं के बारे में बताया गया है:
| इस्तेमाल की सीमा का टाइप | सीमा |
|---|---|
| हर प्रोजेक्ट के लिए, हर मिनट | 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 अनुरोध) के लिए, हमारा सुझाव है कि आपका कोड अपवाद को पकड़ ले और ट्रंकेटेड एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करे. इससे यह पक्का किया जा सकेगा कि आपके डिवाइस ज़्यादा लोड जनरेट न करें.
एक्सपोनेंशियल बैकऑफ़, नेटवर्क ऐप्लिकेशन के लिए गड़बड़ी ठीक करने की एक स्टैंडर्ड रणनीति है. एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को फिर से भेजने की कोशिश करता है. इसके लिए, अनुरोधों के बीच इंतज़ार का समय तेज़ी से बढ़ता जाता है. यह इंतज़ार का ज़्यादा से ज़्यादा समय तक होता है. अगर अनुरोध अब भी पूरे नहीं हो रहे हैं, तो यह ज़रूरी है कि अनुरोधों के बीच का समय धीरे-धीरे बढ़ता जाए, ताकि अनुरोध पूरा हो सके.
एल्गोरिदम का उदाहरण
एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को बार-बार करता है. साथ ही, यह कोशिशों के बीच इंतज़ार के समय को बढ़ाता है. यह इंतज़ार का समय, बैकऑफ़ के ज़्यादा से ज़्यादा समय तक बढ़ सकता है. उदाहरण के लिए:
- Google Drive API को अनुरोध भेजें.
- अगर अनुरोध पूरा नहीं होता है, तो 1 +
random_number_millisecondsसेकंड इंतज़ार करें और फिर से अनुरोध करें. - अगर अनुरोध पूरा नहीं होता है, तो 2 +
random_number_millisecondsसेकंड इंतज़ार करें और फिर से अनुरोध करें. - अगर अनुरोध पूरा नहीं होता है, तो 4 +
random_number_millisecondsसेकंड इंतज़ार करें और फिर से अनुरोध करें. - और इसी तरह,
maximum_backoffबार तक. - कुछ समय तक इंतज़ार करें और ज़्यादा से ज़्यादा बार कोशिश करें. हालांकि, कोशिशों के बीच इंतज़ार की अवधि न बढ़ाएं.
कहां:
- आपको
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 में कोटा और सिस्टम की सीमाएं पेज पर जाकर, कोटे में बदलाव करने का अनुरोध किया जा सकता है.
ज़्यादा जानने के लिए, यहां दिए गए संसाधन देखें:
- कोटा अडजस्टमेंट के बारे में जानकारी
- कोटा के इस्तेमाल और सीमाओं की जानकारी देखना
- कोटा बढ़ाने का अनुरोध करना