Directory API, RESTful Admin SDK API का हिस्सा है. इसका इस्तेमाल करके, Google Workspace खाते के मालिकाना हक वाले, एडमिन के कंट्रोल वाले संसाधनों को प्रोग्राम के ज़रिए बनाया और मैनेज किया जा सकता है. इसके इस्तेमाल के कुछ उदाहरण यहां दिए गए हैं:
- उपयोगकर्ताओं को बनाना और मैनेज करना, साथ ही एडमिन जोड़ना.
- ग्रुप बनाना और मैनेज करना, साथ ही ग्रुप की सदस्यताएं मैनेज करना.
- अपने डोमेन से कनेक्ट किए गए डिवाइसों की निगरानी करना और खोए हुए डिवाइसों पर कार्रवाई करना.
- अपने संगठन के चार्ट और संगठन के स्ट्रक्चर को मैनेज करना.
- उन ऐप्लिकेशन की ऑडिटिंग करना जिन्हें आपके उपयोगकर्ताओं ने ऐक्सेस करने की अनुमति दी है. साथ ही, अनधिकृत ऐप्लिकेशन के लिए दी गई अनुमति वापस लेना.
Directory API में इस्तेमाल किए जाने वाले सामान्य शब्दों की सूची यहां दी गई है:
- ग्राहक
- यह वह इकाई है जिसके पास Google Workspace खाते का मालिकाना हक होता है. इसे ग्राहक संसाधन के तौर पर दिखाया जाता है.
- डोमेन
- अगर लागू हो, तो Google Workspace खाते से जुड़ा डीएनएस डोमेन. इसे डोमेन संसाधन के तौर पर दिखाया जाता है. सभी खातों से कोई डोमेन जुड़ा नहीं होता.
- संगठन की इकाई (ओयू)
- यह Google Workspace खाते के संगठन ट्री की एक सब-यूनिट होती है. इसका इस्तेमाल, नीतियां लागू करने और अनुमतियां देने के लिए, उपयोगकर्ताओं को ग्रुप में शामिल करने और उन्हें क्रम से लगाने के लिए किया जाता है. ओयू को OrgUnit संसाधन के तौर पर दिखाया जाता है.
- खास अधिकार
- Google Workspace के किसी संसाधन पर कोई कार्रवाई करने की उपयोगकर्ता की क्षमता. यह मुख्य रूप से एडमिन पर लागू होता है. खास अधिकार को Privilege संसाधन के तौर पर दिखाया जाता है.
- रोल
- खास अधिकारों का एक तय कलेक्शन, जिसे किसी उपयोगकर्ता या उपयोगकर्ताओं के सेट को असाइन किया जा सकता है. इसे Role संसाधन के तौर पर दिखाया जाता है.
- रोल असाइन किया गया
- यह एक रिकॉर्ड होता है, जिससे यह पता चलता है कि किस उपयोगकर्ता को कौनसे रोल दिए गए हैं और किस दायरे में. रोल असाइनमेंट को RoleAssignment संसाधन के तौर पर दिखाया जाता है.
- स्कीमा
- यह एक JSON ऑब्जेक्ट होता है, जो आपके संगठन के लिए, उपयोगकर्ता के कस्टम एट्रिब्यूट तय करता है, जिसे Schema संसाधन के तौर पर दिखाया जाता है.
- उपयोगकर्ता
- यह एक ऐसा व्यक्तिगत उपयोगकर्ता खाता होता है जिसके पास Google Workspace के ऐप्लिकेशन और संसाधनों का ऐक्सेस होता है. इसे User संसाधन के तौर पर दिखाया जाता है.
अगले चरण
Google Workspace के एपीआई की मदद से डेवलपमेंट करने के बारे में जानने के लिए, जिसमें पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज करना भी शामिल है, Workspace डेवलपर के तौर पर शुरुआत करना लेख पढ़ें.
Directory API वाले ऐप्लिकेशन को कॉन्फ़िगर और चलाने का तरीका जानने के लिए, JavaScript का क्विकस्टार्ट आज़माएं.