编辑器插件的自定义菜单

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

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

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

警告： 如果您尝试执行需要授权的操作， 授权模式为 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();
}