> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh/guan-li-yuan-jiao-luo/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md). # Zoom 日历端点 ### Web 日历服务 Web 日历服务是 Zoom 向所有 Zoom Apps 提供日历信息的核心。 #### Zoom 存储什么信息？ Zoom 网络日历服务会存储对每个用户的日历提供商进行身份验证所需的对象。这意味着，当组织使用 OAuth 将 Outlook 或 Google 日历连接到 Zoom 服务时，Zoom 会存储刷新令牌。这还意味着，对于使用基础版身份验证接入 Exchange On-Premises 的组织，Zoom 会存储账户用户名和密码。 | 已同步的事件 | | ------------ | | `已省略观众` | | `描述` | | `显示名称` (观众) | | `电子邮件` (观众) | | `固定工作位置` | | `iCalUID` | | `位置` | | `显示名称` (组织者) | | `电子邮件` (组织者) | | `摘要` | | `时间提议` | | `已启用工作位置` | 启用双向日历同步（同步 2.0）后，Zoom 不会在其数据库中保留外部日历事件 & 活动 &直播数据（来自 Microsoft 365 或 Google 日历）。\ \ 相反，该服务会监控一个滚动的 24 个月日历活动窗口（最多包括过去 6 个月和未来 18 个月）。如果此窗口内发生更改，Zoom 会收到来自日历提供商的更改通知，并按需检索更新后的事件 & 活动 &直播数据，以处理相应的 Zoom 会议更新。随后会通知会议服务应用所需的更改。 管理员可以在账户或用户群组级别配置此功能/特性。请参阅我们的 [支持文档](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) 了解更多信息。 #### 存储的令牌和凭据是如何受到保护的？ 存储的令牌和凭据在静态存储时使用 256 位 AES-GCM 加密进行加密。此数据被视为客户内容，并受 Zoom 的访问控制政策和标准约束。这些控制措施会由独立审计公司进行评估，并体现在我们的安全认证和鉴证中，例如 SOC 2。对基础架构数据和系统的特权访问会被记录、监控，并使用多因素身份验证和最小权限访问控制进行控制。 #### 应用程序与日历提供商之间的流量是如何受到保护的？ 日历提供商与任何 Zoom 软件（包括 Zoom 桌面版/移动版应用程序、Zoom Web 日历服务、安排工具和 API 连接器）之间的通信，都会在传输过程中使用 TLS 1.2 进行加密。 #### OAuth 令牌的有效期是多久？ Zoom 将请求在 1 小时后过期的访问令牌和在 90 天后过期的刷新令牌，但日历提供商可能会提供具有其他限制的令牌。如果您需要修改默认值，请遵循您的提供商说明。 #### 我可以撤销 OAuth 令牌或凭据吗？ Zoom 管理员可以随时选择从单个 Zoom 账户中移除日历集成，这将阻止该用户的日历功能正常运行。请立即删除该用户的任何存储令牌或凭据。 Microsoft 365 管理员可以通过在 Entra ID 企业版应用程序门户中删除 Zoom 应用程序，来移除所有用户账户的 Zoom 日历访问；而 Google 工作区管理员则可以使用 Google 云平台控制台撤销访问。 #### 我可以限制 Zoom 向提供商写入日历或联系人数据的能力吗？ 完成初始配置后，Zoom 管理员在通过 Microsoft 365 方法正在连接时，可以为日历和联系人同时选择“只读”和“读/写”权限。管理员还可以限制 Google 工作区对用户日历的集成。 ### 桌面和移动应用 #### Zoom Apps 会存储任何日历或联系人数据吗？ Zoom Apps 会将日历信息保存在临时内存（RAM）中，并且不会将任何项目持久保存到本地磁盘。这包括身份验证令牌、凭据、日历事件信息和联系人数据。客户端退出后，这些数据将不再在线。 #### 登录时会发生什么？ Zoom Apps 会在每次登录时进行完整刷新，以收集即将到来的事件列表。这涉及从 Zoom Web 日历服务接收其 OAuth 访问令牌或存储的凭据，然后使用该对象直接从日历提供方刷新事件数据。如果访问令牌无效，Zoom Web 日历服务将使用刷新令牌请求新的访问令牌并将其传递给客户端。 #### 客户端如何知道要刷新其即将到来的事件列表？ 在网页门户中连接日历后，Zoom Web 日历服务会为每个用户订阅日历提供方的 Webhook。这些 Webhook 会将任何更改通知给 Web 日历服务，以便它随后通知 Zoom 客户端需要进行更新。最后，Zoom 客户端将直接向日历提供方请求更新。未收到更新通知的应用会每 30 分钟刷新一次其事件 & 活动 &直播列表。 #### 客户端可在线获取哪些会议详细信息？ Zoom Apps 在清理其解析的事件 & 活动 &直播后显示会议数据，这意味着它已丢弃所有未使用的属性。下表概述了保存供使用和已丢弃的事件 & 活动 &直播属性。 | 保存在客户端中供显示 | 已丢弃且未保留 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | | | | | \*仅当由 AI Companion 2.0 驱动的 事件 & 活动 &直播 捕获已启用时 | | #### 任何日历安排数据是否存储在客户端日志中？ Zoom apps 不会将令牌、凭据或 事件 & 活动 &直播 等敏感日历数据打印到任何客户端日志中。 ### 安排工具 Zoom 提供了多种工具，以简化与 Microsoft 和 Google 产品结合使用的 Zoom 会议安排体验。这些产品包括适用于 Google 工作区 和 Microsoft 365 的原生安排集成，或用于 选择 浏览器 和 Outlook 的软件扩展。 #### 安排工具如何工作？ 除 Outlook 插件外，所有安排工具都会直接向日历提供商和 Zoom 的 Web 日历服务提交 API 请求。Outlook 插件的不同之处在于，它通过 Zoom 桌面客户端安排会议，而 Zoom 桌面客户端会代表该插件向 Zoom Web 日历服务提交 API 请求。 #### 使用工具安排会议时，会向 Zoom 发送哪些信息？ 使用安排工具时保留的唯一数据是安排会议所需的信息。例如，当用户使用 Microsoft 365 加载项安排 Zoom 会议时，该加载项会使用事件 & 活动 &直播主题、日期、时间、时区和重复标志来安排 Zoom 会议。Zoom 加载项不会请求或使用正文或观众列表等额外详细信息。 #### 是否有任何防火墙或安全要求？ 除日历集成已经需要的内容外，安排工具不需要任何额外的防火墙或安全更改。完整的要求列表记录在 [Zoom 的网络和防火墙规则](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### Outlook 插件和 Outlook 加载项有什么区别？ Outlook 插件安装在最终用户的设备上，并协助用户通过其 Outlook 客户端安排 Zoom 会议。该插件通过进程间通信频道（IPC）与 Zoom Workplace 桌面客户端通信。借助该 IPC，插件会通过客户端的资源向 Zoom 的 Web 日历服务发送安排信息。 为在遵循 Apple 和 Microsoft 制定的政策与指南的同时为我们的用户提供最佳体验，Zoom 强烈建议部署和使用适用于 Outlook 的 Zoom 插件。该插件为您提供更便捷的部署和更强大的管理解决方案，由 Microsoft 积极支持，并且更能满足 Apple 等供应商近期增强的安全要求。 {% hint style="danger" %} **警告** 不会为适用于 Outlook 的 Zoom 插件实施新的功能/特性增强。强烈建议迁移到适用于 Outlook 的 Zoom 加载项。 {% endhint %} Outlook 添加项是一个基于 Web 的应用程序，不需要在用户设备上进行本地安装，而是作为内置网页应用出现，既可在本地客户端中使用，也可在 Outlook 网页版中使用。该添加项通过 web API 运行，并直接与 Zoom 的日历 Web 服务通信。 插件和添加项提供类似功能，但添加项需要 Outlook JavaScript API 要求集 v1.8——这是一个仅存在于现代版 Outlook 中、并且在本地部署的 Exchange Server 上根本不在线的版本——才能在线。这意味着： * Outlook 添加项不能用于本地 Exchange Server 的委派安排。 * 代表必须使用 Microsoft 365 Outlook 客户端、Mac/PC 版 Outlook 2021 或更高版本，或网页版 Outlook，才能代表另一位用户安排/定时发送会议。 #### 我如何识别官方 Zoom 添加项应用程序？ 可从以下位置在线获取的官方适用于 Outlook 的 Zoom 插件应用程序 [Microsoft AppSource 商店](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) 以“Zoom-Office-添加项-SSO”的名称安装到您的 Entra ID 企业版应用程序目录中，应用程序 ID 为 ce63c970-e2d7-45e6-bee1-80c330b0800b。 #### 我需要更新 Outlook 插件还是加载项？ 截至 2025 年 1 月，Microsoft 已开始使用嵌套应用身份验证（NAA）替换旧版 Exchange Online 令牌。Zoom 管理员应与 Entra 管理员协作，按照支持文章中的说明在 Zoom Web门户中配置 NAA。 [配置 Office 加载项的嵌套应用身份验证](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **注意** 嵌套应用身份验证（NAA）仅支持 Exchange Online。使用 Exchange 2019（或其他本地部署版 Exchange）的组织需要继续使用旧版 Exchange 用户标识令牌和回调令牌，因为这些令牌在本地部署环境中不会被阻止。 {% endhint %} 否则，适用于 Outlook 的 Zoom 插件加载项是一个基于 Web 的应用程序，不需要在用户设备上进行本地安装，而是显示为一个内置 Web 应用程序，通过 Web API 与 Zoom 的 Web 日历服务进行通信。该加载项适用于 Windows 和 macOS 版 Outlook 应用、Android 和 iOS 版 Outlook 应用，以及网页版 Outlook。该加载项可由 Outlook 管理员进行配置和批量部署，也可由单个用户安装。 Outlook 插件作为已安装的软件运行，会不时进行更新和增强。因此，该插件需要随着时间推移进行版本管理和升级。 {% hint style="info" %} **注意** Outlook 插件不需要嵌套应用身份验证。 {% endhint %} #### 哪种安排工具最适合我的环境？ **Google 工作区** 使用 Google 工作区的组织可以通过从 Google 工作区 Marketplace 安装 Zoom for GSuite 应用，轻松启用所有用户通过 Google 日历安排/定时发送 Zoom Meetings。该应用可集中管理，并会随着 Zoom 向 Google 提交增强功能而自动更新。 或者，也可以使用基于浏览器的扩展程序，但它们通常更适合个人账户用户，因为它们需要本地安装、定期更新，且无法集中管理。 **Microsoft** 对于使用 Microsoft 365 或本地 Exchange Server 的组织，最佳选项取决于环境以及日历集成的配置方式。 适用于 Outlook 的 Zoom 插件加载项是 Microsoft 365 环境的首选工具——无论您使用的是 Outlook 的桌面版、网页版还是移动版。该加载项要求使用适用于 Microsoft 365 的 Outlook、Windows 版 Outlook 2013 或更高版本，或 Mac 版 Outlook 2016 或更高版本。 双向日历同步可确保无缝的日历更新，并且在集成日历时默认启用。这使 Zoom 能够自动反映 Outlook 日历事件中的更改——例如重新安排的时间或取消——而无需用户通过加载项手动更新或移除会议。如果未捕获这些更改，Zoom 会议链接可能会过期，因此这一点尤其重要，尤其是在会议被移动到原始日期 30 天之后的情况下。会议 ID 通常会在 30 天后过期，除非它们属于重复系列的一部分。 现代 JavaScript API (v1.8)（为 OnAppointmentSend 等基于事件 & 活动 &直播的自动化提供支持）不受以下环境和应用程序支持： * 本地 Exchange 环境 * 连接到 M365 的经典 Outlook * iOS 和 Android 上的移动版 Outlook 因此，在这些设置中，Zoom 无法通过加载项自动检测或更新会议。若没有双向同步或基于 API 的自动化，即使是重复会议也可能无法反映更改，从而导致 Zoom 链接过期或无效。 Zoom Outlook插件仅支持 Windows 系统。它通过与 Zoom Workplace 应用直接集成来提供增强的会议同步，从而绕过 Microsoft API 的限制。虽然建议在没有双向同步的 Windows 系统上使用它，但它有一些明显的限制： * 需要由 IT 管理的 MSI 更新 * 较慢的会议安排 * 不支持 macOS 或移动设备 ### Zoom Rooms Zoom Rooms 日历集成独立于用户的桌面或移动客户端集成进行。 设置完成后，日历事件会显示在 Zoom Rooms 显示设备上，包括电视屏幕、安排界面和控制面板。用户可以通过房间控制器一键式启动或加入会议。 #### 设置概览 Zoom Rooms 日历集成涉及两个不同的配置层。无论您选择哪种身份验证方法，第一层都是必需的。 **第 1 层：Exchange 资源邮箱配置（所有方法均必需）** 在配置身份验证之前，管理员必须为每个 Zoom Room 设置 Exchange Online 资源邮箱。这包括在 Exchange Online 中配置资源邮箱，并通过 Exchange Online PowerShell 更新日历处理规则。默认情况下，Exchange Online 会将多个日历处理属性设置为 `True`，这会导致 Exchange 从资源邮箱的日历条目中删除会议详细信息——例如主题行、组织者信息和评论。Zoom Rooms 需要保留这些详细信息，以便在房间显示设备和控制器上显示有意义的事件 & 活动 &直播信息。管理员必须将以下日历处理属性更新为 `False` 对每个 Zoom Room 资源邮箱使用 `Set-CalendarProcessing` cmdlet： * `DeleteSubject` * `AddOrganizerToSubject` * `DeleteComments` * `RemovePrivateProperty` 此配置必须对每个资源邮箱重复执行。有关完整的 PowerShell 操作步骤（包括验证步骤），请参阅 Zoom 支持文章 [使用 Office 365 设置 Zoom Rooms](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474\&DeviceId=70283b61-c13a-475f-ab4d-4a89b1632c1b\&SessionId=1782321876035)。无论您在第 2 层中选择哪种身份验证方法，此层都是必需的。 **第 2 层：身份验证方法选择** 配置资源邮箱后，管理员选择一种身份验证方法，以启用 Zoom Rooms 对日历数据的访问： {% stepper %} {% step %} *应用程序权限（Microsoft Graph API）* * **推荐**：此方法通过具有管理员同意的 Azure 应用注册使用 OAuth 2.0 客户端凭据流程。它不需要专用的服务账户。 {% endstep %} {% step %} *完全委派访问（Microsoft Graph API）* * 此方法使用带有委派邮箱权限的 OAuth 2.0 授权代码流程。它需要专用的服务账户，并且在初始设置和维护方面需要投入更多精力。 {% endstep %} {% endstepper %} Zoom 建议将具有应用程序权限的 Microsoft Graph API 作为标准集成方法。此建议与 Microsoft 计划移除 Exchange Web Services (EWS) 协议的方向一致。Graph API 方法可在 Zoom Rooms 与 Microsoft 365 日历之间提供最稳定的连接。 {% hint style="info" %} 使用第三方会议室系统（如 Cisco、Poly 和 Lifesize）的组织，必须通过 Zoom Enhanced API 连接器完成额外步骤，以确保日历和会议功能正常。有关为 Zoom Rooms 配置日历访问的更多信息，请参阅我们的 M365 日历现场指南文档。 {% endhint %} #### 我可以使用哪些方法来授予对房间邮箱的访问权限？ Zoom Rooms 日历集成依赖 Microsoft Graph API (MGAPI)。Microsoft 已开始 [逐步淘汰 Exchange Web Services (EWS) 方法](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) 这些方法此前可用于连接 Microsoft 365 数据与 Zoom 服务。Zoom 认为这些 EWS 方法属于旧版选项。 Google 工作区只有一种应用权限的方法。 #### 服务账户需要哪些权限？ 具体权限会因所选方法而异。每个选项及所需权限详见下表： | 提供方 | 方法 | 所需权限 | | --------------------------------------- | --------------------------- | ---------------- | | Microsoft 365/Microsoft Exchange Server | 应用程序权限（Microsoft Graph API） | 管理员账户：组织管理和收件人管理 | | Microsoft 365/Microsoft Exchange Server | 完全委派访问（Microsoft Graph API） | 发送为和完全访问权限 | | Google 工作区 | - | 进行更改并管理共享 | {% hint style="info" %} **Zoom 推荐** Zoom 建议日历集成使用应用程序权限方法。此配置所需的管理员工作更少，并且不需要专用的服务账户。对于作为后台服务运行的企业版应用程序，这也是 Microsoft 推荐的方法。 {% endhint %} ### 增强型 API 连接器 通过增强型 API 连接器为基于标准的 H.323 和 SIP 会议室系统进行的日历集成（于 2021 年初发布）独立于用户客户端和 Zoom Rooms 配置进行。服务账户的方法和权限与前面介绍的 Zoom Rooms 部分相同。 #### 增强型 API 连接器的数据流有什么不同？ 通过增强型 API 连接器连接的会议室系统不会直接联系日历提供商，这与 Zoom 客户端和 Zoom Room 的连接流程不同。Zoom Web Service 作为这些系统的客户端，并会将日历数据直接推送到端点，Poly 设备除外。Poly 设备会先向 Zoom Web Service 查询日历更新，然后再将日历数据传输到该设备。 #### 会检索多少天的日历事件？ 增强型 API 连接器会检索未来 30 天内的即将召开的会议数据，并在 30 天后从存储中移除已完成的会议。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://library.zoom.com/technical-library/zh/guan-li-yuan-jiao-luo/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.