Dar formato a los mensajes

En esta página, se explica cómo las apps de Google Chat pueden dar formato al texto para enviar mensajes que contener alguno de los siguientes elementos:

  • Texto enriquecido que contiene hipervínculos o @menciones a uno o todos los usuarios de una Espacio de Chat
  • Texto que aparece en la interfaz de una tarjeta, incluso como texto de párrafo Texto de la IU que se muestra junto a un ícono, como un botón.

Cómo aplicar formato a un mensaje de texto

Chat te permite agregar formato básico a los mensajes de texto, como usar negrita, cursiva y tachado usando un pequeño subconjunto de la sintaxis de Markdown. Tú formatear el texto de manera diferente en los mensajes de texto que en los mensajes con tarjeta porque el texto mensajes tienen el mismo formato que Chat que usan los usuarios.

Para dar formato a los mensajes de texto, usa la siguiente sintaxis:

Formato Símbolo Ejemplo de sintaxis Texto que se muestra en Google Chat
Negrita * *hola* hola
Cursiva _ (guion bajo) _hello_ hola
Tachado ~ ~hola~ hola
Monoespacio ` (comilla inversa) “hello” hello
Bloque monoespacial ` ` ` (tres comillas inversas) ```
Hello
World
```
Hello
World
Lista con viñetas * o - (guion) seguido de un espacio

* Este es el primer elemento de la lista

* Este es el segundo elemento de la lista.

  • Este es el primer elemento de la lista
  • Este es el segundo elemento de la lista

Por ejemplo, considera el siguiente JSON:

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

Este mensaje de texto con formato muestra lo siguiente en un chat espacio:

La app de Cymbal Pizza envía un mensaje de texto que indica que llegó la entrega.

Ver el formato de texto enviado en un mensaje

Cuando un usuario envía un mensaje, el cuerpo de texto sin formato del mensaje se encuentra en text. Parte del formato que se aplica al mensaje de texto con Markdown la sintaxis, está en el campo text. El formato adicional se encuentra en campo formattedText solo de salida, que incluye lo siguiente:

  • Sintaxis adicional de Markdown para texto
  • Menciones de los usuarios
  • Hipervínculos personalizados
  • Emojis personalizados

Por ejemplo, considera el siguiente texto que envía un usuario:

Mensaje recibido en Chat con la palabra

Si el mensaje se dio formato mediante el menú Formato en la en la IU de Chat, el campo text contiene solo texto, mientras que El campo formattedText contiene las marcas, el texto y el hipervínculo. El En el siguiente ejemplo, se muestra el borrador de un mensaje de texto con una palabra hipervinculada elementos de una lista y una palabra en negrita:

Borrador de mensaje con la palabra

El mensaje se recibe en el siguiente 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*?",
    }

Si incluyes una URL de vínculo sin formato en el texto de tu mensaje, como http://www.example.com/, Google Chat lo usará como texto del vínculo y automáticamente hipervincula ese texto a la URL especificada.

Para proporcionar un texto alternativo para tu vínculo, utiliza la siguiente sintaxis:

Ejemplo de sintaxis Texto que se muestra en Google Chat
<https://example.com|Example website>

El texto de la barra vertical y del vínculo son opcionales, de modo que <https://www.example.com/> y https://www.example.com/ son equivalentes.

Mencionar usuarios en un mensaje de texto

Las apps de Chat pueden hacer lo siguiente: enviar mensajes de texto que @mencione a uno o a todos los usuarios de un espacio de Chat. Las apps de Chat no pueden mencionar usuarios que esté en modo de importación o cualquier usuario que no se unieron al espacio.

@mencionar a usuarios específicos

Para @mencionar a un usuario específico, agrega <users/{user}> al mensaje de texto, donde {user} es el ID del usuario. Por ejemplo, considera el siguiente texto mensaje en el que 123456789012345678901 representa el ID del usuario Mahan S.:

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

El mensaje de texto se muestra de la siguiente manera:

La app de Chat menciona a una persona en un mensaje de texto.

Puedes especificar el valor users/{user} de las siguientes maneras:

  • Si la app de Google Chat responde a un mensaje enviado por el usuario, puedes usar el campo message.sender.name de la MESSAGE evento de interacción.
  • Si la app de Google Chat crea una mensaje de texto asíncrono puedes especificar el valor de users/{user} de las siguientes maneras:

    • Usa el campo name de Google Chat Recurso User, como users/123456789012345678901
    • Usa la dirección de correo electrónico del usuario como un alias para el valor {user}. Para Por ejemplo, si la dirección de correo electrónico es mahan@example.com, puedes especificar el usuario como users/mahan@example.com. Para usar un alias de correo electrónico, tu app de Google Chat debe autenticarse como usuario.
  • Si usas la API de People, también puedes usar la Método people.get para identificar el ID de usuario.

@mencionar a todos los usuarios

Para crear un mensaje de texto que @mencione a todos los miembros de un espacio, reemplaza {user} con all. En el siguiente ejemplo de JSON, se mencionan todos los usuarios en un mensaje:

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

Dar formato al texto que aparece en las tarjetas

Dentro de las tarjetas, la mayoría de los campos de texto admiten el formateo de texto básico a través de una pequeña subconjunto de etiquetas HTML. Dales formato al texto de manera diferente en los mensajes de tarjeta que en el texto mensajes, porque los mensajes de texto tienen el mismo formato que que usan los usuarios de Chat.


Usa Card Builder para diseñar y obtener una vista previa de las interfaces de usuario y mensajería para apps de Chat:

Abre el Creador de tarjetas

Dar formato al texto del párrafo

A continuación, se muestran las etiquetas admitidas y su propósito. tabla:

Formato Ejemplo Resultado renderizado
Negrita "This is <b>bold</b>." Este texto está en negrita.
Cursiva "This is <i>italics</i>." Esta es la cursiva.
Subrayar "This is <u>underline</u>." Este texto está subrayado.
Tachado "This is <s>strikethrough</s>." Está tachado.
Color de la fuente "This is <font color=\"#FF0000\">red font</font>." Esta es una fuente roja.
Hipervínculo "This is a <a href=\"https://www.google.com\">hyperlink</a>." Esto es un hipervínculo.
Hora "This is a time format: <time>2023-02-16 15:00</time>." Este es un formato de hora: .
Nueva línea "This is the first line. <br> This is a new line." Esta es la primera línea.
Esta es una línea nueva.

Cómo agregar íconos al texto

Para mostrar iconos junto al texto en una tarjeta, puedes utilizar la DecoratedText y ButtonList widgets.

En las siguientes secciones, se explica cómo usar íconos integrados, Material de Google iconos o iconos personalizados en texto o botones decorados.

Cómo usar íconos de Chat

Para usar íconos integrados disponibles en Chat, sigue estos pasos: especifica una de las siguientes opciones:

En la siguiente tabla, se indican los íconos integrados disponibles para los mensajes de tarjetas:

AVIÓN MARCADOR
Autobús AUTO
RELOJ CONFIRMATION_NUMBER_ICON
DESCRIPCIÓN MONEDA
CORREO ELECTRÓNICO EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
INVITAR MAP_PIN
MEMBRESÍA MULTIPLE_PEOPLE
PERSONA TELÉFONO
RESTAURANT_ICON SHOPPING_CART
STAR TIENDA
ENTRADA ENTRENAMIENTO
VIDEO_CAMERA VIDEO_PLAY

El Este es un ejemplo de una tarjeta con un ícono de correo electrónico:

Usa íconos de Google Material

Puedes usar íconos de Material de Google. para seleccionar entre más de 2,500 opciones de íconos y personalizar la el peso, el relleno y la calificación de los iconos.

El siguiente es un ejemplo de una tarjeta con un ícono de Material de Google:

Cómo usar íconos personalizados

Para agregar un ícono personalizado, incluye el campo iconUrl y especifica la dirección la URL correspondiente.

El siguiente es un ejemplo de un ícono personalizado: