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