> 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-zhuan-qu/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md). # Zoom 日历端点 ### Web 日历服务 Web 日历服务是 Zoom 能够向所有 Zoom Apps 提供日历信息的核心。 #### Zoom 存储哪些信息？ Zoom Web 日历服务会存储用于对每个用户的日历提供商进行身份验证所需的对象。这意味着，当组织使用 OAuth 将 Outlook 或 Google 日历连接到 Zoom 服务时，Zoom 会存储刷新令牌。对于使用基础版 身份验证登录 Exchange 本地部署环境的组织，这也意味着 Zoom 会存储账户用户名和密码。 | 已同步的事件 & 活动 &直播 | | --------------- | | `已省略观众` | | `描述` | | `显示名称` (观众) | | `电子邮件` (观众) | | `固定工作位置` | | `iCalUID` | | `位置` | | `显示名称` (组织者) | | `电子邮件` (组织者) | | `摘要` | | `时间提议` | | `工作位置已启用` | 启用双向日历同步后，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 向提供商写入日历或联系人数据的能力吗？ 在通过 Microsoft 365 方法正在连接时，Zoom 管理员可以为日历和联系人都在“只读”和“读/写”权限之间进行选择。管理员还可以限制用户日历的 Google 工作区集成。 ### 桌面和移动应用 #### Zoom Apps 会存储任何日历或联系人数据吗？ Zoom Apps 将日历信息保存在临时内存（RAM）中，不会将任何项目持久保存到本地磁盘。这包括身份验证令牌、凭据、日历事件 & 活动 &直播信息和联系人数据。客户端退出后，这些数据将不再在线。 #### 登录时会发生什么？ Zoom Apps 会在每次登录时启动完整刷新，以收集即将到来的事件 & 活动 &直播列表。这涉及从 Zoom Web 日历服务接收其 OAuth 访问令牌或已存储的凭据，然后使用该对象直接从日历提供商刷新事件 & 活动 &直播数据。如果访问令牌无效，Zoom Web 日历服务将使用刷新令牌请求并将新的访问令牌传递给客户端。 #### 客户端如何知道要刷新其即将到来的事件 & 活动 &直播列表？ 在 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 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 中。该加载项通过与 Zoom 的日历 Web 服务直接通信的 Web API 运行。 插件和添加项提供类似的功能，但该添加项需要 Outlook JavaScript API 要求集 v1.8——这是一个仅存在于现代版 Outlook 中、并且在本地 Exchange Server 上完全不可在线的版本——才能可用。这意味着： * Outlook 添加项不能用于本地 Exchange Server 上的委派安排。 * 代表另一位用户安排/定时发送会议时，代理必须使用 Microsoft 365 Outlook 客户端、Mac/PC 版 Outlook 2021 或更高版本，或 Web 版 Outlook。 #### 我如何识别官方的 Zoom 添加项应用程序？ 来自以下位置的适用于 Outlook 的 Zoom 插件官方应用程序在线 [Microsoft AppSource 商店](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) 安装到你的 Entra ID 企业版应用程序目录中，名称为“Zoom-Office-添加-in-SSO”，并带有应用程序 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 的桌面版、网页版还是移动版。该加载项需要 Outlook for Microsoft 365、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 更新 * 会议安排/定时发送更慢 * 不支持 Mac 或移动端 ### 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 增强型 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 连接器（于 2021 年初发布）进行的基于标准的 H.323 和 SIP 会议室系统日历集成，独立于用户客户端和 Zoom Rooms 配置进行。服务账户方法和权限与前面介绍的 Zoom Rooms 部分相同。 #### 增强型 API 连接器的数据流有什么不同？ 通过增强版 API 连接器连接的房间系统不会直接联系人日历提供商，这与 Zoom 客户端和 Zoom Room 连接流程不同。Zoom Web Service 作为这些系统的客户端，并会将日历数据直接推送到端点，但 Poly 设备除外。Poly 设备将首先向 Zoom Web Service 查询日历更新，然后 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-zhuan-qu/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.