Method: spaces.messages.delete

删除消息。有关示例，请参阅删除邮件。

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。消息的资源名称。

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

如果您已为消息设置自定义 ID，则可以使用 {message} 的 clientAssignedMessageId 字段中的值。有关详情，请参阅为消息命名。

查询参数

参数
force

boolean

如果设为 true，删除消息时，其消息串式回复也会一并删除。设为 false 时，如果消息有“话题式回复”，删除失败。

仅适用于以用户身份进行身份验证时。以 Chat 应用的身份进行身份验证时无效。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文为空。

授权范围

需要以下 OAuth 范围之一：

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

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