Method: spaces.messages.patch

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

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

HTTP 请求

PATCH 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

有关详情,请参阅授权指南