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

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

अगर आपने कोटा से ज़्यादा अनुरोध किए, तो आम तौर पर आपको 429: Too many requests एचटीटीपी स्टेटस कोड वाला जवाब मिलेगा. अगर ऐसा होता है, तो आपको एक एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करना चाहिए और बाद में फिर से कोशिश करनी चाहिए. अगर आपने हर मिनट के लिए तय किए गए कोटे से कम अनुरोध किए हैं, तो एक दिन में किए जाने वाले अनुरोधों की कोई सीमा नहीं है.

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

कोटा
पढ़ने के अनुरोध
हर प्रोजेक्ट के लिए हर मिनट 3000
हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर मिनट 600
पढ़ने के लिए किए जाने वाले ऐसे अनुरोध जिनमें ज़्यादा संसाधन इस्तेमाल होते हैं

(इनका इस्तेमाल, presentations.pages.getThumbnail अनुरोधों के लिए किया जाता है.)

हर प्रोजेक्ट के लिए हर मिनट 300
हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर मिनट 60
लिखने के अनुरोध
हर प्रोजेक्ट के लिए हर मिनट 600
हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर मिनट 60

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

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

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

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

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

  1. Google Slides 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 समय पूरा होने के बाद, क्लाइंट फिर से कोशिश कर सकता है. इसके बाद, फिर से कोशिश करने के लिए बैकऑफ़ का समय बढ़ाने की ज़रूरत नहीं होती. उदाहरण के लिए, अगर कोई क्लाइंट maximum_backoff समय के तौर पर 64 सेकंड का इस्तेमाल करता है, तो इस वैल्यू तक पहुंचने के बाद, क्लाइंट हर 64 सेकंड में फिर से कोशिश कर सकता है. कुछ समय बाद, क्लाइंट को हमेशा के लिए फिर से कोशिश करने से रोका जाना चाहिए.

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

कीमत

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

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

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

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

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