GAS getDisplayValues()で表示値を一括取得！高速処理の鉄則を解説

// 【非推奨】遅いコードの例
function slowMethod() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:B100");
  const values = [];
  for (let i = 1; i <= 100; i++) {
    const rowValues = [];
    for (let j = 1; j <= 2; j++) {
      // ループのたびにAPI呼び出しが発生し、非常に遅い
      rowValues.push(range.getCell(i, j).getDisplayValue());
    }
    values.push(rowValues);
  }
  return values;
}

// 【推奨】高速なコードの例
function fastMethod() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:B100");
  // API呼び出しは1回だけ！
  const values = range.getDisplayValues();
  return values;
}

function fetchDisplayValues() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('売上データ');
  // A1からC10までの範囲を指定
  const range = sheet.getRange('A1:C10');
  // 指定範囲の表示値を一括取得
  const displayValues = range.getDisplayValues();
  
  // 取得した二次元配列をログに出力
  console.log(displayValues);
}

function processSalesData() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange(); // シート全体のデータを取得
  const values = range.getDisplayValues();
  
  const header = values.shift(); // 1行目（ヘッダー）を取り出す
  
  const salesObjects = values
    .filter(row => row[2] !== '0') // 在庫数(3列目)が'0'でない行だけをフィルタリング
    .map(row => {
      // 配列を扱いやすいオブジェクトに変換
      return {
        productName: row[0], // 商品名
        price: row[1],       // 価格 (例: "¥1,500")
        stock: row[2],       // 在庫数
        lastUpdated: row[3]  // 最終更新日 (例: "2025/12/25")
      };
    });
    
  console.log(salesObjects);
  /*
    実行結果の例:
    [
      { productName: 'リンゴ', price: '¥150', stock: '10', lastUpdated: '2025/12/25' },
      ...
    ]
  */
}