एपीआई के इस्तेमाल की सीमाएं

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

एपीआई अनुरोध पूरे नहीं हो पाए

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

समय के हिसाब से संवेदनशील अनुरोध

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

समय के हिसाब से होने वाली गड़बड़ियां

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

कोटा

एपीआई कोटा की कैटगरी	कोटा
क्वेरी प्रति दिन	हर दिन ज़्यादा से ज़्यादा 1,00,000 क्वेरी की जा सकती हैं. अगर आपको इस सीमा से ज़्यादा स्टोरेज की ज़रूरत है, तो Google Cloud Console में कोटा पेज पर जाकर अनुरोध भेजें
ग्रुप की जानकारी, ज़्यादा से ज़्यादा साइज़	ग्रुप का ब्यौरा, ज़्यादा से ज़्यादा 300 वर्णों में डाला जा सकता है.
ग्रुप का नाम, ज़्यादा से ज़्यादा साइज़	ग्रुप के नाम में ज़्यादा से ज़्यादा 60 वर्ण हो सकते हैं.
defaultMessageDenyNotificationText	सूचना के टेक्स्ट में ज़्यादा से ज़्यादा 10,000 वर्ण हो सकते हैं. defaultMessageDenyNotificationText प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस देखें.
maxMessageBytes	मैसेज का डिफ़ॉल्ट साइज़ 1 एमबी से ज़्यादा नहीं हो सकता. maxMessageBytes प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस देखें.

सीमाएं

सीमाएं किस तरह की हैं	सीमाएं और दिशा-निर्देश
डेटा फ़ॉर्मैट, डिफ़ॉल्ट	डेटा का डिफ़ॉल्ट फ़ॉर्मैट JSON है. यह एपीआई, ऐटम फ़ॉर्मैट के साथ भी काम करता है. JSON और ऐटम डेटा फ़ॉर्मैट, दोनों पर पूरा रीड-राइट फ़ंक्शन काम करता है. ज़्यादा जानकारी के लिए, JSON और ऐटम डेटा फ़ॉर्मैट देखें.
Groups Settings API, चालू करना	Groups Settings API पर कॉल करने से पहले, आपको Directory API को चालू करना होगा. ज़्यादा जानकारी के लिए, Google Workspace API चालू करें देखें.