Google Apps Chat V1 Client - Class Action (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 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