GoogleカレンダーとSlackステータスを連携する【GAS】 #JavaScript

この記事は『Slack Advent Calendar 2019』の15日目の記事です。

作りたいもの

Googleカレンダーに予め予定を入れておき、予定の時間になると、Slackのステータスが切り替わるもの。

ただ、これを使用するには、Googleカレンダーから出席依頼を「承諾」することが必要で、ステータスも「In a meeeting」のみ。もっと他のこと（例えば有給休暇中とか）でステータスを切り替えたくなったり、会社がGoogleカレンダーを使っていないとなると、どうしても自分で作る必要が出てくる。

そこで自分でGoogleカレンダーとSlackステータスを連携させるものを作成して、実際の稼働までを書いてみる。

構成

今回はSlack Web APIとGoogle Calendarを、Google App Script（GAS）を使って連携させる。図にすると理想はこんな感じ。

このようなものを作っている方は結構いらっしゃったが、POSTで投げている方はあまりいなかったので、今回はPOSTで投げてみる。

GASコード

SlackStatusWriter.gs

/**
 Googleカレンダーから取得した現在の予定をSlackステータス用に整形して返却する。
**/
function createStatusText(event) {
  // 整形した開始時刻・終了時刻
  var start = event.getStartTime().getHours() + ":" + ("00" + event.getStartTime().getMinutes()).slice(-2);
  var end = event.getEndTime().getHours() + ":" + ("00" + event.getEndTime().getMinutes()).slice(-2);
  // ステータステキスト
  var text = event.getTitle() + "(" + start + "〜" + end + ")";

  // イベントがある時のステータス
  var event_status = {
    "profile": JSON.stringify({
      "status_text": text,
      "status_emoji": ":spiral_calendar_pad:"
    })
  };

  return event_status;

}

/**
 作成したステータスをSlack Web API経由でプロフィールに反映させる。
**/
function postSlackStatus(status) {
  // アクセス情報
  const TOKEN = "(取得したSlack API トークン)";
  const URL = "https://slack.com/api/users.profile.set";

  // HTTPヘッダー
  const headers = {
    "Authorization" : "Bearer " + TOKEN
  };

  //POSTデータ
  var option = {
    "Content-Type": "application/json",
    "headers": headers,
    "method": "POST",
    "payload": status
  };

  var fetch = UrlFetchApp.fetch(URL, option);

}

/**
 カレンダーから今日の予定を取得し、必要であればSlackステータスを更新する。
**/
function main() {
  // カレンダーID
  const ID = "(Slackステータスに使うGoogleカレンダーID)";
  // 今日の日付
  var date = new Date();
  // カレンダーから今日の予定を取得
  var calendar = CalendarApp.getCalendarById(ID);
  var events = calendar.getEventsForDay(date);

  // 今日のイベントがない場合は何もしない
  if (events.length !== 0) {

    // イベントがないときのステータス
    var set_status = {
      "profile": JSON.stringify({
        "status_text": "暇暇の暇",
        "status_emoji": ":dancer:"
      })
    };

    // 今日の予定をすべて調査
    for (var i in events){
      // 今が予定の開始時刻以降で終了時刻以前なら今はその予定の最中 -> ステータス変更
      if (events[i].getStartTime() <= date && events[i].getEndTime() >= date) {
        set_status = createStatusText(events[i]);
        break;
      }
    }

    postSlackStatus(set_status);

  }
}

コード内の

(取得した取得したSlack API トークン)
(Slackステータスに使うGoogleカレンダーID)

は、別途自分で取得する必要がある。

また、時間を取得する際、分を

("00" + getMinutes()).slice(-2);

としておいたほうがいい。でないと、例えば17:00とかだと、「17:0」になってしまう。間違ってはないけど違和感がある…。

アクセス情報の取得方法

Slack API トークン

Legacy tokensへアクセスする。
- なぜか見つけるのが大変なので、よく使うならブックマークしてもいいかも
Slackワークスペースにサインインしていれば、自分のワークスペースが表示される。まだトークンを作っていなければ、「Create Token」をクリックすれば作成できるので、これをコピーする。

GoogleカレンダーID

Googleカレンダーにアクセスし、Slackのステータスに使いたいカレンダーの「設定と共有」を開く。
「カレンダーの統合」を開き（もしくは下にスクロール）、カレンダーIDをコピーする。

GASコードを動かす

G Suite Developer Hubにアクセスし、「Start Scripting」をクリックする。
Googleアカウントでログインすると、管理画面に飛ばされるので、「新しいプロジェクト」で新規作成する。
コードを実装し、保存する。

時間周期で稼働させる前に、一度実行ボタンから実行しておく。というのも、初回のみGoogleカレンダーへのアクセスの確認が必要なため。

実行時は、最初にどのメソッドを動かすかを指定して、実行する。

時間周期で稼働させる

エディタ画面から「編集→現在のプロジェクトのトリガー」をクリックする。
「トリガーの追加」をクリックする。

以下のように設定する。

項目	設定値
1. 実行する関数を選択	`main`
2. 実行するデプロイを選択	`Head`（しかないはず）
3. イベントのソースを選択	`時間主導型`
4. 時間ベースのトリガーのタイプを選択	`分ベースのタイマー`
5. 時間の間隔を選択（分）	`1分おき`