会议空间表示 用于举行会议的虚拟场所或持久性对象(例如会议室)。会议空间还有助于用户会面和查找共享资源。
使用
spaces.create 方法创建会议空间时,
该方法会返回
spaces 资源的实例。该资源
包含
SpaceConfig 对象
,该对象是会议空间的配置。它还包含
ActiveConference
对象,该对象是指向会议空间内当前
conferenceRecords
资源的链接。如需详细了解如何管理会议
空间,请参阅创建和管理会议
空间。
以下部分详细介绍了如何使用这些对象和方法配置会议空间。
设置审核和会议访问权限
您可以通过
SpaceConfig
对象设置用户加入会议的方式、审核模式、功能
限制以及用户加入会议时获得的权限。
访问会议空间
如需确定哪些人可以无需申请即可加入会议空间,请使用
AccessType 对象设置
accessType
字段。
您可以选择多个设置,以确定是否自动允许参会者加入。该字段默认为用户的默认访问权限设置。
如需定义可用于加入会议空间中托管的会议的入口点,请使用
EntryPointAccess
对象设置
entryPointAccess
字段。设置为 ALL 可允许所有入口点,或设置为 CREATOR_APP_ONLY 可将入口点限定为仅由创建会议空间的 Google Cloud 项目拥有的入口点。
审核会议空间
如需审核会议,您可以使用
Moderation对象设置
moderation
字段。
当 moderation 模式为 on 时,会议组织者可以使用共同主持人管理(请参阅
spaces.members)和使用
moderationRestrictions
字段进行功能限制等功能来控制
会议。如需详细了解成员,请参阅管理聊天室
成员。
如需在审核会议(moderation 为
on)时定义功能限制,请使用
ModerationRestrictions
对象设置moderationRestrictions字段。这些限制定义了会议空间内哪些人有权发送聊天消息或回应,或共享屏幕。
如需对 moderationRestrictions 字段设置功能限制,请使用
RestrictionType
应用 chatRestriction、reactionRestriction、presentRestriction。设置为 HOSTS_ONLY 可将权限应用于会议组织者和共同主持人,或设置为 NO_RESTRICTION 可将权限应用于所有参与者。
如需将分配给用户的默认角色限制为观看者,请使用
DefaultJoinAsViewerType设置布尔值
defaultJoinAsViewerType
字段。
如果 defaultJoinAsViewerType 为 on,则用户以观看者身份加入。如果为“off”,则用户
以贡献者身份加入。默认值为off。如果为用户在 spaces.members 中设置了明确的角色,则用户以该角色加入。
生成出席情况报告
如需为会议空间创建出席情况报告,请使用
AttendanceReportGenerationType
对象设置
attendanceReportGenerationType
字段。如果请求生成报告,Google Meet 会将出席情况报告保存到会议组织者的 Google 云端硬盘,并发送电子邮件。
管理自动制品
会议组织者(而非共同主持人)可以在会议空间内预先配置自动录制、自动转写和智能会议记录。启用这些设置后,系统会自动录制会议空间、生成转写内容,以及记录会议记录并将其整理到 Google 文档中。每项功能都是独立的,并且是按会议空间设置的。 录制字幕仅支持英语。
您可以在创建会议空间时或创建会议空间后预先配置自动制品。这两种方法都需要 meetings.space.settings OAuth 范围。如需了解详情,请参阅设置的
OAuth 范围。
您还可以为通过 Google 日历创建的会议设置自动制品。
如需设置自动制品,请使用
ArtifactConfig
对象中的
SpaceConfig
对象。ArtifactConfig 由 recordingConfig、transcriptionConfig 和 smartNotesConfig 字段组成。
每个字段都映射到类似的对象,例如
RecordingConfig、
TranscriptionConfig和
SmartNotesConfig
。如需设置每个对象,请使用
AutoGenerationType
将配置对象切换为on或off。
如需检索会议期间创建的制品,请参阅使用 制品。
转写内容和智能会议记录之间的区别
虽然会议转写内容和智能会议记录(也称为“帮我记笔记”)都会记录会议中的信息,但这些功能的用途不同,生成的制品也不同。
下表显示了它们之间的区别:
| 功能 | 转写内容 | 智能会议记录 |
|---|---|---|
| 概览 | 逐字逐句的记录。 | 由 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.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| 读取和修改用户可以通过任何其他应用(例如日历)访问的所有会议空间的设置。 | https://www.googleapis.com/auth/meetings.space.settings |
如需详细了解 OAuth 范围,请参阅 Meet REST API 范围。
管理聊天室成员
聊天室成员是指在会议空间中配置了角色的用户。 这些用户无需请求连接权限(也称为“申请”)即可加入会议空间。
虽然会议组织者可以自动进入会议空间,但您也可以配置其他成员无需申请即可加入会议。此外,
还可以将成员配置为在会议中具有
Role
,例如 COHOST,这会使他们拥有与会议组织者相同的会议管理能力。如需详细了解如何无需申请即可访问会议空间,请参阅
AccessType。
The
spaces.members
资源包含 name、user 和 role 字段。
请注意,成员与
参与者不同。参与者是指
加入通话的人员、使用副屏
模式的人员、以观看者身份观看的人员,或
连接到通话的会议室设备。每个人都有一个
conferenceRecords.participants
资源。
您可以使用以下方法管理聊天室成员:
每种方法都采用路径参数,其中创建和列表方法使用 parent 字段来表示会议空间,而删除和获取方法使用 name 字段来根据会议空间和成员名称过滤结果。除删除方法外,所有方法都会返回 spaces.members 资源的实例。
SystemParameterContext如果省略 fields 参数,API 响应默认设置为
"name,email,role,user"。
fields 参数依赖于
FieldMask
进行响应过滤。FieldMask 是一种供 API 调用方列出请求应返回的字段的方式。它是一个以英文逗号分隔的字段列表,用于指定仅使用对象中的某些字段,而其他字段保持不变。
使用 FieldMask 可让 API 避免不必要的工作并提高性能。字段掩码用于创建、获取和列表方法。如需详细了解字段掩码,请参阅 Google Sheets API 的使用字段
掩码。