Class UpdatedWidget

  • UpdatedWidget provides autocomplete options for multiselect menus in SelectionInput, specifically for Google Chat apps.

  • It allows adding items with customizable text, value, selection state, icon, and bottom text using the addItem method.

  • This functionality is exclusive to Google Chat apps and is not available for Google Workspace Add-ons.

UpdatedWidget

The response of the updated widget. Used to provide autocomplete options for multiselect menu in SelectionInput.

const updatedWidget = CardService.newUpdatedWidget()
                          .addItem(
                              'item_one_title',
                              'item_one_value',
                              false,
                              'item_one_uri',
                              'item_one_bottom_text',
                              )
                          .addItem(
                              'item_two_title',
                              'item_two_value',
                              false,
                              'item_two_uri',
                              'item_two_bottom_text',
                          );

Only available for Google Chat apps. Not available for Google Workspace add-ons.

Methods

MethodReturn typeBrief description
addItem(text, value, selected, startIconUri, bottomText)UpdatedWidgetAdds a new item that can be selected.

Detailed documentation

addItem(text, value, selected, startIconUri, bottomText)

Adds a new item that can be selected.

const updatedWidget = CardService.newUpdatedWidget()
                          .addItem(
                              'item_one_title',
                              'item_one_value',
                              false,
                              'item_one_uri',
                              'item_one_bottom_text',
                              )
                          .addItem(
                              'item_two_title',
                              'item_two_value',
                              false,
                              'item_two_uri',
                              'item_two_bottom_text',
                          );
Only available for Google Chat apps. Not available for Google Workspace add-ons.

Parameters

NameTypeDescription
textObjectThe text to be shown for this item. Non-string primitive arguments are converted to strings automatically.
valueObjectThe form input value that is sent via the callback. Non-string primitive arguments are converted to strings automatically.
selectedBooleanWhether 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.
startIconUriObjectFor multiselect menus, the URL for the icon displayed next to the item's text field. Supports PNG and JPEG files.
bottomTextObjectFor multiselect menus, a text description or label that's displayed below the item's text field.

Return

UpdatedWidget — This object, for chaining.