Button

Кнопка с текстом, значком или и тем, и другим, на которую могут нажимать пользователи. Пример для приложений Google Chat приведен в разделе Как добавить кнопку.

Чтобы сделать изображение кнопкой, укажите Image (не ImageComponent) и задайте действие onClick.

Доступно для приложений Google Chat и дополнений Google Workspace.

JSON-представление 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
Поля
text

string

Текст, который будет показываться на кнопке.
icon

object (Icon)

Значок, который показывается на кнопке. Если заданы оба параметра (icon и text), значок будет показываться перед текстом.
color

object (Color)

Необязательное поле. Цвет кнопки. Если задано, для кнопки type устанавливается значение FILLED, а для полей text и icon – контрастный цвет, чтобы текст было удобно читать. Например, если кнопка синяя, то текст и значки на ней будут белыми.

Чтобы задать цвет кнопки, укажите значения в полях red, green и blue. Значение должно быть числом с плавающей запятой от 0 до 1, основанным на значении цвета RGB, где 0 (0/255) означает отсутствие цвета, а 1 (255/255) – максимальную интенсивность цвета.

Например, в следующем примере задается красный цвет максимальной интенсивности:

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

Поле alpha недоступно для цвета кнопки. Если это поле заполнено, оно игнорируется.
onClick

object (OnClick)

Обязательно. Действие, которое выполняется, когда пользователь нажимает кнопку, например открытие гиперссылки или запуск пользовательской функции.
disabled

boolean

Если true, кнопка неактивна и не реагирует на действия пользователя.
altText

string

Альтернативный текст, который используется для специальных возможностей.

Добавьте описание, чтобы пользователи знали, что делает кнопка. Например, если кнопка открывает гиперссылку, вы можете написать: "Открывает новую вкладку браузера и переходит к документации для разработчиков Google Chat по адресу https://developers.google.com/workspace/chat".
type

enum (Type)

Необязательное поле. Тип кнопки. Если тип не задан, по умолчанию используется OUTLINED. Если задано поле color, тип кнопки принудительно устанавливается как FILLED, а любое значение, заданное для этого поля, игнорируется.

Тип

Необязательное поле. Тип кнопки. Если задано поле color, то для type принудительно устанавливается значение FILLED.

Доступно для приложений Google Chat и недоступно для дополнений Google Workspace.

Перечисления
TYPE_UNSPECIFIED Не использовать. Не указано.
OUTLINED Контурные кнопки имеют средний акцент. Обычно они содержат важные, но не основные действия в приложении Chat или дополнении.
FILLED У заполненной кнопки есть контейнер сплошного цвета. Она наиболее заметна и рекомендуется для важных и основных действий в приложении Chat или дополнении.
FILLED_TONAL Заполненная тональная кнопка – это альтернативный средний вариант между заполненными и контурными кнопками. Они полезны в контекстах, где кнопка с более низким приоритетом требует немного большего акцента, чем кнопка с контуром.
BORDERLESS В состоянии по умолчанию у кнопки нет невидимого контейнера. Обычно используется для действий с самым низким приоритетом, особенно когда предлагается несколько вариантов.