予定と締切が二重管理
就活Pass の締切と Google カレンダーを別々に見て、ダブルブッキングが心配。
→ 確定済み締切・作業ブロックを Google へ PATCH 同期
カレンダー連携とは
締切・作業ブロックを起点に、同期キューを経由して Google カレンダーへ一方向で同期する仕組みです。アプリ内イベントが常に正で、Google 側の外部予定は追加表示にとどまります。
カレンダー連携、こんな悩みはありませんか？
Google ログインだけでは連携されません。設定画面から明示的に有効化する設計です。
連携方法が分かりにくい
Google ログインしただけではカレンダーに出てこない。
→ /calendar/settings から連携・追加先カレンダーを選択
同期のタイミングが不明
いつ Google に反映されるのか、手動か自動か分からない。
→ 非同期キューで処理、締切承認後は手動トリガーで同期
特長01
設定画面から、安全にGoogle連携を開始
Google ログインだけではカレンダー連携は有効になりません。/calendar/settings で接続・再連携・解除・追加先カレンダーの選択を行い、targetCalendarId を明示選択したときに初めて同期が有効になります。
- 連携・解除はすべて設定画面から操作
- 追加先カレンダー変更後は以後の同期から新カレンダーを使用
- 既存ミラー予定は自動では移動しない
就活Pass — カレンダー設定
Google連携
Googleアカウント
taro.shukatsu@gmail.com
同期先カレンダー
就活スケジュール
再連携解除
特長02
締切・作業ブロックをGoogleへミラー
同期対象は確定済み締切と作業ブロック。Google 側のイベントには [就活Pass][締切] または [就活Pass][作業] の接頭辞が付き、extendedProperties でアプリ内の entityId と紐づけられます。
- findEventByEntityId() で既存イベントを検索し PATCH
- 接頭辞 [就活Pass] / [シューパス] を同一イベントとして扱う
- 非同期キュー calendar_sync_jobs で処理
就活Pass — カレンダー
7月8日（水）
[就活Pass][締切] A社 ES提出
[就活Pass][作業] ES 推敲ブロック
ゼミ発表（外部予定）
特長03
空き時間提案で、作業ブロックを組みやすく
Google 連携時は freebusy API を使った空き時間提案が利用できます。カレンダー画面の月表示と合わせて、締切前の作業時間を確保しやすくなります。
- freebusyCalendarIds に含まれるカレンダーのみ集計
- アプリ内イベントが真実のデータ、外部予定は追加表示
- 締切管理・タスク機能と同じアカウントで利用
就活Pass — カレンダー
7月10日（金）の空き時間freebusy
9-11
11-13
13-15
15-17
17-19
提案: 15-17時に「ES推敲」の作業ブロック
使い方は3ステップ
設定画面での連携が完了すれば、以降は締切・作業ブロックの保存だけで同期が進みます。
01
設定画面でGoogle連携し、同期先カレンダーを選ぶ
接続だけでは連携は有効になりません。targetCalendarId を明示選択したときに初めて同期が有効になります。
02
締切・作業ブロックが自動で同期される
update-in-place（PATCH）方式で、非同期キュー calendar_sync_jobs が保存後の同期を処理します。
03
月表示で外部予定と合わせて確認する
アプリ内イベントを正として表示しつつ、Google の外部予定も追加表示。freebusy を使った空き時間提案も利用できます。
他の機能ともつながる
よくある質問
いいえ。Google ログインだけでは Google カレンダー連携は有効になりません。/calendar/settings から連携・再連携・解除・追加先カレンダーの選択を明示的に行う必要があります。
確定済み締切と作業ブロックが同期対象です。Google 側のイベントには [就活Pass][締切] または [就活Pass][作業] の接頭辞が付き、extendedProperties でアプリ内のエンティティ ID と紐づけられます。
連携後、カレンダー画面ではアプリ内イベントを正とし、Google の外部予定（アプリ管理外）を追加表示します。月表示で締切・作業ブロックと合わせて確認できます。
非同期キュー（calendar_sync_jobs）で処理されます。締切承認後の Google カレンダー同期は手動トリガーです。追加先カレンダーを変更しても既存のミラー予定は移動せず、以後の同期から新しい追加先が使われます。
Google 連携時は freebusy API を使った空き時間提案が利用できます。freebusyCalendarIds に含まれるカレンダーだけが集計対象です。
締切管理で確定した締切がカレンダーに反映され、作業ブロックも同じ画面で管理できます。タスクの Today's Task と合わせて、予定と ToDo を一つの就活フローで扱えます。