【初心者向けGAS】時限式のイベントトリガーを設置して決まった時刻にBotを送信する方法

photo credit: yourbestdigs thermometer and timer testing on wine cooler via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

初心者向けGoogle Apps Scriptのシリーズとして、名言Botの作成の仕方をお伝えしています。

前回の記事はコチラ。

【初心者向けGAS】Google Apps Scriptで別の関数を呼び出すfunctionの書き方

Google Apps ScriptでBotを作りながらその基本を学ぶシリーズです。今回は、関数から別の関数を呼び出す方法です。functionの書き方、引数、仮引数、戻り値などについても解説します。

別のfunctionの呼び出しについてお伝えしましたね。

これで、スプレッドシートの名言をChatworkに送ることができるようになっているのですが、ほら、毎回手動で実行してたじゃないですか。

GASの大きな特徴の一つとして、トリガーがありますよ。

ということで、Google Apps Scriptで時限式のイベントトリガーを設置して決まった時刻にBotを送信する方法です。

では、行ってみましょう！

前回のおさらい
トリガーとは
インストーラブルトリガーの設置方法
まとめ
連載目次：超初心者向けGASでBotを作りながら基礎を学ぶ

前回のおさらい

まず、スプレッドシートは以下のように名言がリストされています。

そして、この名言を一つずつChatworkに送信するスクリプトを前回までで作成していまして、コチラであります。

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSheet(); 
  const lastRow = sheet.getLastRow();
  
  for(let i = 2; i <= lastRow; i++) {
    if(!sheet.getRange(i, 4).getValue()){ 
      const body = sheet.getRange(i, 1).getValue();
      sendMessage(body);
      sheet.getRange(i, 4).setValue(true);
      
      if(i >= lastRow) {
        sheet.getRange(2, 4, lastRow - 1).clearContent();
      }
      break;
    }
  }
}

function sendMessage(body){
  const cw = ChatWorkClient.factory({token: 'ここにAPIトークンを入力してください'});
  cw.sendMessageToMyChat(body);
}

このmyFunctionを定期的に決まった時刻に実行していきたいわけですね。

トリガーとは

GASでは指定した日時、スプレッドシートの編集、フォームの送信といった出来事（イベントといいます）に合わせて、スクリプトを実行することができる、トリガーという機能があります。

これはまさにGoogleのサーバーで実行されるGASならではの機能でして、つまり皆さんのPCを閉じていたって、皆さんがスヤスヤ眠っていたって、決まった時間や動作に応じてスクリプトを実行できるわけです。

GASのトリガーには、あらかじめ決められた関数名でスクリプトを書くだけで実行されるシンプルトリガーと、トリガー画面から設定をするインストーラブルトリガーと、２種類があります。

今回は、決められた時刻に実行する時限式のトリガーを設置したいのですが、時限式のトリガーはインストーラブルトリガーでのみ設置できますので、そちらを解説しますね。

インストーラブルトリガーの設置方法

GASで時限式のインストーラブルトリガーを設置する方法を解説していきます。

まず、スクリプトエディタのメニューから「トリガー」を選択します。

すると「トリガー」の画面が開きます。

この画面でトリガーの追加や編集を行うことができます。

では、「トリガーを追加」をクリックします。

すると、以下のように「GAS Botのトリガーを追加」というダイアログが表示されます。

この画面を使ってトリガーの設定と追加をしていきます。

実行する関数とイベントのソースを選択

「実行する関数を選択」は、トリガーで発動させたい関数名を指定します。今回は「myFunction」ですね。

「実行するデプロイを選択」はひとまずそのまま「Head」でOK（おそらく変更できませんし）。

「イベントのソースを選択」は以下の３種類から選べます。

時間主導型
スプレッドシートから
カレンダーから

今回は「時間主導型」ですね。

ちなみに、「スプレッドシートから」を選ぶと、次の選択肢で

起動時
編集時
値の変更時
フォームの送信時

を選べます。

「カレンダーから」を選ぶと「予定を更新しました」の一択です。

時間ベースのトリガー

時間主導型を選択すると、次のプルダウンが「時間ベースのタイマー」になります。

特定の日時
分タイマー
時タイマー
日タイマー
週タイマー
月タイマー

これらの中から、どの単位でトリガーを実行するかを選ぶことができます。

今回はすぐに実行確認したいので「分タイマー」にしておきましょう。

すると、その次のプルダウン「時間の間隔を選択」で

1分ごと
5分ごと
10分ごと
15分ごと
30分ごと

と選ぶことができます。今回は「1分ごと」にしてみますよ。

設定が完了した状態がこちら。

これで「保存」をすると、トリガー設置完了です。

トリガーの画面で、以下のように新たなトリガーが追加されていることが確認できます。

なお、トリガーはスクリプトからもコントロールすることができますので、ご興味ある方は以下記事もご覧ください。

Google Apps Script で毎日決まった時刻にスクリプトを実行するトリガー設定

Google Apps Scriptのトリガー設定は毎日実行する場合は、午前8時～9時のように1時間の幅があります。また、時間を細かく指定するには、2018年2月16日08:30のように日にちも設定する必要があります。この二つを使用して、毎日指定した時間にスクリプトを実行させるトリガーを設定します。

トリガーの実行確認

では、実行の確認をしてみましょう。

しばらく放置した末に、Chatworkのマイチャットを確認すると…

以下のように、名言が何回か送信されていますね。

なお、トリガーを止めたい場合は、トリガーの三点リーダーアイコンから削除することができます。

このままだと1分ごとに送信されまくりますからね。

まとめ

Google Apps Scriptのトリガーとは何か、また時限式のトリガーの設置方法についてお伝えしました。

繰り返しになりますが、トリガーは完全クラウド環境のGASならではの素敵機能です。

PC閉じていても実行してくれるようになります。つまり、完全自動になります。

ぜひ活用くださいね！

次回は、プロパティサービスについてお伝えします。

【初心者向けGAS】プロパティストアの概要とスクリプトプロパティの入力方法

初心者向けGoogle Apps Script入門として名言Botの作り方をお伝えしています。今回は、コードに直書きしたくないデータを格納する機能プロパティストアについて、またスクリプトプロパティの入力の方法です。

どうぞお楽しみに！

連載目次：超初心者向けGASでBotを作りながら基礎を学ぶ

Google Apps Script（GAS）をはじめるためのメリットは山程ありますが、何を作ったらいいの？と悩んでしまうこともありますよね。そんな時に、おすすめしたいのが「Bot」の作成です。このシリーズでは、超初心者向けにGASでBotを作る方法を題材としながら、GASプログラミングの一通りの流れと書き方について学んでいきます。

石田より:

2018-05-17 4:29 PM

こんにちは。

こちらのサイトで GAS の勉強をさせてもらっています。

スクリプトの7行目は下記のようにする方が良いのではと思います。
現:Logger.log(sheet.getRange(i, 1).getValue());
正: sendMessage(sheet.getRange(i,1).getValue());

よろしくご検討ください。

石田
- タカハシノリアキより:
  
  2018-05-17 4:41 PM
  
  石田さま
  
  コメントありがとうございます！
  おっしゃる通りですね…失礼しました。
  
  修正をさせていただきました。
  今後とも、当ブログをよろしくお願いいたします。