会议空间表示举办会议的虚拟场所或持久性对象(例如会议室)。会议室还可帮助用户见面和查找共享资源。
当您使用 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.created https://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 表格 API 的使用字段掩码。