Google カレンダー連携

Google カレンダー連携を使うと、Bookora と Google カレンダーが接続され、予約が両方に表示され、個人の Google イベントが Bookora 上で時間をブロックします。一度接続すれば同期は自動で動きます。これはプレミアム機能です。

アクセス方法

Settings タブ > Google Calendar。初めて使うユーザーには紹介ページが表示され、再訪ユーザーには接続ダッシュボードが表示されます。

できること

• ワンタップで Google アカウントに接続できます（Google のセキュアなフローからサインインします）。
• 同期する Google カレンダーを選びます。
• Google にエクスポートする対象を選びます: Appointments、Tasks、Breaks、またはこれらの任意の組み合わせ。
• Google イベントを Bookora にインポートする過去・未来の期間を選びます。
• 同期されたイベントの色を選びます。
• いつでも手動で同期を強制実行できます。
• Bookora 内から Google 由来のイベントを編集・保存・更新できます。
• 同期を不要になったときに、きれいに切断できます。

Google カレンダーに接続する

1. Settings > Google Calendar を開きます。紹介画面で連携の概要を確認できます。
2. Continue with Google をタップします。まだプレミアムでない場合、ここでサブスクリプションペイウォールが表示されます。
3. Google のセキュアなサインイン画面でサインインし、Bookora が要求するすべての権限（カレンダーリスト、カレンダーイベント、メールアドレス）を承認します。
4. Calendar Picker 画面で次の操作を行います。
   • 同期する Google カレンダーを選びます。Primary バッジが既定のカレンダーを示します。
   • エクスポートする Bookora のイベントタイプにチェックを入れます: Appointments、Tasks、Breaks。
   • 過去をどこまでインポートするかを選びます: Past events で 0、7、30、90、180、365 日から選べます。
   • 未来をどこまでインポートするかを選びます: Future events で 0、30、90、180、365、730 日から選べます。
   • 同期されたイベントの色を選びます。
5. Connect をタップします。同期画面が表示され、初回のインポートが実行されます。

接続後に設定を編集する

1. Settings > Google Calendar を開きます。
2. What gets exported、Past events、Future events、Color を調整します。
3. Save をタップします。
4. 変更後すぐに同期したい場合は Sync now をタップします。

同期の仕組み

同期は双方向ですが、両方向の動作は同一ではありません。

• Bookora → Google は即時です。 Bookora で予約、タスク、休憩を作成、編集、削除すると、変更はすぐに Google カレンダーに送信されます。プッシュが失敗した場合（短時間のネットワークや Google の不調など）、Bookora は自動で再試行するので、特に何もする必要はありません。
• Google → Bookora は短いスケジュールで動きます。 Bookora は数分ごとに Google から新しいイベントや更新イベントを取得します。Google カレンダーで直接行った変更は、即座にではなく次の取得時に表示されます。

2 つの方向は同じ速度では動かないため、Google が Bookora より少し先行する短い期間があるのが正常です。たとえば Google カレンダーに追加したばかりの予定が、Bookora に表示されるまで数分かかることがあります。最新の変更を即時に取り込むには、Settings > Google Calendar を開いて Sync now をタップします。逆方向（Bookora の変更が Google に反映される）にはこの操作は不要です。すぐに反映されます。

What gets exported で選んだイベントタイプだけが Google に送信されます。チェックを入れなかったものは Bookora に留まり、送信されません。

どのフィールドをどちら側が所有するか

同じイベントが両方に存在する場合、競合時にどちらが優先されるかは、イベントがどこで作成されたかによります。

• Google で開始されたイベント（Imported from Google チップが付いたもの）。Google が真実のソースです。このようなイベントを Bookora で編集すると、変更は Google にプッシュされますが、Google で直接行った変更は次回のプル時に常に勝ちます。
• Bookora で開始され Google にエクスポートされたイベント。 Bookora が詳細（タイトル、メモ、サービス、クライアントなど）を所有します。同じイベントを Google で編集した場合、Bookora に同期されるのはスケジュール（日付、開始、終了）のみです。Google で変更した他のフィールドは Bookora 側を上書きしません。

どちらかの側でイベントを削除すると、次回の同期で反対側からも削除されます。

繰り返しイベントと終日イベント

• 繰り返しイベント は Google からは個別の発生インスタンスとしてインポートされ、単一の繰り返しシリーズとしてはインポートされません。各インスタンスは Bookora 上で独立したエントリで、それぞれ個別に管理できます。
• 終日イベント はサポートされており、両側で終日のまま保たれます。

同期されたイベントの色

Settings > Google Calendar で選んだ Color は、Google から Bookora に取り込まれたイベントに使われる色です。次の 2 つの場面で適用されます。

• 新しい Google イベントがインポートされたとき、Bookora はこの色で塗ります。
• Color 設定を変更して保存すると、すでに Google からインポート済みのイベントもすべて自動で新しい色に塗り直されます。再同期や再接続は不要です。

Bookora で開始されたイベント（Google にエクスポートされた予約、タスク、休憩）は、それぞれの色を保持します。Bookora が外観を所有するため、連携の色設定はどちらの側でも影響しません。

Bookora で Google 由来のイベントを編集する

1. カレンダーでイベントを開きます。Imported from Google チップが表示されます。
2. Edit をタップします。Google カレンダーから同期されたイベントであることを示すバナー付きでエディターが開きます。
3. タイトル、日付、開始・終了時刻、場所、メモを編集できます。色は読み取り専用です。これらのイベントの色は Google が所有します。
4. Save をタップします。変更はすぐに Google カレンダーにプッシュされます。その後 Google で同じイベントを編集すると、次回のプル時にはその変更が勝ちます。

切断する

1. Settings > Google Calendar を開き、危険な操作ゾーンまでスクロールします。
2. Disconnect Google Calendar をタップして確認します。
3. Bookora は Google カレンダーに作成したイベントを削除し、保存されているアクセス情報をクリアします。

同期ステータスのバッジ

同期されたイベントは、カードに次の 3 つの状態のうち 1 つを表示します。

• Synced with Google — すべて同期されています。
• Syncing… — 同期が進行中です。
• Sync failed — 最新の同期試行が完了しませんでした。イベントをタップしてメッセージを確認するか、Sync now で再試行してください。

制限事項と知っておくと便利なこと

• プレミアム限定です。無料ユーザーは接続前にペイウォールを目にします。
• サポートされている外部カレンダーは Google カレンダーのみです。Outlook、iCloud、その他のカレンダーサービスは Bookora と同期しません。
• 同期できる Google カレンダーは 1 つだけです。同期するカレンダーを変更するには、ダッシュボードで Switch calendar をタップします。
• 読み取り専用の Google カレンダー（表示権限のみがあるもの）は選択できません。Bookora がイベントをエクスポートするには書き込み権限が必要です。
• 初回のインポート範囲が非常に広い場合、接続前に過去または未来の期間を狭めるよう求められる場合があります。
• Bookora と Google は異なるカラーパレットを使うため、Bookora はそれぞれの側で最も近い色を選びます。
• Google 由来のイベントを Bookora から削除することはできません。Google カレンダー側で削除すれば、次回の同期で Bookora からも消えます。
• 同期は過去 1 年、未来 2 年までを対象とします。
• iOS または Android アプリから接続します。
• プレミアムサブスクリプションが失効すると、Google カレンダーは自動で切断され、Bookora が作成したイベントは Google カレンダーから削除されます。更新後は手動で再接続してください。

よくある問題

• Sign-in was cancelled. Try again to connect Google Calendar. サインイン画面を完了前に閉じました。再度 Continue with Google をタップしてください。
• Bookora needs calendar access to sync. Allow all requested permissions to continue. サインイン中に 1 つ以上の権限のチェックを外しました。Bookora にはすべての権限が必要です。Google アカウント > アクセスのあるアプリ で Bookora を削除し、再接続してください。
• Google access is no longer valid. Reconnect to resume sync. アクセストークンの有効期限が切れたか、Google アカウントから Bookora を取り消しました。Settings > Google Calendar の Reconnect バナーをタップしてください。
• Sync failed: rate_limited。 Google が制限をかけています。Bookora が自動で再試行するため、対応は不要です。
• Sync failed: backfill_too_large。 過去または未来の期間が一度にインポートするには大きすぎました。Preferences を開き、Past events と Future events を狭い範囲に変更してください。
• 別のカレンダーのイベントがまだ表示される。 間違ったカレンダーに接続しています。Switch calendar をタップして正しいものを選んでください。
• 色を変えたのに Google で Bookora の予約が同じに見える。 想定どおりです。Color 設定は Google からインポートされたイベントにのみ適用されます。Bookora で作成した予約、タスク、休憩は、設定された色を保持します。
• 色を変えたのに Google からインポートしたイベントが更新されない。 新しい色を保存すると自動で塗り直されるはずです。変更が反映されない場合は、Settings > Google Calendar で Sync now をタップしてください。
• Android でサインインが空のページに開く。 サインインフローは既定のブラウザを使います。インストール済み、最新版、有効になっていることを確認してください。
• Google カレンダーが勝手に切断された。 プレミアムサブスクリプションが失効した可能性があります。プレミアムを更新してから再接続してください。
• 削除できない Google 由来のイベントが Bookora にある。 Google カレンダー側で削除してください。次回の同期で Bookora から消えます。
• Bookora の予約が Google カレンダーに表示されない。 What gets exported にそのイベントタイプ（例: Appointments）が含まれているか確認し、Sync now をタップしてください。
• Google カレンダーで追加・編集したイベントが Bookora にまだ表示されない。 数分間はそうなることがあります。Bookora は Google の変更を即時ではなく短いスケジュールでプルします。すぐに取得するには Settings > Google Calendar を開き Sync now をタップしてください。
• 同期が Syncing… で止まっているように見える。 数分待ってください。長時間止まったままの場合は Sync now をタップして再試行してください。

サポートが必要ですか？

Google カレンダー連携についてサポートが必要な場合は、support@bookora.me までご連絡ください。