दायरा

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

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

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

स्कोप देखना

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

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

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

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

चुनिंदा फ़ाइलों का ऐक्सेस पाने का अनुरोध करने का उदाहरण देखें.

ऐक्सेस टोकन

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

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