Method: spaces.messages.update

更新消息。patch 和 update 方法之间存在差异。patch 方法使用 patch 请求，而 update 方法使用 put 请求。我们建议使用 patch 方法。如需查看示例，请参阅更新消息。

需要身份验证。支持应用身份验证和用户身份验证。使用应用身份验证时，请求只能更新由发起调用的 Chat 应用创建的消息。

HTTP 请求

PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

网址采用 gRPC 转码语法。

路径参数

参数
message.name

string

消息的资源名称。

格式：spaces/{space}/messages/{message}

其中，{space} 是发布消息的空间的 ID，{message} 是系统为消息分配的 ID。例如 spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB。

如果您在创建消息时设置了自定义 ID，则可以使用此 ID 在请求中指定消息，只需将 {message} 替换为 clientAssignedMessageId 字段中的值即可。例如 spaces/AAAAAAAAAAA/messages/client-custom-name。有关详情，请参阅为消息命名。

查询参数

参数
updateMask

string (FieldMask format)

必需。要更新的字段路径。请使用英文逗号分隔多个值，或使用 * 更新所有字段路径。

目前支持的字段路径：
allowMissing

boolean

可选。如果 true 且未找到消息，则系统会创建新消息并忽略 updateMask。指定的消息 ID 必须由客户端分配，否则请求失败。

请求正文

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

响应正文

如果成功，则响应正文包含一个 Message 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

有关详情，请参阅授权指南。