【GAS入門#22】セルを書き換えたら自動実行!onEdit(e)の使い方とイベントオブジェクトの活用法

前回(第21回)は、スプレッドシートを開いた瞬間にオリジナルメニューを自動追加する onOpen(e) を学びました。

第22回となる今回は、スプレッドシートのセルが書き換えられた(編集された)瞬間に、プログラムを自動実行させる onEdit(e)(オン・エディット)を徹底解説します!

「セルに値を入力してEnterキーを押した瞬間に、隣のセルに自動で日付を入力したい」

「入力ミスを防ぐために、特定の列が書き換えられたら自動でチェックを走らせたい」

こうした「人間がボタンを押さなくても、シートが勝手に気を利かせて動いてくれる仕組み」を実現するのが onEdit(e) です。

今回は、プログラミングが初めての方でも挫折しないよう、「イベントオブジェクト e」の正体から、札幌の積雪量記録簿を使った実践ハンズオン、そして初心者が100%つまずくエラーの抜け出し方まで、どこよりも詳しく丁寧に噛み砕いて解説します!

1. そもそも onEdit(e) とは?

onEdit(e) は、GASに最初から用意されている 「シンプルトリガー(Simple Trigger)」 という特別な機能の一つです。

トリガー(Trigger)とは、英語で「引き金」という意味。つまり、「〜という出来事が起きたら、自動でプログラムの引き金をひく(実行する)」 という仕掛けのことです。

「ボタンを押す」作業すら自動化できる!

これまでの連載では、コードを書いたあとにエディタの「実行」ボタンを押したり、スプレッドシート上に置いた図形ボタンをクリックしてプログラムを動かしていましたよね。

しかし onEdit(e) を使うと、Googleがあなたのスプレッドシートを24時間監視してくれて、「ユーザーがセルを手動で書き換えてEnterを押した瞬間」 を自動で検知し、裏側で即座にGASを起動してくれます。

2. 一番の難所「イベントオブジェクト e」を世界一わかりやすく解説!

onEdit(e) のコードを書くときに、全員が最初に首をかしげるのがカッコの中にある (e) という一文字です。

function onEdit(e) {
  // このカッコの中の「e」って一体なに…?
}

この e は、プログラミング用語で 「イベントオブジェクト(Event Object)」 と呼びます。難しそうな名前ですが、イメージとしては 「Googleから届く情報満載の宅配ダンボール箱」 だと思ってください!

ダンボール箱 e の中身とは?

セルが編集された瞬間、Googleは「誰が、どのシートの、どのセルを、どんな値からどんな値へ書き換えたのか」という詳細な報告書を作成し、ダンボール箱 e に詰めてプログラムに届けてくれます。

私たちは、この箱 e の中身を取り出すことで、「あ、今A列の2行目が書き換えられたんだな!」と判断できるわけです。

よく使う e の中身(プロパティ)一覧表

プロパティ名(箱のラベル)どんな情報が入っている?取得できる値の例
e.range編集された「セルそのもの」(Rangeオブジェクト)A2セル、B5セルなど
e.value編集された後の新しい値(文字列)"15"(変更後の値)
e.oldValue編集される前の古い値(文字列)"10"(変更前の値)
e.source編集されたスプレッドシート全体(Spreadsheet)ファイル全体の情報
e.user編集したユーザーのメアド(※権限制限あり)user@example.com

特に重要なのが e.range と e.value です!この2つを使うことで、「どのマス目が」「何に変更されたか」を自由自在に読み取ることができます。

3. 【実践ハンズオン】積雪量が更新されたら隣のセルに「更新日時」を自動記録しよう!

それでは、実際に手を動かしてプログラムを作ってみましょう!

札幌の冬といえば、毎朝の積雪量チェックが欠かせませんよね(笑)。 今回は「札幌市内の積雪量記録簿」を作成し、B列(積雪量)の数値が更新されたら、自動的にC列(更新日時)へ現在の日時(タイムスタンプ)を書き込む システムを作ります。

STEP 1:スプレッドシートの準備

  1. 新しいGoogleスプレッドシートを作成し、ファイル名を 「札幌積雪量チェック」 にします。
  2. 画面下のシートタブ名を 「積雪記録」 に変更します。
  3. 1行目に見出し(ヘッダー)を以下のように入力します。
    • A1: 観測エリア(例:中央区、北区、手稲区)
    • B1: 現在の積雪量(cm)
    • C1: 最終更新日時
  4. 2行目に初期データを入力しておきます。
    • A2: 中央区
    • B2: 15
    • C2: (空欄のままでOK)

STEP 2:GASエディタにコードを入力する

  1. スプレッドシートの上部メニューから 「拡張機能」 > 「Apps Script」 をクリックします。
  2. もともと書かれている function myFunction() { ... } をすべて消して真っ白にします。
  3. 以下のコードをそのままコピー&ペーストしてください。
/**
 * セルが手動で編集されたときに自動実行される関数
 * @param {Object} e - Googleから届く編集情報のダンボール箱(イベントオブジェクト)
 */
function onEdit(e) {
  // ---------------------------------------------------
  // 1. 安全装置(ガード節):無関係な編集は即座に無視する
  // ---------------------------------------------------
  
  // 編集されたシートを取得
  var sheet = e.range.getSheet();
  
  // シート名が「積雪記録」ではない場合は、ここで処理をストップして終了する
  if (sheet.getName() !== "積雪記録") {
    return;
  }
  
  // 編集されたセルの「行番号」と「列番号」を取得
  var editedRow = e.range.getRow();      // 例:2行目なら 2
  var editedColumn = e.range.getColumn(); // 例:B列(2列目)なら 2

  // ---------------------------------------------------
  // 2. 目的のセルが編集されたかチェックして処理を実行
  // ---------------------------------------------------
  
  // 「B列(2列目)」かつ「2行目以降(見出し以外)」が編集された場合のみ動かす
  if (editedColumn === 2 && editedRow >= 2) {
    
    // 編集された行と同じ行の「C列(4列目ではなく3列目)」を指定する
    var targetRange = sheet.getRange(editedRow, 3);
    
    // 現在の日時(JavaScriptのDateオブジェクト)をC列に自動書き込み!
    targetRange.setValue(new Date());
  }
}
  1. 画面上部にある 「保存アイコン(フロッピーディスクのマーク)」(または Ctrl + S / Cmd + S)を押して保存します。

STEP 3:コードを1行ずつ超丁寧に解説!

初心者の方がコードで挫折しないよう、重要パーツを噛み砕いて解説します!

① ガード節(Guard Clause)ってなに?

if (sheet.getName() !== "積雪記録") {
  return;
}

onEdit(e) は、シート上のどのセルがいじられても毎回起動してしまいます。関係ない別シートや関係ない列を触ったときにまでプログラムが最後まで動くと、動作が重くなる原因になります。 そこで「関係ないシートだったら return;(ここで回れ右して終了してね)」というガードマン(安全装置)を設置しています。

② セルの位置を数値で調べる

var editedRow = e.range.getRow();
var editedColumn = e.range.getColumn();

e.range.getRow() は「編集されたセルの行番号(縦の数字)」、e.range.getColumn() は「列番号(横の英字を数値にしたもの。A=1, B=2, C=3…)」を教えてくれます。 これにより、「今書き換えられたのはB列(2列目)の2行目だな!」と正確に特定できます。

③ 同じ行の「隣のセル」にアクセスする

var targetRange = sheet.getRange(editedRow, 3);

第4回で学んだ sheet.getRange(行, 列) の数値指定テクニックです!

editedRow(編集された行)をそのまま使うことで、例えば2行目が編集されたら「2行目の3列目(=C2セル)」、5行目が編集されたら「5行目の3列目(=C5セル)」というように、動的に隣のセルを掴むことができます。

STEP 4:実際の動作を確認してみよう!

保存ができたら、スプレッドシートの画面に戻ります。

  1. B2セル の積雪量「15」を 「20」 に書き換えて、Enterキー を押してみましょう。
  2. すると…! 一瞬のタイムラグのあと、C2セル に自動的に 2026/09/22 10:41:55(現在の日時)が自動入力されます!

ボタンを一切押していないのに、セルをいじっただけでGASが裏で働いてくれました。感動的ですよね!

4. 実務で超役立つ!onEdit(e) の応用テクニック

基本がマスターできたら、実務でよく使われる応用テクニックも見てみましょう。

応用①:「編集前の値」と「編集後の値」をチェックする

イベントオブジェクト e を使えば、変更前後の値を比較できます。

function onEdit(e) {
  var oldValue = e.oldValue; // 編集前の値
  var newValue = e.value;    // 編集後の値
  
  // 例:「10」から「50」へ急激に増えたら警告を表示する処理など
  if (oldValue && newValue) {
    Logger.log("値が " + oldValue + " から " + newValue + " へ変更されました");
  }
}

応用②:特定の文字が入力されたらセルの背景色を変える

例えば、積雪量が「50cm以上」と入力されたら危険信号としてセルを赤く染める、といった処理も可能です。

function onEdit(e) {
  var sheet = e.range.getSheet();
  if (sheet.getName() !== "積雪記録") return;

  var editedRow = e.range.getRow();
  var editedColumn = e.range.getColumn();

  // B列かつ2行目以降
  if (editedColumn === 2 && editedRow >= 2) {
    var amount = Number(e.value); // 入力された値を数値に変換
    
    if (amount >= 50) {
      // 50cm以上ならセルを薄い赤色にする
      e.range.setBackground("#fce8e6");
    } else {
      // 50cm未満なら背景色をリセット(無色)にする
      e.range.setBackground(null);
    }
  }
}

5. 初心者が100%ハマる!onEdit(e) の5大トラップと解決策

onEdit(e) は超便利ですが、仕組みを知らないとハマってしまう独特の罠(トラップ)があります。ここでしっかり予習しておきましょう!

トラップ1:エディタの「実行」ボタンを押すとエラーで怒られる!

GASエディタの画面で onEdit を選択し、上の「実行」ボタンを押すと…

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

という赤文字のエラーが必ず発生します。

【なぜ起きる?】

実行ボタンを押したとき、あなた自身は「セルを編集」していませんよね。そのため、ダンボール箱 e が送られてこず(undefined になり)、中身の e.range を読もうとしてエラーになります。

【解決策】

onEdit(e) はエディタの実行ボタンからテストすることはできません!必ずスプレッドシートの画面に戻り、手動でセルを書き換えてテストしてください。

トラップ2:関数(=SUM())の計算結果が変わっても反応しない!

セルA1に =SUM(B1:B10) という数式が入っているとします。B列の数値を書き換えてA1の計算結果が変わっても、onEdit は発火しません。

【なぜ起きる?】

onEdit が反応するのは、「人間が手動でキーボード入力や値の削除・変更をした瞬間」 だけです。数式による自動計算や、別のGASプログラム(setValue())による書き換えでは動かないルールになっています。

トラップ3:メール送信や外部API連携(LINE通知など)が動かない!

「ステータスが変更されたら、自動でGmailやLINEに通知を送りたい!」と思って GmailApp.sendEmail() などを onEdit の中に書くと、動かずに無視されるかエラーになります。

【なぜ起きる?】

onEdit は誰でも使える「シンプルトリガー」という権限の低いモードで動いています。悪意のあるスクリプトが勝手にメールを乱発しないよう、ユーザーの許可が必要な操作(メール送信・外部通信・Driveの権限変更など)は禁止されているのです。

【解決策】

メール送信やAPI連携を行いたい場合は、次回第23回で学ぶ 「インストール可能トリガー(ScriptApp.newTrigger())」 という設定方法を使う必要があります!

トラップ4:セルを「複数まとめて削除・コピペ」すると e.value が空になる!

1つのセルだけを書き換えたときは e.value に新しい値が入りますが、ドラッグして複数のセルをまとめて削除したり、範囲コピペした場合は e.value が undefined(空っぽ)になります。

【解決策】

複数セルの編集にも耐えられる強固なプログラムを作りたい場合は、e.value だけに頼らず、e.range.getValues() を使って範囲全体の値を配列として取得するコードを書く必要があります。

トラップ5:無条件に書くとシート全体が激重(激遅)になる!

ガード節(if 文によるチェック)を書かずに重い処理を記述すると、関係ないA1セルやD10セルをいじったときにも毎回裏でGASがフル回転してしまい、スプレッドシート全体の挙動がカクカク重くなってしまいます。

【解決策】

処理の1行目で、必ず「目的のシート名か?」「目的の列か?」を判定し、違ったらすぐに return; で処理を抜ける癖をつけましょう!

6. まとめ&次回予告

今回は、セル編集時に自動起動する onEdit(e) について詳しく解説しました。

  • onEdit(e) はセルが手動変更された瞬間に自動起動するシンプルトリガー
  • 引数 e(イベントオブジェクト)はGoogleから届く情報満載の報告書
  • コードの先頭に「ガード節(if判定)」を書いて無関係な編集を弾くのが鉄則
  • GASエディタの「実行」ボタンからはテストできない(シートで手動編集する)
  • メール送信などの強い権限が必要な処理は実行できない(シンプルトリガーの制限)

これで、スプレッドシートがまるで生き物のように自動で反応してくれる心地よさを体感していただけたかと思います!

しかし、先ほどのトラップ3でお伝えした通り、「毎朝7時に自動実行したい」「セルが更新されたらメールやSlackに通知したい」といった高度な自動化は、onEdit 単体ではセキュリティ制限に引っかかってしまいます。

そこで次回(第23回)は、これらの制限をすべて解き放ち、時間指定実行やメール送信を可能にする ScriptApp.newTrigger()(インストール可能トリガー) の使い方を徹底解説します!これぞGASの本領発揮です。ぜひお楽しみに!