混合日曆服務與 Google 日曆整合參考

混合日曆優勢

目前，整合提供下列主要功能：

使用戶能夠透過任何連接到 Google G Suite 日曆（Google 日曆）的日曆用戶端安排協作會議。您無需安裝外掛程式或擴充功能。在位置欄位中輸入關鍵字（例如， @webex 或者 @meet).
向 Webex 應用程式（桌面及行動裝置）及實體端點上的使用者顯示會議清單。
快顯具有加入按鈕（也稱為「一按開始會議 (OBTP)」）的通知。
當使用者在 Gmail 中啟用休假自動回覆（有時稱為外出辦公狀態）時，更新使用者的 Webex App 線上狀態。

本文概述基於雲端的混合行事曆服務如何將 Google Calendar 與 Webex 雲端整合以提供這些功能。

如需其他「混合行事曆服務」整合的類似概觀，請參閱下列文章：

Cisco Webex 混合行事曆服務與 Office 365 整合參考
Cisco Webex 混合式行事曆服務與 Microsoft Exchange 整合參考（適用於基於 Expressway 的行事曆連接器部署）

有關最新功能與部署資訊，請參閱 https://www.cisco.com/go/hybrid-services-calendar。

資料處理

混合日曆從日曆系統接收會議詳情，並如下使用：

檢查會議位置和正文中的 URI 和 URL，以便加入會議。
邀請函標題即為會議標題
在 Webex 應用程式和某些裝置上，會議清單中會顯示會議時段的開始和結束時間。
邀請人員將資訊加入會議清單中的參與者清單中
邀請被邀請者在加入時間到時，向他們發送「加入」按鈕。
會議邀請函主體將填寫 Webex 會議議程。

該服務將加密資料傳送到 Webex 雲端（並以加密形式儲存資料），以提供會議清單和「加入」按鈕。

該服務不會儲存或傳輸未加密的資料。會議描述、會議主體內容以及受邀者的電子郵件地址等敏感資料在儲存和傳輸時始終進行加密。

混合日曆服務會在有限的時間內保留會議資料。儲存的數據涵蓋了過去 7 天到未來 31 天的會議。

對於資料加密，混合日曆使用與 Webex App 相同的 Webex 雲端加密服務。因此，雲端金鑰管理伺服器（KMS）提供金鑰管理。如果您選擇部署混合式資料安全，則您自己的本機 KMS 將提供金鑰管理。（更多詳情，請參閱 Webex應用程式安全文件。）

在部署期間驗證與授權

混合日曆使用 OAuth 2.0 用戶端憑證授權流程連接到 Google 授權伺服器。

應用程式驗證程序

混合日曆已在谷歌註冊為應用程式。它使用具有網域範圍委派權限的服務帳戶，從而避免了使用者同意的需要。（更多詳情請參見 https://developers.google.com/identity/protocols/OAuth2ServiceAccount。）

混合日曆必須具有以下應用程式權限：

權限	使用情況
管理使用者行事曆 https://www.googleapis.com/auth/calendar	使用加入詳細資料更新會議文字。決定使用者的本地化語言。
管理基本郵件設定 https://www.googleapis.com/auth/gmail.settings.basic	讀取「不在辦公室」狀態。

權限

使用情況

管理使用者行事曆

https://www.googleapis.com/auth/calendar

使用加入詳細資料更新會議文字。
決定使用者的本地化語言。

管理基本郵件設定

https://www.googleapis.com/auth/gmail.settings.basic

讀取「不在辦公室」狀態。

在 Control Hub 中，只有具有特權存取權限的管理員才能為客戶的組織配置混合日曆。管理員必須從 Control Hub 複製用戶端 ID 以及授權範圍並將其貼至 Google G Suite 網域管理主控台的管理 API 用戶端存取部分。

流程包括以下高階步驟：

應用程式使用服務帳戶認證從 Google 授權伺服器取得使用者層次的存取權杖，以便存取使用者的行事曆。
應用程式在 Google Calendar API 呼叫中使用存取權杖，以便存取行事曆資訊。

佈建程序

正在啟用使用者進行行事曆存取

成功將混合日曆供應為已註冊應用程式後，管理員必須明確啟用使用者以允許服務存取其各自的 G 套組日曆。

若要成功啟用使用者的行事曆存取，必須滿足下列條件：

Control Hub 中的使用者電子郵件地址必須與組織中的 Google G Suite 租戶中的 Google 行事曆帳戶相符。
管理員必須已驗證使用者電子郵件地址中的網域，或者使用者需要透過成功登入 Webex App 來驗證其電子郵件地址。

啟動使用者會通知混合日曆以驗證其擁有在 G Suite 中存取其日曆的正確許可權。

使用混合日曆功能需要成功驗證。如果服務無法驗證使用者，它會將使用者置於錯誤狀態。此服務強制執行策略，僅會存取成功啟用的使用者行事曆，以便繼續處理程序。

正在進行的作業

混合日曆使用 Google Calendar REST API。此 API 支援使用 Google Calendar 執行多種作業。但是，混合日曆僅使用一部分與 Calendar 使用案例相關的指令。

表 1. 目前由「混合行事曆服務」使用的作業
REST API	使用情況

GET calendars/{calendarId}/events	行事曆活動的清單。
GET calendars/{calendarId}/events/{eventId}/instances	指定的重複活動的實例。
GET /calendars/{calendarId}/events/{eventId}	在行事曆中單個活動的相關資訊。
PATCH /calendars/{calendarId}/events/{eventId}	更新行事曆活動的內容（包括加入資訊及延伸內容）。此作業還用於設定會議的狀態（即接受/拒絕/暫時接受）。
POST /calendars/{calendarId}/events/quickAdd	根據簡單文字字串建立活動。
POST /calendars/{calendarId}/events/watch	訂閱使用者行事曆的變更通知。
POST /channels/stop	取消訂閱使用者行事曆的變更通知。
GET /users/me/settings/{setting}	擷取使用者的地區設定。
GET /users/{userId}/settings/vacation	獲取使用者的假期回應程式設定。
POST /calendars/{calendarId}/acl	建立存取控制規則。
DELETE /calendars/{calendarId}/acl	刪除存取控制規則。
POST /calendars/{calendarId}/events	在行事曆中建立活動。
DELETE /calendars/{calendarId}/events/{eventId}	從行事曆中刪除活動。
GET /freeBusy	顯示指定時間範圍內的使用者可用性及有空/忙碌狀態。

Cisco AI Assistant

感謝您的意見回饋。