GASで自作のカスタム関数を作る方法
スプレッドシートで=MYFUNC()

/**
 * 税抜金額から税込金額を計算する。
 * セルには =TAXIN(A2) または =TAXIN(A2, 0.08) と書く。
 */
function TAXIN(price, rate) {
  if (price === "" || price === null) return "";   // 空セルは空のまま返す
  if (typeof price !== "number") {
    throw new Error("金額は数値で指定してください");  // セルに #ERROR! と理由が出る
  }

  const taxRate = typeof rate === "number" ? rate : 0.1;  // 既定は10%
  return Math.floor(price * (1 + taxRate));               // 端数は切り捨て
}

/**
 * 引数が1セルでも範囲でも動くカスタム関数。
 * =TAXIN_RANGE(A2:A100) のように範囲をまとめて渡せる。
 */
function TAXIN_RANGE(input, rate) {
  const taxRate = typeof rate === "number" ? rate : 0.1;

  // 範囲が渡されると input は二次元配列になる
  if (Array.isArray(input)) {
    return input.map((row) =>
      row.map((cell) => (typeof cell === "number" ? Math.floor(cell * (1 + taxRate)) : ""))
    );
  }

  // 単一セルのときは値がそのまま渡ってくる
  return typeof input === "number" ? Math.floor(input * (1 + taxRate)) : "";
}

/**
 * 住所文字列から「都道府県 / 市区町村以降」の2列に分けて返す。
 * =SPLIT_ADDRESS(A2) と1セルに書くと、右隣のセルまで自動で展開される。
 */
function SPLIT_ADDRESS(address) {
  if (typeof address !== "string" || address === "") return [["", ""]];

  const matched = address.match(/^(.+?[都道府県])(.*)$/);
  if (!matched) return [["", address]];

  // 二次元配列で返すと、そのまま複数セルに展開される
  return [[matched[1], matched[2]]];
}

/**
 * 社員番号を「LS-0001」の形式に整形します。
 *
 * @param {number|string} id 社員番号（例: 1）
 * @param {string} [prefix] 接頭辞（省略時は "LS"）
 * @return {string} 整形後の社員コード
 * @customfunction
 */
function EMPLOYEE_CODE(id, prefix) {
  const head = typeof prefix === "string" && prefix !== "" ? prefix : "LS";
  const num = String(id).replace(/[^0-9]/g, "");
  if (num === "") return "";

  return head + "-" + ("0000" + num).slice(-4);
}

// 動かない例: カスタム関数からは認可が必要なサービスを呼べない
function NG_FETCH(url) {
  const res = UrlFetchApp.fetch(url);   // ← 権限エラーになる
  return res.getContentText();
}

function NG_MAIL_COUNT(label) {
  return GmailApp.search("label:" + label).length;  // ← これも不可
}

// 使えるもの: 計算・文字列処理・Utilities・日付など、権限のいらない処理
function FORMAT_YMD(date) {
  if (!(date instanceof Date)) return "";
  return Utilities.formatDate(date, "Asia/Tokyo", "yyyy/MM/dd");  // これはOK
}

// カスタム関数の代わりに、メニューから実行して結果を「値」で書き込む
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("独自ツール")
    .addItem("要約を一括生成", "fillSummaries")
    .addToUi();
}

function fillSummaries() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const values = sheet.getRange(2, 1, sheet.getLastRow() - 1, 1).getValues();

  const out = values.map((row) => {
    const text = row[0];
    if (!text) return [""];
    return [callExternalApi(text)];   // ここではUrlFetchAppを使える
  });

  sheet.getRange(2, 2, out.length, 1).setValues(out);  // 結果は値として保存される
}

function callExternalApi(text) {
  const res = UrlFetchApp.fetch("https://example.com/api", {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify({ text: text }),
    muteHttpExceptions: true,
  });
  if (res.getResponseCode() !== 200) return "エラー";

  return JSON.parse(res.getContentText()).result;
}

/**
 * 再計算のクセに対応する例。
 * 第2引数に更新用のダミーセル（例: $Z$1）を渡し、
 * その値を変えると強制的に再計算される。
 */
function RANDOM_PICK(range, refresh) {
  const items = (Array.isArray(range) ? range : [[range]])
    .flat()
    .filter((v) => v !== "" && v !== null);

  if (items.length === 0) return "";

  const index = Math.floor(Math.random() * items.length);
  return items[index];
}

// セルには =RANDOM_PICK(A2:A20, $Z$1) と書く。
// $Z$1 を書き換えるたびに引数が変わるため、再計算される。