Cómo diseñar los componentes de una tarjeta o un diálogo

En esta página, se describe cómo diseñar y crear los componentes principales de la IU de los mensajes de tarjeta en Google Chat.

Las tarjetas admiten un diseño definido, elementos de IU interactivos, como botones, y rich media, como imágenes. Puedes usar tarjetas para presentar información, recopilar entradas o dar los próximos pasos a los usuarios a través de mensajes de tarjetas y diálogos.

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

Por lo general, las tarjetas y los diálogos tienen los siguientes componentes:

  • Es un elemento CardHeader que contiene el título de la tarjeta.
  • Uno o más widgets CardSection que forman el cuerpo principal de la tarjeta.
  • Un widget CardFixedFooter específico solo para diálogos

Requisitos previos

  • Una cuenta de Google Workspace con acceso a Google Chat
  • Una app de Chat publicada. Para compilar una app de Chat, sigue esta quickstart.

    • 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 tu tarjeta.

    Puedes incluir CardHeader para los mensajes de tarjetas y los 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. Puedes usar secciones de tarjetas para agrupar widgets dentro de una tarjeta. Para cada sección de la tarjeta, puedes incluir un encabezado y uno o más widgets.

    Puedes incluir CardSection para los mensajes de tarjetas y los diálogos.

    El siguiente es un ejemplo de un CardSection que contiene dos widgets textParagraph:

    El widget CardFixedFooter representa el pie de página de un mensaje de diálogo que envía una app de Chat. Los pies de página pueden incluir un botón principal y uno secundario.

    El widget CardFixedFooter solo está disponible para diálogos.

    El siguiente es un ejemplo de un widget CardFixedFooter con dos botones:

    Solucionar problemas

    Cuando una app o una tarjeta de Google Chat muestran un error, la interfaz de Chat muestra el mensaje “Se produjo un error”. o "No se pudo procesar la 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, puede que no aparezca un mensaje de tarjeta.

    Aunque es posible que un mensaje de error no aparezca en la IU de Chat, hay mensajes de error descriptivos y datos de registro disponibles para ayudarte a corregir errores cuando está activado el registro de errores para las apps de Chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar problemas y corregir errores de Google Chat.