बंदूक पर लगने वाली दूरबीन

उपयोगकर्ताओं को उन ऐड-ऑन और अन्य ऐप्लिकेशन को अनुमति देनी होगी जो उनके डेटा को ऐक्सेस करते हैं या उनकी ओर से कार्रवाई करते हैं. जब कोई उपयोगकर्ता पहली बार किसी ऐड-ऑन को चलाता है, तो ऐड-ऑन का यूज़र इंटरफ़ेस (यूआई) अनुमति देने के लिए एक प्रॉम्प्ट दिखाता है. इससे अनुमति देने की प्रोसेस शुरू होती है.

इस प्रोसेस के दौरान, प्रॉम्प्ट में उपयोगकर्ता को बताया जाता है कि ऐप्लिकेशन को किस काम के लिए अनुमति चाहिए. उदाहरण के लिए, किसी ऐड-ऑन को उपयोगकर्ता के ईमेल मैसेज को पढ़ने या उसके कैलेंडर में इवेंट बनाने की अनुमति चाहिए. ऐड-ऑन का स्क्रिप्ट प्रोजेक्ट, इन अलग-अलग अनुमतियों को OAuth स्कोप के तौर पर तय करता है.

यूआरएल स्ट्रिंग का इस्तेमाल करके, अपने मेनिफ़ेस्ट में स्कोप का एलान करें. अनुमति देने की प्रोसेस के दौरान, Apps Script उपयोगकर्ता को स्कोप के बारे में ऐसी जानकारी दिखाता है जिसे आसानी से समझा जा सकता है. उदाहरण के लिए, आपका Google Workspace ऐड-ऑन "मौजूदा मैसेज पढ़ें" स्कोप का इस्तेमाल कर सकता है. यह स्कोप आपके मेनिफ़ेस्ट में https://www.googleapis.com/auth/gmail.addons.current.message.readonly के तौर पर लिखा गया है. अनुमति देने की प्रोसेस के दौरान, इस स्कोप वाला ऐड-ऑन उपयोगकर्ता से यह अनुमति मांगता है कि ऐड-ऑन को: जब ऐड-ऑन चल रहा हो, तब आपके ईमेल संदेश देखने की अनुमति दें.

ध्यान दें: Apps Script, अपनी अलग-अलग सेवाओं के लिए जिन स्कोप का इस्तेमाल करता है वे संबंधित एपीआई के इस्तेमाल किए गए स्कोप से मिलते-जुलते हैं. उदाहरण के लिए, Apps Script की Calendar सेवा, Calendar API के कई स्कोप का इस्तेमाल करती है. Apps Script के रेफ़रंस दस्तावेज़ में जाकर, उन स्कोप के बारे में जानकारी देखी जा सकती है जिनकी ज़रूरत Apps Script की किसी खास सेवा के तरीकों के लिए होती है.

स्कोप देखना

यहां दिए गए तरीके से, यह देखा जा सकता है कि आपके स्क्रिप्ट प्रोजेक्ट को फ़िलहाल किन स्कोप की ज़रूरत है:

1. स्क्रिप्ट प्रोजेक्ट खोलें.
2. बाईं ओर, खास जानकारी पर क्लिक करें.
3. "प्रोजेक्ट के OAuth स्कोप" में जाकर, स्कोप देखें.

स्क्रिप्ट प्रोजेक्ट के मौजूदा स्कोप को प्रोजेक्ट मेनिफ़ेस्ट में भी देखा जा सकता है. इसके लिए, oauthScopes फ़ील्ड में जाएं. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपने उन स्कोप को साफ़ तौर पर सेट किया हो.

साफ़ तौर पर स्कोप सेट करना

Apps Script, स्क्रिप्ट के कोड को स्कैन करके यह अपने-आप तय करती है कि स्क्रिप्ट को किन स्कोप की ज़रूरत है. ऐसा उन फ़ंक्शन कॉल के लिए किया जाता है जिनके लिए स्कोप की ज़रूरत होती है. ज़्यादातर स्क्रिप्ट के लिए यह तरीका सही है और इससे आपका समय बचता है. हालांकि, पब्लिश किए गए ऐड-ऑन के लिए, आपको स्कोप पर ज़्यादा कंट्रोल रखना चाहिए.

उदाहरण के लिए, Apps Script किसी ऐड-ऑन स्क्रिप्ट प्रोजेक्ट को डिफ़ॉल्ट रूप से https://mail.google.com बहुत ज़्यादा अनुमतियां दे सकता है. जब कोई उपयोगकर्ता इस स्कोप के साथ किसी स्क्रिप्ट प्रोजेक्ट को अनुमति देता है, तो प्रोजेक्ट को उपयोगकर्ता के Gmail खाते का पूरा ऐक्सेस मिल जाता है. पब्लिश किए गए ऐड-ऑन के लिए, आपको इस स्कोप को ऐसे स्कोप से बदलना होगा जो ऐड-ऑन की ज़रूरतों को पूरा करता हो और उससे ज़्यादा न हो. ऐसा करना ज़रूरी है.

चेतावनी: हमेशा सबसे कम अनुमतियों वाले स्कोप का इस्तेमाल करें. उपयोगकर्ता की जानकारी को सुरक्षित रखने के लिए, ऐड-ऑन और अन्य पब्लिश किए गए ऐप्लिकेशन को, स्कोप की उतनी ही अनुमतियां मांगनी चाहिए जितनी उनके लिए ज़रूरी हैं. उन्हें कभी नहीं, इससे ज़्यादा अनुमतियां मांगनी चाहिए. पब्लिश करने के दौरान, ऐड-ऑन की समीक्षा की जाती है. इसमें यह देखा जाता है कि ऐड-ऑन को किन स्कोप की ज़रूरत है.

अगर ऐड-ऑन बहुत ज़्यादा स्कोप का इस्तेमाल करता है, तो उसे समीक्षा में पास नहीं किया जा सकता.

अपनी स्क्रिप्ट के प्रोजेक्ट के लिए, इस्तेमाल किए जाने वाले स्कोप को साफ़ तौर पर सेट किया जा सकता है. इसके लिए, आपको उसकी मेनिफ़ेस्ट फ़ाइल में बदलाव करना होगा. मेनिफ़ेस्ट फ़ील्ड oauthScopes, ऐड-ऑन के इस्तेमाल किए गए सभी स्कोप का कलेक्शन होता है. अपने प्रोजेक्ट के स्कोप सेट करने के लिए, यह तरीका अपनाएं:

1. देखें कि आपका ऐड-ऑन फ़िलहाल किन स्कोप का इस्तेमाल कर रहा है. यह तय करें कि क्या बदलाव करने हैं. जैसे, कम स्कोप का इस्तेमाल करना.
2. अपने ऐड-ऑन की मेनिफ़ेस्ट फ़ाइल खोलें.
3. oauthScopes लेबल वाला टॉप-लेवल फ़ील्ड ढूंढें. अगर यह मौजूद नहीं है, तो इसे जोड़ा जा सकता है.

4. oauthScopes फ़ील्ड, स्ट्रिंग का एक अरे तय करता है. आपके प्रोजेक्ट में इस्तेमाल होने वाले स्कोप सेट करने के लिए, इस ऐरे के कॉन्टेंट को उन स्कोप से बदलें जिनका इस्तेमाल आपको करना है. उदाहरण के लिए, Gmail के लिए उपलब्ध Google Workspace ऐड-ऑन के लिए, आपके पास ये हो सकते हैं:

   {
     ...
     "oauthScopes": [
       "https://www.googleapis.com/auth/gmail.addons.current.message.metadata",
       "https://www.googleapis.com/auth/userinfo.email"
     ],
     ...
   }
   

5. मेनिफ़ेस्ट फ़ाइल में किए गए बदलावों को सेव करें.

OAuth की पुष्टि

कुछ संवेदनशील OAuth स्कोप का इस्तेमाल करने के लिए, आपको अपना ऐड-ऑन पब्लिश करने से पहले, OAuth क्लाइंट की पुष्टि करानी पड़ सकती है. ज़्यादा जानकारी के लिए, ये गाइड देखें:

• Apps Script के लिए OAuth क्लाइंट की पुष्टि करना
• ऐसे ऐप्लिकेशन जिनकी पुष्टि नहीं की गई है
• OAuth की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल
• Google API सेवाएं: उपयोगकर्ता के डेटा की नीति

पाबंदी वाले स्कोप

कुछ स्कोप पाबंदी वाले होते हैं. इन पर अतिरिक्त नियम लागू होते हैं, ताकि उपयोगकर्ता के डेटा को सुरक्षित रखा जा सके. अगर आपको ऐसा Gmail या Editor ऐड-ऑन पब्लिश करना है जो एक या उससे ज़्यादा प्रतिबंधित स्कोप का इस्तेमाल करता है, तो ऐड-ऑन को पब्लिश करने से पहले, बताई गई सभी पाबंदियों का पालन करना होगा.

पब्लिश करने से पहले, पाबंदी वाले स्कोप की पूरी सूची देखें. अगर आपका ऐड-ऑन इनमें से किसी भी स्कोप का इस्तेमाल करता है, तो आपको पब्लिश करने से पहले, एपीआई के कुछ स्कोप के लिए अतिरिक्त ज़रूरी शर्तों का पालन करना होगा.

ध्यान दें: अगर हो सके, तो अपने ऐड-ऑन में पाबंदी वाले स्कोप का इस्तेमाल न करें. ऐसा करने से, ऐड-ऑन की समीक्षा पास करना आसान हो जाता है, ताकि उसे सार्वजनिक तौर पर पब्लिश किया जा सके. गैर-सार्वजनिक ऐड-ऑन के लिए, पाबंदी वाले स्कोप का इस्तेमाल बिना किसी शुल्क के किया जा सकता है.

Visual Studio Code के लिए Google Workspace Developer Tools एक्सटेंशन, सभी स्कोप के लिए डाइग्नोस्टिक जानकारी देता है. इसमें स्कोप का ब्यौरा और यह जानकारी शामिल होती है कि यह संवेदनशील है या इस पर पाबंदी लगी है.

Google Workspace ऐड-ऑन के लिए स्कोप चुनना

यहां दिए गए सेक्शन में, Google Workspace ऐड-ऑन के लिए आम तौर पर इस्तेमाल होने वाले स्कोप दिए गए हैं.

एडिटर के स्कोप

यहां Google Workspace ऐड-ऑन के लिए, अक्सर इस्तेमाल किए जाने वाले स्कोप दिए गए हैं. ये ऐड-ऑन, Docs, Sheets, और Slides की सुविधाओं को बढ़ाते हैं.

ध्यान दें: currentonly स्कोप, सिर्फ़ Apps Script Services में उपलब्ध है. इसमें Apps Script की ऐडवांस सेवाएं या Google Workspace API को सीधे तौर पर कॉल करना शामिल नहीं है.

दायरा
मौजूदा Docs फ़ाइल का ऐक्सेस	https://www.googleapis.com/auth/documents.currentonly अगर ऐड-ऑन, Apps Script Docs API को ऐक्सेस करता है, तो यह ज़रूरी है. इससे खुले हुए दस्तावेज़ के कॉन्टेंट का कुछ समय के लिए ऐक्सेस मिलता है.
मौजूदा Sheets फ़ाइल का ऐक्सेस	https://www.googleapis.com/auth/spreadsheets.currentonly अगर ऐड-ऑन, Apps Script Sheets API को ऐक्सेस करता है, तो यह ज़रूरी है. इस कुकी से, ओपन स्प्रेडशीट के कॉन्टेंट का कुछ समय के लिए ऐक्सेस मिलता है.
मौजूदा स्लाइड की फ़ाइल का ऐक्सेस	https://www.googleapis.com/auth/presentations.currentonly अगर ऐड-ऑन, Apps Script Slides API को ऐक्सेस करता है, तो यह ज़रूरी है. इससे ओपन प्रज़ेंटेशन के कॉन्टेंट का कुछ समय के लिए ऐक्सेस मिलता है.
हर फ़ाइल के लिए ऐक्सेस	https://www.googleapis.com/auth/drive.file ऐड-ऑन को onFileScopeGrantedTrigger का इस्तेमाल करने के लिए ज़रूरी है और अगर ऐड-ऑन, Docs, Sheets, Slides या Drive API को ऐक्सेस करता है. इस स्कोप से, ऐप्लिकेशन को उन फ़ाइलों का ऐक्सेस मिलता है जिन्हें ऐप्लिकेशन ने बनाया है या खोला है. इसके लिए, Apps Script की Advanced Drive Service का इस्तेमाल किया जाता है. हालांकि, इससे Drive की बेसिक सेवा का इस्तेमाल करके, मिलती-जुलती कार्रवाइयां करने की अनुमति नहीं मिलती. फ़ाइल का ऐक्सेस, हर फ़ाइल के हिसाब से दिया जाता है. जब उपयोगकर्ता ऐप्लिकेशन से फ़ाइल का ऐक्सेस हटाता है, तब यह ऐक्सेस रद्द कर दिया जाता है.

Gmail

कुछ स्कोप खास तौर पर Google Workspace ऐड-ऑन के लिए बनाए गए हैं. इनसे, Gmail इस्तेमाल करने वाले लोगों के डेटा को सुरक्षित रखने में मदद मिलती है. आपको अपने ऐड-ऑन मेनिफ़ेस्ट में, इन स्कोप को साफ़ तौर पर जोड़ना होगा. साथ ही, आपको उन स्कोप को भी जोड़ना होगा जिनकी ज़रूरत आपके ऐड-ऑन कोड को है.

यहां Google Workspace ऐड-ऑन के लिए, अक्सर इस्तेमाल किए जाने वाले स्कोप दिए गए हैं. ये ऐड-ऑन, Gmail की सुविधाओं को बढ़ाते हैं. अगर आपका ऐड-ऑन, Gmail की सुविधाओं को बढ़ाता है, तो आपको ज़रूरी के तौर पर लेबल किए गए स्कोप को अपने Google Workspace ऐड-ऑन के मेनिफ़ेस्ट में जोड़ना होगा.

अपने ऐड-ऑन में मौजूद https://mail.google.com स्कोप को भी बदलें. इसके लिए, स्कोप का ऐसा सेट इस्तेमाल करें जो आपके ऐड-ऑन के लिए ज़रूरी इंटरैक्शन की अनुमति देता हो.

दायरा
नए ड्राफ़्ट तैयार करें	https://www.googleapis.com/auth/gmail.addons.current.action.compose अगर ऐड-ऑन, ईमेल लिखने की सुविधा को ट्रिगर करने वाली कार्रवाइयों का इस्तेमाल करता है, तो यह ज़रूरी है. इस अनुमति से ऐड-ऑन, कुछ समय के लिए नए ड्राफ़्ट मैसेज और जवाब बना सकता है. ज़्यादा जानकारी के लिए, ड्राफ़्ट मैसेज लिखना लेख पढ़ें. इस स्कोप का इस्तेमाल अक्सर मैसेज लिखने की कार्रवाइयों के साथ भी किया जाता है. इसके लिए, ऐक्सेस टोकन की ज़रूरत होती है.
खुले हुए मैसेज का मेटाडेटा पढ़ने की अनुमति	https://www.googleapis.com/auth/gmail.addons.current.message.metadata इससे खुले हुए ईमेल के मेटाडेटा (जैसे कि विषय या ईमेल पाने वाले) को कुछ समय के लिए ऐक्सेस करने की अनुमति मिलती है. इससे मैसेज के कॉन्टेंट को पढ़ने की अनुमति नहीं मिलती और इसके लिए ऐक्सेस टोकन की ज़रूरत होती है. अगर ऐड-ऑन, कंपोज़ ऐक्शन ट्रिगर में मेटाडेटा का इस्तेमाल करता है, तो यह ज़रूरी है. अगर ईमेल लिखने से जुड़ी कार्रवाइयों के लिए, कंपोज़ ट्रिगर को मेटाडेटा ऐक्सेस करने की ज़रूरत है, तो इस स्कोप की ज़रूरत होती है. इस स्कोप की मदद से, कंपोज़ ट्रिगर को जवाब वाले ईमेल के ड्राफ़्ट की ईमेल पाने वालों की सूचियों (ये लोग:, कॉपी:, और गुप्त कॉपी:) को ऐक्सेस करने की अनुमति मिलती है.
खुले हुए मैसेज का कॉन्टेंट पढ़ना	https://www.googleapis.com/auth/gmail.addons.current.message.action यह कुकी, उपयोगकर्ता के इंटरैक्शन पर खुले हुए मैसेज के कॉन्टेंट को ऐक्सेस करने की अनुमति देती है. जैसे, जब ऐड-ऑन मेन्यू आइटम चुना जाता है. इसके लिए, ऐक्सेस टोकन की ज़रूरत होती है.
खुले थ्रेड का कॉन्टेंट पढ़ना	https://www.googleapis.com/auth/gmail.addons.current.message.readonly इससे ओपन मैसेज के मेटाडेटा और कॉन्टेंट का कुछ समय के लिए ऐक्सेस मिलता है. इससे खुले हुए थ्रेड में मौजूद अन्य मैसेज के कॉन्टेंट को भी ऐक्सेस करने की अनुमति मिलती है. इसके लिए, ऐक्सेस टोकन की ज़रूरत होती है.
किसी भी मैसेज का कॉन्टेंट और मेटाडेटा पढ़ सकता है	https://www.googleapis.com/auth/gmail.readonly किसी भी ईमेल का मेटाडेटा और कॉन्टेंट पढ़ना. इसमें खोला गया मैसेज भी शामिल है. अगर आपको अन्य मैसेज के बारे में जानकारी पढ़नी है, तो इस कुकी की ज़रूरत होती है. जैसे, खोज क्वेरी करते समय या पूरा ईमेल थ्रेड पढ़ते समय. चेतावनी: यह बहुत बड़ा और सीमित दायरा वाला है. इसका इस्तेमाल सिर्फ़ तब करें, जब बहुत ज़रूरी हो.

Google Calendar के स्कोप

यहां Google Calendar की सुविधाओं को बढ़ाने वाले Google Workspace ऐड-ऑन के लिए, अक्सर इस्तेमाल किए जाने वाले स्कोप दिए गए हैं.

दायरा
इवेंट का मेटाडेटा ऐक्सेस करना	https://www.googleapis.com/auth/calendar.addons.execute अगर ऐड-ऑन, Calendar इवेंट के मेटाडेटा को ऐक्सेस करता है, तो इसकी ज़रूरत होती है. इस कुकी से ऐड-ऑन को इवेंट का मेटाडेटा ऐक्सेस करने की अनुमति मिलती है.
उपयोगकर्ता के जनरेट किए गए इवेंट का डेटा पढ़ना	https://www.googleapis.com/auth/calendar.addons.current.event.read अगर ऐड-ऑन को उपयोगकर्ता के जनरेट किए गए इवेंट डेटा को पढ़ने की ज़रूरत है, तो यह स्कोप ज़रूरी है. इस कुकी से ऐड-ऑन को, उपयोगकर्ता के जनरेट किए गए इवेंट डेटा को ऐक्सेस करने की अनुमति मिलती है. यह डेटा सिर्फ़ तब उपलब्ध होता है, जब addOns.calendar.eventAccess मेनिफ़ेस्ट फ़ील्ड को READ या READ_WRITE पर सेट किया गया हो.
उपयोगकर्ता के जनरेट किए गए इवेंट का डेटा सेव करने की अनुमति दें	https://www.googleapis.com/auth/calendar.addons.current.event.write अगर ऐड-ऑन को उपयोगकर्ता के जनरेट किए गए इवेंट डेटा को लिखना है, तो यह ज़रूरी है. इस अनुमति से ऐड-ऑन को, उपयोगकर्ता के जनरेट किए गए इवेंट डेटा में बदलाव करने की अनुमति मिलती है. यह डेटा सिर्फ़ तब उपलब्ध होता है, जब addOns.calendar.eventAccess मेनिफ़ेस्ट फ़ील्ड को WRITE या READ_WRITE पर सेट किया गया हो.

Google Chat के स्कोप

Chat API को कॉल करने के लिए, आपको Google Chat के उपयोगकर्ता या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी होगी. हर तरह की पुष्टि के लिए अलग-अलग स्कोप की ज़रूरत होती है. साथ ही, Chat API के सभी तरीके, ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ काम नहीं करते.

Chat के स्कोप और पुष्टि करने के तरीकों के बारे में ज़्यादा जानने के लिए, Chat API के Authentication and authorization overview पर जाएं

इस टेबल में, Chat API के सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके और स्कोप दिखाए गए हैं. ये तरीके और स्कोप, पुष्टि करने के उपलब्ध टाइप पर आधारित हैं:

तरीका	उपयोगकर्ता की पुष्टि करने की सुविधा उपलब्ध है	ऐप्लिकेशन की पुष्टि करने की सुविधा काम करती है	अनुमति के लिए उपलब्ध स्कोप
मैसेज भेजें			उपयोगकर्ता की पुष्टि करने की सुविधा के साथ: chat.messages.create chat.messages chat.import ऐप्लिकेशन की पुष्टि की सुविधा के साथ: chat.bot
कोई स्पेस बनाएं			उपयोगकर्ता की पुष्टि करने की सुविधा के साथ: chat.spaces.create chat.spaces chat.import ऐप्लिकेशन की पुष्टि और एडमिन की मंज़ूरी (डेवलपर के लिए उपलब्ध पूर्वावलोकन में उपलब्ध) की मदद से: chat.app.spaces.create chat.app.spaces
स्पेस बनाना और उसमें सदस्यों को जोड़ना		—	उपयोगकर्ता की पुष्टि करने की सुविधा के साथ: chat.spaces.create chat.spaces
किसी स्पेस में उपयोगकर्ता को जोड़ना			उपयोगकर्ता की पुष्टि करने की सुविधा के साथ: chat.memberships chat.memberships.app chat.import ऐप्लिकेशन की पुष्टि और एडमिन की मंज़ूरी (डेवलपर के लिए उपलब्ध पूर्वावलोकन में उपलब्ध) की मदद से: chat.app.memberships
किसी Chat स्पेस में की गई गतिविधियां या इवेंट की सूची		—	उपयोगकर्ता की पुष्टि के लिए, आपको अनुरोध में शामिल हर इवेंट टाइप के लिए स्कोप का इस्तेमाल करना होगा: मैसेज से जुड़े इवेंट के लिए: chat.messages chat.messages.readonly प्रतिक्रियाओं से जुड़े इवेंट के लिए: chat.messages.reactions chat.messages.reactions.readonly chat.messages chat.messages.readonly पैसे चुकाकर ली जाने वाली सदस्यताओं से जुड़े इवेंट के लिए: chat.memberships chat.memberships.readonly स्पेस के बारे में इवेंट के लिए: chat.spaces chat.spaces.readonly

Google Drive के स्कोप

यहां Google Drive को बढ़ाने वाले Google Workspace ऐड-ऑन के लिए, अक्सर इस्तेमाल होने वाले स्कोप दिए गए हैं.

दायरा
चुने गए आइटम का मेटाडेटा पढ़ना	https://www.googleapis.com/auth/drive.addons.metadata.readonly अगर ऐड-ऑन, कॉन्टेक्स्ट के हिसाब से यूज़र इंटरफ़ेस लागू करता है, तो यह ज़रूरी है. यह यूज़र इंटरफ़ेस तब ट्रिगर होता है, जब उपयोगकर्ता Drive में आइटम चुनता है. इस अनुमति से ऐड-ऑन को, Google Drive में उपयोगकर्ता के चुने गए आइटम के बारे में सीमित मेटाडेटा पढ़ने की अनुमति मिलती है. मेटाडेटा में सिर्फ़ आइटम का आईडी, टाइटल, माइम टाइप, आइकॉन का यूआरएल, और यह जानकारी शामिल होती है कि ऐड-ऑन को आइटम ऐक्सेस करने की अनुमति है या नहीं.
हर फ़ाइल के लिए ऐक्सेस	https://www.googleapis.com/auth/drive.file अगर ऐड-ऑन को Drive की अलग-अलग फ़ाइलों को ऐक्सेस करना है, तो हम यह तरीका अपनाने का सुझाव देते हैं. इस स्कोप से, ऐप्लिकेशन को उन फ़ाइलों का ऐक्सेस मिलता है जिन्हें ऐप्लिकेशन ने बनाया है या खोला है. इसके लिए, Apps Script की Advanced Drive Service का इस्तेमाल किया जाता है. हालांकि, इससे Drive की बेसिक सेवा का इस्तेमाल करके, मिलती-जुलती कार्रवाइयां करने की अनुमति नहीं मिलती. फ़ाइल का ऐक्सेस, हर फ़ाइल के हिसाब से दिया जाता है. जब उपयोगकर्ता ऐप्लिकेशन से ऐक्सेस हटाता है, तब यह ऐक्सेस रद्द कर दिया जाता है. चुनिंदा फ़ाइलों का ऐक्सेस पाने का अनुरोध करने का उदाहरण देखें.

ऐक्सेस टोकन

उपयोगकर्ता के डेटा को सुरक्षित रखने के लिए, Google Workspace ऐड-ऑन में इस्तेमाल किए गए Gmail स्कोप, उपयोगकर्ता के डेटा का सिर्फ़ कुछ समय के लिए ऐक्सेस देते हैं. कुछ समय के लिए ऐक्सेस चालू करने के लिए, आपको GmailApp.setCurrentMessageAccessToken(accessToken) फ़ंक्शन को कॉल करना होगा. इसके लिए, ऐक्सेस टोकन को आर्ग्युमेंट के तौर पर इस्तेमाल करें. आपको ऐक्शन इवेंट ऑब्जेक्ट से ऐक्सेस टोकन पाना होगा.

ध्यान दें: Gmail के स्कोप को चालू करने वाला ऐक्सेस टोकन, नहीं है. यह ऐक्सेस टोकन, ScriptApp.getOAuthToken() से मिले ऐक्सेस टोकन के जैसा नहीं है. आपको कार्रवाई वाले इवेंट ऑब्जेक्ट में दिए गए टोकन का इस्तेमाल करना होगा.

यहां किसी मैसेज के मेटाडेटा को ऐक्सेस करने की अनुमति देने के लिए, ऐक्सेस टोकन सेट करने का उदाहरण दिया गया है. इस उदाहरण के लिए, सिर्फ़ https://www.googleapis.com/auth/gmail.addons.current.message.metadata स्कोप ज़रूरी है.

function readSender(e) {
  var accessToken = e.gmail.accessToken;
  var messageId = e.gmail.messageId;

  // The following function enables short-lived access to the current
  // message in Gmail. Access to other Gmail messages or data isn't
  // permitted.
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  return mailMessage.getFrom();
}

Google Workspace के अन्य स्कोप

अगर आपका ऐड-ऑन, Google Workspace या Apps Script की अन्य सेवाओं का इस्तेमाल करता है, तो उसे अतिरिक्त स्कोप की ज़रूरत पड़ सकती है. ज़्यादातर मामलों में, Apps Script को इन स्कोप का पता लगाने और मेनिफ़ेस्ट को अपने-आप अपडेट करने की अनुमति दी जा सकती है. अपने मेनिफ़ेस्ट की स्कोप सूची में बदलाव करते समय, किसी भी स्कोप को तब तक न हटाएं, जब तक आप उसे ज़्यादा सही विकल्प से न बदल रहे हों. जैसे, कोई छोटा स्कोप.

इस टेबल में, उन स्कोप की सूची दी गई है जिनका इस्तेमाल Google Workspace ऐड-ऑन अक्सर करते हैं:

दायरा
उपयोगकर्ता का ईमेल पता पढ़ना	https://www.googleapis.com/auth/userinfo.email इस स्कोप से प्रोजेक्ट को मौजूदा उपयोगकर्ता का ईमेल पता ऐक्सेस करने की अनुमति मिलती है.
बाहरी सेवाओं को कॉल करने की अनुमति दें	https://www.googleapis.com/auth/script.external_request इस अनुमति से, प्रोजेक्ट को UrlFetch अनुरोध करने की अनुमति मिलती है. अगर प्रोजेक्ट में Apps Script के लिए OAuth2 लाइब्रेरी का इस्तेमाल किया जाता है, तो यह भी ज़रूरी है.
उपयोगकर्ता की स्थान-भाषा और टाइमज़ोन की जानकारी पढ़ना	https://www.googleapis.com/auth/script.locale इस कुकी से प्रोजेक्ट को, मौजूदा उपयोगकर्ता की स्थान-भाषा और टाइमज़ोन के बारे में पता चलता है. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और टाइमज़ोन की जानकारी ऐक्सेस करना लेख पढ़ें.
ट्रिगर बनाएं	https://www.googleapis.com/auth/script.scriptapp इस स्कोप से प्रोजेक्ट को ट्रिगर बनाने की अनुमति मिलती है.
तीसरे पक्ष के लिंक की झलक देखना	https://www.googleapis.com/auth/workspace.linkpreview अगर ऐड-ऑन, तीसरे पक्ष की सेवा के लिंक की झलक दिखाता है, तो यह ज़रूरी है. इस कुकी की मदद से, प्रोजेक्ट को Google Workspace ऐप्लिकेशन में मौजूद लिंक को देखने की अनुमति मिलती है. ऐसा तब होता है, जब उपयोगकर्ता उस लिंक के साथ इंटरैक्ट कर रहा हो. ज़्यादा जानने के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.
तीसरे पक्ष के संसाधन बनाना	https://www.googleapis.com/auth/workspace.linkcreate अगर ऐड-ऑन, तीसरे पक्ष की सेवा में संसाधन बनाता है, तो यह ज़रूरी है. इस स्कोप की मदद से, प्रोजेक्ट को यह अनुमति मिलती है कि वह उपयोगकर्ताओं की ओर से संसाधन बनाने के फ़ॉर्म में सबमिट की गई जानकारी को पढ़ सके. साथ ही, Google Workspace ऐप्लिकेशन में संसाधन का लिंक डाल सके. ज़्यादा जानने के लिए, @ मेन्यू से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.