Google की पहले से मौजूद सेवाओं या Google की बेहतर सेवाओं से निजी डेटा ऐक्सेस करने के लिए, Apps Script को उपयोगकर्ता की अनुमति की ज़रूरत होती है.
ऐक्सेस के अधिकार देना
Apps Script, कोड के स्कैन के आधार पर अनुमति के दायरे (जैसे कि अपनी Google Sheets फ़ाइलों या Gmail को ऐक्सेस करना) अपने-आप तय करता है. जिस कोड पर टिप्पणी की गई है वह अब भी अनुमति देने का अनुरोध जनरेट कर सकता है. अगर किसी स्क्रिप्ट को अनुमति की ज़रूरत है, तो उसे चलने के बाद आपको अनुमति देने वाला एक डायलॉग दिखेगा. यह डायलॉग यहां दिखाया गया है.
अगर कोड में किसी बदलाव से नई सेवाएं जुड़ती हैं, तो वे स्क्रिप्ट भी अतिरिक्त अनुमति मांगती हैं जिन्हें आपने पहले अनुमति दी है. अगर स्क्रिप्ट को एक ऐसे वेब ऐप्लिकेशन के तौर पर ऐक्सेस किया जाता है जो स्क्रिप्ट के मालिक की उपयोगकर्ता पहचान के तहत चलता है, तो हो सकता है कि स्क्रिप्ट को अनुमति देने का अनुरोध न किया जाए.
ऐक्सेस के अधिकार वापस लिए जा रहे हैं
अपने डेटा पर किसी स्क्रिप्ट की ऐक्सेस रद्द करने के लिए, इन चरणों का पालन करें:
- अपने Google खाते के लिए, अनुमतियां पेज पर जाएं. (आने वाले समय में इस पेज पर जाने के लिए, Google.com पर जाएं. इसके बाद, स्क्रीन के ऊपरी दाएं कोने में, अपने खाते की फ़ोटो पर क्लिक करें. इसके बाद, मेरा खाता, फिर "साइन-इन और सुरक्षा" सेक्शन में कनेक्ट किए गए ऐप्लिकेशन और साइटें, और फिर ऐप्लिकेशन मैनेज करें पर क्लिक करें.)
- उस स्क्रिप्ट के नाम पर क्लिक करें जिसकी अनुमति को आपको वापस लेना है. इसके बाद, दाईं ओर मौजूद हटाएं पर क्लिक करें और डायलॉग बॉक्स में ठीक है पर क्लिक करें.
अनुमतियां और स्क्रिप्ट के टाइप
उपयोगकर्ता की वह पहचान जिसके साथ स्क्रिप्ट चलती है और इस तरह से वह डेटा जिसे ऐक्सेस किया जा सकता है — यह स्क्रिप्ट को चलाने के हिसाब से अलग-अलग होती है, जैसा कि नीचे टेबल में दिखाया गया है.
| स्क्रिप्ट का टाइप | स्क्रिप्ट इस तरह चलती है... |
|---|---|
| स्टैंडअलोन, ऐड-ऑन या Docs, Sheets, Slides या Forms से जुड़ा | कीबोर्ड पर उपयोगकर्ता |
| स्प्रेडशीट में कस्टम फ़ंक्शन | पहचान छिपाने वाला उपयोगकर्ता; हालांकि, कीबोर्ड पर कोटे के तहत तय की गई सीमाएं उपयोगकर्ताओं के लिए तय की जाती हैं |
| वेब ऐप्लिकेशन या Google Sites गैजेट | कीबोर्ड या स्क्रिप्ट के मालिक की भूमिका वाला उपयोगकर्ता, जो ऐप्लिकेशन को डिप्लॉय करते समय चुने गए विकल्पों के आधार पर काम करता है |
| इंस्टॉल किया जा सकने वाला ट्रिगर | ट्रिगर बनाने वाला उपयोगकर्ता |
Sheets, Docs, Slides, और Forms के लिए मैन्युअल अनुमति के स्कोप
अगर ऐसा ऐड-ऑन या कोई अन्य स्क्रिप्ट बनाई जा रही है जो स्प्रेडशीट सेवा, दस्तावेज़ सेवा, स्लाइड सेवा या फ़ॉर्म सेवा का इस्तेमाल करती है, तो उपयोगकर्ता की स्प्रेडशीट, दस्तावेज़ या फ़ॉर्म के बजाय, सिर्फ़ उन फ़ाइलों का ऐक्सेस मांगने के लिए अनुमति देने वाले डायलॉग बॉक्स से अनुरोध करें जिनमें ऐड-ऑन या स्क्रिप्ट का इस्तेमाल किया गया हो. ऐसा करने के लिए, फ़ाइल लेवल की टिप्पणी में यह JsDoc जानकारी शामिल करें:
/**
* @OnlyCurrentDoc
*/
विरोधी एनोटेशन, @NotOnlyCurrentDoc तब उपलब्ध होता है, जब आपकी स्क्रिप्ट में
@OnlyCurrentDoc का एलान करने वाली लाइब्रेरी शामिल हो, लेकिन मास्टर स्क्रिप्ट को मौजूदा फ़ाइल से ज़्यादा
ऐक्सेस की ज़रूरत हो.
ऐड-ऑन के लिए अनुमति का लाइफ़साइकल
Google Sheets, Docs, Slides, और Forms के लिए ऐड-ऑन आम तौर पर, अनुमति देने वाले ऐसे मॉडल का ही इस्तेमाल करते हैं जो किसी दस्तावेज़ से बंधे होते हैं. हालांकि, कुछ मामलों में उनके onOpen(e) और onEdit(e) फ़ंक्शन, बिना अनुमति वाले मोड में चलते हैं. इसकी वजह से, कुछ और मुश्किलें पैदा होती हैं. ज़्यादा जानकारी के लिए, ऐड-ऑन की अनुमति देने की लाइफ़साइकल से जुड़ी गाइड देखें.
OAuth ऐप्लिकेशन के इस्तेमाल की सीमाएं
Google उपयोगकर्ता का डेटा ऐक्सेस करने के लिए OAuth का इस्तेमाल करने वाले ऐप्लिकेशन पर अनुमति की सीमा लागू होती है. इन ऐप्लिकेशन में Apps Script प्रोजेक्ट भी शामिल हैं. ज़्यादा जानकारी के लिए, OAuth ऐप्लिकेशन के इस्तेमाल की सीमाएं देखें.