GASのflush()でスプレッドシートの
書き込みを即時反映する方法

function whyDelayed() {
  const sheet = SpreadsheetApp.getActiveSheet();

  sheet.getRange("A1").setValue("開始");
  Utilities.sleep(5000);               // この5秒間、画面のA1はまだ空のことがある
  sheet.getRange("A2").setValue("終了"); // GASは書き込みをためて後でまとめて反映するため

  // 途中でどうしても反映させたいときだけ、その場所でflushを呼ぶ
  // SpreadsheetApp.flush();
}

function importWithProgress() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("進捗");
  const total = 50;

  for (let i = 1; i <= total; i++) {
    sheet.getRange(i, 1).setValue("処理中: " + i + "行目");

    // 10件ごとに反映して、途中経過を画面に見せる
    if (i % 10 === 0) {
      SpreadsheetApp.flush();          // 保留中の書き込みをシートに反映
      ss.toast(i + " / " + total + " 件完了", "進捗", 3);
    }
  }

  SpreadsheetApp.flush();
  ss.toast("完了しました", "進捗", 5);   // 右下に3〜5秒だけ出る通知
}

function readAfterFormula() {
  const sheet = SpreadsheetApp.getActiveSheet();

  sheet.getRange("B1").setFormula("=A1*10");
  SpreadsheetApp.flush();               // これが無いと古い(空)の結果を読むことがある

  const result = sheet.getRange("B1").getValue();
  Logger.log(result);                   // 反映後の計算結果が取れる
}

function processInChunks() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("台帳");
  const values = sheet.getDataRange().getValues();
  const startedAt = new Date().getTime();

  for (let i = 1; i < values.length; i++) {
    // ... 1行ずつ時間のかかる処理(外部API呼び出しなど) ...
    sheet.getRange(i + 1, 5).setValue("済");

    if (i % 20 === 0) {
      SpreadsheetApp.flush();            // ここまでの結果を確定させる
    }

    // 6分制限の手前(約5分)で安全に中断し、途中まで保存しておく
    if (new Date().getTime() - startedAt > 5 * 60 * 1000) {
      SpreadsheetApp.flush();
      Logger.log(i + "行目まで処理して中断。次回は続きから。");
      break;
    }
  }

  SpreadsheetApp.flush();
}

// 悪い例: 1行ごとにflushすると毎回サーバーと往復して極端に遅い
function slowFlush() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const data = sheet.getRange("A1:A1000").getValues();

  data.forEach((row, i) => {
    sheet.getRange(i + 1, 2).setValue(row[0]);
    SpreadsheetApp.flush();             // ← 1000回のflushで数分かかることも
  });
}

// 良い例: 一括setValuesならflushは基本不要。まとめて1回で書き込む
function fastBatch() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const data = sheet.getRange("A1:A1000").getValues();
  const out = data.map((row) => [row[0]]);

  sheet.getRange(1, 2, out.length, 1).setValues(out);
}