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

 更新会议室的详细信息。