Dar formato a los mensajes

Google Chat te permite agregar formato a los mensajes, incluido lo siguiente:

Cómo aplicar formato a un mensaje de texto

Chat te permite agregar formato básico a los mensajes de texto, como 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 usa Chat que usan los usuarios. Para dar formato al texto que aparece en una tarjeta, consulta Formatea un mensaje de tarjeta.

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!"
}

Cómo darle formato a un mensaje de tarjeta

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. Para darle formato al texto que aparece en un mensaje de texto, ver Da formato a un mensaje de texto.

Usa Card Builder para diseñar mensajes de tarjetas JSON y obtener una vista previa de ellos para apps de Chat:

Abre el Creador de tarjetas

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 la 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 un ícono integrado a una tarjeta

El DecoratedText y ButtonList los widgets admiten el elemento icon que se usa para especificar uno de los íconos integrados disponibles en Chat.

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
INVITE MAP_PIN
MEMBRESÍA MULTIPLE_PEOPLE
PERSONA TELÉFONO
RESTAURANT_ICON SHOPPING_CART
DESTACAR TIENDA
ENTRADA ENTRENAMIENTO
VIDEO_CAMERA VIDEO_PLAY

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

Cómo agregar un ícono de Material Design de Google a una tarjeta

El DecoratedText y ButtonList los widgets te permiten usar los íconos de Material de Google para que puedas seleccionar entre más de 2500 opciones de iconos 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 agregar un ícono personalizado a una tarjeta

El DecoratedText y ButtonList los widgets te permiten utilizar los iconos integrados o definir tus propios iconos personalizados. Para agregar un ícono personalizado a una tarjeta, incluir el campo iconUrl y especificar el nombre la URL correspondiente.

El siguiente es un ejemplo de un ícono personalizado: