エディタのアドオンのカスタム メニュー

公開されているエディタ アドオン エディタの [拡張機能] メニューでカスタム メニュー項目を作成できる。Google Chat では アドオン メニューを挿入する 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();
}