Button

Es un botón de texto, ícono o texto e ícono en el que los usuarios pueden hacer clic. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un botón.

Para que una imagen sea un botón en el que se pueda hacer clic, especifica un Image (no un ImageComponent) y establece una acción onClick.

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

Representación JSON 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
Campos
text

string

Es el texto que se muestra dentro del botón.
icon

object (Icon)

Es un ícono que se muestra dentro del botón. Si se establecen icon y text, el ícono aparecerá antes del texto.
color

object (Color)

Opcional. Es el color del botón. Si se establece, el botón type se establece en FILLED, y el color de los campos text y icon se establece en un color de contraste para mejorar la legibilidad. Por ejemplo, si el color del botón se establece en azul, el texto o los íconos del botón se establecen en blanco.

Para establecer el color del botón, especifica un valor para los campos red, green y blue. El valor debe ser un número de punto flotante entre 0 y 1 según el valor de color RGB, donde 0 (0/255) representa la ausencia de color y 1 (255/255) representa la intensidad máxima del color.

Por ejemplo, en el siguiente código, se establece el color rojo en su intensidad máxima:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

El campo alpha no está disponible para el color del botón. Si se especifica, se ignora este campo.
onClick

object (OnClick)

Obligatorio. Es la acción que se debe realizar cuando un usuario hace clic en el botón, como abrir un hipervínculo o ejecutar una función personalizada.
disabled

boolean

Si es true, el botón se muestra en un estado inactivo y no responde a las acciones del usuario.
altText

string

Es el texto alternativo que se usa para la accesibilidad.

Establece un texto descriptivo que les permita a los usuarios saber qué hace el botón. Por ejemplo, si un botón abre un hipervínculo, puedes escribir lo siguiente: "Abre una nueva pestaña del navegador y navega a la documentación para desarrolladores de Google Chat en https://developers.google.com/workspace/chat".
type

enum (Type)

Opcional. Es el tipo de botón. Si no se establece, el tipo de botón se establece de forma predeterminada en OUTLINED. Si se establece el campo color, el tipo de botón se fuerza a FILLED y se ignora cualquier valor establecido para este campo.

Tipo

Opcional. El tipo de un botón. Si se establece el campo color, el type se fuerza a FILLED.

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

Enums
TYPE_UNSPECIFIED No usar. Sin especificar.
OUTLINED Los botones con contorno son botones de énfasis medio. Por lo general, contienen acciones que son importantes, pero no son la acción principal en una app de Chat o un complemento.
FILLED Un botón relleno tiene un contenedor con un color sólido. Tiene el mayor impacto visual y se recomienda para la acción importante y principal en una app de Chat o un complemento.
FILLED_TONAL Un botón tonal relleno es una alternativa intermedia entre los botones rellenos y los delineados. Son útiles en contextos en los que un botón de menor prioridad requiere un poco más de énfasis que el que daría un botón con contorno.
BORDERLESS Un botón no tiene un contenedor invisible en su estado predeterminado. A menudo, se usa para las acciones de menor prioridad, en especial cuando se presentan varias opciones.