# 将 Google 日历连接到 Pilotiko

> 了解 Pilotiko 的 Google 日历连接实际做了什么：calendar.events 权限范围、忙碌时段读取、会议邀请发送、连接当前状态，以及如何随时撤销访问权限，一页为您讲清楚。

更新于 2026年11月8日 · https://app.pilotiko.com/zh/integrations/google-calendar

目前，Pilotiko 用自带的排程管理您的预约和空闲时段，无需 Google。Google 日历连接器会读取您的日程（时间、标题、参会者），从中得出您的忙碌时段，保存到您企业的记忆库中，并创建日程。状态：可用。

## 要点
- Pilotiko 的排程本身已能独立运行：在线预约、真实空闲时段、建议的人员安排。
- Google 连接需要 calendar.events 权限范围，另加 openid 和 email，用来确认连接的是哪个账户。
- 凡是会发送邀请的会议，始终要等一位人员批准。

## Google 日历连接做什么？

它有两个用途：了解您什么时候已有安排，并把在 Pilotiko 中安排的会议写入您的 Google 日历，需要时附带 Google Meet 链接。

Pilotiko 本来就有自己的排程：它根据团队的工作时间和已知的预约计算空闲时段。但很多人其实生活在 Google 日历里：一次商务晚宴、一次牙医预约、一场培训。这个连接可以避免向客户提供对方并不空闲的时间，也避免同一场会议输入两次。

为此，Pilotiko 向 Google 请求三项授权。主要的一项 **calendar.events**，Google 描述为“View and edit events on all your calendars”：查看和编辑您所有日历中的日程 [1]。另外两项 **openid** 和 **email** 只用于显示连接的是哪个账户。通过这个连接，Pilotiko 既不请求 Gmail，也不请求 Drive；邮件发送走的是独立的 [Gmail 连接](https://app.pilotiko.com/zh/integrations/gmail)。

对于忙碌时段，连接器读取您的日程列表（events.list），calendar.events 权限范围涵盖这一操作；它不调用 freeBusy 方法，因为那需要另一项权限范围 [2]。已取消、标记为“空闲”或已拒绝的日程不会占用时段。

读取到的日程（时间、标题、描述、地点、参会者）也会进入您企业的记忆库，让助手知道您见过谁、什么时候见的。

- **从 Google 读取**：您的日历列表，以及指定时间段内的忙碌时段（只有开始和结束时间）。
- **写入 Google**：一个包含标题、描述、时间、参会者的日程，如有需要还包括 Google Meet 会议；以及该日程的修改或取消。
- **邀请**：Pilotiko 创建、改期或取消会议时，会请 Google 通知参会者（参数 sendUpdates=all）。
- **批准**：安排一场会发送邀请的会议，需要有人批准。助手提出建议，由您决定。
- **核对**：每个步骤（会议、日程、邀请）都会复核；若有一步失败，已创建的内容会被撤销。

## 如何将 Google 日历连接到 Pilotiko？

1. **打开“连接”页面** — 在 Pilotiko 中进入“连接”，找到 Google 日历卡片。如果 Pilotiko 尚未为您的账户启用该服务商，卡片会如实说明，而不是显示一个无处可去的按钮。
2. **选择 Google 账户** — 点击“连接”。您会被带到 Google，使用存放企业日历或您个人日历的账户。
3. **阅读授权页面** — Google 会显示所请求的授权：查看和编辑您日历中的日程、您的邮箱地址和身份信息。仅此而已。
4. **授权并返回** — 您同意后，Google 会带着一次性代码跳回 Pilotiko。Pilotiko 用它换取令牌，并立即加密保存。
5. **检查状态** — 卡片会变为“已连接”。如果续期出错，会变为“需重新连接”，绝不会悄悄失败。

## 哪些功能已可用，哪些即将推出？

| 功能 | 状态 | 说明 |
|---|---|---|
| Pilotiko 排程中的在线预约和空闲时段 | 可用 | 无需 Google，根据团队的工作时间运行。 |
| 供客户使用的 .ics 文件“添加到我的日历” | 可用 | iCalendar 格式，Google、Apple 和 Outlook 都能读取。 |
| 读取 Google 日历中的忙碌时段 | 可用 | 通过 calendar.events 读取日程。 |
| 创建、改期和取消带邀请的日程 | 可用 | 每个步骤都会复核；失败时，已创建的内容会被撤销。 |
| 会议上的 Google Meet 链接 | 可用 | 创建日程时向 Google 请求。 |
| Google Meet 转录 | 即将推出 | 尚未开发。 |
| 连接每位员工的个人日历 | 可用 | calendar.events，在“我的连接”中操作。 |

状态取自 Pilotiko 的功能登记册：Google 日历在其中列为适配器。

## 一周同步预约是什么样子？

**示例：舍布鲁克的一支 3 人技术员团队**

每位技术员在 Pilotiko 中每周提供 40 小时的服务时段。连接 Google 日历后，Pilotiko 会从这些时段中扣除 Google 日历里标记为忙碌的时段。

每次预约时长 90 分钟。计算结果显示这一周还能容纳多少场完整的预约。

- 提供的时段（3 × 40 小时） : 120 h
- 从 Google 日历读取到的忙碌时段 : − 18 h
- 实际空闲的小时数 : 102 h
- 可安排的 1.5 小时预约（102 ÷ 1.5） : 68
- 本周已预订的预约 : − 41
- **= 仍可预约的 90 分钟预约共 27 个，与 Google 日历没有冲突。**

## 您的 Google 数据如何受到保护？

Google 发放的令牌在存储时经过加密（AES-256-GCM），绝不离开服务器；您的浏览器看不到它们。连接链接带有一次性的“state”参数，与您的企业和用户绑定，10 分钟后失效。授权码还受 PKCE 保护，这是 IETF 标准化的、用于防止授权码被截获的方法 [5]。

Pilotiko 读取您的日程（时间、标题、描述、地点、参会者），用于您的可用时间和企业的记忆库；这些内容只有企业内有权限的人员才能看到。经 Loi 25（第 25 号法案）现代化的《私营部门个人信息保护法》要求告知当事人收集的目的及其撤回同意的权利（第 8 条），并要求同意须针对特定目的作出（第 14 条）[4]。Google 的授权页面和 Pilotiko 的卡片正是为此而设：在您授予访问权限之前，说明这项访问的用途。更多详情见[安全页面](/securite)和[隐私政策](/confidentialite)。

撤销访问权限可以在两处进行。在 Pilotiko 中，“断开连接”会删除令牌，从记忆库中清除从 Google 读取的日程（企业内人员已确认的事实除外），并把该操作记入审计日志。在 Google 一侧，您账户的“关联应用”页面可以选择 Pilotiko，再点“删除访问权限”；Google 说明，此后该应用将无法再访问您的账户 [3]。

## 目前有哪些限制？

- 客户预约的会议首先保留在 Pilotiko 的排程中；自动复制到 Google 的功能尚未上线。
- Google Meet 转录尚未开发；关于会议摘要，请参阅 [Zoom](https://app.pilotiko.com/zh/integrations/zoom) 和 [Microsoft Teams](https://app.pilotiko.com/zh/integrations/microsoft-teams)。
- 如果您的企业使用 Microsoft 365，[Outlook / Microsoft 365](https://app.pilotiko.com/zh/integrations/outlook-microsoft-365) 页面介绍了对应的功能；所有连接都列在[集成索引](https://app.pilotiko.com/zh/integrations)中。

## 常见问题

### 使用 Pilotiko 预约需要 Google 日历吗？

不需要。在线预约和空闲时段的计算只靠 Pilotiko 的排程就能运行。连接器连接后，Google 日历则会把您的其他安排也考虑进去。

### Pilotiko 能读取我的日程内容吗？

可以，日历连接后：Pilotiko 会读取日程的时间、标题、描述、地点和参会者，用于您的可用时间和企业的记忆库。Google 的授权页面会在您同意之前显示这一点（calendar.events：查看和编辑日程）。

### 我的客户会收到 Google 邀请吗？

在您的 Google 日历中创建会议时，Pilotiko 会请 Google 通知参会者。创建会议需要有人批准。

### Pilotiko 会添加 Google Meet 链接吗？

是的，如果会议安排为视频会议并选择了 Google Meet，Pilotiko 会在创建活动时自动请求生成 Meet 链接。

### 如何切断 Pilotiko 对我日历的访问权限？

请在 Pilotiko 的“连接”页面点击“断开连接”：令牌将被清除。同时，请在您 Google 账号的“关联应用”中撤销访问权限，这样 Google 端的授权也会被取消。

### 那 Apple 日历或 iCal 链接呢？

Pilotiko 不会连接 iCloud，也不支持 iCal 订阅。它只会在预约结束后，为您的客户提供一个“添加到我的日历”的 .ics 文件，Apple、Google 和 Outlook 都可以打开。

## 资料来源

1. Google for Developers, « Choose Google Calendar API scopes », https://developers.google.com/workspace/calendar/api/auth (查阅于 2026-10-15)
2. Google for Developers, « Freebusy: query (Google Calendar API) », https://developers.google.com/workspace/calendar/api/v3/reference/freebusy/query (查阅于 2026-10-15)
3. Aide Compte Google, « Gérer les associations entre votre compte Google et les applications d'autres développeurs », https://support.google.com/accounts/answer/13533235?hl=fr (查阅于 2026-10-15)
4. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (查阅于 2026-10-15)
5. RFC Editor (IETF), « RFC 7636 : Proof Key for Code Exchange by OAuth Public Clients », https://www.rfc-editor.org/rfc/rfc7636 (查阅于 2026-10-15)
