會議空間代表虛擬地點或持續性物件 (例如會議室),用於舉辦會議。會議空間還可協助使用者進行會議,並找到共用資源。
使用 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 的「使用欄位遮罩」一文。
管理自動構件
會議發起人 (而非共同主持人) 可以預先設定自動錄製、自動轉錄和「為我記錄」功能。啟用這些設定後,系統會自動錄製會議室、產生轉錄稿,並擷取會議記錄並自動整理至 Google 文件。每項功能皆獨立運作,且會依會議空間設定。錄音字幕僅支援英文。
您可以在建立會議空間時,或在會議空間建立後預先設定自動構件。這項功能還可讓您為透過 Google 日曆建立的會議設定自動產生的構件。這兩種方法都需要 meetings.space.settings
OAuth 範圍。詳情請參閱「設定的 OAuth 範圍」。
自動構件會透過 SpaceConfig
物件下的 ArtifactConfig
物件設定,而 ArtifactConfig
物件是 spaces
資源的一部分。ArtifactConfig
由 recordingConfig
、transcriptionConfig
和 smartNotesConfig
欄位組成。
每個欄位都會對應至類似的物件,例如 RecordingConfig
、TranscriptionConfig
和 SmartNotesConfig
。每個物件都會使用 AutoGenerationType
布林值列舉來設定,藉此切換設定物件的開關。
設定的 OAuth 範圍
如要設定或存取會議設定,您必須具備下列 OAuth 範圍:
用途 | 範圍代碼 |
---|---|
為其他應用程式建立的空間設定自動產生遺留物。 | https://www.googleapis.com/auth/meetings.space.settings |
取得或列出其他應用程式建立的會議構件。 | https://www.googleapis.com/auth/meetings.space.readonly |
取得或列出第三方應用程式建立的會議空間其他會議前設定。 | https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/meetings.space.readonly |
讀取及編輯使用者可透過任何其他應用程式 (例如日曆) 存取的所有會議空間設定。 | https://www.googleapis.com/auth/meetings.space.settings |
如要進一步瞭解 OAuth 範圍,請參閱「 Meet REST API 範圍」。