設定會議空間和成員

會議空間代表虛擬地點或持續性物件 (例如會議室),用於舉辦會議。會議空間還可協助使用者進行會議,並尋找共用資源。

使用 spaces.create 方法建立會議空間時,該方法會傳回 spaces 資源的例項。這項資源包含 SpaceConfig 物件,這是會議場地的設定。它也包含 ActiveConference 物件,這是會議空間中目前 conferenceRecords 資源的連結。

以下各節將詳細說明如何使用多個新的 Beta 版物件和方法設定會議空間。

設定管理員和會議存取權

透過新的 Beta 版物件,您現在可以設定審核模式、功能限制,以及使用者加入會議時可獲得的權限。這些值會透過更新的 SpaceConfig 物件設定。

moderation 欄位是會議的預先設定審核模式,預設會由使用者政策控制。此方法會使用 Moderation 物件。啟用審核模式後,會議擁有者可以透過共辦人管理 (請參閱 spaces.members) 和功能限制 (請參閱 moderationRestrictions) 等功能控管會議。如要進一步瞭解聊天室成員,請參閱「管理聊天室成員」。

moderation 開啟時,moderationRestrictions 欄位會為會議強制執行審核限制。此方法會使用 ModerationRestrictions 物件。限制可定義哪些使用者有權傳送即時通訊訊息和回應、分享螢幕畫面,以及是否要限制將預設角色指派給使用者做為觀眾。moderationRestrictions 欄位會依賴 RestrictionType 套用前三項限制。RestrictionType 可套用至會議擁有者和共同主辦人,或套用至所有參與者。DefaultJoinAsViewerType 會套用最終權限,其中使用者預設為協作者,但主辦人也可以限制使用者以觀眾身分加入。

firstJoinerType 欄位可設定使用者是否可以在會議空間中,比會議主辦人先加入會議。它會定義哪些使用者可以先加入會議,以及其他使用者是否處於等候狀態。此方法會使用 FirstJoinerType 物件。

管理聊天室成員

會議主辦人一律可以不必提出要求就加入會議,但現在您也可以設定哪些成員可以不必提出要求就加入會議。此外,您還可以設定成員在會議中的角色,例如 COHOST,這樣他們就能與會議發起人一樣管理會議。如要進一步瞭解如何在不傳送加入要求的情況下存取會議空間,請參閱 AccessType

spaces.members 資源包含 nameuserrole 欄位。

請注意,成員與參與者不同。參與者是指加入通話或使用夥伴模式、以觀眾身分觀看,或是連線至通話的會議室裝置。每個人都有一個 conferenceRecords.participants 資源。

您可以使用下列方法管理聊天室成員:

每個方法都會使用路徑參數,其中建立和清單方法會使用 parent 欄位來表示會議空間,而刪除和取得方法則會使用 name 欄位,根據會議空間和成員名稱篩選結果。

除了 delete 以外,所有方法都支援 SystemParameterContext 中的 fields 參數。省略 fields 參數時,API 回應會預設為 "name,email,role,user"

fields 參數會使用 FieldMask 篩選回應。FieldMask 是 API 呼叫端用來列出要求應傳回的欄位。這是以半形逗號分隔的欄位清單,可指定只使用物件中的特定欄位,而其他欄位則保持不變。使用 FieldMask 可讓 API 避免不必要的工作,並提升效能。欄位遮罩用於建立、取得和列出方法。如要進一步瞭解欄位遮罩,請參閱 Google 試算表 API 的「使用欄位遮罩」一文。