【GAS：Google Apps Script】トリガーの種類

GAS（Google Apps Script）の記事を書いていてよく「トリガー」というキーワードでの流入が多いので、
今回はトリガーの種類について説明します。

トリガーは様々な種類があるのでどれを使っていいいかわからない…なんてことがありますよね。
一覧にまとめてみましたので参考にしてください！！

「まとめサイトが見つからない。。。」
そんな思いにこたえることができれば幸いです！

トリガーとは？

トリガー（Trigger）とは、何かを引き金に処理を実行する仕組みです。

スプレッドシートを編集したら実行されるもの、スプレッドシートを開いたら実行されるもの、
カレンダーのイベントを作成したら実行されるもの、フォームを送信したら実行されるものなど様々です。

トリガーの種類を見ていく前にどのようなイベントソースがあるのか、スクリプトの種類と合わせて説明します。

イベントソース	スクリプトの種類
スプレッドシートから	スプレッドシートに属したスクリプト
ドキュメントから	ドキュメントに属したスクリプト
フォームから	フォームに属したスクリプト
時間主導型	スプレッドシートに属したスクリプトドキュメントに属したスクリプトフォームに属したスクリプトスタンドアローンなスクリプト
カレンダーから	スプレッドシートに属したスクリプトドキュメントに属したスクリプトフォームに属したスクリプトスタンドアローンなスクリプト

では、実際にイベントのソースごとにどのようなトリガーがあるのか見てみましょう！

イベントの種類	どのようなイベントか？
起動時	スプレッドシートを開いた直後に実行される
変更時	スプレッドシートを変更した際に実行される代表例として以下の操作が該当するセルの値の変更行や列の追加・削除罫線の変更
編集時	スプレッドシートのセル上の値を変更した際に実行される基本的には編集しても値が変更されなければ実行されない
フォーム送信時	スプレッドシートにフォームからの送信があったときに実行される

イベントの種類	どのようなイベントか？
起動時	ドキュメントを開いた直後に実行される

イベントの種類	どのようなイベントか？
起動時	スプレッドシートを開いた直後に実行される
フォーム送信時	フォームからの送信があったときに実行される（スプレッドシートへの書き込みがある場合は、スプレッドシートへの書き込み後に実行される）

時間ベースのトリガータイプ	設定可能な値
特定の日時	YYYY-MM-DD HH:MM形式で日時を指定
分ベースのタイマー	1分おき 5分おき 10分おき 15分おき 30分おき
時間ベースのタイマー	1時間おき 2時間おき 4時間おき 6時間おき 8時間おき 12時間おき
日付ベースのタイマー	「午前0時～1時」のように1時間刻み ※ 大体その間に実行されるという大まかな設定しかできない
週ベースのタイマー	「毎週〇曜日」＋「午前0時～1時」のように1時間刻み
月ベースのタイマー	毎月「〇日」＋「午前0時～1時」のように1時間刻み

カレンダーの詳細	どのようなイベントか？
カレンダー更新済み	指定したカレンダーが更新された場合に実行される（作成・更新・削除が該当する）