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

setParameters

List of action parameters.

Parameter
Name
Description
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
Create a Mobile Website
View Site in Mobile | Classic
Share by: