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

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

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

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

समय के हिसाब से ज़रूरी अनुरोध

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

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

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

कोटा

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

सीमाएं

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