本頁面由 Cloud Translation API 翻譯而成。

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：可用於授權指令碼的網址