Icon

Es un ícono que se muestra en un widget de una tarjeta. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un ícono.

Admite íconos integrados y personalizados.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

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

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
Campos
altText

string

Opcional. Es una descripción del ícono que se usa para la accesibilidad. Si no se especifica, se proporciona el valor predeterminado Button. Como práctica recomendada, debes establecer una descripción útil de lo que muestra el ícono y, si corresponde, de 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/workspace/chat.

Si el ícono se establece en un Button, el altText aparece como texto de ayuda cuando el usuario coloca el cursor sobre el botón. Sin embargo, si el botón también establece text, se ignora el altText del ícono.

imageType

enum (ImageType)

Es el estilo de recorte que se aplica a la imagen. En algunos casos, aplicar un recorte de CIRCLE hace que la imagen se dibuje más grande que un ícono integrado.

Es el ícono que se muestra en el widget de la tarjeta. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
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

Muestra un ícono personalizado alojado en una URL HTTPS.

Por ejemplo:

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

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

materialIcon

object (MaterialIcon)

Muestra uno de los íconos de material de Google.

Por ejemplo, para mostrar un ícono de casilla de verificación, usa lo siguiente:

"materialIcon": {
  "name": "check_box"
}

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Fin de los campos mutuamente excluyentes.

MaterialIcon

Un ícono de material de Google, que incluye más de 2,500 opciones.

Por ejemplo, para mostrar un ícono de casilla de verificación con un grosor y una inclinación personalizados, escribe lo siguiente:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Representación JSON
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Campos
name

string

Es el nombre del ícono definido en el ícono de material de Google, por ejemplo, check_box. Los nombres no válidos se abandonan y se reemplazan por una cadena vacía, lo que hace que el ícono no se renderice.

fill

boolean

Indica si el ícono se renderiza como relleno. El valor predeterminado es falso.

Para obtener una vista previa de los diferentes parámetros de configuración de los íconos, ve a Google Font Icons y ajusta los parámetros de configuración en Customize.

weight

integer

Es el grosor del trazo del ícono. Elige entre {100, 200, 300, 400, 500, 600, 700}. Si no se incluye, el valor predeterminado es 400. Si se especifica cualquier otro valor, se usa el valor predeterminado.

Para obtener una vista previa de los diferentes parámetros de configuración de los íconos, ve a Google Font Icons y ajusta los parámetros de configuración en Customize.

grade

integer

El peso y el grado afectan el grosor de un símbolo. Los ajustes de grado son más detallados que los de peso y tienen un impacto pequeño en el tamaño del símbolo. Elige entre {-25, 0, 200}. Si no se incluye, el valor predeterminado es 0. Si se especifica cualquier otro valor, se usa el valor predeterminado.

Para obtener una vista previa de los diferentes parámetros de configuración de los íconos, ve a Google Font Icons y ajusta los parámetros de configuración en Customize.