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