一个枚举,用于确定 Apps 脚本可以通过触发的函数执行哪些类别的授权服务。这些值在触发的函数中作为事件参数的 authMode
属性公开,即 e
。如需了解详情,请参阅插件的授权生命周期指南。
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 | 一种模式,允许使用部分服务,以便在自定义电子表格函数中使用。其中部分服务(包括对电子表格服务的只读权限)通常需要授权,但在自定义函数中使用时,可以在未经授权的情况下获得授权。由于自定义函数不包含事件参数,因此永远不会返回此值;记录它只是为了证明自定义函数在其自己的授权模式下运行。 |
LIMITED | Enum | 允许访问部分服务的模式。当与文档的插件或脚本绑定到某个文档执行 onOpen(e) 或 onEdit(e) 简单触发器时,会出现此模式,NONE 的情况除外。 |
FULL | Enum | 此模式允许访问所有需要授权的服务。除 LIMITED 或 NONE 所述的情况外,如果插件或脚本通过任何触发器的结果执行,就会出现此模式。 |