【GAS】getBackgrounds()で複数セルの背景色を高速に一括取得する方法

function basicUsage() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C2");

  // カラーコードの二次元配列を取得
  const colors = range.getBackgrounds();
  
  console.log(colors);
  // 出力例:
  // [['#ff0000', '#00ff00', '#0000ff'],  // 1行目の色 (A1, B1, C1)
  //  ['#ffffff', '#ffff00', '#00ffff']]  // 2行目の色 (A2, B2, C2)
}

function findCellsByColor() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange(); // シート全体のデータ範囲

  // ① 値と背景色をそれぞれ一括取得
  const values = range.getValues();
  const backgrounds = range.getBackgrounds();
  
  const targetColor = "#fff2cc"; // 検索したい色（薄い黄色）
  const results = [];

  // ② メモリ上でループ処理
  for (let i = 0; i < backgrounds.length; i++) {
    for (let j = 0; j < backgrounds[i].length; j++) {
      if (backgrounds[i][j] === targetColor) {
        results.push(values[i][j]);
      }
    }
  }

  console.log(results); // ['タスクA', '重要事項B'] のように出力
}

function replaceWhiteToGray() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange();

  // ① 背景色を一括取得
  const originalColors = range.getBackgrounds();
  
  // ② メモリ上で新しい色の二次元配列を作成
  const newColors = originalColors.map(row => {
    return row.map(color => {
      // 白色（#ffffff）なら薄いグレー（#f3f3f3）に置換
      return (color === "#ffffff") ? "#f3f3f3" : color;
    });
  });

  // ③ 背景色を一括更新
  range.setBackgrounds(newColors);
}