Drive Labels API एक शेयर की जाने वाली सेवा है. इसलिए, हम इस पर कोटा और सीमाएं लागू करते हैं. इससे यह पक्का किया जा सकता है कि सभी उपयोगकर्ता इसका सही तरीके से इस्तेमाल करें और Google Workspace के पूरे इकोसिस्टम को सुरक्षित रखा जा सके.
अगर आपने कोटा से ज़्यादा अनुरोध किए हैं, तो आम तौर पर आपको 429: Too many
requests एचटीटीपी स्टेटस कोड वाला जवाब मिलेगा. अगर ऐसा होता है, तो आपको एक
एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करना चाहिए और बाद में फिर से कोशिश करनी चाहिए.
अगर आपने हर मिनट के लिए तय किए गए कोटा के हिसाब से अनुरोध किए हैं, तो एक दिन में किए जाने वाले अनुरोधों की संख्या पर कोई पाबंदी नहीं है.
यहां दी गई टेबल में, अनुरोधों की सीमाओं के बारे में बताया गया है:
| कोटा | |||
|---|---|---|---|
| अनुरोध पढ़ना |
|
||
| अनुरोध लिखना |
|
||
समय के हिसाब से तय किए गए कोटा से जुड़ी गड़बड़ियां ठीक करना
समय के हिसाब से तय किए गए कोटा से जुड़ी सभी गड़बड़ियों (जैसे, हर X मिनट में ज़्यादा से ज़्यादा N अनुरोध) के लिए, हमारा सुझाव है कि आपका कोड अपवाद को पकड़ ले. साथ ही, यह पक्का करने के लिए कि आपके डिवाइस पर ज़्यादा लोड न पड़े, ट्रंकेटेड एक्स्पोनेंशियल बैकऑफ़ का इस्तेमाल करे.
एक्स्पोनेंशियल बैकऑफ़, नेटवर्क ऐप्लिकेशन के लिए गड़बड़ी ठीक करने की एक स्टैंडर्ड रणनीति है. एक एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों के बीच इंतज़ार के समय को एक्स्पोनेंशियल तरीके से बढ़ाकर, अनुरोधों को फिर से भेजता है. हालांकि, इंतज़ार का समय एक तय सीमा से ज़्यादा नहीं होता. अगर अनुरोध अब भी पूरे नहीं होते हैं, तो यह ज़रूरी है कि अनुरोध पूरे होने तक, अनुरोधों के बीच का समय बढ़ता रहे.
एल्गोरिदम का उदाहरण
एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को एक्स्पोनेंशियल तरीके से फिर से भेजता है. साथ ही, फिर से अनुरोध भेजने के बीच इंतज़ार का समय बढ़ाता है. हालांकि, इंतज़ार का समय एक तय सीमा से ज़्यादा नहीं होता. उदाहरण के लिए:
- Drive Labels 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 समय पूरा होने के बाद भी फिर से अनुरोध भेज सकता है.
इसके बाद, फिर से अनुरोध भेजने के लिए, बैकऑफ़ टाइम को बढ़ाने की ज़रूरत नहीं होती. उदाहरण
के लिए, अगर कोई क्लाइंट maximum_backoff समय के तौर पर 64 सेकंड का इस्तेमाल करता है, तो इस वैल्यू तक पहुंचने के बाद, क्लाइंट हर 64 सेकंड में फिर से अनुरोध भेज सकता है. कुछ समय बाद,
क्लाइंट को हमेशा के लिए फिर से अनुरोध भेजने से रोका जाना चाहिए.
फिर से अनुरोध भेजने के बीच इंतज़ार का समय और फिर से अनुरोध भेजने की संख्या, आपके इस्तेमाल के उदाहरण और नेटवर्क की स्थितियों पर निर्भर करती है.
कीमत
Drive Labels API का स्टैंडर्ड इस्तेमाल, बिना किसी अतिरिक्त शुल्क के किया जा सकता है. कोटा के हिसाब से तय की गई अनुरोधों की सीमाओं से ज़्यादा अनुरोध करने पर, 2026 में आपके Google Cloud बिलिंग खाते से शुल्क लिया जाएगा. ज़्यादा जानकारी के लिए, एजेंट टूल और एपीआई के लिए Google Workspace का स्टैंडर्ड मॉडल लेख पढ़ें.
कोटा बढ़ाने का अनुरोध करना
अपने प्रोजेक्ट के संसाधन के इस्तेमाल के हिसाब से, आपको कोटा में बदलाव करने का अनुरोध करना पड़ सकता है. किसी सेवा खाते से किए गए एपीआई कॉल को, एक खाते का इस्तेमाल माना जाता है. कोटा में बदलाव के लिए आवेदन करने का मतलब यह नहीं है कि इसे मंज़ूरी मिल ही जाएगी. कोटा में बदलाव के ऐसे अनुरोधों को मंज़ूरी मिलने में ज़्यादा समय लग सकता है जिनसे कोटा की वैल्यू में काफ़ी बढ़ोतरी हो सकती है.
सभी प्रोजेक्ट के लिए कोटा एक जैसा नहीं होता. समय के साथ-साथ, Google Cloud का इस्तेमाल बढ़ने पर, कोटा की वैल्यू बढ़ाने की ज़रूरत पड़ सकती है. अगर आपको लगता है कि आने वाले समय में इस्तेमाल में काफ़ी बढ़ोतरी होगी, तो Google Cloud कंसोल में, कोटा और सिस्टम की सीमाएं पेज पर जाकर, कोटा में बदलाव करने का अनुरोध किया जा सकता है.
ज़्यादा जानने के लिए, ये संसाधन देखें:
- कोटा में बदलाव के बारे में जानकारी
- अपने कोटा के इस्तेमाल और सीमाओं की जानकारी देखना
- कोटा की सीमा बढ़ाने का अनुरोध करना