GASでスプレッドシートに
カスタムメニューを追加する方法

// スプレッドシートを開いた瞬間に自動で呼ばれる特別な関数
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu("業務ツール")        // メニュー名
    .addItem("データを更新する", "updateData") // 表示名, 実行する関数名
    .addToUi();                      // これを呼ばないと表示されない
}

// メニューから呼ばれる関数
function updateData() {
  SpreadsheetApp.getActiveSpreadsheet().toast("更新を実行しました");
}

function onOpen() {
  const ui = SpreadsheetApp.getUi();

  // サブメニュー（入れ子のメニュー）を先に組み立てる
  const exportMenu = ui.createMenu("エクスポート")
    .addItem("PDFで書き出す", "exportPdf")
    .addItem("CSVで書き出す", "exportCsv");

  ui.createMenu("業務ツール")
    .addItem("データを更新する", "updateData")
    .addItem("重複を削除する", "removeDuplicates")
    .addSeparator()               // 区切り線
    .addSubMenu(exportMenu)        // サブメニューを追加
    .addToUi();
}

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  const menu = ui.createMenu("業務ツール");

  menu.addItem("日次集計を実行", "runDailyReport");

  // 開いているシート名によって項目を出し分ける
  const sheetName = SpreadsheetApp.getActiveSheet().getName();
  if (sheetName === "請求データ") {
    menu.addItem("請求書を発行する", "issueInvoice");
  }

  menu.addToUi();
}

// 確認ダイアログ（はい / いいえ）
function removeDuplicates() {
  const ui = SpreadsheetApp.getUi();
  const answer = ui.alert(
    "確認",
    "重複行を削除します。よろしいですか？",
    ui.ButtonSet.YES_NO
  );
  if (answer !== ui.Button.YES) return; // 「いいえ」なら中止

  // ここに実際の削除処理を書く
  ui.alert("重複行を削除しました。");
}

// 入力プロンプト（文字列を受け取る）
function searchByKeyword() {
  const ui = SpreadsheetApp.getUi();
  const res = ui.prompt("検索", "キーワードを入力してください", ui.ButtonSet.OK_CANCEL);
  if (res.getSelectedButton() !== ui.Button.OK) return;

  const keyword = res.getResponseText();
  SpreadsheetApp.getActiveSpreadsheet().toast("検索語: " + keyword);
}

// 一度だけ手動実行して、インストール型のonOpenトリガーを登録する
function setupMenuTrigger() {
  const ss = SpreadsheetApp.getActive();

  // 二重登録を防ぐため、同じ関数の既存トリガーを削除
  ScriptApp.getProjectTriggers().forEach((t) => {
    if (t.getHandlerFunction() === "buildMenu") {
      ScriptApp.deleteTrigger(t);
    }
  });

  ScriptApp.newTrigger("buildMenu")
    .forSpreadsheet(ss)
    .onOpen()
    .create();
}

// インストール型トリガーは作成者の承認で動くので、
// UrlFetchAppなど権限が必要な処理を呼ぶメニューも作れる
function buildMenu() {
  SpreadsheetApp.getUi()
    .createMenu("業務ツール（拡張）")
    .addItem("外部APIと同期する", "syncExternalApi")
    .addToUi();
}