GAS onEditの使い方｜編集時トリガーと動かない原因一覧

GAS（Google Apps Script）の onEdit は、スプレッドシートのセルの値を人が編集したときに自動で呼ばれる関数です。 スクリプトに function onEdit(e) { ... } と書いて保存するだけで動き、引数 e（イベントオブジェクト）から、編集されたセルの範囲や編集後の値を受け取れます。

この記事では、まず「onEdit が動かない」ときの原因を確認表で切り分け、そのあとにシンプルトリガー・インストール型の編集トリガー・onChange の違いと選び方、e の中身の一覧、特定シートの特定列だけで動くタイムスタンプ自動入力のコードを順に示します。時間で動かすトリガーは扱わず、編集イベントに絞っています。

確認環境：トリガーの仕様・イベントオブジェクトの項目・上限値は、Google 公式の Apps Script ドキュメント（Simple Triggers／Installable Triggers／Event Objects／Quotas）を 2026-10-06 に開いて確認しました。メソッド名と引数は型定義パッケージ @types/google-apps-script 2.0.13 と照合しています。コードは Node.js 22.22.2 で構文を確かめ、スプレッドシートとイベントオブジェクトをまねた簡易モックに入力を渡して、条件分岐と書き込み先の範囲を確認しました。記事中の「モックでの確認結果」はその出力です。

この記事の結論

• onEdit が動かないときは、①人の手による編集ではない変更（スクリプト・API）、②認証が必要なサービスの呼び出し、③30秒の上限、④関数名の違いのどれかに当たることがほとんどです。
• メール送信や他のファイルの操作をしたいなら、インストール型の編集トリガーに切り替えます。セルに日時を入れる程度ならシンプルトリガーの onEdit で足ります。
• 行や列の追加・削除といった構造の変更を拾いたいなら onChange（変更トリガー）を使います。
• 複数セルの貼り付けにも対応させるなら、e.value に頼らず e.range から値を読む書き方にします。

onEditが動かない原因の早見表

表の上から2つは、公式ドキュメントの「Script executions and API requests don't cause triggers to run.（スクリプトの実行と API リクエストではトリガーは動かない）」という制限と、onEdit の説明「ユーザーがスプレッドシートの値を変更したときに動く」に基づいています。公式の例でも、Range.setValue() でセルを編集しても onEdit は動かないと明記されています。

onEditの基本：書いて保存するだけで動く

スプレッドシートのメニュー「拡張機能」→「Apps Script」でエディタを開き、次のコードを貼り付けて保存します。トリガーの登録は要りません。onEdit は Apps Script が予約している関数名で、同じ仲間に onOpen、onInstall、onSelectionChange、doGet、doPost があります。

function onEdit(e) {
  const range = e.range;
  console.log('シート名: ' + range.getSheet().getName());
  console.log('編集範囲: ' + range.getA1Notation());
  console.log('行数×列数: ' + range.getNumRows() + '×' + range.getNumColumns());
  console.log('value: ' + e.value);
  console.log('oldValue: ' + e.oldValue);
}

セルを編集したあと、エディタ左の「実行数」（Executions）を開くと、実行の一覧と状態を確認できます。イベントオブジェクトをまねた入力を3通り渡したときの、モックでの確認結果は次のとおりです。

（C2 を「未着手」から「作業中」に書き換えた場合の入力）
シート名: タスク
編集範囲: C2
行数×列数: 1×1
value: 作業中
oldValue: 未着手

（C3 の値を消した場合の入力）
編集範囲: C3
行数×列数: 1×1
value: undefined
oldValue: 作業中

（C2:C4 の3セルをまとめて編集した場合の入力。value と oldValue を持たない）
編集範囲: C2:C4
行数×列数: 3×1
value: undefined
oldValue: undefined

エディタの「実行」ボタンでこの関数を直接動かすと、e が渡されないため、1行目の e.range で次のエラーになります（Node.js 22 で引数なしで呼んだ結果）。

TypeError: Cannot read properties of undefined (reading 'range')

これはコードの誤りではなく、編集というきっかけが無いまま呼んだことによるものです。動作はシート上でセルを編集して確かめます。

イベントオブジェクト e の中身一覧

公式ドキュメントの「Event Objects」に載っている、スプレッドシートの編集イベントの項目です。

e.range から場所を調べるメソッドは、次の5つを覚えておくと足ります。

シンプルトリガー・インストール型・onChangeの違い

編集をきっかけにするトリガーは3種類あります。関数名を onEdit にするだけで動くのがシンプルトリガー、トリガー画面やコードで登録するのがインストール型です。

onChange の e.changeType に入る値は、公式ドキュメントでは EDIT、INSERT_ROW、INSERT_COLUMN、REMOVE_ROW、REMOVE_COLUMN、INSERT_GRID、REMOVE_GRID、FORMAT、OTHER の9種類です。

どれを使うかの判断表

迷ったら、「セルを書き換えるだけならシンプル、メール送信や他ファイル操作があるならインストール型」と覚えると選びやすくなります。

コピペ用：特定シートの特定列だけで動くタイムスタンプ自動入力

「タスク」シートの C列（状態）が編集されたら、同じ行の D列（更新日時）に日時を入れるコードです。サンプルの表は次の形を想定しています。

const TARGET_SHEET = 'タスク'; // 動かしたいシート名
const WATCH_COL = 3;           // 監視する列（C列＝状態）
const STAMP_COL = 4;           // 日時を書く列（D列＝更新日時）
const HEADER_ROWS = 1;         // 見出しの行数

function onEdit(e) {
  if (!e || !e.range) return; // エディタから直接実行したときは何もしない

  const range = e.range;
  const sheet = range.getSheet();
  if (sheet.getName() !== TARGET_SHEET) return;

  // 編集範囲に監視列が含まれているか
  const firstCol = range.getColumn();
  const lastCol = firstCol + range.getNumColumns() - 1;
  if (WATCH_COL < firstCol || WATCH_COL > lastCol) return;

  // 見出し行を除いた行の範囲を求める
  const firstRow = Math.max(range.getRow(), HEADER_ROWS + 1);
  const lastRow = range.getRow() + range.getNumRows() - 1;
  if (lastRow < firstRow) return;
  const numRows = lastRow - firstRow + 1;

  // e.value は使わず、編集後の値をシートから読む（複数セルでも同じ書き方で動く）
  const values = sheet.getRange(firstRow, WATCH_COL, numRows, 1).getValues();
  const now = new Date();
  const stamps = values.map(row => [row[0] === '' ? '' : now]);

  sheet.getRange(firstRow, STAMP_COL, numRows, 1)
    .setValues(stamps)
    .setNumberFormat('yyyy/MM/dd hh:mm:ss');
}

先頭4行の定数を自分の表に合わせて書き換えれば、そのまま使えます。ポイントは3つです。

• シート名で絞る：sheet.getName() !== TARGET_SHEET のときはすぐ return します。onEdit はファイル内のどのシートの編集でも呼ばれるためです。
• 列は「範囲に含まれるか」で判定する：range.getColumn() === 3 だけで判定すると、B列からC列にまたがる貼り付けを拾えません。
• 値はシートから読み、まとめて書く：getValues と setValues を1回ずつにすると、行数が多い貼り付けでも30秒の上限に余裕が出ます。

モックに編集範囲を渡して、書き込み先がどうなるかを確認した結果です。

e.value と e.oldValue を使う書き方（1セルの編集だけを対象にする）

「状態が完了に変わったときだけ完了日を入れる」のように変化の前後を見たいときは、e.value と e.oldValue を使います。e.oldValue は1セルの編集でしか使えないため、先に行数と列数を確かめます。

const TARGET_SHEET = 'タスク';
const STATUS_COL = 3; // C列＝状態
const DONE_COL = 5;   // E列＝完了日

function onEdit(e) {
  if (!e || !e.range) return;
  const range = e.range;
  const sheet = range.getSheet();
  if (sheet.getName() !== TARGET_SHEET) return;

  // 1セルの編集だけを対象にする（e.value と e.oldValue を使うため）
  if (range.getNumRows() !== 1 || range.getNumColumns() !== 1) return;
  if (range.getColumn() !== STATUS_COL || range.getRow() === 1) return;

  const doneCell = sheet.getRange(range.getRow(), DONE_COL);
  if (e.value === '完了' && e.oldValue !== '完了') {
    doneCell.setValue(new Date()); // 「完了」に変わったときだけ日付を入れる
  } else if (e.value !== '完了') {
    doneCell.clearContent();       // 「完了」以外に戻したら（セルを空にした場合も）消す
  }
}

モックでの確認結果は次のとおりです。

複数セルの貼り付けでも完了日を入れたい場合は、前の節のコードのように e.range の行数ぶん getValues で読み、値が「完了」の行だけ日付を入れる形にします。その場合は編集前の値が分からないので、「完了日が空の行だけ書く」という条件に置き換えると、同じ目的を果たせます。

インストール型の編集トリガーに切り替える手順

メール送信のように認証が必要な処理は、インストール型の編集トリガーで動かします。切り替えは次の3段階です。

1. 関数名を onEdit 以外にする（例：notifyOnDone）。onEdit のままだと予約名としても呼ばれ、同じ編集で2回動くことになります。
2. トリガーを登録する。画面から行う方法と、コードで行う方法があります。
3. シートのセルを編集して、動作を確かめる。

画面から登録する

公式ドキュメントの手順は次のとおりです。

1. Apps Script のプロジェクトを開く
2. 左側の「トリガー」（目覚まし時計のアイコン）をクリックする
3. 右下の「トリガーを追加」をクリックする
4. 実行する関数と、トリガーの種類（スプレッドシートの編集時）を選んで設定する
5. 「保存」をクリックする

コードで登録する

次のコードを貼り付け、installEditTrigger をエディタから1回だけ実行します。同じトリガーを二重に作らないよう、登録済みかどうかを先に調べています。

const TARGET_SHEET = 'タスク';
const STATUS_COL = 3;
const NOTIFY_TO = 'leader@example.com'; // 通知先（例）

// インストール型の編集トリガーから呼ばれる関数（名前は onEdit 以外にする）
function notifyOnDone(e) {
  if (!e || !e.range) return;
  const range = e.range;
  const sheet = range.getSheet();
  if (sheet.getName() !== TARGET_SHEET) return;
  if (range.getNumRows() !== 1 || range.getNumColumns() !== 1) return;
  if (range.getColumn() !== STATUS_COL || range.getRow() === 1) return;
  if (e.value !== '完了' || e.oldValue === '完了') return;

  const row = range.getRow();
  const task = sheet.getRange(row, 1).getValue();
  const owner = sheet.getRange(row, 2).getValue();
  const subject = '【完了】' + task;
  const body = 'タスク「' + task + '」が完了になりました。\n担当: ' + owner + '\n行: ' + row;
  MailApp.sendEmail(NOTIFY_TO, subject, body);
}

// 1回だけ実行して、編集トリガーを登録する
function installEditTrigger() {
  const exists = ScriptApp.getProjectTriggers().some(t =>
    t.getHandlerFunction() === 'notifyOnDone' &&
    t.getEventType() === ScriptApp.EventType.ON_EDIT);
  if (exists) {
    console.log('登録済みのため何もしません');
    return;
  }
  ScriptApp.newTrigger('notifyOnDone')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();
  console.log('編集トリガーを登録しました');
}

// 登録を外す
function uninstallEditTrigger() {
  ScriptApp.getProjectTriggers()
    .filter(t => t.getHandlerFunction() === 'notifyOnDone')
    .forEach(t => ScriptApp.deleteTrigger(t));
  console.log('編集トリガーを削除しました');
}

モックで installEditTrigger を2回続けて呼び、そのあと状態を「完了」に変えた入力を渡した結果です。

編集トリガーを登録しました
登録済みのため何もしません
（登録されているトリガーの数: 1）

（C3 を「作業中」から「完了」にした入力 → 送信内容）
宛先: leader@example.com
件名: 【完了】発注書の確認
本文: タスク「発注書の確認」が完了になりました。
担当: 鈴木
行: 3

（C3 を「完了」から「作業中」に戻した入力 → 送信なし）

インストール型で知っておきたい点を、公式ドキュメントの記載からまとめます。

上限値は変わることがあるため、公式の「Quotas for Google Services」で最新の値を確認してください。

onChangeで行・列の追加や削除を拾う

行の挿入や削除は「値の編集」ではなく「構造の変更」なので、変更トリガーで受け取ります。e.range は無いので、e.changeType で種類を見て、必要ならシートを読み直します。

// 変更トリガーから呼ばれる関数
function logChange(e) {
  console.log('変更の種類: ' + e.changeType);
  if (e.changeType === 'INSERT_ROW' || e.changeType === 'REMOVE_ROW') {
    console.log('行の増減がありました。行数: ' + e.source.getSheetByName('タスク').getLastRow());
  }
}

// 1回だけ実行して、変更トリガーを登録する
function installChangeTrigger() {
  const exists = ScriptApp.getProjectTriggers().some(t =>
    t.getHandlerFunction() === 'logChange' &&
    t.getEventType() === ScriptApp.EventType.ON_CHANGE);
  if (exists) return;
  ScriptApp.newTrigger('logChange')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onChange()
    .create();
}

モックに changeType を渡したときの確認結果です。

（changeType が INSERT_ROW の入力）
変更の種類: INSERT_ROW
行の増減がありました。行数: 5

（changeType が FORMAT の入力）
変更の種類: FORMAT

確かめて分かったこと

• インストール型に切り替えても、スクリプトや API による変更では動きません。 公式の制限は、シンプルトリガーとインストール型の両方のページに同じ文で書かれています。スクリプトが書き換えた結果に反応させたいときは、書き換えた関数から処理を直接呼びます。
• e.oldValue が undefined になる場面は2つあります。 編集範囲が複数セルのときと、元が空のセルを編集したときです。「空から完了になった」も拾えるよう、e.oldValue !== '完了' のように「完了ではなかった」という条件で書くと両方を扱えます。
• e.value はセルを空にしたとき undefined になります。 e.value === '' では判定できないため、e.value === undefined か、シートから読んだ値が '' かで判定します。
• onChange のイベントオブジェクトには range が無いため、どのセルが変わったかは分かりません。値の編集の場所を知りたいときは編集トリガー、構造の変更を知りたいときは変更トリガー、と役割を分けます。
• シンプルトリガーの30秒は、スクリプト全体の6分とは別の上限です。 セルを1つずつ読み書きするループは時間がかかるので、範囲でまとめて扱う書き方が向いています。
• 列の判定を「先頭の列が一致するか」だけにすると、2列にまたがる貼り付けを拾えません。 モックで B2:C3 を渡したところ、「範囲に含まれるか」の判定で D2:D3 に書き込まれることを確認できました。

公開前のチェックリスト

よくある質問

Q. onEdit とは何ですか？ A. スプレッドシートのセルの値をユーザーが変更したときに、自動で呼ばれる Apps Script の関数です。function onEdit(e) と書いて保存するだけで動き、登録の操作は要りません。

Q. onEdit とインストール型の編集トリガーの違いは？ A. 認証が必要なサービスを使えるかどうかが一番の違いです。シンプルトリガーの onEdit はメール送信や他のファイルの操作ができず30秒までですが、インストール型はトリガーを作成した人のアカウントで動き、それらの処理を行えます。

Q. onEdit でメールを送れないときは？ A. インストール型の編集トリガーに切り替えると送れます。関数名を onEdit 以外に変え、トリガー画面か ScriptApp.newTrigger('関数名').forSpreadsheet(...).onEdit().create() で登録します。

Q. スクリプトで setValue した変更に onEdit を反応させるには？ A. トリガーでは反応しないため、setValue を呼んだ関数の中から同じ処理を直接呼びます。この制限はシンプルトリガーにもインストール型にも当てはまります。

Q. 複数セルを貼り付けたとき e.value が使えない場合は？ A. e.range から行数と列数を取り、getValues() で編集後の値を読みます。この記事のタイムスタンプのコードは、1セルでも複数セルでも同じ書き方で動く形にしています。

まとめ

• onEdit は人がセルの値を編集したときに動く。スクリプトや API による変更では動かない
• 動かないときは、変更のきっかけ・認証が必要なサービス・30秒の上限・関数名の順に確かめる
• メール送信や他ファイルの操作はインストール型の編集トリガーで行う。関数名は onEdit 以外にする
• 行や列の追加・削除は onChange。イベントオブジェクトは changeType を持ち、range は持たない
• e.oldValue は1セルの編集のときだけ使える。e.value はセルを空にすると undefined
• 複数セルの貼り付けに対応するなら、e.range の行数ぶん getValues で読み、setValues でまとめて書く
• インストール型のトリガーは1ユーザー・1スクリプトあたり20個まで。登録前に重複を調べる

参考・出典

• Google Apps Script「Simple Triggers」 https://developers.google.com/apps-script/guides/triggers （2026-10-06 閲覧。予約されている関数名、制限事項）
• Google Apps Script「Installable Triggers」 https://developers.google.com/apps-script/guides/triggers/installable （2026-10-06 閲覧。編集トリガーと変更トリガーの違い、登録手順、制限事項）
• Google Apps Script「Event Objects」 https://developers.google.com/apps-script/guides/triggers/events （2026-10-06 閲覧。編集イベント・変更イベントの項目）
• Google Apps Script「Quotas for Google Services」 https://developers.google.com/apps-script/guides/services/quotas （2026-10-06 閲覧。実行時間、トリガーの数と合計実行時間、メールの宛先数）
• Google Apps Script「Logging」 https://developers.google.com/apps-script/guides/logging （2026-10-06 閲覧。実行の一覧の開き方）
• Google Apps Script「Extending Google Sheets」 https://developers.google.com/apps-script/guides/sheets （2026-10-06 閲覧。エディタの開き方）
• 型定義パッケージ @types/google-apps-script 2.0.13（npm。ScriptApp・SpreadsheetTriggerBuilder・Range のメソッド名と引数）

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。