Google Workspace 的 Webex 附加元件請求的權限

使用者帳戶權限

當您啟用排定程式以連線至 Google 帳戶時 Webex 請求的權限的螢幕畫面 — ***Webex 請求這些權限***

表 1. 請求的權限以及 Webex 如何使用權限
權限	範圍	存取的資料	Webex 用它做什麼？
當附加元件正在執行時，檢視您的電子郵件訊息中繼資料	Gmail	主旨行、日期與時間、受邀者清單	當您在 Gmail 中排定 Webex 會議時，排定程式會讀取這些資訊，這是排定會議的基本要求。
以 Gmail 附加元件形式執行	Gmail	—	允許 Webex 排定程式在使用者的 Gmail 中執行。
查看您在 Google Calendar 中開啟的活動	行事曆	主旨行、日期與時間、受邀者清單	當您在 Google Calendar 中開啟活動時，排定程式會讀取這些資訊，這是排定會議的基本要求。
編輯您在 Google Calendar 中開啟的活動	行事曆	主旨行	將 Webex 會議資料資訊（卡片使用者介面/屬性）新增至目前開啟的行事曆活動。
以行事曆附加元件形式執行	行事曆	—	允許 Webex 排定程式在使用者的 Google Calendar 中執行
檢視和編輯所有行事曆上的活動	行事曆	閱讀主旨行、日期與時間、受邀者清單編輯主旨行	我們能夠支援共用行事曆情境，就像我們在單一使用者的行事曆中讀取和寫入活動一樣。
檢視行事曆設定	行事曆	—	Google OAuth 2.0 需要此範圍。請參閱 https://developers.google.com/calendar/api/guides/auth。
查看網域上的使用者相關資訊	Google Workspace 管理員	Google 使用者資訊中的 Webex 網站 URL	如果您在 Google 使用者資訊中設定了 Webex 網站 URL，那麼我們可以讀取此 URL 並以使用者的預設身分登入此網站。
連線至外部服務	應用程式指令碼	連線至 Webex 服務	排定程式需要呼叫 Webex 服務來請求建立/更新/刪除關聯的 Webex 會議。
允許此應用程式在您未出席的情況下執行	應用程式指令碼	根據 Google 觸發程式存取 Google 活動物件	排定程式能夠在您未出席的情況下執行以回應 Google 觸發程式，例如在您的行事曆中更新/刪除會議。請參閱 https://developers.google.com/apps-script/guides/triggers/events。
檢視和管理與應用程式關聯的資料	應用程式指令碼	應用程式的快取	排定程式會在 Google 儲存體中快取一些 Webex 資訊。例如，Webex 網站 URL 和 Webex 會議範本。
檢視您的國家/地區、語言和時區	應用程式指令碼	使用者的目前時間	排定程式會讀取您的時區以排定或更新關聯的 Webex 會議
查看您的主要 Google 帳戶電子郵件地址	其他	使用者的 Gmail 帳戶地址	排定程式會讀取使用者的電子郵件地址以將它繫結至其 Webex 帳戶。
查看您的個人資訊，包括您公開提供的任何個人資訊	其他	使用者姓名和偏好的語言（預設值）	排定程式會讀取使用者的公開使用者資訊，包括姓名以及用作使用者預設值的偏好語言。

Webex 排定程式架構概觀

架構圖顯示 Google 雲端、Webex 雲端、Google Calendar 用戶端以及鏈結它們的編號箭頭。

網站管理員使用「網站管理」或 Control Hub 啟用 Google Workspace 的 Webex 附加元件。
每個人都會為 Google Workspace 的 Webex 附加元件授權（如果管理員未授權的話），並將其 Google 帳戶與其 Webex 帳戶關聯。
Webex 會向 Google 訂閱行事曆變更。
使用者將 Webex 會議新增至 Google Calendar 活動、更新時間或主題，或將活動複製到另一個日期與時間。
Webex 附加元件用戶端接收 Google Calendar 通知並與 Webex 同步。

Webex 排定程式使用的 Google API

下表提供 Webex 排定程式所使用的 Google API 的相關資訊。

在大多數情況下，Webex 排定程式使用 Google 應用程式指令碼 API。在少數情況下，排定程式使用 Google REST API。通常，Google 應用程式指令碼 API 會包裝關聯的 Google REST API。參考 URL 一欄盡可能指向 Google 應用程式指令碼 API，但是必要的話，它可能參照 Google REST API 參考 URL。

表 2. Webex 排定程式使用的 Google 應用程式指令碼 API
Google 應用程式指令碼 API	用途	參考 URL
行事歷.getID	取得使用者行事歷ID，預設行事歷的 ID 是使用者的電子郵件地址	https://developers.google.com/apps-script/reference/calendar/calendar#getId()
Calendar.getName	取得行事歷的名稱	https://developers.google.com/apps-script/reference/calendar/calendar#getName()
Calendar.getTimezone	取得行事歷的時區	https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()
行事歷.活動.清單	搜尋特定的符合某些條件	https://developers.google.com/calendar/api/v3/reference/events/list
行事歷.活動.修補程式	更新特定的活動中繼資料儲存 Webex 會議資訊	https://developers.google.com/calendar/api/v3/reference/events/patch
行事歷Event.出席者	用於存取行事歷出席者的屬性	https://developers.google.com/calendar/api/v3/reference/events#resource
CalendarEvent.會議資料	用於存取活動會議資料的屬性	https://developers.google.com/calendar/api/v3/reference/events#resource
CalendarEvent.getTitle	取得行事曆活動的主題。	https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()
CalendarEvent.getCreators	取得行事歷活動的創建者	https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()
CalendarEvent.getStartTime	獲取活動的開始時間	https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()
CalendarEvent.getEndTime	獲取活動的結束時間	https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()
CacheService.getUserCache	取得使用者的快取，以擷取使用者的喜好設定設定	https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()
快取獲取	取得特定的按鍵設定快取	https://developers.google.com/apps-script/reference/cache/cache#get(String)
快取放入	設定一些特定的依關鍵字快取	https://developers.google.com/apps-script/reference/cache/cache#put(String,String)
會議資料服務。新的會議資料建立器	建立 Google 特定的資料結構來儲存和顯示 Webex 會議資訊	https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()
會議資料建立器	產生 Webex 會議資訊資料	https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()
GmailApp.getmessagebyId	擷取特定的 gmail 訊息	https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)
Gmail應用程式.建立草稿	建立 Gmail 訊息，其中包含 Webex 電子郵件本文	https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)
Gmail訊息.getFrom	獲取 Gmail 發件人電子郵件	https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()
GmailMessage.getTo	取得甘美接收者	https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()
Gmail訊息.get主體	獲取 Gmail 訊息標題	https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()
GmailMessage.getDate	獲取 Gmail 訊息日期與時間	https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()
PropertiesService.getUserProperties	存取持續使用者偏好或設定	https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()
屬性.get屬性	依關鍵字取得特定屬性	https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)
屬性.設定屬性	為鍵和值設定新屬性	https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)
Session.getEffectiveUser().getEmail	獲取目前使用者電子郵件	https://developers.google.com/apps-script/reference/base/user#getEmail()
ScriptApp.new 觸發器	設定新的觸發器來處理活動更新	https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)
URLFetchApp.擷取	使用此API來呼叫 Webex 新增服務或 Google API 來建立/更新會議，我們不會呼叫任何其他第三一方服務	https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

表 3. Webex 排定程式使用的 Google REST API
Google REST API	用途	參考 URL
POST https://accounts.google.com/o/oauth2/token	取得 Google 驗證權杖	https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code
GET https://www.googleapis.com/admin/directory/v1/users/{userKey}	取得已設定的使用者 Webex 網站	https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get