इस दस्तावेज़ में, Directory API से जुड़ी अनुमति और पुष्टि करने के तरीके के बारे में जानकारी दी गई है. इस दस्तावेज़ को पढ़ने से पहले, पुष्टि करने और अनुमति देने के बारे में जानें पर जाकर, Google Workspace के पुष्टि करने और अनुमति देने के सामान्य तरीके के बारे में ज़रूर पढ़ें.
अनुमति के लिए OAuth 2.0 को कॉन्फ़िगर करना
OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें और दायरे चुनें, ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वाले लोगों को कौनसी जानकारी दिखे. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि आप उसे बाद में पब्लिश कर सकें.
Directory API के स्कोप
अपने ऐप्लिकेशन को दिए गए ऐक्सेस लेवल के बारे में बताने के लिए, आपको अनुमति के दायरे की पहचान करनी होगी और उनके बारे में बताना होगा. अनुमति का दायरा, OAuth 2.0 यूआरआई स्ट्रिंग होती है. इसमें Google Workspace ऐप्लिकेशन का नाम, वह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल शामिल होता है. स्कोप, आपके ऐप्लिकेशन के Google Workspace डेटा के साथ काम करने के अनुरोध होते हैं. इसमें, उपयोगकर्ताओं के Google खाते का डेटा भी शामिल है.
आपका ऐप्लिकेशन इंस्टॉल होने पर, उपयोगकर्ता से ऐप्लिकेशन के इस्तेमाल किए गए स्कोप की पुष्टि करने के लिए कहा जाता है. आम तौर पर, आपको ज़्यादा से ज़्यादा सटीक स्कोप चुनना चाहिए. साथ ही, उन स्कोप का अनुरोध करने से बचना चाहिए जिनकी आपके ऐप्लिकेशन को ज़रूरत नहीं है. उपयोगकर्ता, सीमित और साफ़ तौर पर बताए गए दायरों का ऐक्सेस आसानी से देते हैं.
Directory API इन स्कोप के साथ काम करता है:
| डिवाइसों के लिए स्कोप | मतलब |
|---|---|
https://www.googleapis.com/auth/admin.directory.device.chromeos |
Chrome डिवाइस के सभी ऑपरेशन को ऐक्सेस करने के लिए ग्लोबल स्कोप. |
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly |
सिर्फ़ Chrome डिवाइसों को वापस पाने का स्कोप. |
https://www.googleapis.com/auth/admin.directory.device.mobile |
मोबाइल डिवाइस के सभी ऑपरेशन का ऐक्सेस पाने के लिए ग्लोबल स्कोप. |
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly |
सिर्फ़ मोबाइल डिवाइस को वापस पाने का दायरा |
https://www.googleapis.com/auth/admin.directory.device.mobile.action |
मोबाइल डिवाइस पर कार्रवाई करने वाले टास्क का दायरा. |
| ग्रुप, ग्रुप के उपनाम, और ग्रुप के सदस्यों के लिए स्कोप | मतलब |
https://www.googleapis.com/auth/admin.directory.group.member |
ग्रुप के सभी सदस्यों की भूमिकाओं और जानकारी के ऑपरेशन का ऐक्सेस. |
https://www.googleapis.com/auth/admin.directory.group.member.readonly |
सिर्फ़ ग्रुप के सदस्यों की भूमिकाएं और जानकारी हासिल करने का स्कोप. |
https://www.googleapis.com/auth/admin.directory.group |
ग्रुप के सभी ऑपरेशन का ऐक्सेस देने के लिए ग्लोबल स्कोप. इसमें ग्रुप के उपनाम और सदस्य भी शामिल हैं. |
https://www.googleapis.com/auth/admin.directory.group.readonly |
सिर्फ़ ग्रुप, ग्रुप के उपनाम, और सदस्य की जानकारी पाने का स्कोप. |
| संगठन की इकाइयों के लिए स्कोप | मतलब |
https://www.googleapis.com/auth/admin.directory.orgunit |
संगठन की सभी इकाइयों के ऑपरेशंस का ऐक्सेस पाने के लिए ग्लोबल स्कोप. |
https://www.googleapis.com/auth/admin.directory.orgunit.readonly |
सिर्फ़ संगठन की इकाइयों को वापस पाने का स्कोप. |
| उपयोगकर्ताओं और उपयोगकर्ता के दूसरे ईमेल पतों के लिए स्कोप | मतलब |
https://www.googleapis.com/auth/admin.directory.user |
सभी उपयोगकर्ताओं और उपयोगकर्ता के उपनाम के ऑपरेशन को ऐक्सेस करने के लिए ग्लोबल स्कोप. |
https://www.googleapis.com/auth/admin.directory.user.readonly |
सिर्फ़ उपयोगकर्ताओं या उपयोगकर्ता के उपनामों को वापस पाने का स्कोप. |
https://www.googleapis.com/auth/admin.directory.user.alias |
उपयोगकर्ता के सभी उपनामों के ऑपरेशन का ऐक्सेस. |
https://www.googleapis.com/auth/admin.directory.user.alias.readonly |
सिर्फ़ उपयोगकर्ता के उपनामों को वापस पाने का स्कोप. |
| उपयोगकर्ता की सुरक्षा से जुड़ी सुविधाओं के दायरे | मतलब |
https://www.googleapis.com/auth/admin.directory.user.security |
ऐप्लिकेशन के हिसाब से पासवर्ड, OAuth टोकन, और पुष्टि करने वाले कोड के सभी ऑपरेशन को ऐक्सेस करने का स्कोप. |
| भूमिका मैनेजमेंट के दायरे | मतलब |
https://www.googleapis.com/auth/admin.directory.rolemanagement |
भूमिकाओं को मैनेज करने से जुड़े सभी ऑपरेशन का दायरा. इसमें भूमिकाएं बनाना और भूमिकाएं असाइन करना शामिल है. |
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly |
भूमिकाओं, खास अधिकारों, और भूमिकाओं के असाइनमेंट को पाने और सूची में शामिल करने का दायरा. |
| कस्टम उपयोगकर्ता स्कीमा के लिए दायरे | मतलब |
https://www.googleapis.com/auth/admin.directory.userschema |
कस्टम उपयोगकर्ता स्कीमा के सभी ऑपरेशन को ऐक्सेस करने का स्कोप. |
https://www.googleapis.com/auth/admin.directory.userschema.readonly |
सिर्फ़ कस्टम उपयोगकर्ता स्कीमा को वापस लाने का दायरा. |
| ग्राहकों के लिए दायरे | मतलब |
https://www.googleapis.com/auth/admin.directory.customer |
ग्राहक के सभी ऑपरेशन का ऐक्सेस. |
https://www.googleapis.com/auth/admin.directory.customer.readonly |
सिर्फ़ ग्राहकों को वापस पाने के मकसद से. |
| डोमेन के लिए दायरा | मतलब |
https://www.googleapis.com/auth/admin.directory.domain |
डोमेन के सभी ऑपरेशन का ऐक्सेस. |
https://www.googleapis.com/auth/admin.directory.domain.readonly |
सिर्फ़ डोमेन वापस लाने का दायरा. |
| कैलेंडर संसाधनों के दायरे | मतलब |
https://www.googleapis.com/auth/admin.directory.resource.calendar |
कैलेंडर के सभी संसाधनों के ऑपरेशन का ऐक्सेस. |
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly |
सिर्फ़ कैलेंडर संसाधनों को वापस पाने का स्कोप. |