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 主流程

flowchart TD
  A["管理员进入业务插件管理 - 日程同步"] --> B{"企业是否已有日历平台配置"}
  B -->|"无"| C["选择 Google Workspace"]
  B -->|"已有 Outlook"| D["阻止新增 Google，提示先停用或删除 Outlook 配置"]
  B -->|"已有 Google"| E["可编辑当前/新增 Google 配置"]
  C --> F["选择连接方式：Google Workspace 应用连接"]
  F --> G["填写 Google 授权配置并校验"]
  G --> H["设置同步方向，默认不同步"]
  H --> I["配置成功后生成个人待授权卡片"]
  I --> J["员工在个人设置 - 连接账户授权"]
  J --> K{"授权邮箱是否等于 CRM 个人邮箱"}
  K -->|"一致"| L["授权成功，日程应用展示 Google同步"]
  K -->|"不一致"| M["授权失败，提示邮箱不匹配"]
  L --> N["按同步方向同步 CRM 与 Google 主日历"]

三、后台配置方案

3.1 功能入口

沿用 Outlook 日程同步入口：

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

3.2 配置流程

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

3.2.1 选择日历服务

3.3.1 选择连接方式

服务名称说明：

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

3.3.1 将 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.5 同步方向

沿用 Outlook 四种同步状态：

默认规则：

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

3.6 同租户平台互斥校验

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

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

1. 同一用户跨平台互斥会变成独立治理能力，涉及自动解绑、手动解绑、历史数据展示、授权卡片显示等额外规则。
2. 日程选择 是单选字段，两个平台并存会带来历史值、布局保存、跨平台切换和详情页展示问题。
3. 同一个外部会议可能同时从 Outlook 和 Google 回流，CRM 难以稳定判断去重。
4. CRM 创建一条日程时，如果参与人分别授权 Outlook 和 Google，会出现一条 CRM 日程对应两个外部事件的风险。
5. 适用范围、同步方向、连接失败、删除配置等组合会显著扩大测试矩阵。
6. Salesforce 等成熟产品也采用租户或连接层面的平台选择口径，可作为产品取舍参考。

新增 Google 配置前，系统需要检查当前企业是否已存在 Outlook 日历同步配置。

提示文案建议：

当前企业已启用 Office 365 日程同步。同一企业暂不支持同时启用多个日历平台，如需使用 Google 日历同步，请先删除或停用现有 Office 365 日程同步配置。

反向新增 Outlook 时：

当前企业已启用 Google 日历同步。同一企业暂不支持同时启用多个日历平台，如需使用 Office 365 日程同步，请先删除或停用现有 Google 日历同步配置。

四、个人授权方案

4.1 授权入口

沿用 Outlook 个人授权入口：

• 路径：个人设置 - 连接账户
• 展示区域：待授权、已授权
• 类型：日程同步
• 连接器名称：走“Google 日历同步配置名称“
• 连接类型：组织级
• 过期时间：日程同步类型不显示过期时间

个人设置中的 Google 连接器卡片样式沿用 Outlook / WPS 现有连接账户样式，仅替换平台信息。

待授权区卡片：

点击 授权 后展示提示弹窗，沿用 Outlook 说明口径，文案调整为：

管理员已为您的企业创建了 Google 日程同步规则，但在规则生效之前，需要您进行授权，表示同意将当前邮箱与 Google Workspace 日历服务进行匹配。

已授权区列表：

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

4.2 授权条件

授权失败文案沿用 Outlook 口径，可补充邮箱匹配说明：

当前 Google 账号邮箱与 CRM 个人邮箱不一致，无法完成绑定。请使用与 CRM 个人邮箱一致的 Google Workspace 账号授权。

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 Event 资源包含 visibility 和 eventType 字段。
• 本期产品规则不对这两个字段做业务过滤。
• 如果 Google API 因权限或事件可见性只返回部分字段，系统按实际可读字段同步。

6.6 循环日程

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 连接器创建成功次数
• Google 个人授权成功/失败次数
• Google 同步方向分布
• Google 同步失败原因分布

13.3 操作日志

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

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

13.4 BI 分析申请

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