Class AuthorizationInfo

अनुमतिकी जानकारी

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

इस ऑब्जेक्ट को 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).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

वापसी का टिकट

AuthorizationStatus — अनुमति की स्थिति

getAuthorizationUrl()

अनुमति देने वाला यूआरएल पाता है. इसका इस्तेमाल, स्क्रिप्ट का ऐक्सेस देने के लिए किया जा सकता है. अगर अनुमति की ज़रूरत नहीं है, तो यह तरीका null दिखाता है. अगर यूआरएल पर मौजूद पेज को ऐक्सेस किया जाता है और स्क्रिप्ट को अनुमति की ज़रूरत नहीं होती है, तो वह पेज अपने-आप बंद हो जाएगा. 

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

वापसी का टिकट

String — ऐसा यूआरएल जिसका इस्तेमाल स्क्रिप्ट को अनुमति देने के लिए किया जा सकता है