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

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