Class AuthorizationInfo

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

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

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

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

तरीके

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

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