Directory API के स्कोप चुनना

इस दस्तावेज़ में, 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 सिर्फ़ कैलेंडर संसाधनों को वापस पाने का स्कोप.