इस्तेमाल करने की सीमाएं और कोटा

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

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

अगर आपके अनुरोधों को तय समय में पूरा करना है, तो अपने अनुरोधों को एक साथ भेजें. इसके अलावा, अपने Java या C# ऐप्लिकेशन में एक से ज़्यादा थ्रेड का इस्तेमाल करें. एक साथ कई अनुरोध करने का एक उदाहरण यह है कि एक ही समय में, एक उपयोगकर्ता के कई ईमेल पते जोड़ने या हटाने के बजाय, अलग-अलग उपयोगकर्ताओं के ईमेल पतों के छोटे बैच का अनुरोध करना. थ्रेड के मामले में, हर उपयोगकर्ता के ईमेल के लिए एक थ्रेड का इस्तेमाल करके, 10 थ्रेड से शुरुआत करें. ध्यान दें कि थ्रेड के सुझाव के कुछ फ़ायदे और कुछ नुकसान हैं. साथ ही, यह एपीआई से जुड़ी सभी स्थितियों के लिए फ़ायदेमंद नहीं है. अगर अनुरोधों की संख्या बहुत ज़्यादा हो जाती है, तो कोटे से जुड़ी गड़बड़ियां होंगी.

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

एपीआई की सीमाएं तय करने वाली कैटगरी सीमाएं
Alert Center के लिए QPS और QPD की दरें यह एपीआई, आपके API कंसोल प्रोजेक्ट के लिए अनुरोधों की संख्या को सीमित करता है. एपीआई प्रोजेक्ट के लिए, हर सेकंड में ज़्यादा से ज़्यादा 1,000 अनुरोध किए जा सकते हैं (प्रोजेक्ट क्यूपीएस). इसके अलावा, हर उपयोगकर्ता के लिए हर सेकंड में ज़्यादा से ज़्यादा 150 अनुरोध (उपयोगकर्ता क्यूपीएस) किए जा सकते हैं.

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

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

हर प्रोजेक्ट के लिए कोटा बढ़ाने का अनुरोध करना

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

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

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