अनुमति पाने के लिंक

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

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

ज़्यादातर स्क्रिप्ट के लिए, Apps Script अपने-आप यह पता लगा लेती है कि आपके लिए कौनसे स्कोप ज़रूरी हैं. आपके पास, स्क्रिप्ट के इस्तेमाल किए जाने वाले स्कोप देखने का विकल्प हमेशा होता है. यूआरएल स्ट्रिंग का इस्तेमाल करके, अपने मेनिफ़ेस्ट में स्कोप को साफ़ तौर पर सेट किया जा सकता है. कभी-कभी ऐड-ऑन जैसे कुछ ऐप्लिकेशन के लिए साफ़ तौर पर दायरा सेट करना ज़रूरी होता है. इसकी वजह यह है कि पब्लिश किए गए ऐप्लिकेशन में हमेशा सबसे कम दायरों का इस्तेमाल किया जाना चाहिए.

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

कुछ स्कोप में दूसरे स्कोप शामिल हैं. उदाहरण के लिए, अगर स्कोप को अनुमति दी गई है, तो https://www.googleapis.com/auth/spreadsheets, स्प्रेडशीट को पढ़ने और उसमें बदलाव करने का ऐक्सेस देता है.

दायरे देखना

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

1. स्क्रिप्ट प्रोजेक्ट खोलें.
2. बाईं ओर, खास जानकारी पर क्लिक करें info_outline.
3. प्रोजेक्ट OAuth के दायरे में जाकर, स्कोप देखें.

अश्लील स्कोप सेट करना

Apps Script में अपने-आप तय होता है कि किसी स्क्रिप्ट के कोड को स्कैन करना है या नहीं. ऐसा उन फ़ंक्शन कॉल के लिए किया जाता है जिनकी ज़रूरत होती है. ज़्यादातर स्क्रिप्ट के लिए यह काफ़ी है और आपका समय बचाता है. हालांकि, पब्लिश किए गए ऐड-ऑन, वेब ऐप्लिकेशन, Google Chat ऐप्लिकेशन, और Google Chat API का इस्तेमाल करने के लिए, आपको स्कोप को सीधे तौर पर कंट्रोल करने की अनुमति देनी होगी.

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

अपने स्क्रिप्ट प्रोजेक्ट की मेनिफ़ेस्ट फ़ाइल में बदलाव करके, उसके इस्तेमाल के दायरे को साफ़ तौर पर सेट किया जा सकता है. मेनिफ़ेस्ट फ़ील्ड oauthScopes, प्रोजेक्ट में इस्तेमाल किए जाने वाले सभी स्कोप का कलेक्शन है. अपने प्रोजेक्ट के स्कोप सेट करने के लिए, यह तरीका अपनाएं:

1. स्क्रिप्ट प्रोजेक्ट खोलें.
2. बाईं ओर, प्रोजेक्ट सेटिंग settings पर क्लिक करें.
3. "appsscript.json" मेनिफ़ेस्ट फ़ाइल, एडिटर में दिखाएं चेकबॉक्स को चुनें.
4. बाईं ओर, एडिटर code पर क्लिक करें.
5. बाईं ओर, appsscript.json फ़ाइल पर क्लिक करें.
6. oauthScopes लेबल वाले टॉप-लेवल फ़ील्ड को ढूंढें. अगर यह मौजूद नहीं है, तो इसे जोड़ें.
7. oauthScopes फ़ील्ड, स्ट्रिंग का कलेक्शन तय करता है. अपने प्रोजेक्ट में इस्तेमाल किए जाने वाले स्कोप सेट करने के लिए, इस कलेक्शन के कॉन्टेंट को उन स्कोप से बदलें जिनका इस्तेमाल आपको करना है. उदाहरण के लिए:

         {
           ...
           "oauthScopes": [
             "https://www.googleapis.com/auth/spreadsheets.readonly",
             "https://www.googleapis.com/auth/userinfo.email"
           ],
          ...
         }
   

8. सबसे ऊपर, सेव करें save पर क्लिक करें.

OAuth से पुष्टि

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

• Apps Script के लिए OAuth क्लाइंट की पुष्टि करना
• ऐसे ऐप्लिकेशन जिनकी पुष्टि नहीं हुई है
• OAuth की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल
• Google API सेवा: उपयोगकर्ता के डेटा से जुड़ी नीति

पाबंदी वाले दायरे

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

पब्लिश करने से पहले, पाबंदी वाले दायरों की पूरी सूची देखें. अगर आपका ऐप्लिकेशन इनमें से किसी का भी इस्तेमाल करता है, तो पब्लिश करने से पहले आपको खास एपीआई के दायरे के लिए अन्य ज़रूरी शर्तों का पालन करना होगा.