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

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

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

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

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

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

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

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

1. एपीआई से अनुरोध करना
2. फिर से कोशिश करने लायक गड़बड़ी कोड वाला गड़बड़ी का रिस्पॉन्स मिलना
3. एक सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
4. अनुरोध फिर से करें
5. फिर से कोशिश करने लायक गड़बड़ी कोड वाला गड़बड़ी का रिस्पॉन्स मिलना
6. दो सेकंड + random_number_milliseconds सेकंड इंतज़ार करें
7. अनुरोध फिर से करें
8. फिर से कोशिश करने लायक गड़बड़ी कोड वाला गड़बड़ी का रिस्पॉन्स मिलना
9. 4 सेकंड + random_number_milliseconds सेकंड तक इंतज़ार करें
10. अनुरोध फिर से करें
11. फिर से कोशिश करने लायक गड़बड़ी कोड वाला गड़बड़ी का रिस्पॉन्स मिलना
12. आठ सेकंड + 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 अनुरोध. प्रति सेकंड, सूची बनाने के 10 अनुरोध.
उपयोगकर्ताओं का नाम बदलना	सभी सेवाओं पर दिखने में 10 मिनट लग सकते हैं. किसी उपयोगकर्ता का नाम बदलने से पहले, हमारा सुझाव है कि आप उसे सभी ब्राउज़र सेशन और सेवाओं से लॉग आउट कर दें. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं की जानकारी अपडेट करना लेख पढ़ें.
संगठन की इकाइयां बनाना/अपडेट करना	डायरेक्ट्री एपीआई का इस्तेमाल करके, हर ग्राहक के लिए हर सेकंड में एक से ज़्यादा संगठन की इकाइयां नहीं बनाई/अपडेट की जा सकतीं. ग्राहक की संगठनात्मक इकाई के क्रम में ज़्यादा से ज़्यादा 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 एंट्री दिखती हैं. ग्रुप और ग्रुप के सदस्य – हर पेज पर डिफ़ॉल्ट रूप से ज़्यादा से ज़्यादा 200 एंट्री. उपयोगकर्ता – डिफ़ॉल्ट रूप से 100 एंट्री और हर पेज पर ज़्यादा से ज़्यादा 500 एंट्री. उपयोगकर्ता के एलियास और संगठन की इकाई के संसाधनों में, जवाब के पेजों की सुविधा का इस्तेमाल नहीं किया जाता. उपयोगकर्ता के सभी प्राइमरी ईमेल पते, वर्णमाला के क्रम में दिखाए जाते हैं. साथ ही, जवाब का क्रम केस-इनसेंसिटिव होता है.
एक से ज़्यादा डोमेन, एक खाते में ज़्यादा से ज़्यादा डोमेन इस्तेमाल करने की अनुमति	600 (1 प्राइमरी डोमेन + 599 अन्य डोमेन)
संगठन की इकाई, एक बार में ज़्यादा से ज़्यादा उपयोगकर्ताओं को दूसरी इकाई में ले जाने की संख्या	एक बार में 20 उपयोगकर्ताओं को ट्रांसफ़र किया जा सकता है. साथ ही, उपयोगकर्ता के मुख्य ईमेल पते खाते में पहले से मौजूद होने चाहिए.
उपयोगकर्ता के अन्य नाम	हर उपयोगकर्ता खाते के लिए, ज़्यादा से ज़्यादा 30 ईमेल पते बनाए जा सकते हैं.
उपयोगकर्ता के दूसरे ईमेल पते, मिटाए गए दूसरे ईमेल पते का इस्तेमाल करना	मिटाए गए उपयोगकर्ता के उपनाम को तुरंत फिर से इस्तेमाल किया जा सकता है.

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