【GAS】スプレッドシートに記載したタスクを毎日チャットワークに自動で追加する

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

Google Apps Scriptでチャットワークに自動でタスクを追加するシステムを作成しています。

前回は、チャットワークに期限をつけてタスクを追加する方法についてお伝えしました。

429 Too Many Requests

これでタスク追加に関する基本的な使い方はバッチリ抑えられたかと思います。

さて、お仕事の中で毎日や毎週、毎月など定期的に発生するタスクがありますよね。

これらを自動的にチャットワークにタスク追加をしていきたいというとき、どのように実現したらよいでしょうか。

Google Apps Scriptでそれぞれのタスクについてスクリプトを組んでいっても良いですが、例えばスプレッドシートに自動追加するタスクを登録しておいて、その通りにタスクを追加してくれたら楽ちんですよね。

今回から何回かに分けて、Google Apps Scriptを使ってチャットワークに自動追加するタスクをスプレッドシートでコントロールするシステムを開発していきたいと思います。

初回はスプレッドシートにリストされているタスクについて毎日自動でチャットワークでもタスク追加する方法です。

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

スプレッドシートで毎日のタスクリストを作成する
チャットワークにタスク追加をする関数
1. チャットワークにタスクを追加するaddTask関数
スプレッドシートにリストした毎日のタスクをチャットワークに自動追加する
まとめ
連載目次：GASでチャットワークに自動でタスク追加をする

スプレッドシートで毎日のタスクリストを作成する

このようなスプレッドシートを作成しました。

毎日発生するタスクを記載しています。

今は二つしかありませんが…そのうち盛り上がりますので。

ルームIDはタスクを追加するグループチャットのルームID、アカウントIDはタスクを追加する担当者のアカウントID（複数いる場合はカンマ区切り）です。

このリストにあるタスクを毎朝（例えば7～8時など）に、指定のグループチャットにタスク追加するというスクリプトを考えていきます。

チャットワークにタスク追加をする関数

各行についてタスク追加をすることになりますので、チャットワークにタスク追加をするルーチンを関数化しておきたいと思います。

チャットワークAPIの仕様を確認すると

POST　/rooms/{room_id}/tasks
チャットに新しいタスクを追加

body(必須)：タスクの内容
limit：タスクの期限（※Unix timeで入力してください）
to_ids（必須）：担当者のアカウントID（※担当者のアカウントIDをカンマ区切りで)

となっています。

HTTPメソッドはPOSTですね。この時点で関数として渡す引数はroom_id,body,limit,to_idsとなります。

リクエストURLは

https://api.chatwork.com/v2/rooms/{room_id}/tasks

です。

またチャットワークAPI共通でHTTPヘッダに “X-ChatWorkToken”というパラメータ名でAPIトークンを渡す必要がありました。

ちょっと引数が多いですが、関数addTaskを

addTask(APIトークン,ルームID,タスク内容,タスク期限,アカウントID)

といった感じで作ってみます。

チャットワークにタスクを追加するaddTask関数

関数addTaskのコードはこちらです。

function addTask(token,room_id,body,limit,to_ids){
  var params = {
    headers : {"X-ChatWorkToken" : token}, //APIトークン
    method : "post",
    payload : {
      body : body,　//タスク内容
      limit : limit, //タスク期限
      to_ids : to_ids //アカウントID
    }
  };
  var url = "https://api.chatwork.com/v2/rooms/" + room_id + "/tasks";
  UrlFetchApp.fetch(url, params); //チャットワークAPIにリクエスト
}

詳細は前回のこの記事や

429 Too Many Requests

チャットワークにメッセージの送受信をする関数の作り方について解説したこちらの記事をご覧ください。

【GAS】チャットワークのメッセージを取り出す関数とメッセージを送る関数

Google Apps Scriptを活用してチャットワークにおみくじチャットを作成しています。今回はチャットワークからメッセージを取り出す、メッセージを送る処理を関数化して全体のコードをスッキリさせます。

スプレッドシートにリストした毎日のタスクをチャットワークに自動追加する

ではこの関数addTaskを使って、前述のスプレッドシートにリストされた毎日のタスクをチャットワーウに自動追加するスクリプトを作っていきます。

プログラムの流れとしては

シート自体と最終行数、データの取得をする
本日の日付をUNIX時間で取得し、固定小数点表記に変更
全てのタスクについて
- D列の頻度が”毎日”であれば
  - タスク内容、ルームID、アカウントID、期限を本日としてタスク追加

という流れとなります。

スクリプトとしてはこちらになります。

function addRegularTasks() {

  var mySheet=SpreadsheetApp.getActiveSheet();
  var maxRow=mySheet.getDataRange().getLastRow();
  var myVars=mySheet.getDataRange().getValues();

  var token = 'APIトークン'; //チャットワークAPIトークン

  var date = new Date();
  var limit = date.getTime()/1000;
  limit = limit.toFixed();

  for(var i=2;i<=maxRow;i++){
    if(myVars[i-1][4-1]="毎日"){
      var body = myVars[i-1][1-1]; 　//タスク内容
      var room_id = myVars[i-1][2-1]; 　//ルームID
      var to_ids = myVars[i-1][3-1]; 　//アカウントID
      addTask(token,room_id,body,limit,to_ids);
    }
  }
}