Method: spaces.messages.update
Обновляет сообщение. Существует разница между методами patch
и update
. Метод patch
использует запрос patch
, а метод update
использует запрос put
. Мы рекомендуем использовать метод patch
. Пример см. в разделе Обновление сообщения .
Поддерживает следующие типы аутентификации :
При использовании аутентификации приложения запросы могут обновлять только сообщения, созданные вызывающим приложением чата.
HTTP-запрос
PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
message.name | string Идентификатор. Имя ресурса сообщения. Формат: spaces/{space}/messages/{message} Где {space} — это идентификатор пространства, в котором опубликовано сообщение, а {message} — это назначенный системой идентификатор сообщения. Например, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB . Если вы задали собственный идентификатор при создании сообщения, вы можете использовать этот идентификатор для указания сообщения в запросе, заменив {message} значением из поля clientAssignedMessageId . Например, spaces/AAAAAAAAAAA/messages/client-custom-name . Подробности см. в разделе Назовите сообщение . |
Параметры запроса
Параметры |
---|
updateMask | string ( FieldMask format) Необходимый. Пути к полям для обновления. Разделяйте несколько значений запятыми или используйте * , чтобы обновить пути ко всем полям. В настоящее время поддерживаются пути к полям: |
allowMissing | boolean Необязательный. Если true и сообщение не найдено, создается новое сообщение, а updateMask игнорируется. Указанный идентификатор сообщения должен быть назначен клиентом, иначе запрос не будет выполнен. |
Тело запроса
Тело запроса содержит экземпляр Message
.
Тело ответа
В случае успеха тело ответа содержит экземпляр Message
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/chat.bot
-
https://www.googleapis.com/auth/chat.import
-
https://www.googleapis.com/auth/chat.messages
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-02-27 UTC.
[null,null,["Последнее обновление: 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"]]