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
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThis method enables you to delete messages and optionally their replies using an HTTP DELETE request.\u003c/p\u003e\n"],["\u003cp\u003eIt supports both app and user authentication, with app authentication limiting deletion to messages created by the app.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify whether to force delete threaded replies with the \u003ccode\u003eforce\u003c/code\u003e query parameter when using user authentication.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the message's resource name in the URL path and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using one of the specified OAuth scopes.\u003c/p\u003e\n"]]],["This document details how to delete a message using the Chat API. The `DELETE` request targets a specific message's resource name in the format `spaces/*/messages/*`. It supports both app and user authentication, with different limitations for each. The request requires a message's name as a path parameter. A `force` query parameter is optional for user authentication to delete threaded replies. The request body is empty, and a successful response returns an empty JSON object. One of three specified OAuth scopes is required.\n"],null,["# Method: spaces.messages.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes a message. For an example, see [Delete a message](https://developers.google.com/workspace/chat/delete-messages).\n\nSupports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):\n\n- [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope:\n\n - `https://www.googleapis.com/auth/chat.bot`\n- [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.messages`\n - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)\n\nWhen using app authentication, requests can only delete messages created by the calling Chat app.\n\n### HTTP request\n\n`DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). |\n\n### Query parameters\n\n| Parameters ||\n|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `force` | `boolean` Optional. When `true`, deleting a message also deletes its threaded replies. When `false`, if a message has threaded replies, deletion fails. Only applies when [authenticating as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Has no effect when [authenticating as a Chat app](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.bot`\n- `https://www.googleapis.com/auth/chat.import`\n- `https://www.googleapis.com/auth/chat.messages`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]