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

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

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

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

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

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

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

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

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

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

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

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