Ícono

El widget Icon representa un ícono integrado o un ícono personalizado. Puedes usar Icon en mensajes de tarjetas y diálogos de las siguientes maneras:

  • Muestra un ícono independiente.
  • Muestra un ícono delante de texto relacionado, como parte de un widget DecoratedText.
  • Muestra un ícono como un botón interactivo, como parte de un widget ButtonList.

La siguiente es una tarjeta que consta de un componente Icon:

Íconos integrados disponibles para el widget Icon

Para usar un ícono integrado, usa el campo knownIcon:

{
  .
  .
  .
      "knownIcon": "TRAIN",
  .
  .
  .
}

En la siguiente tabla, se muestran los íconos integrados que están disponibles para los mensajes de tarjetas:

AVIÓN BOOKMARK
BUS AUTO
RELOJ CONFIRMATION_NUMBER_ICON
DESCRIPTION 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
DESTACAR TIENDA
BOLETO TRAIN
VIDEO_CAMERA VIDEO_PLAY

Representación de JSON y campos

Representación JSON 
{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string
  // End of list of possible types for union field icons.
}
Campos
altText

string

Opcional. Es una descripción del ícono que se usa con fines de accesibilidad. Si no se especifica, se proporciona el valor predeterminado Button. Como práctica recomendada, debes establecer una descripción útil para lo que muestra el ícono y, si corresponde, para lo que hace. Por ejemplo, A user's account portrait o Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat.

Si se configura el ícono en una Button, el altText aparece como texto auxiliar cuando el usuario se desplaza sobre el botón. Sin embargo, si el botón también establece text, se ignora el altText del ícono.

imageType

enum (ImageType)

El estilo de recorte aplicado a la imagen. En algunos casos, aplicar un recorte CIRCLE causa que la imagen se dibuje más grande que un ícono integrado.

Campo de unión icons. Es el ícono que se muestra en el widget de la tarjeta. icons solo puede ser una de las siguientes opciones:
knownIcon

string

Muestra uno de los íconos integrados que proporciona Google Workspace.

Por ejemplo, para mostrar un ícono de avión, especifica AIRPLANE. Para un autobús, especifica BUS.

Para obtener una lista completa de los íconos compatibles, consulta íconos integrados.

iconUrl

string

Mostrar un ícono personalizado alojado en una URL HTTPS

Por ejemplo: 

"iconUrl":
"https://developers.google.com/chat/images/quickstart-app-avatar.png"

Los tipos de archivos admitidos incluyen .png y .jpg.

ImageType

Forma que se usa para recortar la imagen.

Enumeradores
SQUARE Valor predeterminado Aplica una máscara cuadrada a la imagen. Por ejemplo, una imagen de 4 × 3 se convierte en 3 × 3.
CIRCLE Aplica una máscara circular a la imagen. Por ejemplo, una imagen de 4 x 3 se convierte en un círculo con un diámetro de 3.

Solución de problemas

Cuando una app o tarjeta de Google Chat 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.

Aunque 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 para ayudarte a corregir errores cuando se activa el registro de errores de las apps de chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar y corregir errores de Google Chat.