सीमाएं और कोटा

सीमाएं और कोटा, Google के इंफ़्रास्ट्रक्चर को ऑटोमेटेड प्रोसेस से सुरक्षित रखते हैं. यह ऐसी प्रोसेस है जो Enterprise लाइसेंस मैनेजर एपीआई का गलत तरीके से इस्तेमाल करती है. किसी एपीआई के बहुत ज़्यादा अनुरोध, टाइप करने में हुई किसी गड़बड़ी की वजह से हो सकते हैं. इसके अलावा, यह ऐसे सिस्टम की वजह से भी हो सकता है जिसे गलत तरीके से डिज़ाइन किया गया हो और जो ग़ैर-ज़रूरी एपीआई कॉल करता हो. वजह चाहे जो भी हो, Google Workspace सिस्टम की पूरी परफ़ॉर्मेंस के लिए, किसी खास सोर्स के ट्रैफ़िक को एक खास लेवल पर पहुंचने के बाद ब्लॉक करना ज़रूरी है. इससे यह पक्का होता है कि किसी एक डेवलपर की कार्रवाई से, बड़े कम्यूनिटी पर बुरा असर न पड़े.

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

अगर आपके अनुरोधों को किसी तय समयसीमा में पूरा करना ज़रूरी है, तो अपने अनुरोधों को एक साथ बैच करके भेजें. आपके एपीआई के मकसद और अनुरोधों की संख्या बहुत ज़्यादा होने पर, कोटा से जुड़ी गड़बड़ियां होंगी.

अगर आप सुझाए गए एपीआई के लिए एक साथ कई अनुरोध करने की सुविधा का इस्तेमाल नहीं कर पा रहे हैं, तो एक्स्पोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करें. समय के हिसाब से होने वाली सभी गड़बड़ियों (हर थ्रेड के लिए X सेकंड के लिए ज़्यादा से ज़्यादा N चीज़ें), खास तौर पर 503 स्टेटस कोड की गड़बड़ियों के लिए, हमारा सुझाव है कि आप अपने कोड को अपवाद के तौर पर पहचान लें. साथ ही, एक्सपोनेन्शियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करके, पूरे न हो पाने वाले कॉल को दोबारा कोशिश करने से पहले थोड़ी देर इंतज़ार करें. एक थ्रेड के लिए Enterprise लाइसेंस मैनेजर एपीआई का उदाहरण: पांच सेकंड इंतज़ार करना और पूरे न हो पाने वाले कॉल को फिर से कोशिश करना. अगर अनुरोध पूरा हो जाता है, तो दूसरी थ्रेड के लिए यह पैटर्न दोहराएं. अगर दूसरा अनुरोध पूरा नहीं होता है, तो आपके आवेदन को अनुरोध की फ़्रीक्वेंसी के आधार पर तब तक स्केल करना होगा, जब तक कॉल पूरा नहीं हो जाता. उदाहरण के लिए, शुरुआती 5 सेकंड की देरी को बढ़ाकर 10 सेकंड करें और फ़ेल कॉल फिर से करके देखें. साथ ही, फिर से कोशिश करने की सीमा तय करें. उदाहरण के लिए, ऐप्लिकेशन उपयोगकर्ता को गड़बड़ी दिखाने से पहले, अलग-अलग देरी वाले समय के साथ पांच से सात बार अनुरोध करें.

एपीआई कोटा कैटगरी	कोटा
क्वेरी प्रति सेकंड (QPS)	क्यूपीएस कोटा 1 है.

एपीआई की सीमा की कैटगरी	बाहर रखे गए प्लेसमेंट से जुड़ी सीमाएं
maxनतीजे क्वेरी स्ट्रिंग	maxनतीजे की साइज़ ज़्यादा से ज़्यादा 100 है.

दूसरी तरह की सीमाएं	सीमाएं और दिशा-निर्देश
बैच में किए गए अनुरोध	यह एपीआई बैच अनुरोध भेजने की सुविधा देता है.
एपीआई के रिस्पॉन्स में डेटा फ़ॉर्मैट	रिस्पॉन्स का डेटा फ़ॉर्मैट, JavaScript ऑब्जेक्ट नोटेशन (JSON) है.
Enterprise लाइसेंस मैनेजर एपीआई को चालू करना	Enterprise लाइसेंस मैनेजर एपीआई को कॉल करने से पहले, प्रॉविज़निंग एपीआई को चालू करना ज़रूरी है. अपने कंट्रोल पैनल में, उपयोगकर्ता और समूह टैब के सेटिंग पेज पर जाएं और प्रॉविज़निंग एपीआई को चालू करें. बदलावों को सेव करें. इसके अलावा, Google Groups की सेवा चालू और चालू होनी चाहिए.
बिना अनुमति के किए गए अनुरोध	एपीआई ऐसे किसी भी अनुरोध को स्वीकार नहीं करता है जिसके पास अनुमति नहीं है. अगर अनुमति देने वाला कोई टोकन नहीं दिया गया है, तो अनुरोध को बिना अनुमति के माना जाता है. ज़्यादा जानकारी के लिए, अनुरोधों को अनुमति देना देखें.