编辑器插件的自定义菜单

发布了编辑器插件 可以在编辑器的扩展程序菜单下创建自定义菜单项。您可以使用 Ui.createAddonMenu() 方法插入插件菜单，并使用 Menu.addItem() 方法向其中添加项。菜单通常是在插件的 onOpen(e) 方法中创建。

注意 ：未发布的插件也可能 创建自定义顶级菜单， 但这些插件会自动移至插件菜单下， 发布的内容，可能无法带来您想要的用户体验。如果您 打算发布该插件时，始终使用 Ui.createAddonMenu()至 定义附加菜单。

您可以创建动态菜单，使其根据用户互动或插件状态而发生变化。不过，插件必须先创建初始菜单，然后 。因此，您必须先检查插件的授权模式，然后才能在 onOpen(e) 中构建菜单。在该插件处于 ScriptApp.AuthMode.NONE 状态时，请勿尝试执行任何需要授权的操作（例如检查脚本 Properties）。请参阅 授权生命周期 了解有关授权模式和生命周期的更多详细信息。

警告：如果您在授权模式为 ScriptApp.AuthMode.NONE 时尝试执行需要授权的操作，则会导致错误。这个 可能会导致您的插件菜单无法显示。

以下示例展示了如何为不同的 授权模式：

function onOpen(e) {
  var menu = SpreadsheetApp.getUi().createAddonMenu(); // Or DocumentApp or SlidesApp or FormApp.
  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();
}