Class AuthorizationInfo

AuthorizationInfo

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

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

यह ऑब्जेक्ट, ScriptApp.getAuthorizationInfo(authMode) से मिलता है. ज़्यादातर मामलों में, स्क्रिप्ट को ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) को कॉल करना चाहिए. इसकी वजह यह है कि अनुमति के किसी अन्य मोड के लिए, उपयोगकर्ताओं से अनुमति लेने की ज़रूरत नहीं होती.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getAuthorizationStatus()AuthorizationStatusइससे एक वैल्यू मिलती है. यह वैल्यू बताती है कि उपयोगकर्ता को एक या उससे ज़्यादा सेवाओं का इस्तेमाल करने के लिए, इस स्क्रिप्ट को अनुमति देनी होगी या नहीं. उदाहरण के लिए, ScriptApp.AuthorizationStatus.REQUIRED.
getAuthorizationUrl()String|nullइससे अनुमति देने वाला यूआरएल मिलता है. इसका इस्तेमाल, स्क्रिप्ट को ऐक्सेस करने की अनुमति देने के लिए किया जा सकता है.
getAuthorizedScopes()String[]|nullइससे स्क्रिप्ट के लिए, अनुमति वाले स्कोप की सूची मिलती है.

ज़्यादा जानकारी वाला दस्तावेज़

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|null — एक यूआरएल जिसका इस्तेमाल, स्क्रिप्ट को अनुमति देने के लिए किया जा सकता है.

getAuthorizedScopes()

इससे स्क्रिप्ट के लिए, अनुमति वाले स्कोप की सूची मिलती है. अगर स्कोप की किसी खास सूची के लिए, अनुमति की जानकारी का अनुरोध किया जाता है, तो दी गई सूची में से अनुमति वाले स्कोप दिखते हैं. 

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

वापसी का टिकट

String[]|null — अनुमति वाले स्कोप की सूची.