GASでスプレッドシートの行を
オブジェクト配列に変換する方法

// シートの全データを「ヘッダーをキーにしたオブジェクトの配列」に変換する
function sheetToObjects(sheet) {
  const values = sheet.getDataRange().getValues();
  if (values.length < 2) return []; // ヘッダーだけ／空なら空配列

  const headers = values[0].map((h) => String(h).trim());
  const rows = values.slice(1);

  return rows.map((row) => {
    const obj = {};
    headers.forEach((key, i) => {
      obj[key] = row[i];
    });
    return obj;
  });
}

function example() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("会員");
  const records = sheetToObjects(sheet);

  // 列番号ではなく列名で読める
  records.forEach((r) => {
    Logger.log(r["氏名"] + " / " + r["メール"]);
  });

  Logger.log("件数: " + records.length);
}

// オブジェクトの配列を、指定した列順でシートに書き戻す
function objectsToSheet(sheet, objects, headers) {
  sheet.clearContents();
  sheet.getRange(1, 1, 1, headers.length).setValues([headers]);

  if (objects.length === 0) return;

  // headers の順番どおりに値を並べ替えてから書き込む
  const rows = objects.map((obj) =>
    headers.map((key) => (obj[key] !== undefined ? obj[key] : ""))
  );
  sheet.getRange(2, 1, rows.length, headers.length).setValues(rows);
}

function summarizeSales() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const records = sheetToObjects(sheet);

  // 「東京」支店の行だけ抽出
  const tokyo = records.filter((r) => r["支店"] === "東京");

  // 金額を合計（Number()で確実に数値化）
  const total = tokyo.reduce((sum, r) => sum + Number(r["金額"]), 0);

  Logger.log("東京支店の件数: " + tokyo.length);
  Logger.log("東京支店の合計金額: " + total + "円");
}

function sheetToObjectsSafe(sheet) {
  const values = sheet.getDataRange().getValues();
  if (values.length < 2) return [];

  const headers = values[0].map((h) => String(h).trim());

  return values
    .slice(1)
    // すべてのセルが空の行は除外する
    .filter((row) => row.some((cell) => String(cell).trim() !== ""))
    .map((row) => {
      const obj = {};
      headers.forEach((key, i) => {
        obj[key] = row[i];
      });
      return obj;
    });
}

// 実際のシート行番号を _row として持たせる
function sheetToObjectsWithRow(sheet) {
  const values = sheet.getDataRange().getValues();
  if (values.length < 2) return [];

  const headers = values[0].map((h) => String(h).trim());

  return values.slice(1).map((row, i) => {
    const obj = { _row: i + 2 }; // ヘッダー分+1が実際の行番号
    headers.forEach((key, j) => {
      obj[key] = row[j];
    });
    return obj;
  });
}

// 変換したオブジェクトを使って、その行の特定セルだけ更新する
function markProcessed() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("注文");
  const records = sheetToObjectsWithRow(sheet);
  const statusCol = 5; // E列「状態」

  records
    .filter((r) => r["状態"] !== "処理済み")
    .forEach((r) => {
      // 必要な処理をここで実行
      sheet.getRange(r._row, statusCol).setValue("処理済み");
    });
}