Com o Google Chat, você pode adicionar formatação às mensagens, incluindo o seguinte:
- Formatação básica de texto, como negrito, itálico e tachado, em mensagens de texto e mensagens de cards.
- Texto vinculado.
- @mencionar um ou todos os usuários em um espaço do Chat.
- Adicione ícones integrados e personalizados apenas nas mensagens do cartão.
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. O texto é formatado de maneira diferente nas mensagens de texto e nas mensagens de cartão, porque as mensagens de texto são formatadas com a mesma sintaxe que os usuários do Chat usam. Para formatar o texto que aparece em um card, consulte Formatar uma mensagem de card.
Para formatar mensagens de texto, use esta sintaxe:
Formato | Símbolo | Exemplo de sintaxe | Texto exibido no Google Chat |
---|---|---|---|
Negrito | * | *olá* | Olá |
Itálico | _ (sublinhado) | _olá_ | Olá |
Tachado | ~ | ~olá~ | |
fonte monoespaçada | ` (crase) | "Olá" | hello |
Bloco monoespaçada | ` ` ` (três acentos graves) | ``` Olá Mundo ``` |
Hello |
Lista com marcadores | * ou - (hífen) seguido por um espaço | * Este é o primeiro item da lista * Este é o segundo item da lista |
|
Por exemplo, considere este JSON:
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
Essa mensagem de texto formatada exibe o seguinte em um espaço do Chat:
Conferir a formatação do texto enviada em uma mensagem
Quando um usuário envia uma mensagem, o corpo de texto simples da mensagem está no campo text
. Alguma formatação que é aplicada à mensagem de texto usando a sintaxe Markdown está no campo text
. Há formatação adicional no campo formattedText
somente saída, incluindo o seguinte:
- Sintaxe de Markdown adicional para texto
- Menções do usuário
- Hiperlinks personalizados
- Emojis personalizados
Por exemplo, considere o seguinte texto enviado por um usuário:
Se a mensagem foi formatada usando o menu Formatar na
interface do Chat, o campo text
conterá apenas o texto, enquanto o campo
formattedText
terá as marcações, o texto e o hiperlink. O
exemplo a seguir mostra o rascunho de uma mensagem de texto com uma palavra com hiperlink,
itens em 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 usá-lo como o texto do link e
criar um hiperlink automaticamente para o URL especificado.
Para fornecer um texto de link alternativo para seu link, use a seguinte sintaxe:
Exemplo de sintaxe | Texto exibido no Google Chat |
---|---|
<https://example.com|Example website> |
O texto da barra vertical e do link são opcionais, para que <https://www.example.com/>
e
https://www.example.com/
sejam equivalentes.
Mencionar usuários em uma mensagem de texto
Os apps de chat podem enviar mensagens de texto que mencionam um ou todos os usuários em um espaço do Chat com @. Os apps do Chat não podem mencionar usuários em um espaço que está no modo de importação ou que não entrou no espaço.
@mencionar usuários específicos
Para mencionar um usuário específico usando @, adicione <users/{user}>
à mensagem de texto, em que {user}
é o ID do usuário. Por exemplo, considere esta mensagem
de texto 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 é exibida da seguinte forma:
É 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
do evento de interaçãoMESSAGE
. Se o app do Google Chat estiver criando uma mensagem de texto assíncrona, será possível especificar o valor de
users/{user}
das seguintes maneiras:- Use o campo
name
do recursoUser
do Google Chat, comousers/123456789012345678901
. - Use o endereço de e-mail do usuário como um alias para o valor
{user}
. Por exemplo, se o endereço de e-mail formahan@example.com
, especifique o usuário comousers/mahan@example.com
. Para usar um alias de e-mail, seu app do Google Chat precisa se autenticar como um usuário.
- Use o campo
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 todas as pessoas em um espaço, substitua {user}
por 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 card
Dentro dos cards, a maioria dos campos de texto oferece suporte à formatação básica de texto usando um pequeno subconjunto de tags HTML. O texto é formatado de forma diferente nas mensagens de card e em mensagens de texto porque elas são formatadas com a mesma sintaxe que os usuários do Chat usam. Para formatar o texto que aparece em uma mensagem de texto, consulte Formatar uma mensagem de texto.
Use o Card Builder para criar e visualizar mensagens de cards JSON em apps de chat:
Abra o Criador de cards.A tabela a seguir mostra as tags compatíveis e a finalidade delas:
Formato | Exemplo | Resultado renderizado |
---|---|---|
Negrito | "This is <b>bold</b>." |
Está em negrito. |
Itálico | "This is <i>italics</i>." |
Está em itálico. |
Sublinhado | "This is <u>underline</u>." |
Ele é sublinhado. |
Tachado | "This is <s>strikethrough</s>." |
Isso está |
Cor da fonte | "This is <font color=\"#FF0000\">red font</font>." |
Esta é uma fonte vermelha. |
Hiperlink | "This is a <a href=\"https://www.google.com\">hyperlink</a>." |
Este é um hiperlink. |
Tempo | "This is a time format: <time>2023-02-16 15:00</time>." |
Este é um formato de horário: . |
Nova linha | "This is the first line. <br> This is a new line. pol. |
Esta é a primeira linha. Esta é uma nova linha. |
Adicionar um ícone integrado a um card
Os widgets
DecoratedText
e
ButtonList
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 de cards:
AO PLANO | BOOKMARK | ||
BUS | CAR | ||
RELÓGIO | CONFIRMATION_NUMBER_ICON | ||
DESCRIÇÃO | MOEDA | ||
EVENT_SEAT | |||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
HOTÉ | HOTEL_ROOM_TYPE | ||
CONVIDAR | MAP_PIN | ||
ASSINATURA | MULTIPLE_PEOPLE | ||
PESSOA | TELEFONE | ||
RESTAURANT_ICON | SHOPPING_CART | ||
MARCAR COM ESTRELA | LOJA | ||
INGRESSO | TRAIN | ||
VIDEO_CAMERA | VIDEO_PLAY |
Veja a seguir um exemplo de cartão com um ícone de e-mail:
Adicionar um ícone do Material Design do Google a um card
Os widgets
DecoratedText
e
ButtonList
permitem usar os ícones do Google Material
para selecionar entre mais de 2.500 opções e personalizar o
peso, o preenchimento e a inclinação dos ícones.
Confira a seguir um exemplo de card com um ícone do Material do Google:
Adicionar um ícone personalizado a um cartão
Os widgets
DecoratedText
e
ButtonList
permitem usar os ícones integrados ou definir ícones personalizados. Para adicionar um ícone personalizado a um cartão, inclua o campo iconUrl
e especifique o URL correspondente do ícone.
Este é um exemplo de ícone personalizado: