Google Chat te permite agregar formato a los mensajes, incluido lo siguiente:
- Formato de texto básico, como negrita, cursiva y tachado, en mensajes de texto y mensajes de tarjetas.
- Texto vinculado:
- @menciona a uno o a todos los usuarios en un espacio de Chat.
- Agrega funciones integradas y íconos personalizados solo en los mensajes de tarjeta.
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~ | |
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.name
de laMESSAGE
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 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.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 tarjetasA 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 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: