GASでスプレッドシートに名前付き範囲を
設定して参照する方法

function createNamedRange() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("設定");

  // B2セルに税率、B3セルに送料などが入っている想定
  // B2の1セルに「税率」という名前を付ける
  ss.setNamedRange("税率", sheet.getRange("B2"));

  // 範囲（複数セル）にも名前を付けられる
  // 集計対象の金額列 C2:C1000 に「集計対象金額」と名付ける
  ss.setNamedRange("集計対象金額", sheet.getRange("C2:C1000"));
}

function readByName() {
  const ss = SpreadsheetApp.getActive();

  // 名前で範囲を取得（存在しなければ null が返る）
  const taxRange = ss.getRangeByName("税率");
  if (taxRange === null) {
    throw new Error("名前付き範囲「税率」が見つかりません");
  }

  // 1セルなら getValue で値を読む
  const taxRate = taxRange.getValue(); // 例: 0.1
  Logger.log("税率: " + taxRate);

  // 複数セルの範囲は getValues で二次元配列として読む
  const amounts = ss.getRangeByName("集計対象金額").getValues();
  const total = amounts.flat().reduce((sum, v) => sum + (Number(v) || 0), 0);
  Logger.log("合計: " + total);
}

function writeByName() {
  const ss = SpreadsheetApp.getActive();

  // 名前付き範囲は読み取りだけでなく書き込みにも使える
  // 「税率」の値を10%に更新
  ss.getRangeByName("税率").setValue(0.1);

  // 「最終更新日時」という名前のセルに現在時刻を書き込む
  const updated = ss.getRangeByName("最終更新日時");
  if (updated) {
    updated.setValue(new Date());
  }
}

function listNamedRanges() {
  const ss = SpreadsheetApp.getActive();

  // スプレッドシート内のすべての名前付き範囲を取得
  const namedRanges = ss.getNamedRanges();

  namedRanges.forEach((nr) => {
    const name = nr.getName();                 // 名前
    const a1 = nr.getRange().getA1Notation();  // 実際に指している範囲
    const sheetName = nr.getRange().getSheet().getName();
    Logger.log(name + " -> " + sheetName + "!" + a1);
  });
}

function manageNamedRanges() {
  const ss = SpreadsheetApp.getActive();

  // 名前を変更する（NamedRange オブジェクト経由）
  const target = ss.getNamedRanges().find((nr) => nr.getName() === "税率");
  if (target) {
    target.setName("消費税率"); // リネーム
  }

  // 特定の名前付き範囲を削除する
  const toRemove = ss.getNamedRanges().find((nr) => nr.getName() === "旧・集計対象");
  if (toRemove) {
    toRemove.remove(); // 名前だけ消える。セルの中身は残る
  }

  // ss.removeNamedRange("名前") でも削除できる
  // ss.removeNamedRange("集計対象金額");
}

// 設定シートの名前付き範囲を一括で読み、設定オブジェクトにまとめる
function loadConfig() {
  const ss = SpreadsheetApp.getActive();

  const names = ["税率", "送料", "無料配送の閾値", "通知先メール"];
  const config = {};

  names.forEach((name) => {
    const range = ss.getRangeByName(name);
    // 未設定でも落ちないよう、なければ null を入れておく
    config[name] = range ? range.getValue() : null;
  });

  // config.税率 のように、座標を意識せず設定値を使える
  Logger.log(JSON.stringify(config));
  return config;
}