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. Para ver um exemplo, consulte Atualizar uma mensagem.

Aceita os seguintes tipos de autenticação:

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

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

  • Autenticação de 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 fez a chamada.

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 foi postada e {message} é um ID atribuído pelo sistema à 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. Para isso, substitua {message} pelo valor do campo clientAssignedMessageId. Por exemplo, spaces/AAAAAAAAAAA/messages/client-custom-name. Para mais detalhes, consulte Nomear uma mensagem.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Obrigatório. Os caminhos dos campos a serem atualizados. Separe vários valores com vírgulas ou use * para atualizar todos os caminhos de campo.

Caminhos de campo compatíveis no momento:
allowMissing

boolean

Opcional. Se true e a mensagem não forem encontrados, uma nova mensagem será criada e updateMask será ignorado. O ID da mensagem especificado precisa ser atribuído pelo cliente, caso contrário, 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.