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. Veja um exemplo em Atualizar uma mensagem.

Requer autenticação. Oferece suporte à autenticação de apps e autenticação de usuários. Ao usar a autenticação de apps, as solicitações só podem atualizar as mensagens criadas pelo app do Chat que fez a chamada.

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

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} é o ID da mensagem atribuído pelo sistema. 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. Veja 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 vários valores com vírgulas ou use * para atualizar todos os caminhos de campo.

Caminhos de campo compatíveis atualmente:

allowMissing

boolean

Opcional. Se true e a mensagem não for encontrada, uma nova mensagem vai ser criada, e o updateMask vai ser ignorado. O ID da mensagem especificado precisa ser atribuído pelo cliente. 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 de 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.