はじめに

以前、スプレッドシートからGoogleカレンダーへイベントを登録・編集する記事を書きましたが、これは スプレッドシート -> カレンダー の単方向だったので、逆方向の カレンダー -> スプレッドシート の編集もできるようになりたいと思い調べたところ、スプレッドシート側でカレンダーの編集を検知できるようにするまでの設定が意外と大変（主にgcp側が）だったので、その時の手順をこの場をお借りして整理することにしました。

手順概要

gas（Google Apps Script）側とgcp（Google Cloud Platform）側両方で Calendar APIを有効化する 必要があり、以下の手順が必要になります。

gas側でやること
- Calendar APIを有効化する。
- スプレッドシートからカレンダーへイベント登録した時、カレンダーの内容とスクリプトプロパティを同期化する関数を作る。
- カレンダー側で予定を変更したとき、前回同期化した時からの差分を取得する関数をつくる。
- トリガーを作成する。差分を取得する関数をトリガーに設定。
gcp側でやること
- プロジェクト作ってない場合、作る（プロジェクト番号をgas側に設定するのでメモ）
- Calendar APIを有効化する。
- アプリケーションの登録をする。

gas側でやること

1. Calendar APIを有効化する

スクリプトエディタの リソース -> Googleの拡張サービス からCalendar APIをONにします。

gcpプロジェクトをまだ作ってない場合は、↑の画面のときに、 any applicable services and APIs のリンクから作成できます。既にgcpプロジェクトを作ってる場合は、カレンダーAPIを有効化しておきましょう。
（gcpプロジェクトの作成とAPIの有効化手順をgcp側でやることに記載しましたので、まだの人は良かったら参考にしてください）

2. Cloud Platformプロジェクトを設定

リソース -> Cloud Platform プロジェクト でgcpの プロジェクト番号 を設定します。

3. カレンダーIDをメモ

Googleカレンダーのマイカレンダーから対象のカレンダーの 設定と共有 を開くと カレンダーID が見れますので、メモしておきます。
デフォルトカレンダーの場合は、自分のgmailアドレスがカレンダーIDになります。

4. カレンダーの内容とスクリプトプロパティの内容を同期化する関数を作る

スプレッドシートからカレンダーにイベントを登録した時 に、以下の関数を実行するようにしておきます。スクリプトプロパティの syncToken っていうプロパティにカレンダーのイベント内容を保存すると、スクリプト実行終了後も内容を保持してくれます。

function initialSync() {
  var items = Calendar.Events.list("メモしたカレンダーID");
  var nextSyncToken = items.nextSyncToken;
  var properties = PropertiesService.getScriptProperties();
  properties.setProperty("syncToken", nextSyncToken);
}

5. トリガーに設定する関数を作る

Googleカレンダー側でイベントを編集したときに実行する関数です。
手順4.の initialSync() を実行した時保存したsyncToken プロパティとの差分をとってきて、ログ表示します。その後プロパティの内容を上書きしています。
今回は差分をログ表示するだけですが、この部分をスプレッドシートへ反映する処理に書き換える予定です。

function onCalendarEdit() {
  var properties = PropertiesService.getScriptProperties();
  var nextSyncToken = properties.getProperty("syncToken");
  var optionalArgs = {
    syncToken: nextSyncToken
  };
  var events = Calendar.Events.list("メモしたカレンダーID", optionalArgs);
  Logger.log(events); // 差分をログ表示
  var nextSyncToken = events["nextSyncToken"];
  properties.setProperty("syncToken", nextSyncToken);
}

6. トリガーを作成

編集 -> 現在のプロジェクトのトリガー と選択し、遷移先画面右下の トリガーを追加 で作成します。
実行する関数は、さきほど作ったトリガーに設定する関数を選択します。
カレンダーのオーナーのメールアドレスには、カレンダーIDを入力します。初めて保存すると承認画面が表示されるので承認します。

カレンダーを編集してみる

スプレッドシートはこんなテンプレートです。カレンダーへイベント登録済みである前提

カレンダーからイベントを編集した時のログ

ログの内容から items の中にイベント内容が入っていることがわかります。
さきほどの onCalendarEdit() のログ表示の部分をこんな感じに書き換えるとイベントの内容を取得できます。


 var events = Calendar.Events.list(calendarId, optionalArgs);
 var items = events.items;

 for (var i = 0; i < items.length; i++) {
    // イベントID
    var eventId = items[i].iCalUID;
    // イベントのタイトル
    var title = items[i].summary;
    // 場所
    var location = items[i].location;
    // 開始日
    var startDate = Utilities.formatDate(new Date(items[i].start.dateTime), "Asia/Tokyo", "yyyy/MM/dd");
    // 開始時間
    var startTime = Utilities.formatDate(new Date(items[i].start.dateTime), "Asia/Tokyo", "HH:mm");
    // 終了時間
    var endTime = Utilities.formatDate(new Date(items[i].end.dateTime), "Asia/Tokyo", "HH:mm");
    // ステータス
    var status = items[i].status;

    // TODO ここにスプレッドシートの内容を更新する処理を書こう
  }