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.