設定會議空間和成員

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

使用 spaces.create 方法建立會議空間時,系統會傳回 spaces 資源的例項。這項資源包含 SpaceConfig 物件,這是會議室的設定。它還包含 ActiveConference 物件,這是會議空間中目前 conferenceRecords 資源的連結。如要進一步瞭解如何管理會議聊天室,請參閱「建立及管理會議聊天室」。

以下各節將詳細說明如何使用這些物件和方法設定會議空間。

設定管理員和會議存取權

您可以透過 SpaceConfig 物件,設定使用者加入會議的方式、審核模式、功能限制,以及使用者加入會議時可獲得的權限。

存取會議聊天室

如要決定哪些使用者不必提出要求即可加入會議空間,請使用 AccessType 物件設定 accessType 欄位。您可以選擇是否要自動允許與會者加入。這個欄位預設為使用者的預設存取權設定。

如要定義可用於加入會議空間中會議的進入點,請使用 EntryPointAccess 物件設定 entryPointAccess 欄位。將其設為 ALL 可允許所有進入點,或設為 CREATOR_APP_ONLY 可將進入點範圍限制為由建立會議空間的 Google Cloud 專案所擁有的進入點。

產生出席狀況報表

如要為會議室建立出席狀況報表,請使用 AttendanceReportGenerationType 物件設定布林值 attendanceReportGenerationType 欄位。如果使用者要求提供報表,Google Meet 會將出席狀況報告儲存到會議發起人的 Google 雲端硬碟,並傳送電子郵件。

管理會議聊天室

如要進行會議審核,您可以使用 Moderation 物件設定布林 moderation 欄位。當 moderation 模式為 on 時,會議發起人可以透過共辦人管理 (請參閱 spaces.members) 和使用 moderationRestrictions 欄位限制功能等功能,控管會議。如要進一步瞭解成員,請參閱「管理聊天室成員」。

如要定義會議經過審核 (moderationon) 時的功能限制,請使用 ModerationRestrictions 物件設定 moderationRestrictions 欄位。限制可定義會議空間中哪些使用者有權傳送即時通訊訊息或回應,或分享螢幕畫面。

如要在 moderationRestrictions 欄位上設定功能限制,請使用 RestrictionType 列舉套用 chatRestrictionreactionRestrictionpresentRestriction。將其設為 HOSTS_ONLY 可將權限套用至會議主辦人和共同主持人,或設為 NO_RESTRICTION 則可套用至所有參與者。

如要限制將預設角色指派給使用者做為檢視者,請使用 DefaultJoinAsViewerType 列舉設定布林值 defaultJoinAsViewerType 欄位。如果 defaultJoinAsViewerTypeon,使用者會以觀眾身分加入。如果是 off,使用者會以協作者身分加入。預設值為 off。如果在 spaces.members 中為使用者設定明確的角色,使用者就會以該角色加入。

管理自動構件

會議發起人 (而非共同主持人) 可以在會議空間中預先設定自動錄製、自動轉錄和「為我做筆記」。啟用這些設定後,系統會錄製會議空間、產生轉錄稿,並自動擷取會議記錄並整理至 Google 文件。每項功能皆為獨立設定,且會依會議空間而異。錄音內容的字幕僅支援英文。

您可以在建立會議空間時,或在會議空間建立後預先設定自動構件。這項功能還可讓您為透過 Google 日曆建立的會議設定自動產生的構件。這兩種方法都需要 meetings.space.settings OAuth 範圍。詳情請參閱「設定的 OAuth 範圍」。

如要設定自動構件,請使用 SpaceConfig 物件下的 ArtifactConfig 物件。ArtifactConfigrecordingConfigtranscriptionConfigsmartNotesConfig 欄位組成。

每個欄位都會對應至類似的物件,例如 RecordingConfigTranscriptionConfigSmartNotesConfig。如要設定每個物件,請使用 AutoGenerationType 布林值列舉來切換設定物件 onoff

設定的 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 範圍」。

管理聊天室成員

雖然會議發起人可以隨時不必傳送加入要求即可加入會議,但您也可以設定其他成員不必傳送加入要求即可加入會議。此外,您也可以設定成員在會議中的角色,例如 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 的「使用欄位遮罩」一文。