会议空间表示举办会议的虚拟场所或持久对象(例如会议室)。会议空间还可帮助用户开会和查找共享资源。
使用 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 字段的功能限制等功能来控制会议。如需详细了解成员,请参阅管理空间成员。
如需在会议处于受监督状态 (moderation 为 on) 时定义功能限制,请使用 ModerationRestrictions 对象设置 moderationRestrictions 字段。这些限制规定了会议室中的哪些人有权发送聊天消息或反应,或者共享屏幕。
如需设置 moderationRestrictions 字段的功能限制,请使用 RestrictionType 枚举应用 chatRestriction、reactionRestriction、presentRestriction。设置为 HOSTS_ONLY 可将权限应用于会议组织者和共同主持人,设置为 NO_RESTRICTION 可将权限应用于所有参与者。
如需将分配给用户的默认角色限制为查看者,请使用 DefaultJoinAsViewerType 枚举设置布尔值 defaultJoinAsViewerType 字段。如果 defaultJoinAsViewerType 为 on,则用户以观看者身份加入。如果为 off,用户将以贡献者身份加入。默认值为 off。如果用户在 spaces.members 中设置了明确的角色,则用户将以该角色加入。
管理自动制品
会议组织者(而非共同主持人)可以在会议空间内预先配置自动录制、自动转写和“帮我记笔记”功能。 启用这些设置后,系统会自动录制会议室中的内容、生成转写内容,以及记录会议内容并将其整理到 Google 文档中。每项功能都是独立的,并且是按会议空间设置的。 录制字幕功能仅支持英语。
您可以在创建会议空间时或创建会议空间后预先配置自动生成的内容。您还可以使用此功能为通过 Google 日历创建的会议设置自动生成会议记录。这两种方法都需要 meetings.space.settings OAuth 范围。如需了解详情,请参阅设置的 OAuth 范围。
如需设置自动制品,请使用 SpaceConfig 对象下的 ArtifactConfig 对象。ArtifactConfig 由 recordingConfig、transcriptionConfig 和 smartNotesConfig 字段组成。
每个字段都映射到类似的对象,例如 RecordingConfig、TranscriptionConfig 和 SmartNotesConfig。如需设置每个对象,请使用 AutoGenerationType 布尔值枚举来切换配置对象 on 或 off。
设置的 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 范围,请参阅了解 REST API 范围。
管理聊天室成员
会议组织者始终可以无需申请即可加入会议,但您也可以配置其他成员,使其无需申请即可加入会议。
此外,还可以为成员配置会议角色,例如 COHOST,这样他们就拥有与会议组织者相同的会议管理能力。如需详细了解如何在不敲门的情况下进入会议空间,请参阅 AccessType。
spaces.members 资源包含 name、user 和 role 字段。
请注意,成员与参与者不同。参与者是指加入通话的人员、使用副屏模式的观看者,或连接到通话的会议室设备。每人一个 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 Sheets API 的使用字段掩码。