AI-generated Key Takeaways
-
The Card Service enables building card-based user interfaces for Google Workspace add-ons and Google Chat apps across desktop and mobile platforms.
-
Numerous classes are provided for interactive elements, layout, input and display widgets, response handling, data sources, and styling.
-
The service includes builders to construct complex UI components and enumerations for various property options.
-
Methods are available to configure properties, behaviors, and responses for UI elements.
-
Specific classes and methods are detailed for creating and managing different parts of the user interface, such as sections, cards, carousels, and responses.
This service allows scripts to configure and build card and widget components and behaviors for a UI. The UI structures you build with this service are automatically available in both desktop and mobile devices, so you don't need to develop separate UIs for both.
Classes
| Name | Brief description |
|---|---|
Action
|
An action that enables interactivity within UI elements. |
Action
|
The response object that may be returned from a callback function (e.g., a form response handler) to perform one or more actions on the client. |
Action
|
A builder for Action
objects. |
Action
|
A class that represents the status for a request to either invoke or submit a dialog. |
Attachment
|
Represents an attachment created by an add-on. |
Authorization
|
An authorization action that will send the user to the AuthorizationUrl when clicked. |
Authorization
|
An error that can be returned to trigger an authorization card to be shown to the user. |
Border
|
A class that represents a complete border style that can be applied to widgets. |
Border
|
An enum that represents the border types that can be applied to widgets. |
Button
|
A base class for all buttons. |
Button
|
Holds a set of Button
objects that are displayed in a row. |
Calendar
|
Represents a response that makes changes to the calendar event that the user is currently editing in reaction to an action taken in the UI, such as a button click. |
Calendar
|
A builder for Calendar
objects. |
Card
|
A context card that represents a single view in the UI. |
Card
|
A clickable menu item that is added to the card header menu. |
Card
|
A builder for Card
objects. |
Card
|
The header of a Card
. |
Card
|
A card section holds groups of widgets and provides visual separation between them. |
Card
|
Card |
Card
|
A builder for Card
objects. |
Carousel
|
Carousel, also known as slider, rotates and displays a list of widgets in a slideshow format, with buttons navigating to the previous or next widget. |
Carousel
|
A card that can be displayed as a carousel item. |
Chat
|
A class that represents the parameters that a Chat app can use to configure how its response is posted. |
Chat
|
For a Selection
widget that uses a multiselect menu, a data source from Google Chat. |
Chat
|
The response object for a card message in Google Chat. |
Chat
|
A builder for Chat
objects. |
Chat
|
A data source that populates Google Chat spaces as selection items for a multiselect menu. |
Chip
|
A Chip
with an icon and text label. |
Chip
|
Holds a set of Chip
objects that are displayed in a row, wrapping to the next line to
horizontal scrollable. |
Chip
|
An enum that specifies the layout for Chip
. |
Collapse
|
A customizable collapse and expand control. |
Column
|
A column. |
Columns
|
The Columns
widget displays up to 2 columns in a card or dialog. |
Common
|
A data source shared by all Google Workspace applications. |
Common
|
Defines actions that don't involve evaluations, such as updating widget visibility. |
Compose
|
The response object that may be returned from a callback method for compose action in a Gmail add-on . |
Compose
|
A builder for Compose
objects. |
Composed
|
An enum value that specifies whether the composed email is a standalone or reply draft. |
Condition
|
A condition used to run an event action as part of CEL expression validation . |
Content
|
An enum value that specifies the content type of the content generated by a Update
. |
Date
|
An input field that allows inputing a date. |
Date
|
An input field that allows users to input a date and time. |
Decorated
|
A widget that displays text with optional decorations. |
Dialog
|
For details, see Open interactive dialogs in the Google Chat documentation. |
Dialog
|
A builder for Dialog
objects. |
Display
|
An enum that defines the display style of card. |
Divider
|
A horizontal divider. |
Drive
|
Represents a response that makes changes to Drive while Drive items are selected and in reaction to an action taken in the UI, such as a button click. |
Drive
|
A builder for Drive
objects. |
Editor
|
Makes changes to an Editor, such as Google Docs, Sheets, or Slides in reaction to an action taken in the UI. |
Editor
|
A builder for Editor
objects. |
Event
|
An EventAction to run when a CEL expression validation condition is met. |
Expression
|
The expression data that is used to evaluate an expression |
Expression
|
Actions for CEL expression validation . |
Expression
|
An enum that represents the type of the expression data action . |
Expression
|
Represents a CEL expression validation result. |
Expression
|
Represents whether the CEL expression evaluated successfully. |
Fixed
|
The fixed footer shown at the bottom of a Card
. |
Grid
|
An organized grid to display a collection of grid items. |
Grid
|
The items users interact with within a grid widget. |
Grid
|
An enum that defines the image and text style of a GridItem. |
Horizontal
|
An enum that specifies the horizontal alignment of a widget. |
Horizontal
|
An enum that sets how widgets fill the space of a column. |
Host
|
For a Selection
widget that uses a multiselect menu, a data source from a Google
Workspace application. |
Icon
|
Predefined icons that can be used in various UI objects, such as Image
or Decorated
widgets. |
Icon
|
A predefined icon, a material design icon, or an icon from a URL with a customizable crop style. |
Image
|
A widget that shows a single image. |
Image
|
A Image
with an image displayed on it. |
Image
|
An enum that specifies the style for Image
. |
Image
|
An image component that can be added to grid items. |
Image
|
A class that represents a crop style that can be applied to image components. |
Image
|
An enum that represents the crop styles applied to image components. |
Image
|
An enum that defines an image cropping style. |
Input
|
An enum that defines the input type of the widget. |
Interaction
|
An enum type that specifies what to do in response to an interaction with a user, such as a user clicking a button in a card message. |
|
This class is deprecated. |
Link
|
Card action that displays a link preview card and smart chip in the host app. |
Load
|
An enum type that specifies the type of loading or progress indicator to display while an Action
is being processed. |
Material
|
An object that supports all Google Font Icons . |
Navigation
|
A helper object that controls card navigation. |
Notification
|
A notification shown to the user as a response to interacting with a UI element. |
On
|
An enum that specifies what to do when a URL opened through an Open
is closed. |
Open
|
An enum that specifies how to open a URL. |
Open
|
Represents an action to open a link with some options. |
Overflow
|
Holds a list of Overflow
objects that are displayed in a pop-up menu. |
Overflow
|
An Overflow
with an icon and text label. |
Platform
|
For a Selection
widget that uses a multiselect menu, a data source from Google
Workspace. |
Response
|
An enum that represents the type of Chat app response. |
Selection
|
An input field that allows choosing between a set of predefined options. |
Selection
|
The format of the items that users can select. |
Status
|
An enum that represents the status code. |
Suggestions
|
Autocomplete suggestions to supplement a Text
widget. |
Suggestions
|
A response object that can be returned from a suggestions callback function. |
Suggestions
|
A builder for Suggestions
objects. |
Switch
|
A UI element that supports being toggled on or off. |
Switch
|
Type of a Switch
widget control. |
Text
|
A Text
with a text label. |
Text
|
An enum that specifies the style for Text
. |
Text
|
A input field widget that accepts text input. |
Text
|
A widget that displays text and supports basic HTML formatting . |
Time
|
An input field that allows users to input a time. |
Trigger
|
A trigger that runs CEL expression validation widget event actions according to the action rule ID. |
Universal
|
The response object that may be returned from a method that creates universal action. |
Universal
|
A builder for the Universal
objects. |
Update
|
Represents an action that updates the email draft that the user is currently editing. |
Update
|
A builder for Update
objects. |
Update
|
Updates the Bcc recipients of an email draft. |
Update
|
Updates the email draft body. |
Update
|
An enum value that specifies the type of an Update
. |
Update
|
Updates the Cc recipients of an email draft. |
Update
|
Updates the subject line of an email draft. |
Update
|
Updates the To recipients of an email draft. |
Update
|
Updates the visibility of a card widget to make it display or to hide it. |
Updated
|
The response of the updated widget. |
Validation
|
An object that defines the validation rule for the widget that it is attached to. |
Variable
|
An enum that represents the size of the variable picker button. |
Vertical
|
An enum that sets the vertical alignment of widgets in a column. |
Visibility
|
An enum that represents the visibility state of the widgets. |
Widget
|
Base class for all widgets that can be added to a Card
. |
Workflow
|
For a Selection
, Date
` or Text
widget, a data source
from a Google Workspace flow. |
Workflow
|
An enum that represents the type of the workflow data source. |
Wrap
|
An enum that sets the wrapping style for content within a column. |
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Action
|
Adds the names of the widgets that this Action needs for a valid submission. | |
Action
|
Indicates whether this Action requires inputs from all widgets. | |
Action
|
Sets the name of the callback function to be called. | |
Action
|
Sets the interaction with a user, only required when opening a dialog. | |
Action
|
Sets the loading indicator that displays while the action is in progress. | |
Action
|
Allows custom parameters to be passed to the callback function. | |
Action
|
Indicates whether form values are determined by the client's values or the server's values
after an action response updates the form's Card
. |
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Action
|
Builds the current action response and validates it. | |
Action
|
Sets the response to a Navigation
action. |
|
Action
|
Sets the notification to display when the action is activated. | |
Action
|
Sets the URL to navigate to when the action is activated. | |
Action
|
Sets a flag to indicate that this action changed the existing data state. |
Action
Status
Methods
| Method | Return type | Brief description |
|---|---|---|
Action
|
Represents the status for a request to either open or submit a dialog. | |
Action
|
The message to send users about the status of their request. |
Attachment
Methods
| Method | Return type | Brief description |
|---|---|---|
Attachment
|
Sets the icon URL for the attachment. | |
Attachment
|
Sets the MIME type for the attachment. | |
Attachment
|
Sets the resource URL for the attachment. | |
Attachment
|
Sets the title for the attachment. |
Authorization
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Authorization
|
Sets the authorization URL that user is taken to from the authorization prompt. |
Authorization
Exception
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. | |
Authorization
|
Sets the authorization URL that user is taken to from the authorization prompt. | |
Authorization
|
The name of a function to call to generate a custom authorization prompt. | |
Authorization
|
Sets the name that is displayed to the user when asking for authorization. | |
void
|
Triggers this exception to be thrown. |
Border
Style
Methods
| Method | Return type | Brief description |
|---|---|---|
Border
|
Sets the corner radius of the border, for example 8. | |
Border
|
Sets the color of the border. | |
Border
|
Sets the type of the border. |
Border
Type
Properties
| Property | Type | Description |
|---|---|---|
NO_BORDER
|
Enum
|
No border style. |
STROKE
|
Enum
|
Stroke border style. |
Button
Methods
| Method | Return type | Brief description |
|---|---|---|
Button
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Button
|
Sets an action that composes a draft email when the object is clicked. | |
Button
|
Sets an action that executes when the object is clicked. | |
Button
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Button
|
Sets a URL to be opened when the object is clicked. | |
Button
|
Sets a pop-up menu to be opened when the object is clicked. |
Button
Set
Methods
| Method | Return type | Brief description |
|---|---|---|
Button
|
Adds a button. |
Calendar
Event
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Calendar
Event
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Calendar
|
Specifies that the response should add the attachments to the Calendar event when the associated UI action is taken. | |
Calendar
|
Specifies that the response should add the indicated attendees to the Calendar event when the associated UI action is taken. | |
Calendar
|
Builds the current Calendar event action response and validates it. | |
Calendar
|
Specifies that the response should set the indicated conference data to the Calendar event when the associated UI action is taken. |
Card
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Card
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Card
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Card
|
Sets an action that composes a draft email when the object is clicked. | |
Card
|
Sets an action that executes when the object is clicked. | |
Card
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Card
|
Sets a URL to be opened when the object is clicked. | |
Card
|
Sets the menu text for this action. |
Card
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Card
|
Adds a Card
to this Card. |
|
Card
|
Adds a section to this card. | |
Card
|
Builds the current card and validates it. | |
Card
|
Sets the display style for this card. | |
Card
|
Sets a fixed footer for this card. | |
Card
|
Sets the header for this card. | |
Card
|
Sets the name for this card. | |
Card
|
Sets the peek card header. |
Card
Header
Methods
| Method | Return type | Brief description |
|---|---|---|
Card
|
Sets the alternative text for the header image. | |
Card
|
Sets the cropping of the icon in the card header. | |
Card
|
Sets the image to use in the header by providing its URL or data string. | |
Card
|
Sets the subtitle of the card header. | |
Card
|
Sets the title of the card header. |
Card
Section
Methods
| Method | Return type | Brief description |
|---|---|---|
Card
|
Adds the given widget to this section. | |
Card
|
Sets the customizable expand and collapse buttons of the section. | |
Card
|
Sets whether the section can be collapsed. | |
Card
|
Sets the header of the section. | |
Card
|
Sets the number of widgets that are still shown when this section is collapsed. |
Card
Service
Properties
| Property | Type | Description |
|---|---|---|
Border
|
Border
|
The Border
enumeration. |
Chip
|
Chip
|
The Chip
enumeration. |
Composed
|
Composed
|
The Composed
enumeration. |
Content
|
Content
|
The Content
enumeration. |
Expression
|
Expression
|
The Expression
enumeration. |
Expression
|
Expression
|
The Expression
enumeration. |
Grid
|
Grid
|
The Grid
enumeration. |
Horizontal
|
Horizontal
|
The Horizontal
enumeration. |
Icon
|
Icon
|
The Icon
enumeration. |
Image
|
Image
|
The Image
enumeration. |
Image
|
Image
|
The Image
enumeration. |
Image
|
Image
|
The Image
enumeration. |
Input
|
Input
|
The Input
enumeration. |
Load
|
Load
|
The Load
enumeration. |
On
|
On
|
The On
enumeration. |
Open
|
Open
|
The Open
enumeration. |
Selection
|
Selection
|
The Selection
enumeration. |
Text
|
Text
|
The Text
enumeration. |
Update
|
Update
|
The Update
enumeration. |
Visibility
|
Visibility
|
The Visibility
enumeration. |
Workflow
|
Workflow
|
The Workflow
enumeration. |
Methods
Card
With
Id
Methods
| Method | Return type | Brief description |
|---|---|---|
Card
|
Sets the card of the card
. |
|
Card
|
Sets the unique card ID of the card
. |
Carousel
Methods
| Method | Return type | Brief description |
|---|---|---|
Carousel
|
Adds a carousel card. |
Carousel
Card
Methods
| Method | Return type | Brief description |
|---|---|---|
Carousel
|
Adds the given widget to the footer of this carousel card. | |
Carousel
|
Adds the given widget to this carousel card. |
Chat
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
Chat
|
Sets the dialog action to an event related to a dialog. | |
Chat
|
The type of Chat app response. | |
Chat
|
Sets the updated widget, used to provide autocomplete options for a widget. | |
Chat
|
The URL for users to authenticate or configure. |
Chat
Client
Data
Source
Methods
| Method | Return type | Brief description |
|---|---|---|
Chat
|
A data source that populates Google Chat spaces as selection items for a multiselect menu. |
Chat
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Chat
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Chat
|
Sets the card field of the message. | |
Chat
|
Builds the current action response and validates it. | |
Chat
|
Sets the action response field of the message. | |
Chat
|
Sets the text of the Chat message. |
Chat
Space
Data
Source
Methods
| Method | Return type | Brief description |
|---|---|---|
Chat
|
If set to true
, the multi select menu selects the current Google Chat space as an item
by default. |
Chip
Methods
| Method | Return type | Brief description |
|---|---|---|
Chip
|
Sets the alternative text of the chip for accessibility. | |
Chip
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Chip
|
Sets an action that composes a draft email when the object is clicked. | |
Chip
|
Sets whether the chip is disabled. | |
Chip
|
Sets the icon to be used as the chip. | |
Chip
|
Sets the title of the chip. | |
Chip
|
Sets an action that executes when the object is clicked. | |
Chip
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Chip
|
Sets a URL to be opened when the object is clicked. |
Chip
List
Methods
| Method | Return type | Brief description |
|---|---|---|
Chip
|
Adds a chip. | |
Chip
|
Sets the chip list layout. |
Chip
List
Layout
Properties
| Property | Type | Description |
|---|---|---|
WRAPPED
|
Enum
|
The chip list wraps to the next line if there isn't enough horizontal space. |
HORIZONTAL_SCROLLABLE
|
Enum
|
The chips scroll horizontally if they don't fit in the available space. |
Collapse
Control
Methods
| Method | Return type | Brief description |
|---|---|---|
Collapse
|
Sets the Button
that is displayed for "show less" button. |
|
Collapse
|
Sets the Button
that is displayed for "show more" button. |
|
Collapse
|
Sets the Horizontal
of the Collapse
. |
Column
Methods
| Method | Return type | Brief description |
|---|---|---|
Column
|
Adds a widget to the column. | |
Column
|
Sets the Horizontal
of the Column
. |
|
Column
|
Sets the Horizontal
of the Column. |
|
Column
|
Sets the Vertical
of the Column
. |
Columns
Methods
| Method | Return type | Brief description |
|---|---|---|
Columns
|
Adds a Column
to the Columns widget. |
|
Columns
|
Sets the wrap style of the columns, controls how the column resizes based on screen width. |
Common
Data
Source
Properties
| Property | Type | Description |
|---|---|---|
UNKNOWN
|
Enum
|
Default value. |
USER
|
Enum
|
Google Workspace users. |
Common
Widget
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Common
|
Sets the update visibility action for widgets. |
Compose
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Compose
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Compose
|
Builds the current compose action response and validates it. | |
Compose
|
Sets the draft Gmail
created
using Gmail
or
similar functions. |
Composed
Email
Type
Properties
| Property | Type | Description |
|---|---|---|
REPLY_AS_DRAFT
|
Enum
|
A draft that is a reply to another message. |
STANDALONE_DRAFT
|
Enum
|
A draft that is a standalone message. |
Condition
Methods
| Method | Return type | Brief description |
|---|---|---|
Condition
|
The unique ID of the action rule to run in response to the condition. | |
Condition
|
Sets the CEL expression validation condition used to determine whether the event action should run. |
Content
Type
Properties
| Property | Type | Description |
|---|---|---|
TEXT
|
Enum
|
Indicates that the generated content is plain text. |
MUTABLE_HTML
|
Enum
|
Indicates that the generated content is formatted as HTML. |
IMMUTABLE_HTML
|
Enum
|
Indicates that the generated content is formatted as HTML, but this content cannot be edited after it is generated. |
Date
Picker
Methods
| Method | Return type | Brief description |
|---|---|---|
Date
|
Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. | |
Date
|
Sets an Action
that the script performs whenever the picker input changes. |
|
Date
|
Sets the title displayed above the input field. | |
Date
|
Sets the prefilled value to be set in the input field. | |
Date
|
Sets the prefilled value to be set in the input field. |
Date
Time
Picker
Methods
| Method | Return type | Brief description |
|---|---|---|
Date
|
Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. | |
Date
|
In a Google Workspace flow, lets input variables accept datetime outputs from other steps in the flow. | |
Date
|
Sets an Action
that the script performs whenever the picker input changes. |
|
Date
|
Sets the number of minutes that the time zone should be offset from UTC. | |
Date
|
Sets the title displayed above the input field. | |
Date
|
Sets the prefilled value to be set in the input field. | |
Date
|
Sets the prefilled value to be set in the input field. |
Decorated
Text
Methods
| Method | Return type | Brief description |
|---|---|---|
Decorated
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Decorated
|
Sets the label text to be used as the key and is displayed below the text content. | |
Decorated
|
Sets the Button
that is displayed to the right of the text. |
|
Decorated
|
Sets an action that composes a draft email when the object is clicked. | |
Decorated
|
Sets the optional Icon
that is displayed to the right of the content. |
|
Decorated
|
Sets an action that executes when the object is clicked. | |
Decorated
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Decorated
|
Sets a URL to be opened when the object is clicked. | |
Decorated
|
Sets the optional Icon
to display before the text content. |
|
Decorated
|
Sets the Switch
that is displayed to the right of the content. |
|
Decorated
|
Sets the text to be used as the value. | |
Decorated
|
Sets the label text to be used as the key and is displayed above the text content. | |
Decorated
|
Sets whether the value text should be displayed on a single line or multiple lines. |
Dialog
Methods
| Method | Return type | Brief description |
|---|---|---|
Dialog
|
Sets the card of the Dialog
. |
Dialog
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Dialog
|
Sets the action status of Dialog
. |
|
Dialog
|
Sets the dialog of the Dialog
. |
Display
Style
Properties
| Property | Type | Description |
|---|---|---|
PEEK
|
Enum
|
Show the card header at the bottom of add-on content over existing content. |
REPLACE
|
Enum
|
Show the card by replacing existing content. |
Divider
Drive
Items
Selected
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Drive
Items
Selected
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Drive
|
Builds the current Drive action response. | |
Drive
|
Specifies that the response requests file scope for the contextually-relevant item in Drive. |
Editor
File
Scope
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Editor
File
Scope
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Editor
|
Builds the current Editor action response. | |
Editor
|
Requests the drive.file
scope for the current active Editor document. |
Event
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Event
|
Adds a CEL expression validation condition to evaluate after the event action runs. | |
Event
|
Sets a unique identifier for the event action. | |
Event
|
Set the common widget action for widgets. | |
Event
|
Sets the CEL expression validation data action for widgets. |
Expression
Data
Methods
| Method | Return type | Brief description |
|---|---|---|
Expression
|
Adds a condition to the current expression data. | |
Expression
|
Adds an event action to the current expression data. | |
Expression
|
Sets the expression data value. | |
Expression
|
Sets the expression data id. |
Expression
Data
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Expression
|
Sets the type of the expression data action. |
Expression
Data
Action
Type
Properties
| Property | Type | Description |
|---|---|---|
ACTION_TYPE_UNSPECIFIED
|
Enum
|
The unspecified action type. |
START_EXPRESSION_EVALUATION
|
Enum
|
The action to start the CEL expression validation . |
Expression
Data
Condition
Methods
| Method | Return type | Brief description |
|---|---|---|
Expression
|
Sets condition type for a CEL expression validation to indicate whether the expression evaluated successfully. |
Expression
Data
Condition
Type
Properties
| Property | Type | Description |
|---|---|---|
CONDITION_TYPE_UNSPECIFIED
|
Enum
|
The unspecified condition type. |
EXPRESSION_EVALUATION_SUCCESS
|
Enum
|
The CEL expression evaluated to a successful result. |
EXPRESSION_EVALUATION_FAILURE
|
Enum
|
The CEL expression evaluated to a failure result. |
Fixed
Footer
Methods
| Method | Return type | Brief description |
|---|---|---|
Fixed
|
Set the primary button in the fixed footer. | |
Fixed
|
Set the secondary button in the fixed footer. |
Grid
Methods
| Method | Return type | Brief description |
|---|---|---|
Grid
|
Adds a new grid item to the grid. | |
Grid
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Grid
|
Sets the border style applied to each grid item. | |
Grid
|
Sets an action that composes a draft email when the object is clicked. | |
Grid
|
The number of columns to display in the grid. | |
Grid
|
Sets an action that executes when the object is clicked. | |
Grid
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Grid
|
Sets a URL to be opened when the object is clicked. | |
Grid
|
Sets the title text of the grid. |
Grid
Item
Methods
| Method | Return type | Brief description |
|---|---|---|
Grid
|
Sets the identifier for the grid item. | |
Grid
|
Sets the image for this grid item. | |
Grid
|
Sets the layout of text and image for the grid item. | |
Grid
|
Sets the subtitle of the grid item. | |
Grid
|
Sets the horizontal alignment of the grid item. | |
Grid
|
Sets the title text of the grid item. |
Grid
Item
Layout
Properties
| Property | Type | Description |
|---|---|---|
TEXT_BELOW
|
Enum
|
The title and subtitle are shown below the grid item's image. |
TEXT_ABOVE
|
Enum
|
The title and subtitle are shown above the grid item's image. |
Horizontal
Alignment
Properties
| Property | Type | Description |
|---|---|---|
START
|
Enum
|
Align the widget to the start of the sentence side. |
CENTER
|
Enum
|
Align the widget to the center. |
END
|
Enum
|
Align the widget to the end of the sentence side. |
Horizontal
Size
Style
Properties
| Property | Type | Description |
|---|---|---|
FILL_AVAILABLE_SPACE
|
Enum
|
Sizes the Widget
to fill the available horizontal space of a Column
. |
FILL_MINIMUM_SPACE
|
Enum
|
Resizes the Widget
to fill the least amount of horizontal space in a Column
. |
Host
App
Data
Source
Methods
| Method | Return type | Brief description |
|---|---|---|
Host
|
Sets the data source from Google Chat. | |
Host
|
Sets the data source from Google Workspace Flows. |
Icon
Properties
| Property | Type | Description |
|---|---|---|
NONE
|
Enum
|
No icon. |
AIRPLANE
|
Enum
|
|
BOOKMARK
|
Enum
|
|
BUS
|
Enum
|
|
CAR
|
Enum
|
|
CLOCK
|
Enum
|
|
CONFIRMATION_NUMBER_ICON
|
Enum
|
|
DOLLAR
|
Enum
|
|
DESCRIPTION
|
Enum
|
|
EMAIL
|
Enum
|
|
EVENT_PERFORMER
|
Enum
|
|
EVENT_SEAT
|
Enum
|
|
FLIGHT_ARRIVAL
|
Enum
|
|
FLIGHT_DEPARTURE
|
Enum
|
|
HOTEL
|
Enum
|
|
HOTEL_ROOM_TYPE
|
Enum
|
|
INVITE
|
Enum
|
|
MAP_PIN
|
Enum
|
|
MEMBERSHIP
|
Enum
|
|
MULTIPLE_PEOPLE
|
Enum
|
|
OFFER
|
Enum
|
|
PERSON
|
Enum
|
|
PHONE
|
Enum
|
|
RESTAURANT_ICON
|
Enum
|
|
SHOPPING_CART
|
Enum
|
|
STAR
|
Enum
|
|
STORE
|
Enum
|
|
TICKET
|
Enum
|
|
TRAIN
|
Enum
|
|
VIDEO_CAMERA
|
Enum
|
|
VIDEO_PLAY
|
Enum
|
Icon
Image
Methods
| Method | Return type | Brief description |
|---|---|---|
Icon
|
Sets the alternative text of the URL which is used for accessibility. | |
Icon
|
Sets the predefined icon if the URL is not set. | |
Icon
|
Sets the URL of the icon if the icon is not set. | |
Icon
|
Sets the crop style for the image. | |
Icon
|
Sets the material design icon. |
Image
Methods
| Method | Return type | Brief description |
|---|---|---|
Image
|
Sets the alternative text of the image for accessibility. | |
Image
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Image
|
Sets an action that composes a draft email when the object is clicked. | |
Image
|
Sets the image to use by providing its URL or data string. | |
Image
|
Sets an action that executes when the object is clicked. | |
Image
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Image
|
Sets a URL to be opened when the object is clicked. |
Image
Button
Methods
| Method | Return type | Brief description |
|---|---|---|
Image
|
Sets the alternative text of the button for accessibility. | |
Image
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Image
|
Sets an action that composes a draft email when the object is clicked. | |
Image
|
Sets a predefined Icon
to display on the button. |
|
Image
|
Sets the URL of an image to use as this button's icon. | |
Image
|
Sets the button style. | |
Image
|
Sets the material design icon. | |
Image
|
Sets an action that executes when the object is clicked. | |
Image
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Image
|
Sets a URL to be opened when the object is clicked. | |
Image
|
Sets a pop-up menu to be opened when the object is clicked. |
Image
Button
Style
Properties
| Property | Type | Description |
|---|---|---|
BORDERLESS
|
Enum
|
Image button with no border. |
OUTLINED
|
Enum
|
Image button with clear background. |
FILLED
|
Enum
|
Image button with colored background. |
FILLED_TONAL
|
Enum
|
Image button with an alternative middle ground between filled and outlined buttons. |
Image
Component
Methods
| Method | Return type | Brief description |
|---|---|---|
Image
|
Sets the alternative text of the image. | |
Image
|
Sets the border style applied to the image. | |
Image
|
Sets the crop style for the image. | |
Image
|
Sets the URL of the image. |
Image
Crop
Style
Methods
| Method | Return type | Brief description |
|---|---|---|
Image
|
Sets the aspect ratio to use if the crop type is RECTANGLE_CUSTOM
. |
|
Image
|
Sets the crop type for the image. |
Image
Crop
Type
Properties
| Property | Type | Description |
|---|---|---|
SQUARE
|
Enum
|
Square shape crop style. |
CIRCLE
|
Enum
|
Circle shape crop style. |
RECTANGLE_CUSTOM
|
Enum
|
Rectangle shape crop style with custom ratio. |
RECTANGLE_4_3
|
Enum
|
Rectangle shape crop style with 4:3 ratio. |
Image
Style
Properties
| Property | Type | Description |
|---|---|---|
SQUARE
|
Enum
|
No cropping. |
CIRCLE
|
Enum
|
Crop to a circle shape. |
Input
Type
Properties
| Property | Type | Description |
|---|---|---|
TEXT
|
Enum
|
Accept regular text. |
INTEGER
|
Enum
|
Accept an integer. |
FLOAT
|
Enum
|
Accept a floating-point number. |
EMAIL
|
Enum
|
Accept an email address. |
Interaction
Properties
| Property | Type | Description |
|---|---|---|
INTERACTION_UNSPECIFIED
|
Enum
|
Default value. |
OPEN_DIALOG
|
Enum
|
Opens a dialog, a card-based interface that Chat apps use to interact with users. |
Key
Value
Key
Value
Methods
| Method | Return type | Brief description |
|---|---|---|
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
|
Sets an action that composes a draft email when the object is clicked. | |
|
Sets an action that executes when the object is clicked. | |
|
Sets an action that opens a URL in a tab when the object is clicked. | |
|
Sets a URL to be opened when the object is clicked. |
Link
Preview
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. | |
Link
|
Sets the title that displays in the link preview above the preview card. | |
Link
|
Sets the card that displays information about a link from a third-party or non-Google service. | |
Link
|
Sets the title that displays in the smart chip for the link preview. |
Load
Indicator
Properties
| Property | Type | Description |
|---|---|---|
SPINNER
|
Enum
|
Use a spinner indicator. |
NONE
|
Enum
|
Do not use an indicator. |
Material
Icon
Methods
| Method | Return type | Brief description |
|---|---|---|
Material
|
Whether the icon renders as filled. | |
Material
|
Weight and grade affect a symbol’s thickness. | |
Material
|
Sets the name of the icon. | |
Material
|
The stroke weight of the icon. |
Navigation
Methods
| Method | Return type | Brief description |
|---|---|---|
Navigation
|
Pops a card from the navigation stack. | |
Navigation
|
Pops to the specified card by its card name. | |
Navigation
|
Pops the card stack to the root card. | |
String
|
Prints the JSON representation of this object. | |
Navigation
|
Pushes the given card onto the stack. | |
Navigation
|
Does an in-place replacement of the current card. |
Notification
Methods
| Method | Return type | Brief description |
|---|---|---|
Notification
|
Sets the text to show in the notification. |
On
Close
Properties
| Property | Type | Description |
|---|---|---|
NOTHING
|
Enum
|
Do nothing on close. |
RELOAD
|
Enum
|
Reloads the add-on on when the window closes. |
Open
As
Properties
| Property | Type | Description |
|---|---|---|
FULL_SIZE
|
Enum
|
Open in a full window or tab. |
OVERLAY
|
Enum
|
Open as an overlay such as a pop-up. |
Open
Link
Methods
| Method | Return type | Brief description |
|---|---|---|
Open
|
Sets the behavior of the URL action when the URL window or tab is closed. | |
Open
|
Sets the behavior of URL when it is opened. | |
Open
|
Sets the URL to be opened. |
Overflow
Menu
Methods
| Method | Return type | Brief description |
|---|---|---|
Overflow
|
Adds a menu item. |
Overflow
Menu
Item
Methods
| Method | Return type | Brief description |
|---|---|---|
Overflow
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Overflow
|
Sets an action that composes a draft email when the object is clicked. | |
Overflow
|
Sets whether the menu item is disabled. | |
Overflow
|
Sets an action that executes when the object is clicked. | |
Overflow
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Overflow
|
Sets a URL to be opened when the object is clicked. | |
Overflow
|
Sets the menu item's leading icon. | |
Overflow
|
Sets the title of the menu item. |
Platform
Data
Source
Methods
| Method | Return type | Brief description |
|---|---|---|
Platform
|
Sets the data source from Google Workspace. | |
Platform
|
Used to populate spaces in multiselect menu. |
Response
Type
Properties
| Property | Type | Description |
|---|---|---|
TYPE_UNSPECIFIED
|
Enum
|
Default type that's handled as NEW_MESSAGE
. |
NEW_MESSAGE
|
Enum
|
Post as a new message in the topic. |
UPDATE_MESSAGE
|
Enum
|
Update the Chat app's message. |
UPDATE_USER_MESSAGE_CARDS
|
Enum
|
Update the cards on a user's message. |
REQUEST_CONFIG
|
Enum
|
Privately ask the user for additional authentication or configuration. |
DIALOG
|
Enum
|
Presents a dialog. |
UPDATE_WIDGET
|
Enum
|
Widget text autocomplete options query. |
Selection
Input
Methods
| Method | Return type | Brief description |
|---|---|---|
Selection
|
Adds a new item that can be selected. | |
Selection
|
Adds a new item that can be selected, for multi-select menus. | |
Selection
|
Sets external data source, such as a relational data base. | |
Selection
|
Sets the key that identifies this selection input in the event object that is generated when there is a UI interaction. | |
Selection
|
Sets the maximum number of items that a user can select. | |
Selection
|
Sets the number of text characters that a user inputs before the app queries autocomplete and displays suggested items on the card. | |
Selection
|
Sets an Action
to be performed whenever the selection input changes. |
|
Selection
|
Sets a data source from Google Workspace. | |
Selection
|
Sets the title to be shown ahead of the input field. | |
Selection
|
Sets the type of this input. |
Selection
Input
Type
Properties
| Property | Type | Description |
|---|---|---|
CHECK_BOX
|
Enum
|
Checkbox input style. |
RADIO_BUTTON
|
Enum
|
Radio button input style. |
DROPDOWN
|
Enum
|
Dropdown menu selection input style. |
SWITCH
|
Enum
|
A set of switches. |
MULTI_SELECT
|
Enum
|
A multiselect menu for static or dynamic data. |
OVERFLOW_MENU
|
Enum
|
A UI element that houses additional options that don't fit within the primary interface |
Status
Properties
| Property | Type | Description |
|---|---|---|
OK
|
Enum
|
HTTP Mapping: 200 OK |
CANCELLED
|
Enum
|
HTTP Mapping: 499 Client Closed Request |
UNKNOWN
|
Enum
|
Unknown error. |
INVALID_ARGUMENT
|
Enum
|
The client specified an invalid argument. |
DEADLINE_EXCEEDED
|
Enum
|
HTTP Mapping: 504 Gateway Timeout |
NOT_FOUND
|
Enum
|
HTTP Mapping: 404 Not Found |
ALREADY_EXISTS
|
Enum
|
The entity that a client attempted to create already exists. |
PERMISSION_DENIED
|
Enum
|
HTTP Mapping: 403 Forbidden |
UNAUTHENTICATED
|
Enum
|
HTTP Mapping: 401 Unauthorized |
RESOURCE_EXHAUSTED
|
Enum
|
HTTP Mapping: 429 Too Many Requests |
FAILED_PRECONDITION
|
Enum
|
The operation was rejected because the system is not in a state required for the operation's execution. |
ABORTED
|
Enum
|
The operation was aborted, typically due to a concurrency issue such as a sequencer check failure or transaction abort. |
OUT_OF_RANGE
|
Enum
|
The operation was attempted past the valid range. |
UNIMPLEMENTED
|
Enum
|
HTTP Mapping: 501 Not Implemented |
INTERNAL
|
Enum
|
Internal errors. |
UNAVAILABLE
|
Enum
|
HTTP Mapping: 503 Service Unavailable |
DATA_LOSS
|
Enum
|
Unrecoverable data loss or corruption. |
Suggestions
Methods
| Method | Return type | Brief description |
|---|---|---|
Suggestions
|
Add a text suggestion. | |
Suggestions
|
Add a list of text suggestions. |
Suggestions
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Suggestions
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Suggestions
|
Builds the current suggestions response and validates it. | |
Suggestions
|
Sets the suggestions used in auto complete in text fields. |
Switch
Methods
| Method | Return type | Brief description |
|---|---|---|
Switch
|
Sets the control type of the switch. | |
Switch
|
Sets the key that identifies this switch in the event object that is generated when there is a UI interaction. | |
Switch
|
Sets the action to take when the switch is toggled. | |
Switch
|
Sets whether this switch should start as selected or unselected. | |
Switch
|
Sets the value that is sent as the form input when this switch is toggled on. |
Switch
Control
Type
Properties
| Property | Type | Description |
|---|---|---|
SWITCH
|
Enum
|
Toggle-styled control for a switch widget. |
CHECK_BOX
|
Enum
|
Checkbox-styled control for a switch widget. |
Text
Button
Methods
| Method | Return type | Brief description |
|---|---|---|
Text
|
Sets the alternative text of the button for accessibility. | |
Text
|
Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | |
Text
|
Sets the background color for Text
button. |
|
Text
|
Sets an action that composes a draft email when the object is clicked. | |
Text
|
Sets whether the button is disabled. | |
Text
|
Sets a predefined Icon
to display on the button. |
|
Text
|
Sets the URL of an image to use as this button's icon. | |
Text
|
Sets the material design icon. | |
Text
|
Sets an action that executes when the object is clicked. | |
Text
|
Sets an action that opens a URL in a tab when the object is clicked. | |
Text
|
Sets a URL to be opened when the object is clicked. | |
Text
|
Sets a pop-up menu to be opened when the object is clicked. | |
Text
|
Sets the text that displays on the button. | |
Text
|
Sets the button style. |
Text
Button
Style
Properties
| Property | Type | Description |
|---|---|---|
OUTLINED
|
Enum
|
Normal text button with clear background. |
TEXT
|
Enum
|
DO NOT USE. |
FILLED
|
Enum
|
Text button with colored background. |
FILLED_TONAL
|
Enum
|
Normal text button with an alternative middle ground between filled and outlined buttons. |
BORDERLESS
|
Enum
|
Normal text button with no border. |
Text
Input
Methods
| Method | Return type | Brief description |
|---|---|---|
Text
|
Sets the key that identifies this text input in the event object that is generated when there is a UI interaction. | |
Text
|
Sets a hint for the text input. | |
Text
|
Sets a data source from Google Workspace applications. | |
Text
|
Sets whether the input text shows on one line or multiple lines. | |
Text
|
Sets an action to be performed whenever the text input changes. | |
Text
|
Sets the suggestions for autocompletion in the text field. | |
Text
|
Sets the callback action to fetch suggestions based on user input for autocompletion. | |
Text
|
Sets the title to be shown above the input field. | |
Text
|
Sets the validation rule for this widget. | |
Text
|
Sets the pre-filled value to be set in the input field. |
Text
Paragraph
Methods
| Method | Return type | Brief description |
|---|---|---|
Text
|
Sets the maximum number of lines of text that are displayed in the widget. | |
Text
|
Sets the text of the paragraph. |
Time
Picker
Methods
| Method | Return type | Brief description |
|---|---|---|
Time
|
Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. | |
Time
|
Sets the prefilled hours value to set in the input field. | |
Time
|
Sets the prefilled minutes value to set in the input field. | |
Time
|
Sets an Action
that the script performs whenever the picker input changes. |
|
Time
|
Sets the title displayed above the input field. |
Trigger
Methods
| Method | Return type | Brief description |
|---|---|---|
Trigger
|
Sets the action rule id for the trigger. |
Universal
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Universal
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Universal
|
Builds the current universal action response and validates it. | |
Universal
|
Displays the add-on with the specified cards. | |
Universal
|
Sets the URL to open when the universal action is selected. |
Update
Draft
Action
Response
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Prints the JSON representation of this object. |
Update
Draft
Action
Response
Builder
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Builds the current update draft action response and validates it. | |
Update
|
Sets an action that updates the email Bcc recipients of a draft. | |
Update
|
Set an action that updates the email body of a draft. | |
Update
|
Sets an action that updates the Cc recipients of a draft. | |
Update
|
Sets an action that updates the subject line of a draft. | |
Update
|
Sets an action that updates the To recipients of a draft. |
Update
Draft
Bcc
Recipients
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Updates the Bcc recipients of an email draft. |
Update
Draft
Body
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Adds the specified content to the draft body. | |
Update
|
Sets the Update
of this update action on the draft body. |
Update
Draft
Body
Type
Properties
| Property | Type | Description |
|---|---|---|
IN_PLACE_INSERT
|
Enum
|
Default. |
INSERT_AT_START
|
Enum
|
Update actions insert content at the start of message body. |
INSERT_AT_END
|
Enum
|
Update actions insert content at the end of the message body. |
Update
Draft
Cc
Recipients
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Updates the Cc recipients of an email draft. |
Update
Draft
Subject
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Updates the subject line of an email draft. |
Update
Draft
To
Recipients
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Updates the To recipients of an email draft. |
Update
Visibility
Action
Methods
| Method | Return type | Brief description |
|---|---|---|
Update
|
Sets the visibility of widgets to visible or hidden. |
Updated
Widget
Methods
| Method | Return type | Brief description |
|---|---|---|
Updated
|
Adds a new item that can be selected. |
Validation
Methods
| Method | Return type | Brief description |
|---|---|---|
Validation
|
Sets the character limit of the widget. | |
Validation
|
Sets the input type of the widget. |
Variable
Button
Size
Properties
| Property | Type | Description |
|---|---|---|
UNSPECIFIED
|
Enum
|
Automatically chooses COMPACT
for Sidepanel, chooses FULL_SIZE
otherwise. |
COMPACT
|
Enum
|
For buttons labeled `+` |
FULL_SIZE
|
Enum
|
For buttons labeled `+ variable` |
Vertical
Alignment
Properties
| Property | Type | Description |
|---|---|---|
CENTER
|
Enum
|
Vertically places the content at the center of the container. |
TOP
|
Enum
|
Vertically places the content at the top of the container. |
BOTTOM
|
Enum
|
Vertically places the content at the bottom of the container. |
Visibility
Properties
| Property | Type | Description |
|---|---|---|
VISIBLE
|
Enum
|
The UI element is visible. |
HIDDEN
|
Enum
|
The UI element is invisible. |
VISIBILITY_UNSPECIFIED
|
Enum
|
The UI element is unspecified. |
Widget
Workflow
Data
Source
Methods
| Method | Return type | Brief description |
|---|---|---|
Workflow
|
Whether to include variables from the previous step in the data source. | |
Workflow
|
Sets the type of the workflow data source. | |
Workflow
|
Sets the label of the variable picker button, which will be displayed after the `+` sign in FULL_SIZE button size. | |
Workflow
|
Sets the size of the variable picker button, Workflow will automatically using COMPACT in side panel and FULL_SIZE in other cases if UNSPECIFIED is selected. |
Workflow
Data
Source
Type
Properties
| Property | Type | Description |
|---|---|---|
UNKNOWN
|
Enum
|
Default value. |
USER
|
Enum
|
The data source is a user's data. |
SPACE
|
Enum
|
The data source is a Google Chat space. |
USER_WITH_FREE_FORM
|
Enum
|
The data source is a user's data; users can choose to view and select existing members from their Google Workspace organization or manually enter an email address or a valid domain. |
Wrap
Style
Properties
| Property | Type | Description |
|---|---|---|
NOWRAP
|
Enum
|
No wrapping. |
WRAP
|
Enum
|
Wraps the content for any widgets in a column. |

