Method: spaces.messages.update
Atualiza uma mensagem. Há uma diferença entre os métodos patch
e update
. O método patch
usa uma solicitação patch
, enquanto o método update
usa uma solicitação put
. Recomendamos usar o método patch
. Veja um exemplo em Atualizar uma mensagem.
Oferece suporte aos seguintes tipos de autenticação:
Ao usar a autenticação de app, as solicitações só podem atualizar mensagens criadas pelo app de chat que está ligando.
Solicitação HTTP
PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
message.name |
string
Identificador. Nome do recurso da mensagem. Formato: spaces/{space}/messages/{message} Em que {space} é o ID do espaço em que a mensagem é postada e {message} é um ID atribuído pelo sistema para a mensagem. Por exemplo, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB . Se você definir um ID personalizado ao criar uma mensagem, poderá usá-lo para especificar a mensagem em uma solicitação. Basta substituir {message} pelo valor do campo clientAssignedMessageId . Por exemplo, spaces/AAAAAAAAAAA/messages/client-custom-name . Veja mais detalhes em Nomear uma mensagem.
|
Parâmetros de consulta
Parâmetros |
updateMask |
string (FieldMask format)
Obrigatório. Os caminhos do campo a serem atualizados. Separe valores por vírgulas ou use * para atualizar todos os caminhos de campo. Caminhos de campo compatíveis:
|
allowMissing |
boolean
Opcional. Se true e a mensagem não for encontrada, uma nova mensagem será criada e updateMask será ignorada. O ID da mensagem especificado precisa ser atribuído pelo cliente, ou a solicitação vai falhar.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de Message
.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Message
.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-04 UTC.
[null,null,["Última atualização 2024-11-04 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"]]