配置会议聊天室和成员

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

当您使用 spaces.create() 方法创建会议室时,该方法会返回 spaces 资源的实例。该资源包含 SpaceConfig 对象,该对象是会议室的配置。它还包含 ActiveConference 对象,该对象是指向会议室内当前 conferenceRecords 资源的链接。如需详细了解如何管理会议空间,请参阅使用会议空间

以下部分将详细介绍如何使用几个新的 Beta 版对象和方法配置会议室。

设置管理和会议访问权限

现在,您可以通过新的 Beta 版对象设置审核模式、功能限制以及用户加入会议时获得的权限。这些值通过更新后的 SpaceConfig 对象进行设置。

moderation 字段是会议的预配置审核模式,默认模式由用户的政策控制。它使用 Moderation 对象。启用审核模式后,会议组织者可以使用管理联合主持人(请参阅 spaces.members)和功能限制(请参阅 moderationRestrictions)等功能来控制会议。如需详细了解成员,请参阅管理聊天室成员

moderation 处于开启状态时,moderationRestrictions 字段会对会议强制执行审核限制。它使用 ModerationRestrictions 对象。限制可定义哪些用户有权发送聊天消息和回应、共享屏幕,以及是否将为用户分配的默认角色限制为“观看者”。moderationRestrictions 字段依赖于 RestrictionType 来应用前三个限制。RestrictionType 可应用于会议组织者和共同主持人,也可以应用于所有参与者。DefaultJoinAsViewerType 会应用最终权限,默认情况下用户加入时会成为贡献者,但主持人也可以限制用户加入时只能成为观看者。

firstJoinerType 字段用于设置用户是否可以在主持人之前加入此会议室中的会议。它定义了哪些用户可以先加入会议,以及其他用户是否处于等待状态。它使用 FirstJoinerType 对象。

管理聊天室成员

会议组织者始终可以不经过申请即可加入会议,但现在,您还可以配置哪些成员也可以不经过申请即可加入会议。此外,您还可以将成员配置为在会议中拥有某个角色(例如 COHOST),从而使他们拥有与会议组织者相同的会议管理权限。如需详细了解如何在不敲门的情况下访问会议空间,请参阅 AccessType

spaces.members 资源包含 nameuserrole 字段。

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

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

每个方法都接受路径参数,其中 create 和 list 方法使用 parent 字段表示会议室,delete 和 get 方法使用 name 字段根据会议室和成员名称过滤结果。

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

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

管理自动工件

会议组织者(而非共同主持人)可以在会议空间中预先配置自动录制、自动转写和“为我记事”。启用这些设置后,系统会自动录制会议聊天室、生成转写内容,并自动捕获会议记录并将其整理到 Google 文档中。每项功能都是独立的,并且按会议室进行设置。录音字幕仅提供英文版。

您可以在创建会议室时或会议室创建后预配置自动工件。借助此功能,您还可以为通过 Google 日历创建的会议设置自动工件。这两种方法都需要 meetings.space.settings OAuth 范围。如需了解详情,请参阅用于设置的 OAuth 范围

自动工件是通过 ArtifactConfig 对象设置的,该对象位于 SpaceConfig 对象下,后者是 spaces 资源的一部分。ArtifactConfigrecordingConfigtranscriptionConfigsmartNotesConfig 字段组成。

每个字段都会映射到类似的对象,例如 RecordingConfigTranscriptionConfigSmartNotesConfig。每个对象均使用 AutoGenerationType 布尔枚举进行设置,以开启或关闭配置对象。

设置的 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 范围