Google 日历连接器产品方案 PRD

版本：v1.0 草稿 | 创建日期：2026-06-21

需求来源：Google 日历连接器近期建设需求 + Outlook 日程同步一期/二期方案复用

业务模块：协同日程 / 日程同步 / 第三方连接器

文档状态：草稿

需求变更记录

依赖需求 Story 列表

一、需求概述

1.1 需求背景

当前纷享销客已围绕 Outlook / Office 365 建设日程同步能力，覆盖后台组织级配置、个人授权、同步方向、日程选择、主日历同步、参与人/联系人解析、历史范围、解除授权保留数据、第三方日程展示等主干规则。

随着国际化客户对 Google Workspace 的使用增加，需要新增 Google 日历连接器，使用 Google Workspace 的企业能够将 Google Calendar 与 CRM 日程进行同步。Google 本期只做日历能力，不纳入 Gmail 和 Contacts。

本需求不是重新设计一套独立日程同步体系，而是在 Outlook 日程同步一期/二期方案基础上新增 Google Calendar 平台适配。可复用的规则应尽量复用；Google 特有的授权、字段映射和 API 能力差异单独定义。

1.2 市场背景参考

1. Microsoft 365 / Outlook 仍是国际企业办公场景中的强主流平台。Gartner 2025 年研究摘要提到，Microsoft 365 在 SaaS enterprise productivity 中约占 77% 份额；Microsoft 财报也披露 M365 commercial paid seats 已超过 4.5 亿。
2. Google Workspace / Google Calendar 是另一类高频国际办公生态。Google Workspace 官方资料显示，其覆盖超过 30 亿用户和超过 1100 万付费客户，套件中包含 Gmail、Calendar、Drive、Docs、Meet 等基础办公能力。
3. 从办公入口看，Gmail 和 Outlook 都是全球高频使用入口。Litmus 邮箱客户端数据中，Gmail 与 Outlook 均长期处于主要邮箱客户端之列，可作为 Google / Microsoft 办公生态高频使用的辅助参考。

结论：当前虽暂无明确客户反馈“一定要使用 Google Calendar”，但 Google Calendar 作为 Google Workspace 默认日历能力，属于国际化客户前期选型和项目搭建中容易遇到的基础能力缺口。本期建设 Google 日历连接器，核心是先解决从无到有，避免客户已采用 Google Workspace 时，因纷享缺少 Google Calendar 集成而在售前或项目落地阶段处于被动。

参考资料：Gartner Microsoft 365 研究摘要、Microsoft FY26 Q2 财报、Google Workspace 官方资料、Litmus Email Client Market Share。

1.3 现有方案依据

1.4 竞品调研：Salesforce Google 连接流程

Salesforce 在 Einstein Activity Capture 中提供 Google 连接能力时，服务选择使用 Google G Suite，并提供 用户级 与 Google Workspace Marketplace 应用程序 两种连接方式。

这里的 G Suite 可以理解为 Google Workspace 的历史平台名称。对我们来说，微软侧现有服务卡片展示为 Microsoft Office 365，Google 侧服务卡片建议展示为 Google，避免误解为只支持某一个单点日历产品；第二步连接方式再展示 Google Workspace 应用连接，说明这是面向 Google Workspace 企业账号的连接方式。功能边界仍明确为“仅同步 Google Calendar，不做 Gmail / Contacts”。

参考截图：

截图	说明
	Salesforce 在服务选择中使用Google G Suite，与 Office 365、Exchange 并列
	Salesforce 提供用户级 与 Google Workspace Marketplace 应用程序 两种连接方式
	Marketplace 路径要求管理员登录、选择用户、安装应用程序
	Salesforce 已在 Google Workspace Marketplace 提供 Einstein Activity Capture 应用

1.5 产品价值

1. 覆盖使用 Google Workspace 的国际化客户，补齐 Google Calendar 与 CRM 日程同步能力。

1.6 需求目标

1. 新增 Google 日历连接器，支持企业管理员完成 Google Workspace 日历同步配置。
2. 支持员工在个人设置中授权 Google 日历连接账户，授权邮箱必须等于 CRM 个人邮箱。
3. 支持 CRM 日程与 Google Calendar 主日历之间按配置方向同步。
4. 复用 Outlook 日程同步规则：历史范围、默认不同步、解除授权保留数据、参与人/联系人解析、编辑删除回流、绿色展示、系统创建不可编辑等。
5. 明确 Google 与 Outlook 在同一企业内的互斥规则：一个企业同一时间只允许启用一个日历平台。

二、整体方案

2.1 主流程

三、后台配置方案

3.1 功能入口

沿用 Outlook 日程同步入口：

• 路径：业务插件管理 - 日程同步
• 管理权限：沿用【日程同步】权限，默认分配给系统管理员和 CRM 管理员，支持自定义管理角色分配。
• 配置列表中，Google 与 Outlook 同属日历同步配置，但企业级平台互斥。

3.2 配置流程

步骤	名称		Google 方案
步骤一	选择日历服务		新增Google
步骤二	选择连接方式		展示Google Workspace 应用连接
步骤三	将 Google Workspace 连接至 CRM		管理员按 Google Workspace 管理后台授权要求配置应用连接信息
步骤四	同步配置		设置同步方向，默认不同步

3.2.1 选择日历服务

3.2.2 选择连接方式

服务名称说明：

• 第一步服务卡片建议使用平台名称 Google，与现有 Microsoft Office 365 同属于第三方日历平台选择。
• 第二步连接方式建议使用 Google Workspace 应用连接，表达这是 Google Workspace 企业账号下的应用授权方式，不直接暴露 OAuth、Marketplace、Domain-wide delegation 等技术名词。
• 如果后续确认会通过 Google Workspace Marketplace 上架应用，可在帮助说明中补充“从 Google Workspace Marketplace 安装或授权纷享应用”。在未确认 Marketplace 上架前，不建议把连接方式主名称直接写成 Google Workspace Marketplace 应用程序。

3.2.3 将 Google Workspace 连接至 CRM

Google Workspace 连接器建议只保留两种产品路径：

• 方案 A：Google Workspace Marketplace 应用连接。 对标 Salesforce 的企业级连接体验，长期推荐。
• 方案 B：手动 OAuth 应用配置。 对标当前 Office 365 日程同步中“客户去第三方管理后台创建应用、获取 ID 和密钥、配置 API 权限、回填纷享后台”的模式，作为本期不上架 Marketplace 时的落地方案。

API 权限选择

结论：本期默认申请 https://www.googleapis.com/auth/calendar.events。该 scope 可以覆盖 Google 日历事件的查看和编辑，能支撑向内同步、向外同步、编辑和删除回流；不默认申请完整 calendar 权限，避免把日历列表、共享设置等超出本期范围的能力一并授权。

管理员侧需要理解的配置点：

1. 只授权 Calendar 事件读写，不授权 Gmail、Contacts、Drive 等能力。
2. 如果采用 Marketplace 应用路径，权限范围会在应用安装/授权过程中展示，管理员确认即可。
3. 如果采用手动 OAuth 应用路径，客户需要在 Google Cloud / Google Auth Platform 中创建 OAuth 应用，并在 OAuth consent screen 中配置本期 scope。
4. 员工个人授权时仍会看到 Google 授权确认页，授权邮箱必须等于 CRM 个人邮箱。

方案 A：Google Workspace Marketplace 应用连接

适用场景：希望客户管理员像 Salesforce 一样，从 Google Workspace Marketplace 安装或授权纷享应用，减少手动复制 Client ID、Client Secret、Redirect URI 的步骤。

客户管理员需要做的工作：

1. 使用 Google Workspace 管理员账号进入 Google Workspace Marketplace。
2. 找到并安装/授权纷享应用。
3. 确认应用请求的 Calendar 事件权限，授权范围为 calendar.events。
4. 回到纷享后台，完成连接状态校验并进入同步配置。

纷享需要提前完成的工作：

纷享后台第三步“连接配置”建议展示：

方案 A 的结论：体验最好、最像 Salesforce，但需要提前完成 Google Marketplace 上架和审核工作，不一定适合作为本期最快上线路径。

方案 B：手动 OAuth 应用配置

适用场景：本期暂不上架 Google Workspace Marketplace，但仍需要支持客户完成 Google Calendar 连接。这个模式更接近现有 Office 365 日程同步手册：客户管理员先到第三方平台创建应用和配置权限，再把关键 ID / 密钥填回纷享后台。

客户管理员需要在 Google 侧做的工作：

1. 在 Google Cloud Console 创建或选择企业自己的 Cloud project。
2. 启用 Google Calendar API。
3. 在 Google Auth Platform / OAuth consent screen 中配置应用信息和授权范围，scope 使用 https://www.googleapis.com/auth/calendar.events。
4. 创建 OAuth 2.0 Client，应用类型选择 Web application。
5. 配置纷享提供的 Authorized redirect URI。
6. 获取 Client ID 和 Client Secret。
7. 必要时在 Google Admin console 的第三方应用访问控制中，将该 OAuth 应用设为可信或允许访问。
8. 回到纷享后台填写连接信息，系统校验成功后进入同步配置。

与 Office 365 配置的对齐结论：

• Google OAuth 手动配置下，和 Office 365 类似，客户最终需要回填到纷享后台的核心凭证是 Client ID 和 Client Secret。
• Google 侧没有一个与 Microsoft Entra 租户ID 完全等价、且必须回填到第三方系统的“租户字段”。Google Workspace 域名不是 OAuth 授权必填凭证，本期不建议放入连接配置表单；如后续需要企业域识别，可作为系统自动解析或排障信息处理。
• Redirect URI 与 API 权限范围不由客户随意填写，而是由纷享后台展示给管理员，管理员复制到 Google Cloud / OAuth 配置中。

纷享后台第三步“连接配置”需要支持填写：

方案 B 的结论：最接近当前 Office 365 手册中的配置模式，适合作为本期不上架 Marketplace 时的可落地方案；缺点是客户需要进入 Google Cloud / Admin console 操作，实施门槛高于方案 A。

推荐决策

本期产品方案建议按以下优先级收敛：

1. 长期目标按方案 A 设计：Google Workspace Marketplace 应用连接。 这是更标准、更低配置成本的企业级体验，也更接近 Salesforce 的呈现方式。
2. 本期如 Marketplace 上架周期不可控，优先落地方案 B：手动 OAuth 应用配置。 该方式与现有 Office 365 同步的客户配置心智一致，后台需要让客户填写 Client ID / Client Secret，并提供 Redirect URI 和 scope 指引。
3. Service Account / Domain-wide delegation 不进入本期主方案，只作为后续高级集成能力评估。

官方依据：

• Google Calendar API scopes：https://developers.google.com/workspace/calendar/api/auth
• Google Calendar Events list / watch 支持 calendar.events scope：https://developers.google.com/workspace/calendar/api/v3/reference/events/list、https://developers.google.com/workspace/calendar/api/v3/reference/events/watch
• Google OAuth Client ID / Client Secret：https://support.google.com/cloud/answer/15549257
• Google OAuth consent screen：https://developers.google.com/workspace/guides/configure-oauth-consent
• Google Workspace Marketplace 发布流程：https://developers.google.com/workspace/marketplace/how-to-publish
• Google Workspace Marketplace SDK 配置：https://developers.google.com/workspace/marketplace/enable-configure-sdk
• Google Workspace Marketplace OAuth 配置：https://developers.google.com/workspace/marketplace/configure-oauth-consent-screen

3.2.4 同步方向

沿用 Outlook 四种同步状态：

默认规则：

• 新建配置默认 不同步。
• 点击第三步并校验通过后，若第四步取消，保存一条 连接成功 + 不同步 的配置。
• 若同步方向为 不同步，不生成个人待授权卡片。
• 若从可同步方向改为 不同步，已授权用户的授权记录保留，但数据不再同步生效；待后台恢复正常同步方向后，再同步恢复后新发生的数据。

3.2.5 同租户平台互斥校验

Google 日历连接器作为 Outlook 日程同步能力的新增平台，不与 Outlook 在同一企业内并行启用。

不支持同一企业同时开启 Outlook 和 Google 的原因：

1. 控制多人协作场景下的数据同步复杂度。 如果同一企业同时启用两个日历平台，不同用户可能分别授权 Google 和 Outlook。同一场多人日程会同时存在于组织者和参与人所授权的平台，两个连接器均可能感知并回流该日程，造成重复日程回流，并使更新、删除和跨平台去重链路成倍复杂。本期不建设混合平台同步模型，短期内也不将多平台并行作为演进方向。
2. 与主流国际产品的连接口径保持一致。 Salesforce 等成熟产品在企业连接场景中，同样采用一个企业选择一个邮件和日历平台的方式；本期沿用“一个企业启用一个日历平台”的产品口径。

新增任一日历平台配置前，系统需要检查当前企业的日程同步配置列表。平台互斥校验采用通用规则，不按 Google 或 Outlook 分别实现。

切换平台时，不支持只删除其中一条配置，也不以停用、不同步或连接失败作为释放条件。管理员必须返回日程同步配置列表，删除已配置平台下的全部连接器配置，系统确认该平台不存在任何配置记录后，才允许选择其他平台。

通用提示模板：

当前企业已配置 {已配置平台}，暂不支持同时使用多个日历平台。如需切换至 {目标平台}，请先返回日程同步配置列表，删除 {已配置平台} 下的全部连接器配置后再试。

变量示例：已有 Office 365 配置时选择 Google，{已配置平台}展示Microsoft Office 365，{目标平台}展示Google；已有 Google 配置时选择 Office 365，变量反向替换，规则和提示结构保持一致。

四、个人授权方案

4.1 授权入口

沿用 Outlook 个人授权入口：

待授权区卡片：

点击 授权 后展示提示弹窗，沿用 Outlook 弹窗说明，无变更

管理员已为您的邮箱账户创建了日程同步规则，但在规则生效之前，需要您进行授权，表示同意将当前邮箱地址与第三方账户服务进行匹配

已授权区列表：

移动端连接账户页同步展示相同卡片信息，布局沿用现有移动端授权卡片：图标、主标题、类型标签和 授权 操作保持可见。

4.2 授权条件

授权失败文案沿用 Outlook 口径，无变更

您当前的邮箱地址在同步的目标账户服务中不存在，请添加后再重新授权

4.3 解除授权

沿用 Outlook 规则：

• 用户可在已授权列表中解除授权。
• 解除授权后，历史同步产生的日程数据继续保留。
• 解除授权后不再继续同步新数据。
• 非授权期间产生的 Google 日程，在用户重新授权后按历史范围和未来日程规则处理。

五、日程应用方案

5.1 我的日程分组

当企业启用 Google 日历同步且用户授权成功后，在日程应用的 我的日程 下展示：

• CRM日程
• Google同步

规则：

5.2 新建日程

用户个人授权成功后，如果同步方向为 CRM向Google同步 或 双向同步，新建日程页展示 日程选择。

选项固定为：

• CRM日程
• Google同步

规则：

5.3 第三方日程展示

沿用 Outlook规范：

• 由 Google 同步过来的日程，或创建时选择 Google同步 的日程，日/周/月视图默认绿色。
• 日程组件、工具栏日程组件、移动端日程应用和布局组件是否区分颜色，沿用 Outlook 当前规则。
• 详情页中，Google 同步日程按第三方日程展示。

5.4 编辑、删除与系统创建

沿用 Outlook：

六、同步规则

6.1 日历范围

本期只同步 Google Calendar 主日历：

• API 层可使用 calendarId = primary 指代授权用户主日历。
• 不拉取 Google Calendar 其他日历分组。
• 不同步共享日历、资源日历、订阅日历。
• CRM 侧固定展示 Google同步，不映射 Google Calendar 的多个 calendar 名称。

6.2 时间范围

沿用 Outlook 历史范围配置：

历史范围配置沿用 Outlook，不在 Google 连接器中重新定义。

6.3 同步方向

编辑、删除、作废的回流规则沿用 Outlook，包括：

• 同步方向控制新增、编辑、删除是否回流。
• 配置从单向切换为双向后，已存在的第三方同步数据按新方向生效。
• 配置变为不同步或连接失败后，已授权卡片保留，但数据不再同步；恢复后同步恢复时点之后的新变化。

6.4 参与人与联系人解析

沿用 Outlook：

6.5 循环日程

Google 循环日程本期不单独展开新方案。

规则：

• 当前先按 Outlook 现有逻辑走。
• CRM 创建 Google 同步日程时，如果当前 Outlook 逻辑对第三方循环日程仍是拦截，则 Google 同步也保持拦截。
• Google 创建循环日程同步到 CRM 的处理方式，跟随 Outlook 当前同步逻辑。
• 后续由独立循环日程方案统一解决 Google 循环日程与纷享循环日程之间的同步逻辑。
• Outlook 循环日程适配完成后，Google 再基于统一规则适配。

Google 官方能力说明：

• Google Calendar Event 通过 recurrence[] 表示 RRULE/RDATE/EXDATE。
• 单个循环实例和例外实例会涉及 recurringEventId、originalStartTime 等字段。
• 这些能力比本期 Google 连接器范围更复杂，因此不在本方案中展开。

6.7 Google Meet 和附件

本期不考虑：

七、字段映射

7.1 纷享日程与 Google Event 映射

7.2 字段处理原则

1. 能直接映射的基础字段按字段级映射处理，不做数据级复杂拼接。
2. 参与人和联系人继续按邮箱解析。
3. 超出 Google 或 CRM 字段长度限制时，沿用 Outlook 截断策略。
4. Google 返回但 CRM 无字段承载的信息，不强行写入日程内容。

八、异常与边界

8.1 企业切换平台

企业从 Outlook 切换到 Google，或从 Google 切换到 Outlook：

• 必须先删除当前平台下的全部连接器配置；停用、不同步或连接失败均不视为释放平台。
• 历史第三方日程继续保留展示。
• 历史日程不迁移到新平台。
• 历史日程不因新平台配置重新同步。
• 旧平台配置删除后，对应个人授权卡片和日程筛选项移除。
• 旧平台产生的历史数据仍默认展示在日历中。

8.2 邮箱变更

沿用 Outlook：

8.3 连接失败

沿用 Outlook：

• 后台连接状态变为连接失败后，已授权用户的已授权卡片仍展示。
• 数据同步不再生效。
• 未授权用户是否仍展示待授权卡片，沿用当前 Outlook 对象侧实现。
• 连接恢复后，授权关系继续有效，同步恢复时点之后的数据。

8.4 删除配置

沿用 Outlook：

• 删除连接器配置。
• 删除个人设置中对应授权卡片。
• 删除日程应用中 Google同步 筛选项。
• 删除日程创建页 Google同步 选项。
• 不删除历史同步产生的日程数据。

删除提示文案建议：

删除后，与之相关的个人设置-连接账户中对应员工的授权数据以及日程应用中涉及到该配置项的展示将全部删除。基于该配置已同步产生的历史日程数据将继续保留，确认要删除当前配置吗？

九、官方资料依据

十、风险点

十一、待确认事项

十二、上线策略

12.1 收费标准

• [X] 不收费，随日程同步能力提供
• [ ] 收费
• [ ] 待确认

12.2 上线节奏

建议灰度：

12.3 适用终端

十三、规范检查项

13.1 多语言

需要新增或复用以下文案多语：

13.2 埋点

本期需要补充 Google 日历连接器相关埋点，整体沿用 Outlook 日程同步已有统计口径，并在事件属性中区分第三方平台类型，避免为 Google 重新建设一套不可对比的统计体系。

产品口径：

1. 若现有 Outlook 埋点已支持第三方平台维度，本期优先复用原事件 Key，仅新增 platform=google / connector=google_calendar 等维度。
2. 若现有 Outlook 埋点事件 Key 固定写死 Office 365，需要研发评估改造为通用“第三方日程同步”事件，避免后续继续接入其他日历平台时重复新增看板。
3. 授权失败、同步失败等失败原因应与现有 Outlook 失败原因枚举保持可比；Google 特有失败原因可在枚举中追加。
4. 后台连接器配置创建、编辑、删除属于管理员配置行为，可优先进入操作日志；如后续需要分析管理员配置转化，再补充后台配置埋点。

13.3 操作日志

建议沿用 Outlook 日程同步操作日志口径：

• 创建 Google 日历连接器配置
• 编辑同步方向
• 删除配置
• 用户授权 / 解除授权
• 连接失败 / 恢复

13.4 BI 分析申请

待研发确认。若新增 Google 连接器配置对象字段、第三方平台类型、同步关系表字段、Google event ID、scope、授权状态等，需要按平台规则补充 BI 或对象字段申请。