GASのトリガーの使い方｜毎日決まった時刻・編集時に自動で実行する

GASのトリガーとは

GAS で集計やメール送信のスクリプトを作っても、毎回 [実行] を押していては手間は半分しか減りません。トリガーを付けると、決めたきっかけで関数が自動で動くようになり、人が何もしなくても処理が回ります。

トリガーには、関数の名前を決まった形にするだけで動く「シンプルトリガー」と、画面やコードで設定する「インストール型トリガー」の 2 種類があります。

公式ガイドによると、シンプルトリガーは許可が必要なサービスを使えず、30 秒を超えて動けません。メールを送る・別のファイルを書き換えるといった処理には、インストール型トリガーを使います。

インストール型トリガーの種類

画面でトリガーを設定する手順

公式ガイドの手順です。毎朝 9 時台に dailyReport という関数を動かす例で説明します。

1. トリガーの画面を開く

   Apps Script の画面の左側で [トリガー] (時計のアイコン) を押します。

2. トリガーを追加する

   右下の [トリガーを追加] を押します。

3. 関数ときっかけを選ぶ

   実行する関数に dailyReport、イベントのソースに「時間主導型」、タイプに「日付ベースのタイマー」、時刻に「午前 9 時〜10 時」を選びます。

4. 保存する

   [保存] を押します。初めてのときは、スクリプトがアクセスする範囲の許可を求められるので、自分のアカウントで許可します。

コードでトリガーを作る・消す

トリガーはコードからも作れます。設定を作り直すたびに画面を操作しなくて済み、どんな設定にしたかがコードに残るので、引き継ぎにも向いています。

const HANDLER = "dailyReport";

function setupTrigger() {
  ScriptApp.getProjectTriggers()
    .filter((trigger) => trigger.getHandlerFunction() === HANDLER)
    .forEach((trigger) => ScriptApp.deleteTrigger(trigger));

  ScriptApp.newTrigger(HANDLER)
    .timeBased()
    .atHour(9)
    .everyDays(1)
    .inTimezone("Asia/Tokyo")
    .create();
}

function dailyReport() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("ログ");
  sheet.appendRow([new Date(), "毎朝の処理が動きました"]);
}

setupTrigger を 1 回だけ手で実行すると、毎日 9 時台に dailyReport が動くトリガーができます。最初に同じ関数のトリガーを消してから作っているので、何度実行してもトリガーが重複しません。dailyReport の中身は、自分の処理に書き換えてください。

よく使う時間の指定

公式リファレンスによると、everyMinutes に指定できるのは 1・5・10・15・30 のどれかです。nearMinute(45) を付けると、動く分を 45 分の前後 15 分の幅に寄せられます。

編集されたときに動かす (onEdit)

シートが編集されたときに処理をするだけなら、シンプルトリガーの onEdit が手軽です。スプレッドシートに紐づいたスクリプトに次の関数を書くだけで、トリガーの設定は要りません。

function onEdit(e) {
  const range = e.range;
  const sheet = range.getSheet();
  if (sheet.getName() !== "案件" || range.getColumn() !== 3) return;

  sheet.getRange(range.getRow(), 4).setValue(new Date());
}

この例では、「案件」シートの C 列 (状況) が書き換えられたら、同じ行の D 列に更新日時を入れます。e.range は編集されたセルの範囲です。

動かないとき・止まったときの確認点

• 時刻がずれる: 公式ガイドによると、9 時の設定は 9 時から 10 時の間のどこかで動き、以後は毎日ほぼその時刻に動きます。ぴったりの時刻が必要な用途には向きません。
• 失敗したかを知りたい: トリガーの処理が失敗すると、作った人に「Summary of failures for Apps Script」という件名のメールが届きます。Apps Script の画面の左側の [実行数] で、失敗の内容を確かめられます。
• 人が変わったら動かない: インストール型トリガーは、作った人のアカウントで動きます。作った人が退職してアカウントが止まると動かなくなるため、業務では共用のアカウントで作っておきます。
• ほかの人のトリガーが見えない: 別のアカウントが作ったトリガーは自分の画面には出ませんが、動いてはいます。同じ処理が二重に動いていないか、作った人に確かめます。

公式の割り当ての一覧のとおり、個人のアカウントでは 1 日のトリガーの実行時間が合計 90 分までです。15 分ごとに数分かかる処理を回すと、すぐに上限に届くので、間隔は必要な分だけにします。

自分で作るのが難しいときは

トリガーを付ければ、毎朝の集計や通知を人の手から離せます。ただ、処理が増えると「どのトリガーが何を動かしているか誰もわからない」「作った人の異動で止まっていたのに気づかなかった」といったことが起きやすくなります。

止まったときに通知する仕組みや、複数の処理をまとめて管理する形まで含めて作り直したい場合は、シートナビの相談フォームからお気軽にご相談ください。

よくある質問