GASでスプレッドシートの処理を
高速化する方法

// 遅い例: 1セルずつ読み書きしている
function addTaxSlow() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const lastRow = sheet.getLastRow();

  // 2行目から最終行まで、1行ずつ処理
  for (let row = 2; row <= lastRow; row++) {
    const price = sheet.getRange(row, 1).getValue(); // 毎回通信
    const withTax = Math.round(price * 1.1);
    sheet.getRange(row, 2).setValue(withTax);        // 毎回通信
  }
}
// 1000行なら getValue + setValue で約2000回の通信が発生する

// 速い例: 一括で読み込み、配列で計算し、一括で書き込む
function addTaxFast() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return; // データが無ければ終了

  // A列（単価）を2行目から一括取得: 通信は1回
  const numRows = lastRow - 1;
  const prices = sheet.getRange(2, 1, numRows, 1).getValues();

  // 計算はJavaScriptの配列だけで行う（スプレッドシートに触れない）
  const result = prices.map((r) => [Math.round(r[0] * 1.1)]);

  // B列に一括書き込み: 通信は1回
  sheet.getRange(2, 2, numRows, 1).setValues(result);
}
// 1000行でも通信は合計2回で済む

function readTable() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("名簿");

  // 使用範囲全体を二次元配列で取得
  const data = sheet.getDataRange().getValues();
  const header = data[0];  // 1行目はヘッダー
  const rows = data.slice(1);

  rows.forEach((row) => {
    // 列は0始まり。A列=row[0], B列=row[1], C列=row[2]
    const name = row[0];
    const email = row[1];
    Logger.log(name + " / " + email);
  });

  Logger.log("ヘッダー: " + header.join(", "));
}

// 複数列をまとめて計算し、行の配列を組み立ててから一括書き込み
function buildInvoiceAmounts() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("受注");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  const numRows = lastRow - 1;
  // A:単価, B:数量, C:税率 の3列をまとめて取得
  const src = sheet.getRange(2, 1, numRows, 3).getValues();

  // D:小計, E:税込 の2列を配列で組み立てる
  const output = src.map((row) => {
    const [price, qty, taxRate] = row;
    const subtotal = price * qty;
    const total = Math.round(subtotal * (1 + taxRate));
    return [subtotal, total];
  });

  // D2から2列分を一括書き込み
  sheet.getRange(2, 4, numRows, 2).setValues(output);
}

// 悪い例: ループの中で毎回getRangeを呼ぶ
function markDoneSlow(rowNumbers) {
  const sheet = SpreadsheetApp.getActive().getSheetByName("タスク");
  rowNumbers.forEach((row) => {
    sheet.getRange(row, 3).setValue("完了"); // 対象行の数だけ通信
  });
}

// 良い例: C列をまとめて読み、配列を書き換えて一括で戻す
function markDoneFast(rowNumbers) {
  const sheet = SpreadsheetApp.getActive().getSheetByName("タスク");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  const numRows = lastRow - 1;
  const status = sheet.getRange(2, 3, numRows, 1).getValues(); // 1回で取得
  const targets = new Set(rowNumbers);

  for (let i = 0; i < numRows; i++) {
    const actualRow = i + 2; // 配列indexを実際の行番号に変換
    if (targets.has(actualRow)) {
      status[i][0] = "完了";
    }
  }

  sheet.getRange(2, 3, numRows, 1).setValues(status); // 1回で書き戻す
}

// 一括化しても終わらない大量データは、行を分割して処理する
function processInChunks() {
  const props = PropertiesService.getScriptProperties();
  const sheet = SpreadsheetApp.getActive().getSheetByName("大量データ");
  const lastRow = sheet.getLastRow();

  const CHUNK = 2000; // 1回で処理する行数
  const start = Number(props.getProperty("startRow") || 2);
  const end = Math.min(start + CHUNK - 1, lastRow);
  if (start > lastRow) {
    props.deleteProperty("startRow");
    return; // 全行処理済み
  }

  const numRows = end - start + 1;
  const data = sheet.getRange(start, 1, numRows, 1).getValues();
  const result = data.map((r) => [String(r[0]).trim()]);
  sheet.getRange(start, 1, numRows, 1).setValues(result);

  // 次回の開始位置を保存。トリガーで再度この関数を呼べば続きから処理される
  props.setProperty("startRow", String(end + 1));
}