REST Resource: spaces

资源：Space

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

JSON 表示法 
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  },
  "phoneAccess": [
    {
      object (PhoneAccess)
    }
  ],
  "gatewaySipAccess": [
    {
      object (GatewaySipAccess)
    }
  ]
}
字段
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)

活跃会议（如果有）。
phoneAccess[]

object (PhoneAccess)

仅限输出。相应会议空间的所有区域性电话接入方法。可以留空。
gatewaySipAccess[]

object (GatewaySipAccess)

仅限输出。可用于加入会议的基于 SIP 的接入方法。可以留空。

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 Embed SDK Web 或移动应用。

枚举
ENTRY_POINT_ACCESS_UNSPECIFIED 未使用。
ALL 允许所有入口点。
CREATOR_APP_ONLY 只有创建此空间的 Google Cloud 项目所拥有的入口点才能用于加入此空间中的会议。应用可以使用 Meet 嵌入 SDK（网页版）或移动版 Meet SDK 来创建自有入口点。

管理

会议的管理员模式。当会议处于审核模式时，会议所有者可以通过共同主持人管理（请参阅消息 Member）和功能限制（请参阅消息 ModerationRestrictions）等功能更好地控制会议。

枚举
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

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

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

AttendanceReportGenerationType

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

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

ArtifactConfig

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

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

object (RecordingConfig)

录制配置。
transcriptionConfig

object (TranscriptionConfig)

自动转写功能的配置。
smartNotesConfig

object (SmartNotesConfig)

自动智能会议记录的配置。

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。

PhoneAccess

电话访问权限包含使用区域电话号码和特定于该电话号码的 PIN 码拨入电话会议所需的信息。

JSON 表示法 
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
字段
phoneNumber

string

会议室的拨入电话号码，采用 E.164 格式。带有前导“+”字符的完整电话号码。
pin

string

用户在拨打指定号码后必须输入的 PIN 码。PIN 码仅包含十进制数字，长度可能有所不同。
regionCode

string

与相应电话访问权限关联的国家/地区的 CLDR/ISO 3166 地区代码。供 i18n RegionCode 实用程序解析。例如：瑞典的地区代码为“SE”。
languageCode

string

与相应手机访问权限关联的语言的 BCP 47/LDML 语言代码。供 i18n LanguageCode 实用程序解析。示例：拉丁美洲西班牙语为“es-419”，加拿大法语为“fr-CA”。

GatewaySipAccess

详细介绍了如何通过 SIP 网关加入会议。

JSON 表示法 
{
  "uri": string,
  "sipAccessCode": string
}
字段
uri

string

会议可通过会话发起协议 (SIP) URI 访问。

字符串采用以下格式之一：

其中，USER_ID 是 13 位通用 PIN 码（未来还可以选择支持使用 Meet 会议代码），GATEWAY_ADDRESS 是要使用 DNS SRV 查找或点分四组表示法解析的有效地址。
sipAccessCode

string

可在特殊配置的设备上手动输入的永久数字代码。

方法

create

 创建聊天室。

endActiveConference

 结束正在进行的会议（如果有）。

get

 获取会议室的详细信息。

patch

 更新会议室的详细信息。