onEditという名前の関数は、シンプルトリガーです。プロジェクトを保存すると、設定なしで、だれかがセルを編集するたびにSheetsがそれを実行します。関数はイベントオブジェクトを受け取り、普通はeと呼びます:
- e.rangeは、編集されたセルです。getSheet().getName()、getRow()、**getColumn()**で、それがどこにあるかがわかります。
- e.valueは新しい値、e.oldValueは前の値で、どちらもテキストです。チェックを入れたチェックボックスは、ブール値のtrueではなく**"TRUE"**として届きます。
- e.sourceはスプレッドシートで、ほかのタブに届くために使います。
onEditはファイル全体のすべての編集で実行されるので、ガード節から始めてください:編集が正しいタブ、列、行でなければ、何かをする前にreturnします。ガード節がないと、見出しの変更やほかのタブの編集でもコードが動いてしまいます。
シンプルトリガーでは、メールの送信のように許可が必要なことはできません。それにはインストール型トリガーが必要で、次のレッスンで扱います。この練習用のコピーでは、グリッドでの編集が保存したonEditを実行し、チェッカーが一連の編集をそれに通します。