Directory API: सीमाएं और कोटा

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

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

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

कोड	कारण	ब्यौरा	सुझाई गई कार्रवाई
403	userRateLimitExceeded	इससे पता चलता है कि उपयोगकर्ता की दर की सीमा पार हो गई है. Google Cloud Console में सेट की गई डिफ़ॉल्ट वैल्यू, हर Google Cloud प्रोजेक्ट के लिए हर उपयोगकर्ता को हर मिनट 2,400 क्वेरी है.	अपने Google Cloud प्रोजेक्ट के एडमिन SDK API कोटा पेज पर जाकर, हर उपयोगकर्ता के लिए तय की गई सीमाएं बढ़ाएं या एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करके, अनुरोध भेजने की दर को धीमा करें.
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 सेकंड की देरी होती है. ज़रूरत पड़ने पर, आपका एपीआई क्लाइंट ज़्यादा बार कोशिश कर सकता है.

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

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

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