Apps Script को Google की पहले से मौजूद सेवाओं या Google की बेहतर सेवाओं से मिले निजी डेटा को ऐक्सेस करने के लिए, उपयोगकर्ता की अनुमति की ज़रूरत होती है.
पहुंच के अधिकार देना
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 ऐप्लिकेशन के लिए उपयोगकर्ता सीमाएं देखें.