इस दस्तावेज़ में डायरेक्ट्री एपीआई के लिए खास तौर पर अनुमति देने और पुष्टि करने की जानकारी मौजूद है. इस दस्तावेज़ को पढ़ने से पहले, पुष्टि करने और अनुमति देने के बारे में जानें पेज पर, पुष्टि करने और अनुमति देने के बारे में Google Workspace की सामान्य जानकारी ज़रूर पढ़ें.
अनुमति देने के लिए OAuth 2.0 को कॉन्फ़िगर करना
OAuth सहमति वाली स्क्रीन कॉन्फ़िगर करें और स्कोप चुनें, ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन के समीक्षकों को कौनसी जानकारी दिखे. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि उसे बाद में पब्लिश किया जा सके.
डायरेक्ट्री एपीआई के दायरे
अपने ऐप्लिकेशन को दिए गए ऐक्सेस का लेवल तय करने के लिए, आपको अनुमति के दायरे पहचानने और एलान करने होंगे. अनुमति का स्कोप, OAuth 2.0 यूआरआई स्ट्रिंग होता है. इसमें Google Workspace ऐप्लिकेशन का नाम, यह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल शामिल होता है. आपके ऐप्लिकेशन के अनुरोध का स्कोप, Google Workspace के डेटा के साथ काम करने के अनुरोध होते हैं. इनमें उपयोगकर्ताओं के Google खाते का डेटा भी शामिल होता है.
आपका ऐप्लिकेशन इंस्टॉल होने पर, उपयोगकर्ता से उन दायरों की पुष्टि करने के लिए कहा जाता है जिनका इस्तेमाल वह करता है. आम तौर पर, आपको सबसे सटीक जानकारी वाला स्कोप चुनना चाहिए. साथ ही, ऐसे दायरों का अनुरोध करने से बचें जिनकी आपके ऐप्लिकेशन को ज़रूरत नहीं है. उपयोगकर्ता आसानी से सीमित और साफ़ तौर पर बताए गए दायरों का ऐक्सेस दे देते हैं.
डायरेक्ट्री एपीआई इन दायरों के साथ काम करता है:
| डिवाइसों के स्कोप | मतलब |
|---|---|
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 |
सिर्फ़ कैलेंडर के संसाधनों को वापस पाने का दायरा. |