En esta página, se describe cómo diseñar y crear los componentes principales de la IU de los mensajes de tarjetas en Google Chat.
Las tarjetas admiten un diseño definido, elementos interactivos de la IU (como botones) y rich media, como imágenes. Puedes usar tarjetas para presentar información, recopilar entradas o proporcionar los próximos pasos a los usuarios mediante mensajes de tarjetas y diálogos.
Diseña tarjetas y obtén una vista previa de ellas con el Creador de tarjetas.
Abre el Creador de tarjetasPor lo general, las tarjetas y los diálogos tienen los siguientes componentes:
- Un objeto
CardHeaderque contiene el título de la tarjeta - Uno o más widgets
CardSectionque forman el cuerpo principal de la tarjeta. - Un widget
CardFixedFooterespecífico solo para diálogos.
Requisitos previos
Agregar un encabezado
El widget CardHeader representa el encabezado de una tarjeta. Los encabezados pueden incluir un título, un subtítulo y una imagen de avatar para la tarjeta.
Puedes incluir CardHeader para mensajes de tarjetas y diálogos.
A continuación, se muestra un ejemplo de un CardHeader:
Cómo definir una sección de una tarjeta
El widget CardSection es un contenedor de alto nivel dentro de una tarjeta. Usas secciones de tarjetas para agrupar widgets dentro de una tarjeta. Para cada sección de tarjetas, puedes incluir un encabezado y uno o más widgets.
Puedes incluir CardSection para mensajes de tarjetas y diálogos.
A continuación, se muestra un ejemplo de un CardSection que contiene dos widgets textParagraph:
Agrega un pie de página persistente
El widget CardFixedFooter representa el pie de página de un mensaje de diálogo enviado por una app de Chat. Los pies de página pueden incluir un botón principal y uno secundario.
El widget de CardFixedFooter solo está disponible para diálogos.
El siguiente es un ejemplo de un widget de CardFixedFooter con dos botones:
Solución de problemas
Cuando una app de Google Chat o una tarjeta devuelve un error, la interfaz de Chat muestra un mensaje que dice “Se produjo un error” o “No se pudo procesar tu solicitud”. A veces, la IU de Chat no muestra ningún mensaje de error, pero la app o la tarjeta de Chat producen un resultado inesperado; por ejemplo, es posible que no aparezca un mensaje de tarjeta.
Si bien es posible que no se muestre un mensaje de error en la IU de Chat, hay mensajes de error descriptivos y datos de registro disponibles que te ayudarán a corregir errores cuando se activa el registro de errores para las apps de Chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar problemas de Google Chat.