REST Resource: spaces

资源:聊天室

举办会议的虚拟场所。在任何给定时间,一个聊天室内只能有一场正在进行的会议。

JSON 表示法
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  }
}
字段
name

string

不可变。聊天室的资源名称。

格式:spaces/{space}

{space} 是聊天室的资源标识符。这是服务器生成的唯一 ID,区分大小写。例如 jQCFfuBOdN5z

如需了解详情,请参阅Meet 如何识别会议空间

meetingUri

string

仅限输出。用于加入会议的 URI,由 https://meet.google.com/ 后跟 meetingCode 组成。例如 https://meet.google.com/abc-mnop-xyz

meetingCode

string

仅限输出。用于加入会议的易于输入的唯一字符串。

格式:[a-z]+-[a-z]+-[a-z]+。例如 abc-mnop-xyz

长度不得超过 128 个字符。

只能用作聊天室名称的别名来获取聊天室。

config

object (SpaceConfig)

与会议空间相关的配置。

activeConference

object (ActiveConference)

正在进行的会议(如果有)。

SpaceConfig

与会议空间相关的配置。

JSON 表示法
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
字段
accessType

enum (AccessType)

会议室的访问权限类型,用于确定哪些人可以不经过申请即可加入会议。默认:用户的默认访问权限设置。对于企业用户,由用户的管理员控制;对于个人用户,则为“受限”。

entryPointAccess

enum (EntryPointAccess)

定义可用于加入在此会议室中主持的会议的入口点。默认:EntryPointAccess.ALL

moderation

enum (Moderation)

会议的预配置管理模式。默认:由用户的政策控制。

moderationRestrictions

object (ModerationRestrictions)

当 moderation.ON 处于启用状态时,这些限制会应用于会议。如果 moderation.OFF,则会重置为默认的 ModerationRestrictions。

attendanceReportGenerationType

enum (AttendanceReportGenerationType)

会议室是否启用了出席情况报告。

artifactConfig

object (ArtifactConfig)

与会议支持的自动生成工件相关的配置。

AccessType

会议室的可能访问权限类型。

枚举
ACCESS_TYPE_UNSPECIFIED 用户所在组织指定的默认值。注意:系统从不返回此值,而是返回配置的访问类型。
OPEN 知道加入信息(例如网址或电话访问信息)的任何人都可以不经过申请即可加入会议。
TRUSTED 主持人所在组织的成员、受邀的外部用户和拨入用户无需敲门即可加入会议。其他所有人都必须发出加入申请。
RESTRICTED 只有受邀者可以直接加入会议,无需敲门。其他所有人都必须发出加入申请。

EntryPointAccess

可用于加入会议的入口点。示例:meet.google.com、Meet 嵌入 SDK Web 或移动应用。

枚举
ENTRY_POINT_ACCESS_UNSPECIFIED 未使用。
ALL 允许使用所有入口点。
CREATOR_APP_ONLY 只有创建聊天室的 Google Cloud 项目拥有的入口点才能用于加入此聊天室中的会议。应用可以使用 Meet 嵌入 SDK Web 或移动 Meet SDK 创建自有入口点。

管理

会议的管理模式。启用审核模式后,会议所有者可以通过管理联合主持人(请参阅消息“成员”)和功能限制(请参阅消息“审核限制”)等功能,更好地控制会议。

枚举
MODERATION_UNSPECIFIED 未指定审核类型。这用于指明用户未指定任何值,因为用户不打算更新状态。用户不得将值设置为“未指定”。
OFF 管理功能处于关闭状态。
ON 审核功能处于开启状态。

ModerationRestrictions

定义会议在有主持人监督时对功能的限制。

JSON 表示法
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
字段
chatRestriction

enum (RestrictionType)

指定哪些人有权在会议聊天室中发送聊天消息。

reactionRestriction

enum (RestrictionType)

定义哪些人有权在会议室中发送回应。

presentRestriction

enum (RestrictionType)

定义哪些人有权在会议聊天室中共享屏幕。

defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

定义是否将分配给用户的默认角色限制为“查看者”。

RestrictionType

确定哪些用户有权使用特定功能。

枚举
RESTRICTION_TYPE_UNSPECIFIED 用户政策指定的默认值。应永不返回此值。
HOSTS_ONLY 会议所有者和共同主持人拥有此权限。
NO_RESTRICTION 所有参与者都有权限。

DefaultJoinAsViewerType

默认情况下,用户将以贡献者的身份加入。主持人可以限制用户以观看者身份加入会议。注意:如果在“成员”资源中为用户设置了明确的角色,则用户将以该角色加入。

枚举
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED 用户政策指定的默认值。应永不返回此值。
ON 用户默认会以观看者的身份加入会议。
OFF 用户默认会以贡献者的身份加入。

AttendanceReportGenerationType

会议室是否启用了出席情况报告的可能状态。

枚举
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED 用户政策指定的默认值。应永不返回此值。
GENERATE_REPORT 系统会生成出席情况报告,并将其发送到云端硬盘/电子邮件地址。
DO_NOT_GENERATE 系统不会生成出勤报告。

ArtifactConfig

与此会议空间可能生成的会议工件相关的配置。

JSON 表示法
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
字段
recordingConfig

object (RecordingConfig)

录制的配置。

transcriptionConfig

object (TranscriptionConfig)

自动转写的配置。

smartNotesConfig

object (SmartNotesConfig)

auto-smart-notes 的配置。

RecordingConfig

与在会议空间中录制相关的配置。

JSON 表示法
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
字段
autoRecordingGeneration

enum (AutoGenerationType)

定义当有录制权限的用户加入会议时,系统是否自动录制会议聊天室。

AutoGenerationType

确定是否可以在会议聊天室中自动生成工件。

枚举
AUTO_GENERATION_TYPE_UNSPECIFIED 用户政策指定的默认值。应永不返回此值。
ON 工件会自动生成。
OFF 工件不会自动生成。

TranscriptionConfig

与会议室中的转写功能相关的配置。

JSON 表示法
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
字段
autoTranscriptionGeneration

enum (AutoGenerationType)

定义当有转写权限的用户加入会议时,系统是否自动转写会议内容。

SmartNotesConfig

与会议室中的智能记事相关的配置。如需详细了解智能记事,请参阅 Google Meet 中的“帮我记笔记”功能

JSON 表示法
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
字段
autoSmartNotesGeneration

enum (AutoGenerationType)

定义当有权启用智能记事的用户加入会议时,系统是否应自动为组织中的所有邀请对象生成会议摘要和会议回顾。

ActiveConference

正在进行的会议。

JSON 表示法
{
  "conferenceRecord": string
}
字段
conferenceRecord

string

仅限输出。对“ConferenceRecord”资源的引用。格式:conferenceRecords/{conferenceRecord},其中 {conferenceRecord} 是聊天室内每个通话实例的唯一 ID。

方法

create

创建聊天室。

endActiveConference

结束正在进行的会议(如果有)。

get

获取会议室的详细信息。

patch

更新会议室的详细信息。