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 \ V1Methods
__construct
Constructor.
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
↳ 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 .
string
setFunction
A custom function to invoke when the containing element is clicked or othrwise activated.
For example usage, see Read form data .
var
string
$this
getParameters
List of action parameters.
setParameters
List of action parameters.
$this
getLoadIndicator
Specifies the loading indicator that the action displays while making the call to the action.
int
setLoadIndicator
Specifies the loading indicator that the action displays while making the call to the action.
var
int
$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
.
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
.
var
bool
$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
:
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
:
var
int
$this