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

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

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

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

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

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

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

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

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

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

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

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