設定會議空間和成員

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

使用 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
讀取及編輯使用者可透過任何其他應用程式 (例如 Google 日曆) 存取的所有會議空間設定。 https://www.googleapis.com/auth/meetings.space.settings

如要進一步瞭解 OAuth 範圍,請參閱「Meet REST API 範圍」。

管理聊天室成員

會議主辦人一律不必提出要求即可加入會議,您也可以設定其他成員不必提出要求即可加入會議。此外,您也可以為成員設定會議角色,例如COHOST,讓他們擁有與會議發起人相同的會議管理權限。如要進一步瞭解如何免按鈴進入會議空間,請參閱AccessType

spaces.members 資源包含 nameuserrole 欄位。

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

你可以透過下列方式管理聊天室成員:

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

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

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