Method: spaces.messages.patch
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
. Para conferir um exemplo, consulte Atualizar uma mensagem.
Oferece suporte aos seguintes tipos de autenticação:
Ao usar a autenticação de apps, as solicitações só podem atualizar as mensagens criadas pelo app de chamada do Chat.
Solicitação HTTP
PATCH 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á usar esse ID para especificar a mensagem em uma solicitação substituindo {message} pelo valor do campo clientAssignedMessageId . Por exemplo, spaces/AAAAAAAAAAA/messages/client-custom-name . Confira mais detalhes em Nomear uma mensagem.
|
Parâmetros de consulta
Parâmetros |
updateMask |
string (FieldMask format)
Obrigatório. Os caminhos de 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 client-assigned. Caso contrário, a solicitação 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 `PATCH` method, preferably over the `update` method which uses `PUT`."],["Supports both app and user authentication, with app authentication limited to updating messages created by the calling Chat app."],["Requires specifying the message to update using its resource name in the URL path and the fields to update using the `updateMask` query parameter."],["Allows creation of a new message if the original is not found when `allowMissing` query parameter is set to `true` and a client-assigned message ID is provided."],["Requires authorization with one of the specified OAuth scopes (`chat.bot`, `chat.import`, or `chat.messages`)."]]],["This documentation outlines how to update a message using the `PATCH` method via an HTTP request to `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. The `message.name` path parameter is required, specifying the message's resource name. The `updateMask` query parameter is mandatory, indicating which fields to update (e.g., text, attachments). Optionally, `allowMissing` creates a new message if one isn't found. The request and response bodies utilize the `Message` resource, and app or user authentication are supported, with specific authentication impacting permissions.\n"]]