दायरा

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

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

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

Apps Script, अपनी अलग-अलग सेवाओं के लिए जिन स्कोप का इस्तेमाल करती है वे संबंधित एपीआई के इस्तेमाल किए गए स्कोप से मेल खाते हैं. उदाहरण के लिए, Apps Script की Calendar service, 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 क्लाइंट की पुष्टि करानी पड़ सकती है. ज़्यादा जानकारी के लिए, ये गाइड देखें:

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

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

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

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

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

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

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

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

दायरा
मौजूदा Docs फ़ाइल का ऐक्सेस https://www.googleapis.com/auth/documents.currentonly

अगर ऐड-ऑन, Google Apps Script Docs API को ऐक्सेस करता है, तो यह ज़रूरी है. इससे खुले हुए दस्तावेज़ के कॉन्टेंट का कुछ समय के लिए ऐक्सेस मिलता है.

मौजूदा Sheets फ़ाइल का ऐक्सेस https://www.googleapis.com/auth/spreadsheets.currentonly

अगर ऐड-ऑन, Apps Script Sheets API को ऐक्सेस करता है, तो यह ज़रूरी है. इस कुकी से, खुली हुई स्प्रेडशीट के कॉन्टेंट का कुछ समय के लिए ऐक्सेस मिलता है.

मौजूदा Slides फ़ाइल का ऐक्सेस 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 Google Drive Service का इस्तेमाल करके बनाई या खोली जाती हैं. इससे, Drive सेवा का इस्तेमाल करके, मिलती-जुलती कार्रवाइयाँ नहीं की जा सकतीं. फ़ाइल का ऐक्सेस देने की अनुमति, हर फ़ाइल के हिसाब से दी जाती है. जब उपयोगकर्ता ऐप्लिकेशन से अनुमति हटाता है, तब यह अनुमति रद्द कर दी जाती है.

Gmail

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

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

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

दायरा
नए ड्राफ़्ट तैयार करें https://www.googleapis.com/auth/gmail.addons.current.action.compose

अगर ऐड-ऑन, ईमेल लिखने की सुविधा को ट्रिगर करने वाली कार्रवाइयों का इस्तेमाल करता है, तो यह ज़रूरी है. इस कुकी की मदद से, ऐड-ऑन कुछ समय के लिए नए ड्राफ़्ट मैसेज और जवाब बना सकता है. ज़्यादा जानकारी के लिए, ड्राफ़्ट मैसेज लिखना देखें. इस स्कोप का इस्तेमाल अक्सर [compose actions] (/workspace/add-ons/gmail/extending-compose-ui) के साथ किया जाता है. इसके लिए, ऐक्सेस टोकन की ज़रूरत होती है.

खुले हुए मैसेज का मेटाडेटा पढ़ने की अनुमति 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 के स्कोप

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

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

यहां दी गई टेबल में, 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 Workspace ऐड-ऑन के लिए अक्सर इस्तेमाल किए जाने वाले स्कोप की सूची दी गई है. ये ऐड-ऑन, Google Drive की सुविधाओं को बढ़ाते हैं.

दायरा
चुने गए आइटम का मेटाडेटा पढ़ना 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 को कॉल करें.

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 ऐप्लिकेशन में संसाधन का लिंक डालने की अनुमति मिलती है. ज़्यादा जानने के लिए, @ मेन्यू से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.