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 日历中所做的修改会在下次检查后显示，而不是立刻显示。

由于两个方向的速度不同，短时间内出现 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 的事件所使用的颜色。它在两种情况下生效：

• 当导入一条新的 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 日历中创建的事件，并清除已存储的访问权限。

同步状态徽章

同步事件的卡片上会显示以下三种状态之一：

• Synced with Google —— 一切同步正常。
• Syncing… —— 同步正在进行。
• Sync failed —— 最近一次同步尝试未能完成。点击该事件查看信息，或使用 Sync now 重试。

限制与注意事项

• 仅限高级版。免费用户在连接前会看到付费墙。
• 仅支持 Google 日历。Outlook、iCloud 和其他日历服务不会与 Bookora 同步。
• 一次只能同步一个 Google 日历。要更改同步哪个日历，请在管理面板中点击 Switch calendar。
• 只读 Google 日历（你只有查看权限）无法选择——Bookora 需要写入权限才能导出事件。
• 如果你的首次导入覆盖了非常宽的日期范围，连接前可能会被要求缩小过去或未来窗口。
• Bookora 和 Google 使用不同的调色板；Bookora 会在每一边挑选最接近的匹配色。
• 无法在 Bookora 中删除源自 Google 的事件——请在 Google 日历本身删除，下次同步时它会从 Bookora 中消失。
• 同步覆盖最多一年的过去事件和两年的未来事件。
• 从 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. 你在登录时取消勾选了一项或多项权限。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 日历自己断开了连接。 你的高级版订阅可能已过期。续订高级版后重新连接。
• Bookora 中出现了一个我无法删除的源自 Google 的事件。 请在 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。