Method: spaces.patch

string

聊天室的资源名称。

格式：spaces/{space}

string (FieldMask format)

必需。更新后的字段路径（如果存在多个路径，则以英文逗号分隔）。

您可以更新聊天室的以下字段：

• spaceDetails

• displayName：仅支持更新 spaceType 字段为 SPACE 的聊天室的显示名称。如果您收到错误消息 ALREADY_EXISTS，请尝试输入其他值。Google Workspace 组织中的现有聊天室可能已经在使用此显示名称。

• spaceType：仅支持将 GROUP_CHAT 聊天室类型更改为 SPACE。在更新掩码中添加 displayName 和 spaceType，并确保指定空间的显示名称和 SPACE 空间类型均非空。如果现有空间已具有 SPACE 类型，则在更新显示名称时，可以选择在指定空间中包含 spaceType 掩码和 SPACE 类型。尝试以其他方式更新空格类型会导致参数无效错误。spaceType 不支持管理员访问权限。

• spaceHistoryState：通过为聊天室开启或关闭聊天记录功能，更新聊天室聊天记录设置。必须为 Google Workspace 组织启用聊天记录设置。如需更新聊天室的聊天记录状态，您必须在请求中省略所有其他字段掩码。spaceHistoryState 不支持管理员访问权限。

• accessSettings.audience：更新访问权限设置，指定哪些人可以在已命名的聊天室中发现聊天室、加入聊天室以及预览消息（spaceType 字段为 SPACE）。如果现有聊天室有目标对象群组，您可以移除目标对象群组，通过省略此字段掩码的值来限制聊天室访问权限。如需更新聊天室的访问权限设置，执行身份验证的用户必须是聊天室管理员，并且在您的请求中省略所有其他字段掩码。如果聊天室处于导入模式，您无法更新此字段。如需了解详情，请参阅将聊天室设为可供特定用户搜索。accessSettings.audience 不支持管理员访问权限。

• 开发者预览版：支持更改聊天室的权限设置，支持的字段路径包括：permissionSettings.manage_members_and_groups、permissionSettings.modify_space_details、permissionSettings.toggle_history、permissionSettings.use_at_mention_all、permissionSettings.manage_apps、permissionSettings.manage_webhooks、permissionSettings.reply_messages（警告：与所有其他非权限设置字段路径互斥）。permissionSettings 不支持管理员访问权限。

boolean

发起通话的用户必须是拥有“管理聊天和聊天室对话”权限的 Google Workspace 管理员。

需要 chat.admin.spaces OAuth 2.0 范围。

部分 FieldMask 值不支持使用管理员访问权限。如需了解详情，请参阅 updateMask 的说明。