Method: spaces.patch

更新聊天室。如需查看示例,请参阅更新聊天室。需要用户身份验证chat.spaces 范围。

HTTP 请求

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

网址采用 gRPC 转码语法。

路径参数

参数
space.name

string

聊天室的资源名称。

格式:spaces/{space}

查询参数

参数
updateMask

string (FieldMask format)

必需。更新后的字段路径,如有多个,以英文逗号分隔。

目前支持的字段路径:

  • displayName(仅支持更改类型为 SPACE 的聊天室的显示名称,或者也支持添加 spaceType 掩码以将 GROUP_CHAT 聊天室类型更改为 SPACE)。尝试更新 GROUP_CHATDIRECT_MESSAGE 空格的显示名称会导致参数无效。)

  • spaceType(仅支持将 GROUP_CHAT 聊天室类型更改为 SPACE)。将 displayNamespaceType 一起添加到更新掩码中,并确保指定的空格的显示名称不为空且类型为 SPACE。如果现有聊天室已有 SPACE 类型,则在更新显示名称时,在指定名称中包含 spaceType 掩码和 SPACE 类型将是可选的。尝试以其他方式更新聊天室类型会导致参数无效)。

  • spaceDetails

  • spaceHistoryState(如果组织允许用户更改其聊天记录设置,则支持为聊天室开启或关闭聊天记录功能)。警告:与所有其他字段路径互斥。)

请求正文

请求正文包含一个 Space 实例。

响应正文

如果成功,响应正文将包含一个 Space 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

如需了解详情,请参阅授权指南