Google की सेवाओं के लिए अनुमति देना

Google की पहले से मौजूद सेवाओं या Google की बेहतर सेवाओं से निजी डेटा ऐक्सेस करने के लिए, Apps Script को उपयोगकर्ता की अनुमति की ज़रूरत होती है.

ऐक्सेस का अधिकार देना

Apps Script, कोड को स्कैन करके अपने-आप अनुमति के दायरे तय करता है. जैसे, आपकी Google Sheets फ़ाइलों या Gmail को ऐक्सेस करना. टिप्पणी वाले कोड से अब भी अनुमति का अनुरोध जनरेट किया जा सकता है. अगर किसी स्क्रिप्ट को अनुमति की ज़रूरत है, तो उसे चलाने पर आपको यहां दिखाए गए अनुमति वाले डायलॉग बॉक्स में से कोई एक दिखेगा.

अगर कोड में बदलाव करके नई सेवाएं जोड़ी जाती हैं, तो आपने जिन स्क्रिप्ट को पहले अनुमति दी है वे भी अनुमति के लिए फिर से अनुरोध करती हैं. अगर स्क्रिप्ट को स्क्रिप्ट के मालिक की उपयोगकर्ता पहचान के तहत चलने वाले वेब ऐप्लिकेशन के तौर पर ऐक्सेस किया जाता है, तो हो सकता है कि स्क्रिप्ट अनुमति का अनुरोध न करें.

ऐक्सेस का अधिकार रद्द करना

किसी स्क्रिप्ट से अपने डेटा का ऐक्सेस वापस लेने के लिए, यह तरीका अपनाएं:

1. अपने Google खाते के लिए, अनुमतियां पेज पर जाएं. (आने वाले समय में इस पेज पर जाने के लिए, Google.com पर जाएं. इसके बाद, स्क्रीन पर सबसे ऊपर दाएं कोने में मौजूद अपने खाते की फ़ोटो पर क्लिक करें. इसके बाद, मेरा खाता पर क्लिक करें. इसके बाद, "साइन इन और सुरक्षा" सेक्शन में जाकर, कनेक्ट किए गए ऐप्लिकेशन और साइटें पर क्लिक करें. इसके बाद, ऐप्लिकेशन मैनेज करें पर क्लिक करें.
2. उस स्क्रिप्ट के नाम पर क्लिक करें जिसका ऐक्सेस रद्द करना है. इसके बाद, दाईं ओर मौजूद हटाएं पर क्लिक करें. इसके बाद, डायलॉग बॉक्स में ठीक है पर क्लिक करें.

स्क्रिप्ट की अनुमतियां और टाइप

स्क्रिप्ट जिस उपयोगकर्ता आईडी के साथ चलती है और जिस डेटा को ऐक्सेस कर सकती है वह स्क्रिप्ट के चलने की स्थिति के आधार पर अलग-अलग होता है. इस बारे में नीचे दी गई टेबल में बताया गया है.

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 ऐप्लिकेशन के उपयोगकर्ता की सीमाएं देखें.