GASトリガーの設定方法と種類一覧｜毎日決まった時刻に動かす

GAS（Google Apps Script）のトリガーとは、「ファイルを開いた」「決まった時刻になった」といったきっかけで、関数を自動で実行する仕組みです。 決まった名前の関数を書くだけで動くシンプルトリガーと、画面またはコードで登録するインストール型トリガーの2種類があり、毎日決まった時刻に動かす時間主導型はインストール型に含まれます。

この記事は時間主導型とトリガーの管理に絞り、毎日動かすための2通りのコード（作成・重複防止・削除つき）、種類の一覧、2種類の違いと選び方、公式の割り当て（数や実行時間の上限）をまとめます。

確認環境（確認日 2026-10-06）：メソッド名・引数・説明・割り当ての数値は Google 公式の Apps Script ドキュメントで確認し、型定義パッケージ @types/google-apps-script 2.0.13 とも照らし合わせました。コードの構文と、重複防止・次回日時の計算の動きは、ScriptApp を置き換えた簡易スタブを使い Node.js 22.22（タイムゾーン Asia/Tokyo）で実行しています。

この記事の結論

• 権限が要る処理や時刻での実行はインストール型、ファイルを開いたときのメニュー追加のような軽い処理はシンプルトリガーが向いています。
• トリガーは 1ユーザー・1スクリプトあたり20個まで、トリガーによる実行時間の合計は 1日90分（Google Workspace は6時間）までです。

GASトリガーの種類一覧

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

公式ガイドの手順は次の5つです。

1. Apps Script のプロジェクトを開く。
2. 左側の「トリガー」（時計のアイコン）をクリックする。
3. 右下の「トリガーを追加」をクリックする。
4. 作りたいトリガーの種類を選んで設定する。
5. 「保存」をクリックする。

毎日おおよその時刻に動かす（atHour と everyDays）

毎日9時台に動けば足りる処理は、この形がいちばん短く書けます。 setDailyTrigger を手動で1回実行すると登録されます。

function setDailyTrigger() {
  deleteTriggersOf('dailyJob');
  ScriptApp.newTrigger('dailyJob')
    .timeBased()
    .atHour(9)
    .everyDays(1)
    .inTimezone('Asia/Tokyo')
    .create();
}

function dailyJob() {
  console.log('毎日の処理を実行');
}

// 指定した関数のトリガーをすべて削除する
function deleteTriggersOf(functionName) {
  ScriptApp.getProjectTriggers()
    .filter(t => t.getHandlerFunction() === functionName)
    .forEach(t => ScriptApp.deleteTrigger(t));
}

押さえておきたい点は3つです。

• 最後の create() を呼ぶまで登録されません。
• atHour(9) は「9時ちょうど」ではありません。公式ガイドは、時刻は少しずらされることがあり、たとえば毎日9時のトリガーなら9時から10時の間の時刻が選ばれ、その後は毎日同じ時刻に実行されると説明しています。
• 先に deleteTriggersOf を呼んでいるので、setDailyTrigger を何度実行してもトリガーは1つのままです。

スタブで setDailyTrigger を3回続けて実行した後の登録内容は、次のとおり1件でした。

setDailyTrigger を3回実行 → [ 'dailyJob: atHour(9).everyDays(1).inTimezone("Asia/Tokyo")' ]

分まで指定して毎日動かす（at で翌日分を作り直す）

「毎日8時30分」のように分まで指定したいときは、日時を1つ指定する at(date) を使い、実行のたびに次回分を作り直します。 at で作るトリガーは1回分なので、処理の最後に次の日時で作り直すことで毎日の実行になります。

const RUN_HOUR = 8;
const RUN_MINUTE = 30;

// 最初に1回だけ手動で実行する
function startExactJob() {
  scheduleExactJob();
}

function exactJob() {
  try {
    console.log('分まで指定した処理を実行');
  } finally {
    scheduleExactJob(); // 処理がエラーで止まっても次回分を作る
  }
}

function scheduleExactJob() {
  deleteTriggersOf('exactJob');
  ScriptApp.newTrigger('exactJob')
    .timeBased()
    .at(nextRunDate(new Date(), RUN_HOUR, RUN_MINUTE))
    .create();
}

// now より後で、いちばん近い「時:分」の日時を返す
function nextRunDate(now, hour, minute) {
  const next = new Date(now.getFullYear(), now.getMonth(), now.getDate(), hour, minute, 0);
  if (next.getTime() <= now.getTime()) {
    next.setDate(next.getDate() + 1);
  }
  return next;
}

（deleteTriggersOf は前の節のものを使います。）

このコードが守っていることは次の3つです。

nextRunDate に 8時30分を指定したときの計算結果です。

2026-10-06 07:00 → 2026-10-06 08:30
2026-10-06 08:30 → 2026-10-07 08:30
2026-10-06 21:15 → 2026-10-07 08:30
2026-10-31 09:00 → 2026-11-01 08:30
2026-12-31 23:59 → 2027-01-01 08:30

月末や年末も setDate が繰り上げてくれます。スタブで startExactJob の後に exactJob を2回実行しても、exactJob のトリガーは1件のままでした。

2通りの選び方

timeBased のメソッド早見表

ScriptApp.newTrigger(関数名).timeBased() の後に続けて書くメソッドです。説明は公式リファレンス（ClockTriggerBuilder）の記載に沿っています。

よく使う組み合わせをまとめます。

// 10分ごと
ScriptApp.newTrigger('job').timeBased().everyMinutes(10).create();

// 6時間ごと
ScriptApp.newTrigger('job').timeBased().everyHours(6).create();

// 毎週月曜の9時台
ScriptApp.newTrigger('job').timeBased().onWeekDay(ScriptApp.WeekDay.MONDAY).atHour(9).create();

// 毎月1日の9時台
ScriptApp.newTrigger('job').timeBased().onMonthDay(1).atHour(9).create();

// 10分後より後に1回
ScriptApp.newTrigger('job').timeBased().after(10 * 60 * 1000).create();

new Date(2026, 9, 7, 8, 30) の月は0から数えるので 9 が10月、atDate(2026, 10, 7) の月は1から数えるので 10 が10月です。同じ「月」でも数え方が違う点に気をつけます。

シンプルトリガーとインストール型トリガーの違い

どちらにも共通する点として、閲覧専用（閲覧・コメントのみ）で開いたファイルでは動かず、スクリプトや API による変更はきっかけになりません。たとえばスクリプトがセルを書き換えても onEdit は動きません。

インストール型は作った人のアカウントで動くため、誰が作ったトリガーなのかをチームで共有しておくと、担当が替わったときの引き継ぎがなめらかになります。公式ガイドには、あるアカウントからほかのアカウントのトリガーは見えないとも書かれています。

トリガーの一覧表示と削除

// このプロジェクトで自分が作ったトリガーを一覧表示する
function listTriggers() {
  ScriptApp.getProjectTriggers().forEach(t => {
    console.log(`${t.getHandlerFunction()} / ${t.getEventType()} / ${t.getUniqueId()}`);
  });
}

// すべて削除する
function deleteAllTriggers() {
  ScriptApp.getProjectTriggers().forEach(t => ScriptApp.deleteTrigger(t));
}

getProjectTriggers が返すのは「現在のユーザー」の分です。ほかの人が作ったトリガーは、その人自身が削除することになります。

トリガーの数と実行時間の割り当て一覧

Google 公式の Quotas ページに載っている、トリガーに関係する値です（2026-10-06 に確認）。

同じページには、割り当てはユーザーごとで、最初のリクエストから24時間後にリセットされるとあります。

間隔を決めるときは、1回の実行時間 × 1日の回数を合計の枠と見比べます。次の表は Python で計算した値で、「1日90分」の枠で1回あたりに使える時間の目安です。

間隔  1日の回数   1回あたりに使える時間（90分の枠）
1分ごと    1440    3.75秒
5分ごと    288 18.75秒
10分ごと   144 37.5秒
30分ごと   48  112.5秒
1時間ごと   24  225秒

確かめて分かったこと

• atHour(9) は9時ちょうどを意味しません。 公式ガイドの例では、9時から10時の間で時刻が選ばれ、その後は毎日同じ時刻になります。
• nearMinute も前後15分の幅を持ちます。 公式リファレンスの説明は「指定した分の前後15分」で、分をぴったり合わせるメソッドではありません。
• everyMinutes に渡せる値は 1・5・10・15・30 の5つと公式リファレンスに明記されています。3分ごとや20分ごとにしたいときは、近い間隔で動かして関数の中で実行するかどうかを判断します。
• 1分ごとのトリガーは、1回あたり約3.75秒で90分の枠を使い切る計算になります。間隔を短くするほど、1回の処理を軽くする必要があります。
• 重複防止の関数を入れておくと、登録用の関数を3回実行してもトリガーは1件のままでした（スタブで確認）。
• Date の月は0始まり、atDate の月は1始まりです。

よくある質問

Q. GASのトリガーとは何ですか？ A. 特定のきっかけで関数を自動実行する仕組みです。関数名で決まるシンプルトリガーと、登録して使うインストール型トリガーがあり、時刻で動かせるのはインストール型の時間主導型です。

Q. トリガーが指定した時刻ちょうどに動かないのはなぜですか？ A. 時間主導型は実行時刻に幅を持つ仕様だからです。atHour は指定した1時間の中、nearMinute は前後15分の幅で動きます。開始時刻を分まで決めたいときは、at(日時) で1回分のトリガーを作り、実行のたびに次回分を作り直します。

Q. トリガーを削除できないときは何を確かめますか？ A. そのトリガーを作ったアカウントで操作しているかを確かめます。getProjectTriggers が返すのは現在のユーザーのトリガーだけなので、ほかの人が作ったものは一覧に出てきません。作った人に削除を依頼します。

Q. onEditとインストール型の編集トリガーの違いは何ですか？ A. 使える権限と実行時間が違います。シンプルトリガーの onEdit は承認が必要なサービスを使えず30秒までで、インストール型はトリガーを作った人の権限で動き、メール送信なども行えます。

まとめ

• トリガーはシンプルトリガーとインストール型トリガーの2種類です。
• 毎日おおよその時刻なら atHour().everyDays(1)、分まで指定するなら at(日時) を毎回作り直す形にします。
• 作る前に同じ関数のトリガーを削除して、重複を防ぎます。
• 権限が要る処理・時刻での実行・30秒を超える処理はインストール型を選びます。
• インストール型は作った人のアカウントで動きます。
• トリガーは1ユーザー・1スクリプトあたり20個、実行時間の合計は1日90分（Workspace は6時間）までです。
• 間隔を決めるときは、1回の実行時間 × 1日の回数を枠と見比べます。

参考・出典

• Google Apps Script「Simple Triggers」 https://developers.google.com/apps-script/guides/triggers
• Google Apps Script「Installable Triggers」 https://developers.google.com/apps-script/guides/triggers/installable
• Google Apps Script リファレンス「Class ClockTriggerBuilder」 https://developers.google.com/apps-script/reference/script/clock-trigger-builder
• Google Apps Script リファレンス「Class ScriptApp」 https://developers.google.com/apps-script/reference/script/script-app
• Google Apps Script「Quotas for Google Services」 https://developers.google.com/apps-script/guides/services/quotas

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。