> 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-tw/guan-li-yuan-zhuan-qu/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md). # Zoom 行事曆端點 ### 網頁行事曆服務 網頁行事曆服務是 Zoom 能夠將行事曆資訊傳遞給所有 Zoom 應用程式的核心。 #### Zoom 會儲存哪些資訊？ Zoom 網頁行事曆服務會儲存驗證每位使用者行事曆提供者所需的物件。這表示當組織使用 OAuth 將 Outlook 或 Google 日曆連接至 Zoom 服務時，Zoom 會儲存重新整理權杖。這也表示，對於使用基本驗證登入內部部署 Exchange 的組織，Zoom 會儲存帳號使用者名稱與密碼。 | 已同步的事件 | | ------------ | | `已省略與會者` | | `描述` | | `顯示名稱` （與會者） | | `電子郵件` （與會者） | | `固定工作地點` | | `iCalUID` | | `地點` | | `顯示名稱` （主辦人） | | `電子郵件` （主辦人） | | `摘要` | | `時間提案` | | `已啟用工作地點` | 當啟用雙向行事曆同步（Sync 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 網頁行事曆服務、排程工具，以及 API 連接器——之間的通訊在傳輸過程中會使用 TLS 1.2 加密。 #### OAuth 權杖的有效期限是多久？ Zoom 會請求 1 小時後過期的存取權杖，以及 90 天後過期的重新整理權杖，但行事曆供應商可能會提供具有不同限制的權杖。如果您需要修改預設值，請遵循供應商的指示。 #### 我可以撤銷 OAuth 權杖或認證嗎？ Zoom 管理員可隨時選擇從單一 Zoom 帳戶移除行事曆整合，這會導致該使用者的行事曆功能無法運作。請立即刪除該使用者的任何已儲存權杖或認證。 Microsoft 365 管理員可透過在 Entra ID 企業應用程式入口網站中刪除 Zoom 應用程式，來從所有使用者帳戶移除 Zoom 的行事曆存取權；而 Google Workspace 管理員則可使用 Google Cloud Platform 控制台撤銷存取權。 #### 我可以限制 Zoom 向供應商寫入行事曆或聯絡人資料的能力嗎？ 完成初始設定後，Zoom 管理員在透過 Microsoft 365 方法連線時，可針對行事曆與聯絡人選擇「讀取」與「讀取/寫入」權限。管理員也可以限制 Google Workspace 與使用者行事曆的整合。 ### 桌面與行動應用程式 #### Zoom 應用程式會儲存任何行事曆或聯絡人資料嗎？ Zoom 應用程式會將行事曆資訊保存在暫時記憶體（RAM）中，不會將任何項目持久儲存在本機磁碟中。這包括驗證權杖、憑證、行事曆事件資訊以及聯絡人資料。用戶端結束後，這些資料就不再可用。 #### 登入時會發生什麼事？ Zoom 應用程式會在每次登入時進行完整重新整理，以收集即將發生的事件清單。這涉及從 Zoom 網頁行事曆服務接收其 OAuth 存取權杖或已儲存的憑證，然後使用該物件直接向行事曆提供者重新整理事件資料。如果存取權杖無效，Zoom 網頁行事曆服務會使用重新整理權杖來請求新的存取權杖並將其傳遞給用戶端。 #### 用戶端如何知道要重新整理其即將發生的事件清單？ 在網頁入口網站中連結行事曆後，Zoom 網頁行事曆服務會為每位使用者訂閱行事曆提供者的 webhook。這些 webhook 會通知網頁行事曆服務任何變更，使其接著通知 Zoom 用戶端需要更新。最後，Zoom 用戶端會直接向行事曆提供者請求更新。未收到更新通知的應用程式會每 30 分鐘重新整理一次其事件清單。 #### 用戶端可取得哪些會議詳細資料？ Zoom 應用程式會在清理其解析的事件後顯示會議資料，這表示它已捨棄所有不使用的屬性。可保留與捨棄以供使用的事件屬性如下表所示。 | 已儲存以供在用戶端顯示 | 已捨棄且不保留 | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | | | | | \*僅在啟用由 AI Companion 2.0 提供的事件擷取時適用 | | #### 是否有任何行事曆資料儲存在用戶端記錄中？ Zoom 應用程式不會將權杖、憑證或事件等敏感行事曆資料列印到任何用戶端記錄中。 ### 排程工具 Zoom 提供各種工具，以簡化與 Microsoft 和 Google 產品的 Zoom 會議排程體驗。這些產品包括適用於 Google Workspace 和 Microsoft 365 的原生排程整合，或供特定瀏覽器和 Outlook 使用的軟體擴充功能。 #### 排程工具如何運作？ 除 Outlook Plugin 外，所有排程工具都會直接向行事曆提供者以及 Zoom 的網頁行事曆服務提交 API 請求。Outlook Plugin 的不同之處在於，它會透過 Zoom 桌面用戶端來排程會議，而該用戶端會代表外掛程式向 Zoom 網頁行事曆服務提交 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 Plugin 與 Outlook 增益集有什麼差異？ Outlook Plugin 會安裝在終端使用者的電腦上，並協助使用者透過其 Outlook 用戶端排程 Zoom 會議。該外掛程式會透過程序間通訊通道（IPC）與 Zoom Workplace 桌面用戶端通訊。透過此 IPC，外掛程式會利用用戶端的資源將排程送至 Zoom 的網頁行事曆服務。 為了在遵循 Apple 與 Microsoft 制定的政策與指引的同時，為使用者提供最佳體驗，Zoom 強烈建議部署並使用 Zoom for Outlook 增益集。此增益集提供更簡便的部署與更強大的管理解決方案，並受到 Microsoft 積極支援，也更符合 Apple 等供應商近期加強的安全性需求。 {% hint style="danger" %} **警告** Zoom for Outlook Plugin 將不會實作新的功能增強。強烈建議遷移至 Zoom for Outlook 增益集。 {% endhint %} Outlook 增益集是一個以網頁為基礎的應用程式，不需要在使用者電腦上進行本機安裝，而是以內建網頁應用程式的形式顯示，可在本機用戶端與網頁版 Outlook 中使用。該增益集透過直接與 Zoom 的行事曆網頁服務通訊的網頁 API 運作。 外掛程式與增益集提供類似功能，但增益集需要可用的 Outlook JavaScript API 要求集 v1.8——此版本僅存在於較新版本的 Outlook 中，且在內部部署的 Exchange Server 上完全不可用——這表示： * Outlook 增益集不能用於在內部部署的 Exchange Server 上進行代為排程。 * 代理人必須使用 Microsoft 365 Outlook 用戶端、Mac/PC 上的 Outlook 2021 或更新版本，或 Outlook 網頁版，才能代替其他使用者排程會議。 #### 如何識別官方的 Zoom 增益集應用程式？ 可從 [Microsoft AppSource 商店](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) 取得的官方 Zoom for Outlook 應用程式，會以「Zoom-Office-add-in-SSO」名稱安裝到您的 Entra ID Enterprise Apps 目錄中，應用程式 ID 為 ce63c970-e2d7-45e6-bee1-80c330b0800b。 #### 我需要更新 Outlook Plugin 或增益集嗎？ 截至 2025 年 1 月，Microsoft 已開始以巢狀應用程式驗證（NAA）取代舊版 Exchange Online 權杖。Zoom 管理員應與 Entra 管理員合作，依照支援文章中的說明，在 Zoom 網頁入口網站中設定 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 %} 否則，Zoom for Outlook 增益集是一個以網頁為基礎的應用程式，不需要在使用者電腦上進行本機安裝，而是以內建網頁應用程式的形式顯示，並透過網頁 API 與 Zoom 的網頁行事曆服務通訊。此增益集可供 Windows 與 macOS 的 Outlook 應用程式、Android 與 iOS 的 Outlook 應用程式，以及 Outlook 網頁版使用。Outlook 管理員可設定並大規模部署此增益集，或由個別使用者自行安裝。 Outlook Plugin 是以已安裝軟體的形式運作，會不時進行更新與增強。因此，該外掛程式需要隨時間進行版本管理與升級。 {% hint style="info" %} **注意** Outlook Plugin 不需要巢狀應用程式驗證。 {% endhint %} #### 哪一種排程工具最適合我的環境？ **Google Workspace** 使用 Google Workspace 的組織可以透過從 Google Workspace Marketplace 安裝 Zoom for GSuite 應用程式，輕鬆讓所有使用者都能透過 Google Calendar 排程 Zoom 會議。此應用程式由中央統一管理，並會在 Zoom 向 Google 推出增強功能時自動更新。 或者，也可以使用以瀏覽器為基礎的擴充功能，但它們通常更適合個人帳戶使用者，因為它們需要本機安裝、定期更新，且不是由中央統一管理。 **Microsoft** 對於使用 Microsoft 365 或內部部署 Exchange Server 的組織，最佳選項取決於環境以及行事曆整合的設定方式。 Zoom for Outlook 增益集是 Microsoft 365 環境的首選工具——無論您使用的是桌面版、網頁版還是行動版 Outlook。此增益集需要適用於 Microsoft 365 的 Outlook、Windows 版 Outlook 2013 或更新版本，或 Mac 版 Outlook 2016 或更新版本。 雙向行事曆同步可確保行事曆更新無縫進行，且在整合行事曆時預設為啟用。這使得 Zoom 能夠自動反映對 Outlook 行事曆事件所做的變更，例如重新排程時間或取消，而無需使用者透過增益集手動更新或移除會議。這一點尤其重要，因為如果未擷取變更，Zoom 會議連結可能會過期，特別是當會議移至原始日期後超過 30 天時。會議 ID 通常在 30 天後過期，除非它們是循環系列的一部分。 支援事件型自動化（例如 OnAppointmentSend）的現代 JavaScript API（v1.8），以下環境與應用程式不支援： * 內部部署的 Exchange 環境 * 連線到 M365 的傳統版 Outlook * iOS 與 Android 上的行動版 Outlook 因此，在這些設定中，Zoom 無法透過增益集自動偵測或更新會議。若沒有雙向同步或以 API 為基礎的自動化，即使是循環會議也可能不會反映變更，導致 Zoom 連結過期或無效。 Zoom Outlook Plugin 僅支援 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 App Registration 使用 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 Connector 完成額外步驟，以確保行事曆與會議功能正常運作。更多有關為 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 Workspace 只有單一的權限套用方法。 #### 服務帳戶需要哪些權限？ 具體權限會因所選方法而異。各選項與所需權限詳列於下表： | 提供者 | 方法 | 所需權限 | | --------------------------------------- | ----------------------------- | ---------------- | | Microsoft 365/Microsoft Exchange Server | 應用程式權限（Microsoft Graph API） | 管理員帳戶：組織管理與收件者管理 | | Microsoft 365/Microsoft Exchange Server | 完整代理人存取權（Microsoft Graph API） | 寄送為 完整存取 | | Google Workspace | - | 進行變更並管理共用 | {% hint style="info" %} **Zoom 建議** Zoom 建議行事曆整合使用應用程式權限方法。此設定所需的管理員工作較少，且不需要專用服務帳戶。這也是 Microsoft 建議企業應用程式以背景服務方式執行時採用的方法。 {% endhint %} ### 增強型 API Connector 透過增強型 API Connector（於 2021 年初推出）進行的標準 H.323 與 SIP 會議室系統行事曆整合，是獨立於使用者用戶端與 Zoom Rooms 設定之外進行的。服務帳戶方法與權限與前述 Zoom Rooms 區段相同。 #### 增強型 API Connector 的資料流程有何不同？ 透過增強型 API Connector 連線的會議室系統不會直接聯絡行事曆提供者，這與 Zoom 用戶端和 Zoom Room 的連線流程不同。Zoom Web Service 會作為這些系統的用戶端，並直接將行事曆資料推送至端點，但 Poly 裝置除外。Poly 裝置會先向 Zoom Web Service 查詢行事曆更新，然後再將行事曆資料傳送到裝置。 #### 會擷取多少天的行事曆事件？ 增強型 API Connector 會擷取未來 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-tw/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.