Method: spaces.messages.delete
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Usuwa wiadomość. Przykład znajdziesz w sekcji Usuwanie wiadomości.
Obsługuje te typy uwierzytelniania:
Gdy używasz uwierzytelniania aplikacji, żądania mogą usuwać tylko wiadomości utworzone przez aplikację Google Chat.
Żądanie HTTP
DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
name |
string
Wymagane. Nazwa zasobu wiadomości. Format: spaces/{space}/messages/{message} Jeśli dla wiadomości ustawiono niestandardowy identyfikator, w polu {message} możesz użyć wartości z pola clientAssignedMessageId. Szczegółowe informacje znajdziesz w artykule Nazywanie wiadomości.
|
Parametry zapytania
| Parametry |
force |
boolean
Opcjonalnie. Gdy true, usunięcie wiadomości powoduje też usunięcie odpowiedzi na niej. Jeśli false, a wiadomość ma odpowiedzi w wątku, usunięcie się nie uda. Dotyczy tylko uwierzytelniania jako użytkownik. Nie ma wpływu na uwierzytelnianie jako aplikacja Google Chat.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi to pusty obiekt JSON.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/chat.bothttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.messages
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\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)."]]
