एक ऑब्जेक्ट जो यह तय करता है कि उपयोगकर्ता को एक या उससे ज़्यादा स्क्रिप्ट का इस्तेमाल करने के लिए, इस स्क्रिप्ट को अनुमति देने की ज़रूरत है या नहीं सेवाएं और अनुमति देने वाले डायलॉग के लिए यूआरएल देने के लिए. अगर स्क्रिप्ट को ऐसे ऐड-ऑन के तौर पर पब्लिश किया गया है जो इंस्टॉल किए जा सकने वाले ट्रिगर का इस्तेमाल करता है, तो इस जानकारी का इस्तेमाल किया जा सकता है का इस्तेमाल करके, कोड के ऐसे सेक्शन का ऐक्सेस कंट्रोल किया जा सकता है जिनके लिए उपयोगकर्ता से ज़रूरी अनुमति नहीं ली गई है. इसके अलावा, ऐड-ऑन, उपयोगकर्ता से अनुमति वाले डायलॉग बॉक्स का यूआरएल खोलने के लिए कह सकता है, ताकि उसे हल किया जा सके उस समस्या को हल कर सकें.
यह ऑब्जेक्ट ScriptApp.getAuthorizationInfo(authMode)
के ज़रिए दिखाया जाता है. करीब
सभी मामलों में, स्क्रिप्ट को ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL)
को कॉल करना चाहिए,
क्योंकि किसी अन्य प्राधिकरण मोड के लिए उपयोगकर्ताओं को अनुमति देने की ज़रूरत नहीं है.
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
getAuthorizationStatus() | AuthorizationStatus | इससे एक वैल्यू मिलती है, जिससे पता चलता है कि उपयोगकर्ता को एक या उससे ज़्यादा स्क्रिप्ट का इस्तेमाल करने के लिए, इस स्क्रिप्ट को अनुमति देने की ज़रूरत है या नहीं
सेवाएं (उदाहरण के लिए, ScriptApp.AuthorizationStatus.REQUIRED ). |
getAuthorizationUrl() | String | अनुमति देने वाला यूआरएल मिलता है, जिसका इस्तेमाल स्क्रिप्ट का ऐक्सेस देने के लिए किया जा सकता है. |
विस्तृत दस्तावेज़
getAuthorizationStatus()
इससे एक वैल्यू मिलती है, जो बताती है कि उपयोगकर्ता को एक या उससे ज़्यादा स्क्रिप्ट का इस्तेमाल करने के लिए, इस स्क्रिप्ट को अनुमति देने की ज़रूरत है या नहीं
सेवाएं (उदाहरण के लिए, ScriptApp.AuthorizationStatus.REQUIRED
).
// Log the authorization status (REQUIRED or NOT_REQUIRED). var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationStatus());
वापसी का टिकट
AuthorizationStatus
— अनुमति देने की स्थिति
getAuthorizationUrl()
अनुमति देने वाला यूआरएल लाता है, जिसका इस्तेमाल स्क्रिप्ट का ऐक्सेस देने के लिए किया जा सकता है. इस तरीके से नतीजे मिलते हैं
अगर अनुमति की ज़रूरत नहीं है, तो null
. अगर यूआरएल पर मौजूद पेज अपने-आप बंद हो जाएगा, तो
इसे ऐक्सेस किया जाता है और स्क्रिप्ट को किसी अनुमति की ज़रूरत नहीं है.
// Log the URL used to grant access to the script. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
वापसी का टिकट
String
— स्क्रिप्ट को अनुमति देने के लिए इस्तेमाल किया जाने वाला यूआरएल