GASでスプレッドシートの
変更履歴を自動で記録する方法

// 簡易トリガー: 関数名を onEdit にするだけで、編集のたびに自動実行される
function onEdit(e) {
  if (!e || !e.range) return;

  const sheet = e.range.getSheet();
  if (sheet.getName() === "変更履歴") return; // ログシート自身の編集は無視

  const logSheet = getOrCreateLogSheet(e.source);
  logSheet.appendRow([
    new Date(),                 // 日時
    sheet.getName(),            // シート名
    e.range.getA1Notation(),    // セル(例: B3)
    e.oldValue == null ? "" : e.oldValue, // 変更前
    e.value == null ? "" : e.value,       // 変更後
  ]);
}

function getOrCreateLogSheet(ss) {
  let logSheet = ss.getSheetByName("変更履歴");
  if (!logSheet) {
    logSheet = ss.insertSheet("変更履歴");
    logSheet.appendRow(["日時", "シート名", "セル", "変更前", "変更後"]);
  }
  return logSheet;
}

// インストール型トリガーから実行する想定の関数
function onEditLogger(e) {
  if (!e || !e.range) return;

  const ss = e.source;
  const sheet = e.range.getSheet();
  if (sheet.getName() === "変更履歴") return;

  const logSheet = getOrCreateLogSheet(ss);
  logSheet.appendRow([
    new Date(),
    getEditorEmail(e),          // 編集者のメールアドレス
    sheet.getName(),
    e.range.getA1Notation(),
    e.oldValue == null ? "" : e.oldValue,
    e.value == null ? "" : e.value,
  ]);
}

function getEditorEmail(e) {
  try {
    // 同一組織内なら取得できることが多い。取れない場合は空文字になる
    const email = (e.user && e.user.getEmail())
      ? e.user.getEmail()
      : Session.getActiveUser().getEmail();
    return email || "(不明)";
  } catch (err) {
    return "(取得不可)";
  }
}

function onEditLogger(e) {
  if (!e || !e.range) return;

  const range = e.range;
  const sheet = range.getSheet();
  if (sheet.getName() === "変更履歴") return;

  const logSheet = getOrCreateLogSheet(e.source);
  const now = new Date();
  const email = getEditorEmail(e);

  const numRows = range.getNumRows();
  const numCols = range.getNumColumns();

  // 単一セルの編集: oldValue / value がそのまま使える
  if (numRows === 1 && numCols === 1) {
    logSheet.appendRow([
      now, email, sheet.getName(), range.getA1Notation(),
      e.oldValue == null ? "" : e.oldValue,
      e.value == null ? "" : e.value,
    ]);
    return;
  }

  // 複数セル(貼り付け等): oldValue は取得できないため現在値のみ記録
  const values = range.getValues();
  const rows = [];
  for (let r = 0; r < numRows; r++) {
    for (let c = 0; c < numCols; c++) {
      rows.push([
        now, email, sheet.getName(),
        range.getCell(r + 1, c + 1).getA1Notation(),
        "(複数セル編集のため取得不可)",
        values[r][c],
      ]);
    }
  }
  if (rows.length > 0) {
    logSheet.getRange(logSheet.getLastRow() + 1, 1, rows.length, 6).setValues(rows);
  }
}

// 監視したいシートと列を1か所にまとめる
// 値の配列が空なら「全列を記録」、番号を入れると「その列だけ記録」(1始まり)
const WATCH_CONFIG = {
  "受注データ": [3, 5], // C列・E列だけ記録
  "顧客マスタ": [],     // 全列を記録
};

function onEditLogger(e) {
  if (!e || !e.range) return;

  const sheet = e.range.getSheet();
  const config = WATCH_CONFIG[sheet.getName()];
  if (config === undefined) return; // 監視対象外のシートは無視

  const col = e.range.getColumn();
  if (config.length > 0 && config.indexOf(col) === -1) return; // 対象外の列は無視

  const logSheet = getOrCreateLogSheet(e.source);
  logSheet.appendRow([
    new Date(),
    getEditorEmail(e),
    sheet.getName(),
    e.range.getA1Notation(),
    e.oldValue == null ? "" : e.oldValue,
    e.value == null ? "" : e.value,
  ]);
}

// この関数を一度だけ手動実行すると、インストール型トリガーが登録される
function createOnEditTrigger() {
  const ss = SpreadsheetApp.getActive();

  // 二重登録を防ぐため、既存の同名トリガーを先に削除する
  ScriptApp.getProjectTriggers().forEach((t) => {
    if (t.getHandlerFunction() === "onEditLogger") {
      ScriptApp.deleteTrigger(t);
    }
  });

  ScriptApp.newTrigger("onEditLogger")
    .forSpreadsheet(ss)
    .onEdit()
    .create();
}