Method: spaces.messages.update
Aktualizuje wiadomość. Metody patch
i update
różnią się od siebie. Metoda patch
używa żądania patch
, a metoda update
– put
. Zalecamy użycie metody patch
. Przykład znajdziesz w sekcji Aktualizowanie wiadomości.
Obsługuje te typy uwierzytelniania:
Gdy używasz uwierzytelniania aplikacji, żądania mogą aktualizować tylko wiadomości utworzone przez wywołującą aplikację Google Chat.
Żądanie HTTP
PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry |
message.name |
string
Identyfikator. Nazwa zasobu wiadomości. Format: spaces/{space}/messages/{message} Gdzie {space} to identyfikator pokoju, w którym opublikowano wiadomość, a {message} to przypisany do niej identyfikator systemu. Na przykład: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB . Jeśli podczas tworzenia wiadomości ustawisz niestandardowy identyfikator, możesz użyć tego identyfikatora do określenia wiadomości w żądaniu, zastępując {message} wartością z pola clientAssignedMessageId . Na przykład: spaces/AAAAAAAAAAA/messages/client-custom-name . Szczegółowe informacje znajdziesz w artykule Nazywanie wiadomości.
|
Parametry zapytania
Parametry |
updateMask |
string (FieldMask format)
Wymagany. Ścieżki pól do zaktualizowania. Jeśli jest wiele wartości, rozdziel je przecinkami lub użyj * , aby zaktualizować wszystkie ścieżki pól. Obecnie obsługiwane ścieżki pól:
|
allowMissing |
boolean
Opcjonalnie: Jeśli true i wiadomość nie zostaną znalezione, zostanie utworzona nowa wiadomość, a wartość updateMask zostanie zignorowana. Podany identyfikator wiadomości musi być przypisany przez klienta, w przeciwnym razie żądanie się nie powiedzie.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu Message
.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Message
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://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-02-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-02-27 UTC."],[[["Updates a Google Chat message using the `PUT` method, preferably with the `patch` approach for partial modifications."],["Requires providing the message's resource name in the URL path for identification."],["Allows specifying fields to update using `updateMask` and supports creating a new message if the original is missing with `allowMissing` set to `true`."],["Authentication can be done using app authentication or user authentication, with app authentication restricting updates to messages created by the calling Chat app."],["Needs authorization with specific OAuth scopes like `chat.bot`, `chat.import`, or `chat.messages`."]]],["This describes updating messages in Google Chat using either `patch` or `put` requests, recommending `patch`. The `PUT` request uses the format `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. Updating requires specifying the `message.name` path parameter and the `updateMask` query parameter to identify fields to modify. Optional `allowMissing` creates a new message if one is not found. The request and response body are `Message` instances. Authorization requires specific OAuth scopes. App authentication can update messages from the calling app only.\n"]]