用來判斷使用者是否需要授權這個指令碼使用一或多個指令碼的物件 服務,並提供授權對話方塊的網址。如果指令碼是以使用可安裝觸發條件的外掛程式發布,就可以使用這項資訊 針對使用者缺少必要授權的程式碼區段,控管程式碼區段的存取權限。 或者,外掛程式可以要求使用者開啟授權對話方塊的網址,以便解決問題 問題。
這個物件是由 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
:可用來授權指令碼的網址