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 — अनुमति वाले स्कोप की सूची.