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

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

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

Drive API के कोटा

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

  • हर मिनट, हर प्रोजेक्ट के लिए: यह कोटे की उन यूनिट की संख्या है जिनका इस्तेमाल आपका Google 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,00,00,000 कोटा यूनिट

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

हर तरीके के लिए कोटा यूनिट की लागत

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

रीड मेथड (पांच कोटा यूनिट)

तरीका
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

List methods (100 कोटा यूनिट)

तरीका
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

Edit methods (50 quota units)

तरीका
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch, drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide, drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch, drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch, drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

डाउनलोड करने के तरीके (200 कोटा यूनिट)

तरीका
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

अन्य तरीके (पांच कोटा यूनिट)

तरीका
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

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

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 के एमसीपी सर्वर के हर तरीके के लिए, क्वेरी की लागत के बारे में सेक्शन के हिसाब से बताया गया है:

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 MCP API का रेफ़रंस देखें.