Mensagens de formato

Com o Google Chat, você pode adicionar formatação às mensagens. Por exemplo:

• A formatação básica de texto, como negrito, itálico e tachado, em mensagens de texto e mensagens do card.
• Texto do link.
• @mencionar um ou todos os usuários em um espaço do Chat.
• Adicionar integrado e ícones personalizados somente nas mensagens do card.

Formatar uma mensagem de texto

O Chat permite adicionar formatação básica a uma mensagem de texto, incluindo negrito, itálico e tachado, usando um pequeno subconjunto da sintaxe Markdown. Você formatar o texto de maneira diferente em mensagens de texto e em cards porque o texto as mensagens são formatadas com a mesma sintaxe que as pelos usuários. Para formatar o texto que aparece em um card, consulte Formatar uma mensagem de card.

Para formatar mensagens de texto, use a seguinte sintaxe:

Formato	Símbolo	Exemplo de sintaxe	Texto mostrado no Google Chat
Negrito	*	*Olá*	Olá
Itálico	_ (sublinhado)	_hello_	Olá
Tachado	~	olá!	Olá
fonte monoespaçada	` (acento grave)	"olá"	hello
Bloco monoespaçada	` ` ` (três aspas)	``` Hello World ```	Hello World
Lista com marcadores	* ou - (hífen) seguido por um espaço	* Este é o primeiro item na lista * Este é o segundo item da lista	Este é o primeiro item na lista Este é o segundo item na lista

Por exemplo, considere o seguinte JSON:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

Esta mensagem de texto formatada exibe o seguinte em uma janela do Chat espaço:

Ver a formatação do texto enviada em uma mensagem

Quando um usuário envia uma mensagem, o corpo de texto simples da mensagem fica no text. Alguma formatação aplicada à mensagem de texto usando Markdown está no campo text. Há outras formatações no campo formattedText somente saída, incluindo o seguinte:

• Sintaxe de Markdown adicional para texto
• Menções de usuários
• Hiperlinks personalizados
• Emojis personalizados

Por exemplo, considere o texto a seguir enviado por um usuário:

Se a mensagem foi formatada usando o menu Formatar na seção Na interface do Chat, o campo text contém apenas o texto, enquanto o formattedText contém as marcações, o texto e o hiperlink. A exemplo a seguir mostra o rascunho de uma mensagem de texto com uma palavra com hiperlink, itens de uma lista e uma palavra em negrito:

A mensagem é recebida no seguinte formato:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

Formatar links

Se você incluir um URL de link simples no texto da mensagem, como http://www.example.com/, o Google Chat vai usar isso como o texto do link e cria um hiperlink automaticamente para o URL especificado.

Para fornecer um texto de link alternativo para o seu link, use a seguinte sintaxe:

Exemplo de sintaxe	Texto mostrado no Google Chat
<https://example.com|Example website>	Example website

O pipe e o texto do link são opcionais, de modo que <https://www.example.com/> e https://www.example.com/ são equivalentes.

Mencionar usuários em uma mensagem de texto

Os apps de chat podem enviar mensagens de texto @mencionar um ou todos os usuários em um espaço do Chat. Apps de chat não podem mencionar usuários em uma espaço que está no modo de importação ou qualquer usuário que não estão participando do espaço.

@mencionar usuários específicos

Para @mencionar um usuário específico, adicione <users/{user}> à mensagem de texto em que {user} é o ID do usuário. Por exemplo, considere o seguinte texto mensagem em que 123456789012345678901 representa o ID do usuário Mahan S.

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

A mensagem de texto vai aparecer assim:

É possível especificar o valor users/{user} das seguintes maneiras:

• Se o app do Google Chat estiver respondendo a uma mensagem enviada pelo usuário, use o campo message.sender.name da MESSAGE evento de interação.

• Se o app Google Chat estiver criando uma mensagem de texto assíncrona, é possível especificar o valor de users/{user} das seguintes maneiras:

  • Usar o campo name do Google Chat User, como users/123456789012345678901.
  • Use o endereço de e-mail do usuário como um alias para o valor {user}. Para Por exemplo, se o endereço de e-mail for mahan@example.com, será possível especificar o usuário como users/mahan@example.com. Para usar um alias de e-mail, seu O app Google Chat precisa autenticar como um usuário.

• Se você usar a API People, também poderá usar o Método people.get para identificar o ID do usuário.

@mencionar todos os usuários

Para criar uma mensagem de texto que @mencione todos em um espaço, substitua {user} com all. O exemplo de JSON a seguir menciona todos os usuários em uma mensagem:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Formatar uma mensagem de cartão

Nos cards, a maioria dos campos de texto é compatível com a formatação básica usando uma pequena subconjunto de tags HTML. Você formata o texto de maneira diferente nas mensagens de cartão e de texto porque as mensagens de texto são formatadas com a mesma sintaxe que Utilizado pelo usuário do Chat. Para formatar o texto que aparece em uma mensagem de texto, ver Formatar uma mensagem de texto.

---

Use o Card Builder para criar e visualizar mensagens de cards JSON para apps do Chat:

Abrir o Card Builder

---

As tags compatíveis e suas finalidades são mostradas a seguir tabela:

Formato	Exemplo	Resultado renderizado
Negrito	"This is <b>bold</b>."	Isso está em negrito.
Itálico	"This is <i>italics</i>."	Isso está em itálico.
Sublinhado	"This is <u>underline</u>."	Isso é sublinhado.
Tachado	"This is <s>strikethrough</s>."	Isso está tachado.
Cor da fonte	"This is <font color=\"#FF0000\">red font</font>."	Esta é a fonte vermelha.
Hiperlink	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	Isso é um hiperlink.
Tempo	"This is a time format: <time>2023-02-16 15:00</time>."	Este é um formato de hora: 2023-02-16 15:00.
Nova linha	"This is the first line. <br> This is a new line."	Essa é a primeira linha. Esta é uma nova linha.

Adicionar um ícone integrado a um card

A DecoratedText e ButtonList widgets oferecem suporte ao elemento icon usado para especificar um dos ícones integrados disponíveis no Chat.

A tabela a seguir lista os ícones integrados disponíveis para mensagens do card:

flight	AÉREO	bookmark	MARCA EM RELAÇÃO AO LIVRO
directions_bus	ÔNIBUS	directions_car	CARRO
schedule	RELÓGIO	confirmation_number	CONFIRMATION_NUMBER_ICON
subject	DESCRIÇÃO	attach_money	MOEDA
mail	E-MAIL	event_seat	EVENT_SEAT
flight_land	FLIGHT_ARRIVAL	flight_takeoff	FLIGHT_DEPARTURE
hotel	HOTEL	grade	HOTEL_ROOM_TYPE
insert_invitation	INVITE	location_on	MAP_PIN
card_membership	ASSINATURA	people	MULTIPLE_PEOPLE
person	PESSOA	local_phone	TELEFONE
restaurant	RESTAURANT_ICON	shopping_cart	SHOPPING_CART
grade	MARCAR COM ESTRELA	store	LOJA
local_play	INGRESSO	train	TREINAMENTO
videocam	VIDEO_CAMERA	play_circle_filled	VIDEO_PLAY

A Confira a seguir um exemplo de cartão com um ícone de e-mail:

Adicionar um ícone do Material Design do Google a um card

A DecoratedText e ButtonList Os widgets permitem usar os ícones do Google Material para que você possa selecionar entre mais de 2500 opções de ícones e personalizar o peso, preenchimento e gradação dos ícones.

Confira abaixo um exemplo de card com um ícone do Google Material:

Adicionar um ícone personalizado a um cartão

A DecoratedText e ButtonList Os widgets permitem que você use os ícones integrados ou defina seus próprios ícones personalizados. Para adicione um ícone personalizado a um cartão, inclua o campo iconUrl e especifique o tipo URL correspondente.

Este é um exemplo de ícone personalizado: