G-gen の kiharu です。当記事では、Google Apps Script のトリガーイベント「編集」と「変更」の違いについて解説します。

はじめに

Google Apps Scriptとは

Google Apps Script（以下、GAS）は、Google のサービス（Google スプレッドシート、ドキュメント、スライドなど）を自動化、拡張できるクラウドベースのプラットフォームです。
JavaScript ベースで、Google アプリケーションと連携したカスタム機能を簡単に作成できます。

参考 : Apps Script

GAS のトリガー

トリガーとは、GAS のスクリプトが実行される契機となる設定です。トリガーを設定することで、Google スプレッドシートの値が変更されたときや、特定の時刻になったときなど、指定したイベントを契機として自動的にスクリプトが実行されます。

GAS のトリガーには大きく分けて以下の2種類あります。

シンプルなトリガー
インストール可能なトリガー

どちらも特定のイベントに基づいてスクリプトを自動実行しますが、以下のように使い方と特徴が異なります。

	シンプルなトリガー	インストール可能なトリガー
使い方	用途に応じた関数名のいずれかを使用して関数を作成する（onOpen、onEdit など）	ユーザーが明示的に設定画面から設定する
特徴	スプレッドシート等を操作しているユーザーのアカウントで実行される	常にトリガー設定時に認証したユーザーのアカウントで実行される

インストール可能なトリガーでは、新規トリガーを設定する際の最初の1回だけ、認証が求められます。トリガーが起動すると、設定時に認証したユーザーのアカウントの認証情報でスクリプトが実行されます。

参考 : シンプルなトリガー
参考 : インストール可能なトリガー

検知できるイベントタイプ

「シンプルなトリガー」と「インストール可能なトリガー」では、検知できるイベントが異なります。

例えば、スプレッドシートでの「変更」イベントはシンプルなトリガーでは検知できず、インストール可能なトリガーで定義する必要があります。当記事では、その中でも「編集」と「変更」の違いについて解説します。

参考 : 使用可能なトリガーの種類

「編集」と「変更」の違い

「編集」と「変更」、この２つの言葉だけをみて具体的に使い分けるのは難しいと思います。以下に違いをまとめました。

	編集	変更
検知する操作	スプレッドシートの "値" を変更したとき	スプレッドシートの "構成" を変更したとき
ユーザーのアクセス	要	不要
取得できる情報	* 認証モード * トリガーが検知されたファイル * 検知したトリガーID * どのユーザー権限で実行されたか * 編集前のセル値 * 編集後のセルの値 * 編集されたセルまたは範囲	* 認証モード * トリガーが検知されたファイル * 検知したトリガーID * どのユーザー権限で実行されたか * 変更の種類（行追加、値の変更など）