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