設定會議空間和成員

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

使用 spaces.create 方法建立會議空間時,系統會傳回 spaces 資源的執行個體。資源包含 SpaceConfig 物件,這是會議空間的設定。其中也包含 ActiveConference 物件,該物件是會議空間中目前 conferenceRecords 資源的連結。如要進一步瞭解如何管理會議空間,請參閱「建立及管理會議空間」。

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

設定管理和會議存取權

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

存取會議空間

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

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

管理會議空間

如要控管會議,可以使用 Moderation 物件設定 moderation 欄位。如果 moderation 模式為 on,會議發起人可以透過共同主辦人管理 (請參閱 spaces.members) 和使用 moderationRestrictions 欄位限制功能等功能,控管會議。如要進一步瞭解成員,請參閱「管理空間成員」。

如要在會議受到控管時 (moderationon) 定義功能限制,請使用 ModerationRestrictions 物件設定 moderationRestrictions 欄位。限制條件會定義會議空間中哪些人有權傳送即時通訊訊息或回應,或是分享螢幕畫面。

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

如要將指派給使用者的預設角色限制為檢視者,請使用 DefaultJoinAsViewerType 設定布林值 defaultJoinAsViewerType 欄位。如果 defaultJoinAsViewerTypeon,使用者會以檢視者身分加入。如果off,使用者會以共同編輯者身分加入。預設值為 off。如果使用者在 spaces.members 中設定了明確的角色,使用者加入時就會擔任該角色。

產生出席狀況報告

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

管理自動構件

會議發起人 (而非共同主辦人) 可以在會議空間中預先設定自動錄製、自動轉錄和智慧筆記。啟用這些設定後,系統會錄製會議空間、生成轉錄稿,並自動擷取會議記錄,整理至 Google 文件。每項功能都是獨立運作,且會針對每個會議空間進行設定。 錄音內容的字幕僅支援英文。

您可以在建立會議空間時預先設定自動構件,也可以在建立會議空間後設定。這兩種方法都需要 meetings.space.settings OAuth 範圍。詳情請參閱「設定的 OAuth 範圍」。

您也可以為透過 Google 日曆建立的會議設定自動生成會議內容。

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

每個欄位都會對應到類似的物件,例如 RecordingConfigTranscriptionConfigSmartNotesConfig。如要設定每個物件,請使用 AutoGenerationType 切換設定物件 onoff

如要擷取會議期間建立的構件,請參閱「處理構件」一文。

轉錄稿和智慧筆記的差異

會議轉錄稿和智慧筆記 (又稱「幫我做筆記」) 都會擷取會議資訊,但這兩項功能用途不同,產出的內容也不一樣。

下表列出兩者的差異:

功能 轉錄稿 智慧紀錄
總覽 逐字逐句記錄。 Gemini 生成的重點簡短摘要。
詳細程度 100% 呈現細節。系統會記錄所有對話內容。 高層級。著重於決策和待辦事項。
用途 法律遵循、檢查確切引文和使用者無障礙功能。 讓遲到的參與者立即掌握會議內容;自動記錄會議內容和追蹤專案進度。
即時用量 用於字幕。通話結束後,系統就會產生檔案。 通話期間,你可以在側邊面板查看摘要。
輸出內容 Google 文件內容很長,且包含講者姓名和時間戳記。 Google 文件會提供簡潔的會議記錄,並以段落和項目符號呈現。
引用內容 包含可連結的完整文字。 如果同時啟用轉錄稿和智慧筆記,系統會提供引用內容 (時間戳記),連結回轉錄稿中的特定時間點,方便查看背景資訊。詳情請參閱「同時啟用兩項功能時」。

同時啟用這兩項功能時

雖然每項功能都能單獨使用,但同時使用轉錄稿和智慧筆記,可製作更優質的會議後續資料。

啟用這兩項功能後,生成的智慧筆記文件就會加入引用內容。這些引用內容會列在詳細資料部分,且會連結至會議轉錄稿中的特定時間戳記。點選引用內容,即可直接跳到轉錄稿中的相關部分,進一步瞭解討論事項。

會議期間,參與者會看到這兩項功能都已啟用的指標。 會議期間必須保持啟用狀態,才能產生可點選的引文。即使檔案相互連結,系統仍會在主機的 Google 雲端硬碟中產生兩個不同的文件。這兩個檔案也會自動附加到 Google 日曆活動中。

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

管理聊天室成員

聊天室成員是指在會議空間中設定角色的使用者。 這些使用者可以直接加入會議空間,不必提出連線要求 (也稱為「敲門」)。

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

spaces.members 資源包含 nameuserrole 欄位。

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

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

每個方法都會採用路徑參數,其中建立和列出方法會使用 parent 欄位來表示會議空間,而刪除和取得方法則會使用 name 欄位,根據會議空間和成員名稱篩選結果。除了刪除以外,所有方法都會傳回 spaces.members 資源的執行個體。

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

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