會議空間代表虛擬地點或會議舉辦地點的持續性物件 (例如會議室)。會議空間還可協助使用者進行會議,並尋找共用資源。
使用 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
資源包含 name
、user
和 role
欄位。
請注意,成員與參與者不同。參與者是指加入通話或使用夥伴模式、以觀眾身分觀看,或是與通話連線的會議室裝置。每個人都有一個 conferenceRecords.participants
資源。
你可以使用下列方法管理聊天室成員:
每個方法都會使用路徑參數,其中建立和清單方法會使用 parent
欄位來表示會議空間,而刪除和取得方法則會使用 name
欄位,根據會議空間和成員名稱篩選結果。
除了 delete 以外,所有方法都支援 SystemParameterContext 中的 fields
參數。省略 fields
參數時,API 回應會預設為 "name,email,role,user"
。
fields
參數會使用 FieldMask 篩選回應。FieldMask 是 API 呼叫端用來列出要求應傳回的欄位。這是以半形逗號分隔的欄位清單,可指定只使用物件中的特定欄位,而其他欄位則保持不變。使用 FieldMask 可讓 API 避免不必要的工作,並提升效能。欄位遮罩用於建立、取得和列出方法。如要進一步瞭解欄位遮罩,請參閱 Google 試算表 API 的「使用欄位遮罩」一文。