> 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-overview.md).

# Zoom 日历概述

当为用户帐户、Zoom Rooms 以及 H.323 或 SIP 会议室系统启用日历集成时，Zoom 可为用户提供最佳体验。

### 启用日历集成有什么好处？

* 用户可在其 Zoom 应用中看到完整的日历（包括非 Zoom 会议）
* 用户可以在其 Zoom 应用中安排和编辑会议
* Zoom Rooms 屏幕和安排显示屏会显示即将到来的日历事件
* 基于标准的 H.323 和 SIP 终端可通过增强版 API 连接器自动加入 Zoom 会议，或通过一键式操作加入

{% hint style="info" %}
双向同步是 **推荐使用并默认启用** 当日历集成有效时。借助双向同步，该集成同时涵盖 Zoom 和非 Zoom 日历事件，为依赖 Zoom 作为其核心安排中心的用户提供统一体验。

启用双向日历同步可确保在安排过程中被删除、编辑或放弃的任何第三方日历事件都会自动与 Zoom Web 日历服务同步
{% endhint %}

### 支持哪些日历提供商？

Zoom 客户可以通过三个提供商集成联系人和日历数据：

* Microsoft 365（原 Office 365）
* Microsoft Exchange Server
* Google 工作区

### 日历集成如何工作？

Zoom 的日历集成遵循四个阶段：授权、事件监控、端点数据检索和双向同步。前两个阶段适用于所有端点和方法。第三个阶段因端点类型和所选的身份验证方法而异。

{% stepper %}
{% step %}

#### **授权与安全凭据存储**

Zoom 管理员——或者在组织允许的情况下，用户——必须首先通过 Zoom Web门户 授权访问其日历提供商。

Zoom 将访问已连接日历所需的对象存储在持久、加密且安全的位置。使用 OAuth 2.0 时，Zoom 会将访问令牌和委派访问刷新令牌安全地存储在 Zoom 云中。然而，对于本地部署的 Exchange（非混合部署），由于其不支持 OAuth 2.0，Zoom 必须将用户名和密码安全地存储在 Zoom 云中，因为这是保持访问的唯一可用方法。

{% hint style="info" %}
与本地部署 Exchange 的直接集成需要基础身份验证。
{% endhint %}

{% hint style="info" %}
您可以选择将日历集成配置为使用 Zoom客户管理的密钥 (CMK) 来加密和存储凭据，从而使用您自己的加密密钥保护 Zoom 云基础设施中静态存储的某些数据。CMK 是付费产品，也是 Zoom 的 自带密钥 (BYOK) 解决方案。您可以 [阅读有关 Zoom CMK 的更多信息](https://www.zoom.com/en/blog/zoom-customer-managed-key/) 在 Zoom 网站上。
{% endhint %}
{% endstep %}

{% step %}

#### **事件监控和更改通知**

在 Web 门户中连接日历后，Zoom Web 日历服务会为每个用户订阅来自日历提供商的 Webhook。这些 Webhook 会将任何日历更改通知给 Web 日历服务，以便它随后通知相应的 Zoom 端点需要进行更新。
{% endstep %}

{% step %}

#### **端点数据检索**

日历数据如何到达 Zoom 端点取决于端点类型和所选的身份验证方法。以下各节将介绍每种模型。

**桌面和移动应用程序：委派访问**

使用委派访问时，Zoom Web 日历服务会在登录时将 OAuth 访问令牌传递给桌面或移动客户端。客户端会在内存中临时保留该令牌，并使用它直接连接到日历提供商以检索事件数据。如果访问令牌无效，Zoom Web 日历服务会使用存储的刷新令牌请求新的访问令牌，并将其传递给客户端。

**桌面和移动应用程序：应用程序权限（Microsoft Graph API）**

使用应用程序权限方法时，访问令牌会保留在 Zoom 云中，不会传递给客户端设备。相反，所有日历数据请求都会代表客户端通过 Zoom Web 日历服务进行代理。客户端不会直接连接到日历提供商。

**Zoom Rooms：两种方法**

无论使用应用程序权限还是完全委派访问，Zoom Rooms 都会将令牌同时存储在 Zoom 云和 Zoom Room 端点本地。Zoom Rooms 会直接连接到日历提供商以检索日历数据。

{% hint style="info" %}
该页面上的图示 [提供商特定详细信息](/technical-library/zh/guan-li-yuan-zhuan-qu/third-party-integrations/zoom-calendaring-integration-explainer/provider-specific-details.md) 展示了用于用户桌面和移动集成的委派式和基于应用程序的 Microsoft Graph API 方法。如上所述，Zoom Rooms 采用不同的令牌存储和检索模型。
{% endhint %}
{% endstep %}

{% step %}

#### 双向日历同步

启用双向日历同步后，如果用户从 Zoom 客户端或网页安排或更新会议，Web 日历服务会通过日历服务提供商的 API 在用户的日历上创建或更新该事件。

{% hint style="info" %}
管理员可以 [配置双向同步](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) 在账户或用户组级别上。

双向同步支持对以下会议类型所做的更新：

* 单个会议
* 一系列会议（重复）
* 一系列会议中的单个实例
  {% endhint %}
  {% endstep %}
  {% endstepper %}

### 自定义 Microsoft Entra 应用程序注册是可选的

要了解更多有关为 Zoom Rooms 设置自定义应用程序的信息，请参阅 Zoom 支持文章 [使用 Office 365 设置 Zoom Rooms](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474).

### 哪些 Zoom 终端可以访问日历服务？

Zoom 日历终端有四种不同类型，本文档后面将更详细地介绍每一种。

* Web 日历服务
* 桌面和移动应用程序
* Zoom Rooms
* 增强型 API 连接器


---

# 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-overview.md?ask=<question>&goal=<endgoal>
```

`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.