REST Resource: spaces.messages

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.

object (User)

Apenas saída. O usuário que criou a mensagem. Se o app de chat se autenticar como um usuário, a saída vai preencher o usuário name e type.

string (Timestamp format)

Opcional. Imutável. Para espaços criados no Chat, a hora em que a mensagem foi criada. Esse campo é somente saída, exceto quando usado em espaços do modo de importação.

Para espaços no modo de importação, defina esse campo como o carimbo de data/hora histórico em que a mensagem foi criada na origem para preservar o horário de criação original.

string (Timestamp format)

Apenas saída. A hora em que a mensagem foi editada pela última vez por um usuário. Se a mensagem nunca foi editada, esse campo estará vazio.

string (Timestamp format)

Apenas saída. A hora em que a mensagem foi excluída no Google Chat. Se a mensagem nunca for excluída, esse campo ficará vazio.

string

Opcional. Corpo de texto simples da mensagem. O primeiro link para uma imagem, vídeo ou página da Web gera um ícone de visualização. Você também pode @mencionar um usuário do Google Chat ou todos no espaço.

Para saber como criar mensagens de texto, consulte Enviar uma mensagem.

string

Apenas saída. Contém a mensagem text com marcações adicionadas para comunicar a formatação. Esse campo pode não capturar toda a formatação visível na interface, mas inclui o seguinte:

• Sintaxe de marcação para negrito, itálico, sublinhado, monoespaçado, bloco monoespaçado e lista com marcadores.

• Menções de usuários usando o formato <users/{user}>.

• Hiperlinks personalizados usando o formato <{url}|{rendered_text}>, em que a primeira string é o URL e a segunda é o texto renderizado. Por exemplo, <http://example.com|custom text>.

• Emoji personalizado usando o formato :{emojiName}:, por exemplo, :smile:. Isso não se aplica a emojis Unicode, como U+1F600 para emojis de rosto sorridente.

Saiba mais em Visualizar a formatação do texto enviada em uma mensagem.

object (Card)

Descontinuado: use cardsV2.

Cards interativos, formatados e avançados que podem ser usados para mostrar elementos de interface, como textos formatados, botões e imagens clicáveis. Os cards normalmente aparecem abaixo do corpo do texto simples da mensagem. cards e cardsV2 podem ter um tamanho máximo de 32 KB.

object (CardWithId)

Opcional. Uma matriz de cards.

Somente os apps de chat podem criar cards. Se o app do Chat se autenticar como um usuário, as mensagens não poderão conter cards.

Para saber como criar uma mensagem com cards, consulte Enviar uma mensagem.

Crie e visualize cards com o Criador de cards.

object (Annotation)

Apenas saída. Anotações associadas ao text nesta mensagem.

object (Thread)

A linha de execução à qual a mensagem pertence. Para conferir um exemplo de uso, consulte Iniciar ou responder a uma conversa.

object (Space)

Apenas saída. Se o app de chat se autenticar como um usuário, a saída vai preencher apenas o espaço name.

string

Opcional. Uma descrição em texto simples dos cards da mensagem, usada quando os cards reais não podem ser exibidos, por exemplo, notificações para dispositivos móveis.

object (ActionResponse)

Somente entrada. Parâmetros que um app de chat pode usar para configurar como a resposta é postada.

string

Apenas saída. Corpo de texto simples da mensagem com todas as menções a apps do Chat removidas.

object (SlashCommand)

Apenas saída. Informações sobre o comando de barra, se aplicável.

object (Attachment)

Opcional. Anexo enviado pelo usuário.

object (MatchedUrl)

Apenas saída. Um URL em spaces.messages.text que corresponde a um padrão de visualização de link. Para mais informações, consulte Visualizar links.

boolean

Apenas saída. Quando definido como true, a mensagem é uma resposta em uma conversa. Quando false, a mensagem fica visível na conversa de nível superior do espaço como a primeira mensagem de uma conversa ou uma mensagem sem respostas agrupadas.

Se o espaço não oferecer suporte a respostas em conversas, esse campo será sempre false.

string

Opcional. Um ID personalizado para a mensagem. É possível usar o campo para identificar, receber, excluir ou atualizar uma mensagem. Para definir um ID personalizado, especifique o campo messageId ao criar a mensagem. Confira mais detalhes em Nomear uma mensagem.

object (EmojiReactionSummary)

Apenas saída. A lista de resumos das reações com emojis na mensagem.

object (User)

Opcional. Imutável. Entrada para criar uma mensagem, caso contrário, apenas saída. O usuário que pode acessar a mensagem. Quando definido, a mensagem é privada e só fica visível para o usuário especificado e para o app Chat. Para incluir esse campo na solicitação, chame a API Chat usando a autenticação do app e omita o seguinte:

• Anexos
• Widgets de acessórios

Para mais detalhes, consulte Enviar uma mensagem particular.

object (DeletionMetadata)

Apenas saída. Informações sobre uma mensagem excluída. Uma mensagem é excluída quando deleteTime é definida.

object (QuotedMessageMetadata)

Apenas saída. Informações sobre uma mensagem citada por um usuário do Google Chat em um espaço. Os usuários do Google Chat podem citar uma mensagem para responder a ela.

object (AttachedGif)

Apenas saída. Imagens GIF anexadas à mensagem.

object (AccessoryWidget)

Opcional. Um ou mais widgets interativos que aparecem na parte de baixo de uma mensagem. É possível adicionar widgets a mensagens que contêm texto, cards ou ambos. Não é compatível com mensagens que contêm caixas de diálogo. Para mais detalhes, consulte Adicionar widgets interativos na parte de baixo de uma mensagem.

A criação de uma mensagem com widgets acessórios requer a autenticação do app.