動機
最近、Google謹製のTODOリストを使っている。シンプルなのは非常にいいのだが、いくつか使いづらい点がある。そのうちの一つに、時間指定のタスク登録・通知ができないという点がある。そこで、Google Apps Scriptの勉強もかねて、GoogleカレンダーとGoogle TODOリストを連携させて、時間指定の通知をできるようにしたいと思う。そんなのカレンダーに直接登録すればいいじゃん！という声も聞こえそうだが、TODOリストへの登録のしやすさは捨てがたいので、こういう面倒なことを思いつくのであった。
また、もう一つ強力なモチベーションとして、このスマートウォッチの購入がある。
- 電話
- メール
- カレンダー
実践
やりたいことをより具体的にすると、TODOリストに日限(時刻含む)が記載されているタスクを、Googleカレンダーの指定の時刻に登録、ということなので、Google謹製ソフトの連携だけなので簡単じゃん！…とはいかず。曲者はTODOリストのほうである。公式のReferenceは下記。
Google謹製のくせに標準でGoogle Apps Scriptのクラスには登録されておらずハブられているし、実行しようにもひと手間加えてあげないといけないという面倒なやつ。公式Referenceも英語だけなのはまだしも、肝心のGASベースでの記述方法が書いておらず、非常に使いづらい…
ということで行きついたのが下記のサイト
Tasksの使いはじめの設定から、リストの取得や変更まで詳しく書いてあり、このページでほとんど事足りるのだが、いかんせん作成されたのが2012年で、このころと仕様が若干変わっているらしく、命令などもちょっと違っている。
ということで、実際に書いたコードが下記である。
function tasksToCalender() {
//defaultのタスクリスト読み込み
var listitem = Tasks.Tasklists.list().items;
var taskListId = listitem[0].id;
var tasks = Tasks.Tasks.list(taskListId);
//全タスクについて判定
if (tasks.items) {
for (var i = 0; i < tasks.items.length; i++) {
//タスク読み込み
var task = tasks.items[i];
//日付判定。タスクの日付が今日以前もしくは期日設定なしの場合は処理終了
var date = new Date(tasks.items[i].due);
var today = new Date();
if (date.getTime() < today.getTime() || !date.getTime()) {
continue;
}
//なぜかnotesでStringの関数が使えないため変換
var str = String(task.notes);
//@がnotesにある場合はgoogleカレンダーに登録する
if (str.match('@')) {
//日本時刻に戻すために9時間引いた値を時間に設定
date.setHours(date.getHours() + Number(str.substr(1,2))-9)
//startTimeはさらに分を足して設定。アラーム目的なのでendTimeは+1hour
var startTime = new Date(date.setMinutes(date.getMinutes() + Number(str.substr(3,2))));
var endTime = new Date(date.setHours(date.getHours() + 1));
CalendarApp.createEvent('TEST', startTime, endTime);
//@を消して二重登録を防ぐ
task.notes = str.replace('@','');
Tasks.Tasks.update(task, taskListId, task.id);
};
}
}
}タスク登録は、下記のように詳細部分に@時間、のように指定する。
詳細
ちょっと面倒なところだけ説明を加えようかと思う。
1. TODOリストの取得
1. TODOリストの取得
var listitem = Tasks.Tasklists.list().items;
var taskListId = listitem[0].id;
var tasks = Tasks.Tasks.list(taskListId);
やっていることは単純なんだが、先のリンクにも書いてある通り、まずはTasklistsでTODOリストのタスクリストを配列として取得して、その中から目的のタスクリスト(今回はdefaultなので配列の0番目)のidを取得、その上でタスクリスト内のタスクを配列で取得、となんとも回りくどいことをしないといけない。
2. 時間の判定
この1行目が曲者で、公式さんはTasksのnotesプロパティはStringだよ!!と言っているにもかかわらず、なぜかStringに使用できるmatch他のメソッドが使用できないというエラーが出るため、ここで強制的にString型に変換している。何とも不思議である。一体何型が返ってきているのだろうか??2. 時間の判定
var str = String(task.notes);
if (str.match('@')) {
… …
}
で、まあ予定通りに@がついているものだけ処理するif文を入れてます。
3. タスクのupdate
task.notes = str.replace('@','');
Tasks.Tasks.update(task, taskListId, task.id);
Tasks.Tasks.update(Task resource, String tasklist, String task)
まとめ
ということで、連携完了。コード自体はすごく単純なんだが、教科書が頼りにならず、ググってもこんなマニアックなことやろうとする人はいないらしく検索できず、ほぼ自力で作成したので時間がかかってしまった。あとはこいつを適当な時間タイミングでリピートすればOKということですな。
デバッグ不十分なため、ミスあるかも。
