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 o uso do método patch. Para conferir um exemplo, consulte Atualizar uma mensagem.

Oferece suporte aos seguintes tipos de autenticação:

  • Autenticação do app com o escopo de autorização:

    • https://www.googleapis.com/auth/chat.bot

  • Autenticação do usuário com um dos seguintes escopos de autorização:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (somente espaços do modo de importaçã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

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 vários valores com 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 forem encontradas, uma nova mensagem será criada e updateMask será ignorado. 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.