Google Apps Chat V1 Client - Class Action (0.3.0)

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

An action that describes the behavior when the form is submitted.

For example, you can invoke an Apps Script script to handle the form. If the action is triggered, the form values are sent to the server. Google Workspace Add-ons and Chat apps:

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

Namespace

Google \ Apps \ Card \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ function string

A custom function to invoke when the containing element is clicked or othrwise activated. For example usage, see Read form data.

↳ parameters array<Google\Apps\Card\V1\Action\ActionParameter>

List of action parameters.

↳ load_indicator int

Specifies the loading indicator that the action displays while making the call to the action.

↳ persist_values bool

Indicates whether form values persist after the action. The default value is false. If true, form values remain after the action is triggered. To let the user make changes while the action is being processed, set LoadIndicator to NONE. For card messages in Chat apps, you must also set the action's ResponseType to UPDATE_MESSAGE and use the same card_id from the card that contained the action. If false, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set LoadIndicator to SPINNER.

↳ interaction int

Optional. Required when opening a dialog. What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an action—like opening a link or running a function—as normal. By specifying an interaction, the app can respond in special interactive ways. For example, by setting interaction to OPEN_DIALOG, the app can open a dialog. When specified, a loading indicator isn't shown. If specified for an add-on, the entire card is stripped and nothing is shown in the client. Google Chat apps:

getFunction

A custom function to invoke when the containing element is clicked or othrwise activated.

For example usage, see Read form data.

Returns
Type Description
string

setFunction

A custom function to invoke when the containing element is clicked or othrwise activated.

For example usage, see Read form data.

Parameter
Name Description
var string
Returns
Type Description
$this

getParameters

List of action parameters.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setParameters

List of action parameters.

Parameter
Name Description
var array<Google\Apps\Card\V1\Action\ActionParameter>
Returns
Type Description
$this

getLoadIndicator

Specifies the loading indicator that the action displays while making the call to the action.

Returns
Type Description
int

setLoadIndicator

Specifies the loading indicator that the action displays while making the call to the action.

Parameter
Name Description
var int
Returns
Type Description
$this

getPersistValues

Indicates whether form values persist after the action. The default value is false.

If true, form values remain after the action is triggered. To let the user make changes while the action is being processed, set LoadIndicator to NONE. For card messages in Chat apps, you must also set the action's ResponseType to UPDATE_MESSAGE and use the same card_id from the card that contained the action. If false, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set LoadIndicator to SPINNER.

Returns
Type Description
bool

setPersistValues

Indicates whether form values persist after the action. The default value is false.

If true, form values remain after the action is triggered. To let the user make changes while the action is being processed, set LoadIndicator to NONE. For card messages in Chat apps, you must also set the action's ResponseType to UPDATE_MESSAGE and use the same card_id from the card that contained the action. If false, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set LoadIndicator to SPINNER.

Parameter
Name Description
var bool
Returns
Type Description
$this

getInteraction

Optional. Required when opening a dialog.

What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an action—like opening a link or running a function—as normal. By specifying an interaction, the app can respond in special interactive ways. For example, by setting interaction to OPEN_DIALOG, the app can open a dialog. When specified, a loading indicator isn't shown. If specified for an add-on, the entire card is stripped and nothing is shown in the client. Google Chat apps:

Returns
Type Description
int

setInteraction

Optional. Required when opening a dialog.

What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an action—like opening a link or running a function—as normal. By specifying an interaction, the app can respond in special interactive ways. For example, by setting interaction to OPEN_DIALOG, the app can open a dialog. When specified, a loading indicator isn't shown. If specified for an add-on, the entire card is stripped and nothing is shown in the client. Google Chat apps:

Parameter
Name Description
var int
Returns
Type Description
$this