配置会议聊天室和成员

会议空间表示举行会议的虚拟场所或持久性对象(例如会议室)。会议空间还可以帮助用户开会和查找共享资源。

使用 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
读取和修改用户可通过任何其他应用(例如日历)访问的所有会议空间的设置。 https://www.googleapis.com/auth/meetings.space.settings

如需详细了解 OAuth 范围,请参阅了解 REST API 范围

管理聊天室成员

聊天室成员是指在会议聊天室中被配置为具有某种角色的用户。 这些用户无需请求连接权限(也称为“敲门”)即可加入会议空间。

会议组织者可以自动进入会议空间,您还可以配置其他成员无需申请即可加入会议。此外,还可以将成员配置为在会议中拥有 Role,例如 COHOST,这样他们就拥有与会议组织者相同的会议管理能力。如需详细了解如何在不敲门的情况下进入会议空间,请参阅 AccessType

spaces.members 资源包含 nameuserrole 字段。

请注意,成员与参与者不同。参与者是指加入通话的人员、使用副屏模式的观看者,或连接到通话的会议室设备。每个人都有一个 conferenceRecords.participants 资源。

您可以使用以下方法管理聊天室成员:

每种方法都采用路径参数,其中 create 和 list 方法使用 parent 字段来表示会议空间,而 delete 和 get 方法使用 name 字段来根据会议空间和成员名称过滤结果。除 delete 之外的所有方法都会返回 spaces.members 资源的实例。

除 delete 之外的所有方法都支持 SystemParameterContext 中的 fields 参数。如果省略 fields 参数,API 响应将默认为 "name,email,role,user"

fields 参数依赖于 FieldMask 进行响应过滤。FieldMask 是一种供 API 调用方列出请求应返回的字段的方式。这是一个以英文逗号分隔的字段列表,用于指定仅使用对象中的某些字段,而让其他字段保持不变。使用 FieldMask 可让 API 避免不必要的工作,从而提高性能。字段掩码用于 create、get 和 list 方法。如需详细了解字段掩码,请参阅 Google Sheets API 的使用字段掩码