Enum AuthMode
AuthMode
列舉項目,用於識別 Apps Script 可存取哪些授權服務類別
透過觸發的函式執行這些值會在「觸發的函式」中顯示為 authMode
事件參數屬性 e
。適用對象
請參閱這份指南
外掛程式的授權生命週期。
如要呼叫列舉,您可以呼叫其父項類別、名稱和屬性。例如
ScriptApp.AuthMode.CUSTOM_FUNCTION
。
function onOpen(e) {
var menu = SpreadsheetApp.getUi().createAddonMenu();
if (e && e.authMode == ScriptApp.AuthMode.NONE) {
// Add a normal menu item (works in all authorization modes).
menu.addItem('Start workflow', 'startWorkflow');
} else {
// Add a menu item based on properties (doesn't work in AuthMode.NONE).
var properties = PropertiesService.getDocumentProperties();
var workflowStarted = properties.getProperty('workflowStarted');
if (workflowStarted) {
menu.addItem('Check workflow status', 'checkWorkflow');
} else {
menu.addItem('Start workflow', 'startWorkflow');
}
// Record analytics.
UrlFetchApp.fetch('http://www.example.com/analytics?event=open');
}
menu.addToUi();
}
屬性
屬性 | 類型 | 說明 |
NONE | Enum | 模式不允許存取任何需要授權的服務。發生這個模式時
外掛程式執行 onOpen(e) 簡單觸發條件,且使用者安裝
外掛程式,但並未在目前的文件中使用這個外掛程式。 |
CUSTOM_FUNCTION | Enum | 此模式允許存取部分服務,供自訂試算表使用
函式。其中一些服務 (包括試算表服務的唯讀存取權)
通常需要授權,但如果用於自訂和自訂用途,則不必獲得授權
函式。由於自訂函式不含事件參數,因此這個值一律不得
returned;但僅用於示範自訂函式是自行執行
授權模式。 |
LIMITED | Enum | 允許存取部分服務模式的模式。這個模式會發生在
「繫結」至文件的指令碼會執行 onOpen(e) 或 onEdit(e) 簡易觸發條件,但 NONE 中描述的情況除外。 |
FULL | Enum | 允許存取所有需要授權的服務。這時,
外掛程式或指令碼會在所有觸發事件的結果,
LIMITED 或 NONE 。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-29 (世界標準時間)。
[null,null,["上次更新時間:2024-08-29 (世界標準時間)。"],[[["AuthMode defines the level of access Apps Script has to authorized services when a triggered function is executed."],["It's crucial for understanding how add-ons and scripts interact with Google services, especially concerning user authorization."],["Different AuthModes like NONE, LIMITED, and FULL, dictate the scope of service access, impacting functionalities within triggered functions."],["Custom functions operate under a specific authorization mode that allows restricted access to certain services without explicit user authorization."]]],[]]