डायरेक्ट्री एपीआई: सीमाएं और कोटा

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

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

इस सूची में गड़बड़ी के संभावित कोड, वजहें, और उनसे जुड़ी जानकारी के बारे में बताया गया है. साथ ही, कोटा की सीमाओं को पार करने पर होने वाली गड़बड़ियों के लिए सुझाई गई कार्रवाई भी दी गई है.

कोड	वजह	ब्यौरा	सुझाई गई कार्रवाई
403	userRateLimitExceeded	इससे पता चलता है कि उपयोगकर्ता दर की सीमा पार हो गई है. Google Cloud Console में सेट की गई डिफ़ॉल्ट वैल्यू, हर Google Cloud प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से 2,400 क्वेरी प्रति मिनट है.	अपने Google Cloud प्रोजेक्ट के एडमिन SDK एपीआई कोटा पेज से, हर उपयोगकर्ता के लिए सीमा बढ़ाएं या एक्सपोनेन्शियल बैकऑफ़ का इस्तेमाल करके, अनुरोध भेजने की दर कम करें.
403	quotaExceeded	इससे पता चलता है कि किसी खास कार्रवाई के लिए, एक साथ अनुरोध करने की सीमा पूरी हो गई है.	एक्सपोनेन्शियल बैक-ऑफ़ सुविधा का इस्तेमाल करके फिर से कोशिश करें. आपको अनुरोध भेजने की दर को कम करना होगा.
429	rateLimitExceeded	इससे पता चलता है कि किसी खास कार्रवाई के लिए, एक साथ अनुरोध करने की सीमा पूरी हो गई है.	एक्सपोनेन्शियल बैक-ऑफ़ सुविधा का इस्तेमाल करके फिर से कोशिश करें. आपको जिस दर से अनुरोध भेजे जा रहे हैं उसे कम करना होगा. यह सीमा हर Google Workspace खाते के हिसाब से होती है, न कि हर एपीआई क्लाइंट या हर उपयोगकर्ता के हिसाब से. इस सीमा को बढ़ाया नहीं जा सकता.

एक्सपोनेन्शियल बैकऑफ़ लागू करना

एक्सपोनेंशियल बैकऑफ़ वह प्रोसेस है जिसमें क्लाइंट, समय-समय पर फ़ेल हो चुके अनुरोध को प्रोसेस करने की कोशिश करता रहता है. यह नेटवर्क ऐप्लिकेशन के लिए, गड़बड़ियों को ठीक करने की स्टैंडर्ड रणनीति है. एक्सपोनेन्शियल बैकऑफ़ का इस्तेमाल करने से बैंडविथ के इस्तेमाल की क्षमता बढ़ जाती है. साथ ही, एक सफल रिस्पॉन्स पाने के लिए ज़रूरी अनुरोधों की संख्या कम हो जाती है और एक ही समय में एक साथ मिलने वाले एनवायरमेंट में अनुरोधों की संख्या बढ़ जाती है.

सामान्य एक्सपोनेन्शियल बैकऑफ़ लागू करने का फ़्लो इस तरह है.

1. एपीआई से अनुरोध करें
2. गड़बड़ी का ऐसा गड़बड़ी कोड मिला है जिसके लिए फिर से कोशिश की जा सकती है
3. 1 सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
4. फिर से अनुरोध करें
5. गड़बड़ी का ऐसा गड़बड़ी कोड मिला है जिसके लिए फिर से कोशिश की जा सकती है
6. 2 सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
7. फिर से अनुरोध करें
8. गड़बड़ी का ऐसा गड़बड़ी कोड मिला है जिसके लिए फिर से कोशिश की जा सकती है
9. 4 सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
10. फिर से अनुरोध करें
11. गड़बड़ी का ऐसा गड़बड़ी कोड मिला है जिसके लिए फिर से कोशिश की जा सकती है
12. 8 सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
13. फिर से अनुरोध करें
14. गड़बड़ी का ऐसा गड़बड़ी कोड मिला है जिसके लिए फिर से कोशिश की जा सकती है
15. 16 सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
16. फिर से अनुरोध करें
17. अगर आपको अब भी गड़बड़ी का कोई मैसेज मिलता है, तो उसे रोकें और लॉग करें.

ऊपर दिए गए फ़्लो में, random_number_milliseconds, 1,000 से कम या उसके बराबर मिलीसेकंड की कोई रैंडम संख्या है. यह ज़रूरी है, ताकि एक साथ लागू किए जाने वाले कुछ वर्शन में लॉक से जुड़ी कुछ गड़बड़ियों से बचा जा सके. हर इंतज़ार के बाद, random_number_milliseconds को फिर से तय करना होगा.

ध्यान दें: इंतज़ार हमेशा (2 ^ n) + random_number_milliseconds होता है, जहां n एक मोनोटोनिक रूप से बढ़ने वाला पूर्णांक है, जिसे शुरू में 0 के रूप में परिभाषित किया गया है. हर इटरेशन (हर अनुरोध) के लिए n को 1 से बढ़ाया जाता है.

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

एपीआई की सीमाएं और कोटा

एपीआई की सीमा की कैटगरी	बाहर रखे गए प्लेसमेंट से जुड़ी सीमाएं
उपयोगकर्ता बनाना	डायरेक्ट्री एपीआई का इस्तेमाल करके, हर डोमेन के लिए 10 से ज़्यादा उपयोगकर्ता नहीं बनाए जा सकते.
ग्रुप को सदस्य के तौर पर, किसी दूसरे ग्रुप में जोड़ा गया	चाइल्ड ग्रुप के सदस्यों को, पैरंट ग्रुप के सदस्य के तौर पर दिखने में 10 मिनट तक की देरी हो सकती है. सिस्टम की क्षमता के हिसाब से, यह सीमा बदल सकती है.
मोबाइल डिवाइस	डायरेक्ट्री एपीआई का इस्तेमाल करके, ये काम किए जा सकते हैं: हर सेकंड, कार्रवाई के 20 अनुरोध. हर सेकंड, मिटाने के 20 अनुरोध. हर सेकंड 10 अनुरोध मिलते हैं. हर सेकंड, सूची के 10 अनुरोध.
उपयोगकर्ताओं के नाम बदले जा रहे हैं	इसे सभी सेवाओं पर लागू होने में 10 मिनट लग सकते हैं. उपयोगकर्ता का नाम बदलने से पहले, यह सुझाव दिया जाता है कि उपयोगकर्ता को सभी ब्राउज़र सेशन और सेवाओं से लॉग आउट कर दें. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं को अपडेट करें देखें.
संगठन की इकाइयां बनाना/अपडेट करना	डायरेक्ट्री एपीआई का इस्तेमाल करके, हर ग्राहक के लिए हर सेकंड में एक से ज़्यादा संगठन की इकाई नहीं बनाई जा सकती और न ही उसे अपडेट किया जा सकता है. ग्राहक के संगठन की इकाई की हैरारकी में, गहराई के 35 लेवल तक शामिल हो सकते हैं. हर ग्राहक के लिए संगठन की इकाइयों की कुल संख्या 40,000 से ज़्यादा नहीं होनी चाहिए.
एपीआई कोटा कैटगरी	कोटा
Chrome डिवाइस annotatedLocation, ज़्यादा से ज़्यादा वर्ण	किसी डिवाइस की जगह की जानकारी में ज़्यादा से ज़्यादा 200 वर्ण हो सकते हैं.
Chrome डिवाइस notes, ज़्यादा से ज़्यादा वर्ण	किसी डिवाइस के नोट की जानकारी में ज़्यादा से ज़्यादा 500 वर्ण हो सकते हैं.
Chrome डिवाइस, ज़्यादा से ज़्यादा user वर्ण	डिवाइस के उपयोगकर्ता के नाम में ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं.
डोमेन अन्य नाम, अधिकतम	डोमेन अन्य नाम ज़्यादा से ज़्यादा 20 हो सकते हैं.
ग्रुप, जानकारी	ब्यौरे में ज़्यादा से ज़्यादा 4,096 वर्ण हो सकते हैं.
समूह, प्रति खाता	G Suite के पुराने मुफ़्त वर्शन वाले खाते में, ग्रुप की संख्या 10 हो सकती है. अन्य वर्शन में, ग्रुप की संख्या की कोई सीमा नहीं है.
ग्रुप, हर ग्रुप के सदस्य	G Suite के पुराने मुफ़्त वर्शन वाले खाते से, किसी ग्रुप में 100 सदस्य शामिल हो सकते हैं. अन्य वर्शन में, ग्रुप के सदस्यों की संख्या की कोई सीमा नहीं होती. हर उपयोगकर्ता के हिसाब से ग्रुप की सदस्यता की सीमाओं के बारे में जानने के लिए, Groups की नीतियों और सीमाओं को समझना लेख पढ़ें
maxनतीजे क्वेरी स्ट्रिंग	एपीआई यह दिखाता है: Chrome और मोबाइल डिवाइस – एक डिफ़ॉल्ट और हर पेज पर ज़्यादा से ज़्यादा 100 एंट्री. ग्रुप और ग्रुप के सदस्य – एक डिफ़ॉल्ट और हर पेज पर ज़्यादा से ज़्यादा 200 एंट्री. उपयोगकर्ता - हर पेज पर ज़्यादा से ज़्यादा 100 एंट्री और ज़्यादा से ज़्यादा 500 एंट्री. उपयोगकर्ता का दूसरा ईमेल पता और संगठन की इकाई के संसाधन, रिस्पॉन्स के तौर पर क्रम में लगाने की सुविधा का इस्तेमाल नहीं करते. सभी उपयोगकर्ता के मुख्य ईमेल वर्णमाला के क्रम में दिए जाते हैं और जवाब का क्रम केस-इनसेंसिटिव होता है.
एक से ज़्यादा डोमेन, एक खाते में ज़्यादा से ज़्यादा डोमेन की अनुमति है	600 (1 प्राइमरी डोमेन + 599 अतिरिक्त डोमेन)
संगठन की इकाई: एक बार में ज़्यादा से ज़्यादा कितने उपयोगकर्ता माइग्रेट किए जा सकते हैं	एक बार में 20 उपयोगकर्ताओं को माइग्रेट किया जा सकता है. साथ ही, खाते में उपयोगकर्ता के मुख्य ईमेल पते पहले से ही मौजूद होने चाहिए.
उपयोगकर्ता के उपनाम	हर उपयोगकर्ता खाते के लिए, 30 उपनाम इस्तेमाल किए जा सकते हैं.
मिटाए गए उपनाम का इस्तेमाल करने वाले उपयोगकर्ता का उपनाम	मिटाए गए उपयोगकर्ता का दूसरा ईमेल पता, तुरंत फिर से इस्तेमाल किया जा सकता है.

दूसरी तरह की सीमाएं	सीमाएं और दिशा-निर्देश
बिलिंग और उपयोगकर्ता बनाना	अगर आपने Google Workspace के लिए, ज़रूरत के हिसाब से प्लान लिया हुआ है, तो इस एपीआई का इस्तेमाल करके उपयोगकर्ता बनाने पर, पैसे पर असर पड़ेगा. साथ ही, आपको ग्राहक के बिलिंग खाते के लिए शुल्क देना होगा. उदाहरण के लिए, अगर आपने Google Workspace के लिए महीने के हिसाब से प्लान लिया हुआ है, तो 10 उपयोगकर्ता बनाने पर, आपके खाते में पोस्ट किए जाने वाले Google Workspace के 10 लाइसेंस के लिए शुल्क लिया जाएगा. यह शुल्क, लाइसेंस बनाए जाने के समय के हिसाब से लिया जाएगा. अगर आपने सालाना प्लान लिया है, तो पहले ही तय संख्या में लाइसेंस के लिए पैसे चुकाने होंगे. साथ ही, इस प्लान के हिसाब से उतने उपयोगकर्ता ही बनाए जा सकते हैं. बिलिंग प्लान और अपने बिलिंग खाते के बारे में ज़्यादा जानकारी के लिए, एडमिन सहायता केंद्र पर जाएं.
नाम और सरनेम	नाम और सरनेम में ज़्यादा से ज़्यादा 40 वर्ण होते हैं. ये यूनिकोड/UTF-8 वर्णों के साथ काम करते हैं और इनमें खाली जगह, अक्षर (a-z), संख्याएं (0-9), डैश (-), फ़ॉरवर्ड स्लैश (/), और पीरियड (.) हो सकते हैं. वर्ण का इस्तेमाल करने के नियमों के बारे में ज़्यादा जानने के लिए, एडमिन सहायता केंद्र पर जाएं.
ग्रुप वाले सेक्शन को मिटाया जा रहा है	किसी ग्रुप को मिटाने पर, ग्रुप के सदस्य के उपयोगकर्ता खाते नहीं मिटते हैं.
ग्रुप और ग्रुप के सदस्य, ईमेल पता बदलना	एपीआई के इस वर्शन में, Google Workspace की सेवा चालू होने से पहले किसी ग्रुप का ईमेल पता बदला जा सकता है. समूह के किसी सदस्य का ईमेल पता बदलने के लिए Admin console का इस्तेमाल करें. बदलाव करने के बाद, एपीआई अपने-आप ईमेल पते में हुए बदलावों को दिखाता है.
ग्रुप, सेटिंग	Admin console की मदद से ग्रुप की ऐक्सेस सेटिंग, शेयर करने के विकल्प, निगरानी करने, और चर्चा के संग्रह को मैनेज किया जाता है. ग्रुप की सेटिंग के बारे में ज़्यादा जानकारी के लिए, एडमिन सहायता केंद्र पर जाएं.
ग्रुप, मैसेज भेजना	स्पैम और ईमेल के गलत इस्तेमाल को रोकने के लिए, Google बाहरी लोगों को एक साथ भेजे जा सकने वाले मैसेज की संख्या को सीमित करता है. किसी ग्रुप को मैसेज भेजने पर, संगठन से बाहर के हर सदस्य को एक ईमेल पाने वाले व्यक्ति के तौर पर गिना जाता है. ज़्यादा जानकारी के लिए, ईमेल भेजने की सीमाएं और Gmail के उपयोगकर्ताओं के ईमेल को ब्लॉक किए जाने या स्पैम में भेजे जाने से रोकना लेख पढ़ें.
ग्रुप, एनडीआर मैसेज भेजना	आपके पास किसी ग्रुप को नॉन-डिलीवरी रसीद (एनडीआर) भेजने या फ़ॉरवर्ड करने का विकल्प नहीं है. इन रसीदों को "बाउंस मैसेज" भी कहा जाता है.
उपयोगकर्ताओं के बनाए गए ग्रुप, सीमाएं	उपयोगकर्ताओं के बनाए गए ग्रुप की सीमाओं के बारे में जानने के लिए, एडमिन सहायता केंद्र पर जाएं
संगठन की इकाई, सेवाओं को चालू/बंद करना	संगठन की किसी इकाई के लिए, सेवाओं को चालू और बंद करना मैनेज करने के लिए, Admin console का इस्तेमाल करें.
पासवर्ड	इसमें वर्णों का कोई भी कॉम्बिनेशन हो सकता है. कम से कम 8 वर्णों का होना ज़रूरी है. ज़्यादा से ज़्यादा 100 वर्ण इस्तेमाल किए जा सकते हैं.
फ़ोटो	एपीआई के इस वर्शन में, उपयोगकर्ता की सबसे नई Google प्रोफ़ाइल फ़ोटो फ़ोटो होती है.
उपयोगकर्ता नाम	उपयोगकर्ता के नाम में अक्षर (a-z), संख्याएं (0-9), डैश (-), अंडरस्कोर (_), और Google Workspace बिंदुओं या फ़ुल स्टॉप (.) की पहचान कर सकता है. यह Gmail की तरह नहीं है. उपयोगकर्ता नाम की लाइन में, बराबर का चिह्न (=), ब्रैकेट (<,>) या एक से ज़्यादा पीरियड (.) नहीं होने चाहिए. ज़्यादा जानकारी के लिए, एडमिन सहायता केंद्र पर जाएं.
उपयोगकर्ताओं के नाम, नाम बदलना	नाम बदलने के बाद Google Hangouts, याद रखे गए सभी चैट न्योते खारिज कर देता है. उपयोगकर्ता को दोस्तों के साथ दोबारा चैट करने के लिए अनुमति का अनुरोध करना होगा. पुराने उपयोगकर्ता नाम को ईमेल उपनाम के तौर पर सेव करके रखा गया है, ताकि ईमेल फ़ॉरवर्ड करने की सेटिंग के मामले में मेल की डिलीवरी को लगातार जारी रखा जा सके. साथ ही, यह नए उपयोगकर्ता नाम के तौर पर उपलब्ध नहीं होगा. उपयोगकर्ताओं का नाम बदलने से पड़ने वाले असर के बारे में अहम जानकारी पाने के लिए, एडमिन सहायता केंद्र पर जाएं. नाम बदलने के बाद, ईमेल उपनाम हटाने के लिए, उपयोगकर्ता का उपनाम मिटाएं कार्रवाई का इस्तेमाल करें.
एक से ज़्यादा डोमेन के उपयोगकर्ता	Google Workspace खाते में आपका कोई भी डोमेन शामिल हो सकता है. किसी एक से ज़्यादा डोमेन वाले खाते के एक डोमेन के उपयोगकर्ता, दूसरे खाता डोमेन के उपयोगकर्ताओं के साथ सेवाएं शेयर कर सकते हैं. एक से ज़्यादा डोमेन कॉम्पोनेंट: प्राइमरी डोमेन -- आपके खाते का प्राइमरी डोमेन, उस एडमिन का डोमेन होता है जिसने Google Workspace की सेवा की शर्तों का कानूनी समझौता स्वीकार किया है. यह डोमेन, संगठन की टॉप लेवल की इकाई में खाता लेवल पर है. हमारा सुझाव है कि Google Workspace खाते के लिए साइन अप करते समय, आप प्राइमरी डोमेन के लिए अपने कारोबार के डोमेन का इस्तेमाल करें. साथ ही, पायलट और टेस्ट जैसे खास कामों के लिए, अपने दूसरे डोमेन बुक करें. सभी सुपर एडमिन पूरे खाते को मैनेज कर सकते हैं. एपीआई, Google Workspace खाते के प्राइमरी डोमेन को बदल नहीं सकता या उसे मूव नहीं कर सकता. हालांकि, एपीआई किसी उपयोगकर्ता के खाते का नाम बदल सकता है और उसके ईमेल पते को एक डोमेन से दूसरे डोमेन में बदल सकता है. Google Workspace खातों के लिए, आपको 21 दिन के अंदर अपने प्राइमरी डोमेन के मालिकाना हक की पुष्टि करनी होगी. अतिरिक्त डोमेन के लिए, आपको उपयोगकर्ता के प्राइमरी ईमेल पते के लिए डोमेन का इस्तेमाल करने से पहले, अपने डोमेन के मालिकाना हक की पुष्टि करनी होगी. ऐसे मामलों में, 21 दिन का ग्रेस पीरियड लागू नहीं होता. एपीआई के इस वर्शन में, प्राइमरी डोमेन की सेटिंग, Google Workspace की सेवाओं के उपयोगकर्ता ऐक्सेस को छोड़कर, खाते से जुड़े सभी डोमेन पर लागू होती हैं. अतिरिक्त खाता डोमेन -- अपना प्राथमिक डोमेन स्थापित और अपना खाता सेट अप करने के बाद, आप अपने अतिरिक्त डोमेन खाते में जोड़ सकते हैं. अन्य डोमेन के लिए, इस डोमेन को सेट अप करते समय और उपयोगकर्ता के प्राइमरी ईमेल पते के लिए डोमेन का इस्तेमाल करने से पहले, अपने मालिकाना हक की पुष्टि करें. उपयोगकर्ता का होम डोमेन -- उपयोगकर्ता के प्राथमिक ईमेल पते में उपयोग किया गया डोमेन, उपयोगकर्ता का होम डोमेन होता है. यह डोमेन, खाते का कोई भी डोमेन हो सकता है. इसमें प्राइमरी डोमेन भी शामिल है. एक से ज़्यादा डोमेन की हाल ही की सीमाओं के बारे में जानने के लिए, डोमेन की एक से ज़्यादा सीमाएं देखें. इसमें डोमेन अन्य नाम, खाता मर्ज करने वगैरह की जानकारी शामिल है.
चेतावनियां, ग्रुप के सदस्य	ग्रुप_CANNOT TRANSLATE उदाहरण के लिए, अगर ग्रुप 1, ग्रुप 2 का सदस्य है, तो ग्रुप 2, ग्रुप 1 का सदस्य नहीं हो सकता.