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~ | |
| Monoespacio | ` (comilla inversa) | “hello” | hello |
| Bloque monoespacial | ` ` ` (tres comillas inversas) | ``` Hello World ``` |
Hello |
| 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. |
|
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:
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:
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:
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*?",
}
Cómo aplicarles formato a los vínculos
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:
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.namede laMESSAGEevento 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
namede Google Chat RecursoUser, comousers/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 esmahan@example.com, puedes especificar el usuario comousers/mahan@example.com. Para usar un alias de correo electrónico, tu app de Google Chat debe autenticarse como usuario.
- Usa el campo
Si usas la API de People, también puedes usar la Método
people.getpara 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 tarjetasDar 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á |
| 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: