Method: spaces.messages.delete

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

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

  • 使用授权范围进行应用身份验证：

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

  • 使用以下某个授权范围进行用户身份验证：

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import（仅限导入模式聊天室）

使用应用身份验证时，请求只能删除发起调用的 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 应用身份进行身份验证时，此属性没有任何影响。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文为空的 JSON 对象。

授权范围

需要以下 OAuth 范围之一：

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

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