配置会议聊天室和成员

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

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

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

管理聊天室成员

虽然会议组织者始终可以不敲门即可进入会议,但您还可以将其他成员配置为无需敲门即可加入会议。此外,您还可以将成员配置为在会议中拥有某个角色(例如 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 的使用字段掩码