Cards v2

object ( CardHeader )

Заголовок карточки. Заголовок обычно содержит основное изображение и заголовок. Заголовки всегда располагаются в верхней части карточки.

object ( Section )

Содержит набор виджетов. Каждый раздел имеет свой собственный, необязательный заголовок. Разделы визуально разделены разделительной линией. Пример использования в приложениях Google Chat см. в разделе «Определение раздела карточки» .

enum ( DividerStyle )

Стиль разделителя между заголовком, разделами и нижним колонтитулом.

object ( CardAction )

Действия карточки. Действия добавляются в меню панели инструментов карточки.

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

Например, следующий JSON-код формирует меню действий в виде карточки с опциями Settings и Send Feedback :

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

Name of the card. Used as a card identifier in card navigation.

Available for Google Workspace add-ons and unavailable for Google Chat apps.

object ( CardFixedFooter )

Фиксированный нижний колонтитул, показанный внизу этой карточки.

Установка fixedFooter без указания primaryButton или secondaryButton приводит к ошибке. В чат-приложениях можно использовать фиксированные нижние колонтитулы в диалогах , но не в сообщениях-карточках .

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

enum ( DisplayStyle )

In Google Workspace add-ons, sets the display properties of the peekCardHeader .

Available for Google Workspace add-ons and unavailable for Google Chat apps.

object ( CardHeader )

When displaying contextual content, the peek card header acts as a placeholder so that the user can navigate forward between the homepage cards and the contextual cards.

Available for Google Workspace add-ons and unavailable for Google Chat apps.

object ( ExpressionData )

Данные выражения для карты.

Доступно для дополнений Google Workspace, расширяющих функциональность Google Workspace Studio. Недоступно для приложений Google Chat.

string

Обязательно. Заголовок верхней части карточки. Высота заголовка фиксирована: если указаны и заголовок, и подзаголовок, каждый занимает одну строку. Если указан только заголовок, он занимает обе строки.

string

The subtitle of the card header. If specified, appears on its own line below the title .

enum ( ImageType )

Форма, используемая для обрезки изображения.

Available for Google Chat apps and Google Workspace add-ons.

string

HTTPS-адрес изображения в заголовке карточки.

string

The alternative text of this image that's used for accessibility.

string

Текст, отображаемый в верхней части раздела. Поддерживается простой HTML-форматированный текст. Для получения дополнительной информации о форматировании текста см. разделы «Форматирование текста в приложениях Google Chat» и «Форматирование текста в надстройках Google Workspace».

object ( Widget )

Все виджеты в разделе. Должен содержать как минимум один виджет.

boolean

Указывает, можно ли свернуть этот раздел.

Collapsible sections hide some or all widgets, but users can expand the section to reveal the hidden widgets by clicking Show more . Users can hide the widgets again by clicking Show less .

To determine which widgets are hidden, specify uncollapsibleWidgetsCount .

integer

The number of uncollapsible widgets which remain visible even when a section is collapsed.

Например, если раздел содержит пять виджетов, а параметр uncollapsibleWidgetsCount установлен на 2 , то по умолчанию всегда отображаются первые два виджета, а последние три свернуты. Параметр uncollapsibleWidgetsCount учитывается только тогда, когда collapsible имеет true .

string

A unique ID assigned to the section that's used to identify the section to be mutated. The ID has a character limit of 64 characters and should be in the format of [a-zA-Z0-9-]+ .

Доступно для дополнений Google Workspace, расширяющих функциональность Google Workspace Studio. Недоступно для приложений Google Chat.

object ( CollapseControl )

Optional. Define the expand and collapse button of the section. This button will be shown only if the section is collapsible. If this field isn't set, the default button is used.

enum ( HorizontalAlignment )

Specifies whether widgets align to the left, right, or center of a column.

string

A unique ID assigned to the widget that's used to identify the widget to be mutated. The ID has a character limit of 64 characters and should be in the format of [a-zA-Z0-9-]+ .

Доступно для дополнений Google Workspace, расширяющих функциональность Google Workspace Studio. Недоступно для приложений Google Chat.

enum ( Visibility )

Specifies whether the widget is visible or hidden. The default value is VISIBLE .

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

object ( EventAction )

Specifies the event actions that can be performed on the widget.

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

object ( TextParagraph )

Отображает абзац текста. Поддерживает простой HTML-форматированный текст. Для получения дополнительной информации о форматировании текста см. разделы «Форматирование текста в приложениях Google Chat» и «Форматирование текста в надстройках Google Workspace».

Например, следующий JSON-код создает текст, выделенный жирным шрифтом:

"textParagraph": {
  "text": "  <b>bold text</b>"
}

object ( Image )

Отображает изображение.

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

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

object ( DecoratedText )

Отображает текстовый элемент с декоративным оформлением.

For example, the following JSON creates a decorated text widget showing email address:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

object ( ButtonList )

Список кнопок.

For example, the following JSON creates two buttons. The first is a blue text button and the second is an image button that opens a link:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

object ( TextInput )

Отображает текстовое поле, в которое пользователи могут вводить текст.

For example, the following JSON creates a text input for an email address:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

As another example, the following JSON creates a text input for a programming language with static suggestions:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

object ( SelectionInput )

Отображает элемент управления выбором, позволяющий пользователям выбирать элементы. В качестве элементов управления выбором могут использоваться флажки, переключатели, переключатели или выпадающие меню.

For example, the following JSON creates a dropdown menu that lets users choose a size:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

object ( DateTimePicker )

Отображает виджет, позволяющий пользователям вводить дату, время или дату и время.

For example, the following JSON creates a date time picker to schedule an appointment:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}

object ( Divider )

Отображает горизонтальную разделительную линию между виджетами.

Например, следующий JSON-код создает разделитель:

"divider": {
}

object ( Grid )

Отображает сетку с набором элементов.

Таблица поддерживает любое количество столбцов и элементов. Количество строк определяется как верхнее значение отношения количества элементов к количеству столбцов. Таблица с 10 элементами и 2 столбцами имеет 5 строк. Таблица с 11 элементами и 2 столбцами имеет 6 строк.

Available for Google Chat apps and Google Workspace add-ons.

Например, следующий JSON-код создает сетку из двух столбцов с одним элементом:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

object ( Columns )

Отображает до 2 столбцов.

Чтобы добавить более двух столбцов или использовать строки, воспользуйтесь виджетом Grid .

Например, следующий JSON-код создает 2 столбца, каждый из которых содержит текстовые абзацы:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

object ( Carousel )

Карусель содержит набор вложенных виджетов. Например, это JSON-представление карусели, содержащей два текстовых абзаца.

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}

object ( ChipList )

Список чипсов.

Например, следующий JSON-код создает два чипа. Первый — текстовый чип, а второй — чип-иконка, открывающий ссылку:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

string

Текст, отображаемый в виджете.

integer

Максимальное количество строк текста, отображаемых в виджете. Если текст превышает указанное максимальное количество строк, лишнее содержимое скрывается за кнопкой «Показать больше» . Если текст равен или короче указанного максимального количества строк, кнопка «Показать больше» не отображается.

The default value is 0, in which case all context is displayed. Negative values are ignored.

enum ( TextSyntax )

Синтаксис текста. Если не задано, текст отображается как HTML.

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

string

HTTPS-адрес, на котором размещено изображение.

Например:

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

object ( OnClick )

Когда пользователь щелкает по изображению, этот щелчок запускает данное действие.

string

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

object ( Action )

Если указано иное, действие запускается этим обработчиком onClick .

object ( OpenLink )

Если указано, то onClick запускает действие открытия ссылки.

object ( Action )

Дополнение запускает это действие, когда необходимо открыть ссылку. Это отличается от описанного выше метода openLink тем, что для получения ссылки необходимо связаться с сервером. Таким образом, веб-клиенту требуется выполнить некоторую подготовительную работу, прежде чем будет получен ответ от функции открытия ссылки.

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

object ( Card )

Если указано иное, после нажатия кнопки новая карточка добавляется в стопку карточек.

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

object ( OverflowMenu )

Если указано, то onClick открывает дополнительное меню.

string

Пользовательская функция, вызываемая при щелчке по содержащему элементу или при его иной активации.

Пример использования см. в разделе «Чтение данных формы» .

object ( ActionParameter )

Список параметров действия.

enum ( LoadIndicator )

Указывает индикатор загрузки, который отображается при вызове действия.

boolean

Указывает, сохраняются ли значения формы после выполнения действия. Значение по умолчанию — false .

Если true , значения формы сохраняются после запуска действия. Чтобы пользователь мог вносить изменения во время обработки действия, установите LoadIndicator в NONE . Для сообщений в виде карточек в чат-приложениях необходимо также установить ResponseType действия в значение UPDATE_MESSAGE и использовать тот же cardId что и карточка, содержащая действие.

Если false , значения формы очищаются при срабатывании действия. Чтобы предотвратить внесение пользователем изменений во время обработки действия, установите для LoadIndicator SPINNER .

enum ( Interaction )

Необязательно. Обязательно при открытии диалогового окна .

Что делать в ответ на взаимодействие с пользователем, например, когда пользователь нажимает кнопку в сообщении-карточке?

Если параметр не указан, приложение реагирует, выполняя action — например, открывая ссылку или запуская функцию — как обычно.

Указав параметр interaction , приложение может реагировать особыми интерактивными способами. Например, установив interaction на OPEN_DIALOG , приложение может открыть диалоговое окно . При указании этого параметра индикатор загрузки не отображается. Если параметр указан для дополнения, вся карточка удаляется, и на экране клиента ничего не отображается.

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

string

Optional. Fill this list with the names of widgets that this Action needs for a valid submission.

Если при вызове этого действия у перечисленных здесь виджетов отсутствует значение, отправка формы будет прервана.

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

boolean

Необязательно. Если это так, то все виджеты считаются обязательными для данного действия.

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

string

Название параметра для скрипта действия.

string

Значение параметра.

string

URL-адрес для открытия. HTTP-адреса преобразуются в HTTPS.

enum ( OpenAs )

Как открыть ссылку.

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

enum ( OnClose )

Забывает ли клиент о ссылке после её открытия или следит за ней до закрытия окна.

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

object ( OverflowMenuItem )

Обязательно. Список пунктов меню.

object ( Icon )

Значок, отображаемый перед текстом.

string

Required. The text that identifies or describes the item to users.

object ( OnClick )

Required. The action invoked when a menu option is selected. This OnClick cannot contain an OverflowMenu , any specified OverflowMenu is dropped and the menu item disabled.

boolean

Whether the menu option is disabled. Defaults to false.

string

Optional. A description of the icon used for accessibility. If unspecified, the default value Button is provided. As a best practice, you should set a helpful description for what the icon displays, and if applicable, what it does. For example, A user's account portrait , or Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat .

If the icon is set in a Button , the altText appears as helper text when the user hovers over the button. However, if the button also sets text , the icon's altText is ignored.

enum ( ImageType )

The crop style applied to the image. In some cases, applying a CIRCLE crop causes the image to be drawn larger than a built-in icon.

string

Display one of the built-in icons provided by Google Workspace.

For example, to display an airplane icon, specify AIRPLANE . For a bus, specify BUS .

For a full list of supported icons, see built-in icons .

string

Отобразить пользовательскую иконку, размещенную по адресу HTTPS.

Например:

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

Поддерживаются файлы следующих форматов: .png и .jpg .

object ( MaterialIcon )

Отобразите один из значков Google Material Icons .

Например, чтобы отобразить значок флажка , используйте

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

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

string

Имя значка, определенное в Google Material Icon , например, check_box . Любые недопустимые имена отбрасываются и заменяются пустой строкой, что приводит к невозможности отображения значка.

boolean

Whether the icon renders as filled. Default value is false.

To preview different icon settings, go to Google Font Icons and adjust the settings under Customize .

integer

The stroke weight of the icon. Choose from {100, 200, 300, 400, 500, 600, 700}. If absent, default value is 400. If any other value is specified, the default value is used.

To preview different icon settings, go to Google Font Icons and adjust the settings under Customize .

integer

Толщина и градиент влияют на размер символа. Корректировка градиента более точна, чем корректировка толщины, и оказывает незначительное влияние на размер символа. Выберите один из вариантов: {-25, 0, 200}. Если значение отсутствует, используется значение по умолчанию 0. Если указано другое значение, используется значение по умолчанию.

To preview different icon settings, go to Google Font Icons and adjust the settings under Customize .

object ( Icon )

Устарело, вместо него используется startIcon .

object ( Icon )

Значок, отображаемый перед текстом.

enum ( VerticalAlignment )

Optional. Vertical alignment of the start icon. If not set, the icon will be vertically centered.

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

string

The text that appears above text . Always truncates.

object ( TextParagraph )

TextParagraph equivalent of topLabel . Always truncates. Allows for more complex formatting than topLabel .

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

string

Обязательно. Основной текст.

Supports simple formatting. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace add-ons .

object ( TextParagraph )

TextParagraph эквивалент text . Позволяет использовать более сложное форматирование, чем text .

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

boolean

Параметр переноса текста. Если true , текст переносится и отображается в несколько строк. В противном случае текст обрезается.

Only applies to text , not topLabel and bottomLabel .

string

Текст, отображаемый ниже text , всегда переносится на следующий текст.

object ( TextParagraph )

TextParagraph equivalent of bottomLabel . Always wraps. Allows for more complex formatting than bottomLabel .

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

object ( OnClick )

This action is triggered when users click topLabel or bottomLabel .

object ( Button )

A button that a user can click to trigger an action.

object ( SwitchControl )

A switch widget that a user can click to change its state and trigger an action.

object ( Icon )

Значок, отображаемый после текста.

Поддерживает встроенные и пользовательские значки.

string

Текст, отображаемый внутри кнопки.

object ( Icon )

An icon displayed inside the button. If both icon and text are set, then the icon appears before the text.

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,
}

The alpha field is unavailable for button color. If specified, this field is ignored.

object ( OnClick )

Required. The action to perform when a user clicks the button, such as opening a hyperlink or running a custom function.

boolean

If true , the button is displayed in an inactive state and doesn't respond to user actions.

string

The alternative text that's used for accessibility.

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

enum ( Type )

Optional. The type of a button. If unset, button type defaults to OUTLINED . If the color field is set, the button type is forced to FILLED and any value set for this field is ignored.

number

Количество красного цвета в заданном диапазоне значений находится в интервале [0, 1].

number

Количество зеленого цвета в заданном диапазоне значений находится в интервале [0, 1].

number

Количество синего цвета в заданном цвете выражается значением в интервале [0, 1].

number

Доля этого цвета, которая должна быть применена к пикселю. То есть, окончательный цвет пикселя определяется уравнением:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Это означает, что значение 1,0 соответствует сплошному цвету, а значение 0,0 — полностью прозрачному цвету. Используется оберточное сообщение, а не простое скалярное значение с плавающей запятой, что позволяет различать значение по умолчанию и значение, которое не задано. Если этот параметр опущен, объект цвета отображается как сплошной цвет (как если бы значению альфа-канала было явно присвоено значение 1,0).

string

The name by which the switch widget is identified in a form input event.

For details about working with form inputs, see Receive form data .

string

The value entered by a user, returned as part of a form input event.

For details about working with form inputs, see Receive form data .

boolean

Если true , переключатель выбран.

object ( Action )

The action to perform when the switch state is changed, such as what function to run.

enum ( ControlType )

Как переключатель отображается в пользовательском интерфейсе.

Available for Google Chat apps and Google Workspace add-ons.

object ( Button )

Набор кнопок.

string

Имя, по которому текстовое поле идентифицируется в событии ввода формы.

Подробную информацию о работе с полями ввода формы см. в разделе «Получение данных формы» .

string

The text that appears above the text input field in the user interface.

Укажите текст, который поможет пользователю ввести необходимую вашему приложению информацию. Например, если вы спрашиваете имя, но вам нужна именно фамилия, напишите surname вместо name .

Обязательно, если hintText не указан. В противном случае — необязательно.

string

Текст, отображаемый под полем ввода текста, призван помочь пользователям, предлагая им ввести определенное значение. Этот текст всегда виден.

Обязательно, если label не указана. В противном случае — необязательно.

string

Значение, введенное пользователем, возвращается в рамках события ввода данных в форму.

Подробную информацию о работе с полями ввода формы см. в разделе «Получение данных формы» .

enum ( Type )

Как текстовое поле ввода отображается в пользовательском интерфейсе. Например, является ли поле однострочным или многострочным.

object ( Action )

Что делать, если в текстовом поле произошли изменения? Например, пользователь добавил текст в поле или удалил его.

В качестве примеров действий можно привести запуск пользовательской функции или открытие диалога в Google Chat.

object ( Suggestions )

Предлагаемые значения, которые могут ввести пользователи. Эти значения появляются при щелчке мышью внутри текстового поля ввода. По мере ввода пользователем предлагаемые значения динамически фильтруются, чтобы соответствовать введенному тексту.

Например, текстовое поле ввода для языка программирования может предлагать Java, JavaScript, Python и C++. Когда пользователь начинает вводить Jav , список подсказок фильтруется, отображая только Java и JavaScript .

Предлагаемые значения помогают пользователям вводить данные, которые ваше приложение сможет распознать. Применительно к JavaScript, одни пользователи могут ввести javascript , а другие java script . Предложение значений JavaScript может стандартизировать взаимодействие пользователей с вашим приложением.

Если указано значение, TextInput.type всегда будет SINGLE_LINE , даже если оно установлено на MULTIPLE_LINE .

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

object ( Action )

Необязательно. Укажите, какое действие следует предпринять, когда текстовое поле ввода предлагает варианты действий пользователям, взаимодействующим с ним.

Если параметр не указан, предложения формируются параметром initialSuggestions и обрабатываются клиентом.

Если указано иное, приложение выполнит указанное здесь действие, например, запустит пользовательскую функцию.

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

object ( Validation )

Укажите необходимые параметры проверки формата ввода для этого текстового поля.

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

string

Текст, который отображается в поле ввода текста, когда поле пустое. Используйте этот текст, чтобы предложить пользователям ввести значение. Например: « Enter a number from 0 to 100 .

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

object ( HostAppDataSourceMarkup )

Уникальный для каждого приложения Google Workspace источник данных, например, электронные письма Gmail, события Google Calendar или сообщения Google Chat.

Доступно для дополнений Google Workspace, расширяющих функциональность Google Workspace Studio. Недоступно для приложений Google Chat.

Action

Navigation

Выполняет операцию добавления, извлечения или обновления карты.

Дополнения в Google Чат .

Card

Добавляет карту в стопку карт.

Для диалогов в Google Chat : открывает или обновляет диалог.

Card

Обновляет верхнюю карточку новой карточкой, сохраняя значения заполненных полей формы. Для неэквивалентного поля значение удаляется.

Для диалогов в Google Chat : открывает или обновляет диалог.

object ( SuggestionItem )

Список подсказок, используемых для автозаполнения в текстовых полях ввода.

string

The value of a suggested input to a text input field. This is equivalent to what users enter themselves.

integer

Specify the character limit for text input widgets. Note that this is only used for text input and is ignored for other widgets.

Available for Google Chat apps and Google Workspace add-ons.

enum ( InputType )

Specify the type of the input widgets.

Available for Google Chat apps and Google Workspace add-ons.

object ( ChatClientDataSourceMarkup )

Источник данных из Google Chat.

object ( WorkflowDataSourceMarkup )

Источник данных из Google Workflow.

object ( SpaceDataSource )

Чат-пространства Google, участником которых является пользователь.

boolean

Если установлено значение true , то в меню с множественным выбором по умолчанию выбирается текущее пространство чата Google в качестве элемента.

boolean

Следует ли включать переменные из предыдущего шага в источник данных.

enum ( Type )

Тип источника данных.

string

Required. The name that identifies the selection input in a form input event.

For details about working with form inputs, see Receive form data .

string

The text that appears above the selection input field in the user interface.

Specify text that helps the user enter the information your app needs. For example, if users are selecting the urgency of a work ticket from a drop-down menu, the label might be "Urgency" or "Select urgency".

enum ( SelectionType )

The type of items that are displayed to users in a SelectionInput widget. Selection types support different types of interactions. For example, users can select one or more checkboxes, but they can only select one value from a dropdown menu.

object ( SelectionItem )

An array of selectable items. For example, an array of radio buttons or checkboxes. Supports up to 100 items.

object ( Action )

If specified, the form is submitted when the selection changes. If not specified, you must specify a separate button that submits the form.

For details about working with form inputs, see Receive form data .

integer

For multiselect menus, the number of text characters that a user inputs before the menu returns suggested selection items.

If unset, the multiselect menu uses the following default values:

• If the menu uses a static array of SelectionInput items, defaults to 0 characters and immediately populates items from the array.
• If the menu uses a dynamic data source ( multi_select_data_source ), defaults to 3 characters before querying the data source to return suggested items.

object ( DataSourceConfig )

Optional. The data source configs for the selection control. This field provides more fine-grained control over the data source.

If specified, the multiSelectMaxSelectedItems field, multiSelectMinQueryLength field, externalDataSource field and platformDataSource field are ignored.

Available for Google Workspace add-ons that extend Google Workspace Studio.

Available for the Dropdown widget in Google Chat apps. For the Dropdown widget in Google Chat apps, only one DataSourceConfig is supported. If multiple DataSourceConfig s are set, only the first one is used.

integer

For multiselect menus, the maximum number of items that a user can select. Minimum value is 1 item. If unspecified, defaults to 3 items.

string

Optional. Text that appears below the selection input field meant to assist users by prompting them to enter a certain value. This text is always visible.

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

object ( Action )

An external data source, such as a relational database.

object ( PlatformDataSource )

A data source from Google Workspace.

string

The text that identifies or describes the item to users.

string

The value associated with this item. The client should use this as a form input value.

For details about working with form inputs, see Receive form data .

boolean

Whether the item is selected by default. If the selection input only accepts one value (such as for radio buttons or a dropdown menu), only set this field for one item.

string

For multiselect menus, a text description or label that's displayed below the item's text field.

string

enum ( CommonDataSource )

A data source shared by all Google Workspace applications, such as users in a Google Workspace organization.

object ( HostAppDataSourceMarkup )

A data source that's unique to a Google Workspace host application, such spaces in Google Chat.

This field supports the Google API Client Libraries but isn't available in the Cloud Client Libraries. To learn more, see Install the client libraries .

object ( Action )

The data is from a remote data provider.

object ( PlatformDataSource )

The data is from a Google Workspace application.

integer

The minimum number of characters the user must enter before this data provider is triggered (ie, before it starts returning results).

string

The name by which the DateTimePicker is identified in a form input event.

For details about working with form inputs, see Receive form data .

string

The text that prompts users to input a date, a time, or a date and time. For example, if users are scheduling an appointment, use a label such as Appointment date or Appointment date and time .

enum ( DateTimePickerType )

Whether the widget supports inputting a date, a time, or the date and time.

string ( int64 format)

The default value displayed in the widget, in milliseconds since Unix epoch time .

Specify the value based on the type of picker ( DateTimePickerType ):

• DATE_AND_TIME : a calendar date and time in UTC. For example, to represent January 1, 2023 at 12:00 PM UTC, use 1672574400000 .
• DATE_ONLY : a calendar date at 00:00:00 UTC. For example, to represent January 1, 2023, use 1672531200000 .
• TIME_ONLY : a time in UTC. For example, to represent 12:00 PM, use 43200000 (or 12 * 60 * 60 * 1000 ).

integer

The number representing the time zone offset from UTC, in minutes. If set, the valueMsEpoch is displayed in the specified time zone. If unset, the value defaults to the user's time zone setting.

object ( Action )

Triggered when the user clicks Save or Clear from the DateTimePicker interface.

object ( HostAppDataSourceMarkup )

A data source that's unique to a Google Workspace host application, such as Gmail emails, Google Calendar events, or Google Chat messages.

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

string

The text that displays in the grid header.

object ( GridItem )

The items to display in the grid.

object ( BorderStyle )

The border style to apply to each grid item.

integer

The number of columns to display in the grid. A default value is used if this field isn't specified, and that default value is different depending on where the grid is shown (dialog versus companion).

object ( OnClick )

This callback is reused by each individual grid item, but with the item's identifier and index in the items list added to the callback's parameters.

string

A user-specified identifier for this grid item. This identifier is returned in the parent grid's onClick callback parameters.

object ( ImageComponent )

The image that displays in the grid item.

string

The grid item's title.

string

The grid item's subtitle.

enum ( GridItemLayout )

The layout to use for the grid item.

string

The image URL.

string

The accessibility label for the image.

object ( ImageCropStyle )

The crop style to apply to the image.

object ( BorderStyle )

The border style to apply to the image.

enum ( ImageCropType )

The crop type.

number

The aspect ratio to use if the crop type is RECTANGLE_CUSTOM .

For example, here's how to apply a 16:9 aspect ratio:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

enum ( BorderType )

The border type.

object ( Color )

The colors to use when the type is BORDER_TYPE_STROKE .

To set the stroke color, specify a value for the red , green , and blue fields. The value must be a float number between 0 and 1 based on the RGB color value, where 0 (0/255) represents the absence of color and 1 (255/255) represents the maximum intensity of the color.

For example, the following sets the color to red at its maximum intensity:

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

The alpha field is unavailable for stroke color. If specified, this field is ignored.

integer

The corner radius for the border.

object ( Column )

An array of columns. You can include up to 2 columns in a card or dialog.

enum ( HorizontalSizeStyle )

Specifies how a column fills the width of the card.

enum ( HorizontalAlignment )

Specifies whether widgets align to the left, right, or center of a column.

enum ( VerticalAlignment )

Specifies whether widgets align to the top, bottom, or center of a column.

object ( Widgets )

An array of widgets included in a column. Widgets appear in the order that they are specified.

object ( TextParagraph )

TextParagraph widget.

object ( Image )

Image widget.

object ( DecoratedText )

DecoratedText widget.

object ( ButtonList )

ButtonList widget.

object ( TextInput )

TextInput widget.

object ( SelectionInput )

SelectionInput widget.

object ( DateTimePicker )

DateTimePicker widget.

object ( ChipList )

ChipList widget.

enum ( Layout )

Specified chip list layout.

object ( Chip )

An array of chips.

object ( Icon )

The icon image. If both icon and text are set, then the icon appears before the text.

string

The text displayed inside the chip.

object ( OnClick )

Optional. The action to perform when a user clicks the chip, such as opening a hyperlink or running a custom function.

boolean

Whether the chip is in an active state and responds to user actions. Defaults to true . Deprecated. Use disabled instead.

boolean

Whether the chip is in an inactive state and ignores user actions. Defaults to false .

string

The alternative text that's used for accessibility.

Set descriptive text that lets users know what the chip does. For example, if a chip opens a hyperlink, write: "Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat" .

object ( CarouselCard )

A list of cards included in the carousel.

object ( NestedWidget )

A list of widgets displayed in the carousel card. The widgets are displayed in the order that they are specified.

object ( NestedWidget )

A list of widgets displayed at the bottom of the carousel card. The widgets are displayed in the order that they are specified.

object ( TextParagraph )

A text paragraph widget.

object ( ButtonList )

A button list widget.

object ( Image )

An image widget.

string

The unique identifier of the ActionRule.

object ( Trigger )

The list of triggers that will be triggered after the EventAction is executed.

object ( CommonWidgetAction )

Common widget action.

string

The unique identifier of the ActionRule.

object ( UpdateVisibilityAction )

The action to update the visibility of a widget.

enum ( Visibility )

The new visibility.

enum ( HorizontalAlignment )

The horizontal alignment of the expand and collapse button.

object ( Button )

Optional. Define a customizable button to expand the section. Both expandButton and collapseButton field must be set. Only one field set will not take into effect. If this field isn't set, the default button is used.

object ( Button )

Optional. Define a customizable button to collapse the section. Both expandButton and collapseButton field must be set. Only one field set will not take into effect. If this field isn't set, the default button is used.

string

The label that displays as the action menu item.

object ( OnClick )

The onClick action for this action item.

object ( Button )

The primary button of the fixed footer. The button must be a text button with text and color set.

object ( Button )

The secondary button of the fixed footer. The button must be a text button with text and color set. If secondaryButton is set, you must also set primaryButton .

string

The unique identifier of the ExpressionData.

string

The uncompiled expression.

object ( Condition )

The list of conditions that are determined by the expression evaluation result.

object ( EventAction )

The list of actions that the ExpressionData can be used.

string

The unique identifier of the ActionRule.

object ( ExpressionDataCondition )

The condition that is determined by the expression data.

enum ( ConditionType )

The type of the condition.