Google Apps Chat V1 Client - Class SelectionInput (0.1.3)

Version latest

• 0.1.3 (latest)
• 0.1.2

Reference documentation and code samples for the Google Apps Chat V1 Client class SelectionInput.

A widget that creates one or more UI items that users can select.

For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see Add selectable UI elements. Chat apps can process the value of items that users select or input. For details about working with form inputs, see Receive form data. To collect undefined or abstract data from users, use the TextInput widget. Google Workspace Add-ons and Chat apps:

Generated from protobuf message google.apps.card.v1.SelectionInput

Namespace

Google \ Apps \ Card \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ name	string The name that identifies the selection input in a form input event. For details about working with form inputs, see Receive form data.
↳ label	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".
↳ type	int 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.
↳ items	array<Google\Apps\Card\V1\SelectionInput\SelectionItem> An array of selectable items. For example, an array of radio buttons or checkboxes. Supports up to 100 items.
↳ on_change_action	Google\Apps\Card\V1\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.
↳ multi_select_max_selected_items	int For multiselect menus, the maximum number of items that a user can select. Minimum value is 1 item. If unspecified, defaults to 3 items.
↳ multi_select_min_query_length	int For multiselect menus, the number of text characters that a user inputs before the app queries autocomplete and displays suggested items in the menu. If unspecified, defaults to 0 characters for static data sources and 3 characters for external data sources.
↳ external_data_source	Google\Apps\Card\V1\Action An external data source, such as a relational data base.
↳ platform_data_source	Google\Apps\Card\V1\SelectionInput\PlatformDataSource A data source from Google Workspace.

getName

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

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

Returns
Type	Description
string

setName

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

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

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getLabel

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".

Returns
Type	Description
string

setLabel

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".

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getType

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.

Returns
Type	Description
int

setType

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.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getItems

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

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setItems

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

Parameter
Name	Description
var	array<Google\Apps\Card\V1\SelectionInput\SelectionItem>

Returns
Type	Description
$this

getOnChangeAction

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.

Returns
Type	Description
Google\Apps\Card\V1\Action|null

hasOnChangeAction

clearOnChangeAction

setOnChangeAction

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.

Parameter
Name	Description
var	Google\Apps\Card\V1\Action

Returns
Type	Description
$this

getMultiSelectMaxSelectedItems

For multiselect menus, the maximum number of items that a user can select.

Minimum value is 1 item. If unspecified, defaults to 3 items.

Returns
Type	Description
int

setMultiSelectMaxSelectedItems

For multiselect menus, the maximum number of items that a user can select.

Minimum value is 1 item. If unspecified, defaults to 3 items.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getMultiSelectMinQueryLength

For multiselect menus, the number of text characters that a user inputs before the app queries autocomplete and displays suggested items in the menu.

If unspecified, defaults to 0 characters for static data sources and 3 characters for external data sources.

Returns
Type	Description
int

setMultiSelectMinQueryLength

For multiselect menus, the number of text characters that a user inputs before the app queries autocomplete and displays suggested items in the menu.

If unspecified, defaults to 0 characters for static data sources and 3 characters for external data sources.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getExternalDataSource

An external data source, such as a relational data base.

Returns
Type	Description
Google\Apps\Card\V1\Action|null

hasExternalDataSource

setExternalDataSource

An external data source, such as a relational data base.

Parameter
Name	Description
var	Google\Apps\Card\V1\Action

Returns
Type	Description
$this

getPlatformDataSource

A data source from Google Workspace.

Returns
Type	Description
Google\Apps\Card\V1\SelectionInput\PlatformDataSource|null

hasPlatformDataSource

setPlatformDataSource

A data source from Google Workspace.

Parameter
Name	Description
var	Google\Apps\Card\V1\SelectionInput\PlatformDataSource

Returns
Type	Description
$this

getMultiSelectDataSource

Returns
Type	Description
string