- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- MessageReplyOption
- Faça um teste
Cria uma mensagem em um espaço do Google Chat. Veja um exemplo em Enviar uma mensagem.
O método create()
requer autenticação do usuário ou do app. O Chat atribui o remetente da mensagem de maneira diferente, dependendo do tipo de autenticação usado na solicitação.
A imagem abaixo mostra como o Chat atribui uma mensagem quando você usa a autenticação do app. O Chat mostra o app do Chat como o remetente da mensagem. O conteúdo da mensagem pode ter texto (text
), cards (cardsV2
) e widgets de acessório (accessoryWidgets
).
A imagem a seguir mostra como o Chat atribui uma mensagem quando você usa a autenticação do usuário. O Chat mostra o usuário como remetente e atribui o app do Chat à mensagem mostrando o nome dela. O conteúdo da mensagem só pode conter texto (text
).
O tamanho máximo da mensagem, incluindo o conteúdo dela, é de 32.000 bytes.
Solicitação HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
parent |
Obrigatório. O nome do recurso do espaço em que uma mensagem será criada. Formato: |
Parâmetros de consulta
Parâmetros | |
---|---|
threadKey |
Opcional. Obsoleto: use |
requestId |
Opcional. Um ID de solicitação exclusivo para esta mensagem. Especificar um ID de solicitação existente retorna a mensagem criada com esse ID, em vez de criar uma nova mensagem. |
messageReplyOption |
Opcional. Especifica se uma mensagem inicia uma conversa ou responde a uma. Compatível apenas com espaços nomeados. |
messageId |
Opcional. Um ID personalizado para uma mensagem. Permite que os apps do Chat recebam, atualizem ou excluam uma mensagem sem precisar armazenar o ID atribuído pelo sistema no nome do recurso da mensagem (representado no campo O valor desse campo precisa atender aos seguintes requisitos:
Veja mais detalhes em Nomear uma mensagem. |
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 incluirá 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
https://www.googleapis.com/auth/chat.messages.create
Para mais informações, consulte o Guia de autorização.
MessageReplyOption
Especifica como responder a uma mensagem. Mais estados podem ser adicionados no futuro.
Enums | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Padrão. Inicia uma nova conversa. O uso dessa opção ignora qualquer thread ID ou incluído. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Cria a mensagem como uma resposta à conversa especificada por thread ID ou . Em caso de falha, a mensagem inicia uma nova conversa. |
REPLY_MESSAGE_OR_FAIL |
Cria a mensagem como uma resposta à conversa especificada por thread ID ou . Se uma nova threadKey for usada, uma nova linha de execução será criada. Se a criação da mensagem falhar, um erro NOT_FOUND será retornado. |