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