Google Apps Scriptリファレンス: イベント処理

一定の間隔で処理を実行する

一定の間隔で処理を実行する場合は、「トリガー」を下記手順で設定をする。「現在の
プロジェクトのトリガー」画面を表示する迄の手順は、今まで同様割愛する。


設定方法は、「現在のプロジェクトのトリガー」画面について、下記要領でにて各ドロップ
ダウンリストの値を指定する :

・実行 : 実行したい function を選択する
・イベントの一つ目のドロップダウン : 「時間主導型」を選択
・イベントの二つ目のドロップダウン : 「時タイマー」、または、「分タイマー」を選択
・時間間隔設定のテキストボックス : 指定したい間隔を選択する。


下図は実際の設定画面である。この例の場合は、30 分間隔で処理が実行されるよう設定
を行っている :

毎日定刻に処理を実行する

毎日、特定の時刻に処理を実行する場合は、「トリガー」を下記手順で設定をする。「現在
のプロジェクトのトリガー」画面を表示する迄の手順は、今まで同様割愛する。


設定方法は、「現在のプロジェクトのトリガー」画面について、下記要領でにて各ドロップ
ダウンリストの値を指定する :

・実行 : 実行したい function を選択する
・イベントの一つ目のドロップダウン : 「時間主導型」を選択
・イベントの二つ目のドロップダウン : 「日タイマー」を選択
・時刻設定のテキストボックス : 指定したい時間帯を選択する。


下図は実際の設定画面である。この例の場合は、毎日の午後 2 時から 3 時の間に処理が
実行されるよう設定を行っている :

特定の曜日・時間に処理を実行する

特定の曜日・時間に処理を実行する場合は、「トリガー」を下記手順で設定をする。但し、
「現在のプロジェクトのトリガー」画面を表示する迄の手順は、『スプレッドシートが開くとき
にスクリプトを実行する』の項で記した方法と同一なので割愛する。


設定方法は、「現在のプロジェクトのトリガー」画面について、下記要領でそれぞれの
ドロップダウンリストの値を選択する :

・実行 : 実行したい function を選択する
・イベントの一つ目のドロップダウン : 「時間主導型」を選択
・イベントの二つ目のドロップダウン : 「週タイマー」を選択
・イベントの三つ目のドロップダウン : 指定したい曜日を選択する。
・時刻設定のテキストボックス : 指定したい時間帯を選択する。


下図は実際の設定画面である。この例の場合は、毎週火曜日の午前 5 時から 6 時の間
に処理が実行されるよう設定を行っている :

特定の日時に処理を実行する

特定の日時に処理を実行する場合は、「トリガー」を下記手順で設定を行う。但し、「現在
のプロジェクトのトリガー」画面を表示する迄の手順は、『スプレッドシートが開くときにスク
リプトを実行する』の項で記した方法と同一なので割愛する。


設定方法は、「現在のプロジェクトのトリガー」画面について、下記要領でそれぞれのドロップ
ダウンリストの値を選択する :

・実行 : 実行したい function を選択する
・イベントの一つ目のドロップダウン : 「時間主導型」を選択
・イベントの二つ目のドロップダウン : 「特定の日時」を選択
・日時設定のテキストボックス : YYYY-MM-DD HH:MM 形式で日時を指定


実際の設定画面は下図の通り :

スプレッドシートが開くときにスクリプトを実行する

スプレッドシートが開くときにスクリプトを実行するためには「トリガー」の設定を行う必要が
ある。先ずは、下記コードを準備する。メッセージボックスにメッセージ「開いたよ!!」と表示
させるだけの単純なものである。


function ShowMessage() {
Browser.msgBox("開いた!!");
}


コードを書いて保存したら、メニューの「リソース」→「現在のスクリプトのトリガー」を選択する :

トリガーが何も設定されていない場合は、

「 トリガーが設定されていません。今すぐ追加するにはここをクリックしてください。 」

と書かれてある部分をクリックし、既にトリガーを一つ以上設定している場合は

「新しいトリガーを追加」

の部分をクリックする(下図はトリガーが一つも設定されていない場合) :