Method: spaces.messages.delete

删除消息。如需查看示例，请参阅删除邮件。

支持以下类型的身份验证：

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。消息的资源名称。

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

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

查询参数

参数
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

如需了解详情，请参阅授权指南。