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 Actionobjects. | 
| 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 Buttonobjects 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 Calendarobjects. | 
| 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 Cardobjects. | 
| 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 Cardobjects. | 
| 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 Selectionwidget 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 Chatobjects. | 
| Chat | A data source that populates Google Chat spaces as selection items for a multiselect menu. | 
| Chip | A Chipwith an icon and text label. | 
| Chip | Holds a set of Chipobjects 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 Columnswidget 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 Composeobjects. | 
| 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 Dialogobjects. | 
| 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 Driveobjects. | 
| 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 Editorobjects. | 
| 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 Selectionwidget 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 ImageorDecoratedwidgets. | 
| 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 Imagewith 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 Actionis 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 Openis 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 Overflowobjects that are displayed in a pop-up menu. | 
| Overflow | An Overflowwith an icon and text label. | 
| Platform | For a Selectionwidget 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 Textwidget. | 
| Suggestions | A response object that can be returned from a suggestions callback function. | 
| Suggestions | A builder for Suggestionsobjects. | 
| Switch | A UI element that supports being toggled on or off. | 
| Switch | Type of a Switchwidget control. | 
| Text | A Textwith 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 Universalobjects. | 
| Update | Represents an action that updates the email draft that the user is currently editing. | 
| Update | A builder for Updateobjects. | 
| 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` orTextwidget, 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 | 
|---|---|---|
| add | Action | Adds the names of the widgets that this Action needs for a valid submission. | 
| set | Action | Indicates whether this Action requires inputs from all widgets. | 
| set | Action | Sets the name of the callback function to be called. | 
| set | Action | Sets the interaction with a user, only required when opening a dialog. | 
| set | Action | Sets the loading indicator that displays while the action is in progress. | 
| set | Action | Allows custom parameters to be passed to the callback function. | 
| set | 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. | 
ActionResponse 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
ActionResponseBuilder  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Action | Builds the current action response and validates it. | 
| set | Action | Sets the response to a Navigationaction. | 
| set | Action | Sets the notification to display when the action is activated. | 
| set | Action | Sets the URL to navigate to when the action is activated. | 
| set | Action | Sets a flag to indicate that this action changed the existing data state. | 
ActionStatus 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Action | Represents the status for a request to either open or submit a dialog. | 
| set | Action | The message to send users about the status of their request. | 
Attachment
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Attachment | Sets the icon URL for the attachment. | 
| set | Attachment | Sets the MIME type for the attachment. | 
| set | Attachment | Sets the resource URL for the attachment. | 
| set | Attachment | Sets the title for the attachment. | 
AuthorizationAction 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Authorization | Sets the authorization URL that user is taken to from the authorization prompt. | 
AuthorizationException 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
| set | Authorization | Sets the authorization URL that user is taken to from the authorization prompt. | 
| set | Authorization | The name of a function to call to generate a custom authorization prompt. | 
| set | Authorization | Sets the name that is displayed to the user when asking for authorization. | 
| throw | void | Triggers this exception to be thrown. | 
BorderStyle 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Border | Sets the corner radius of the border, for example 8. | 
| set | Border | Sets the color of the border. | 
| set | Border | Sets the type of the border. | 
BorderType 
Properties
| Property | Type | Description | 
|---|---|---|
| NO_BORDER | Enum | No border style. | 
| STROKE | Enum | Stroke border style. | 
Button
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Button | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Button | Sets an action that composes a draft email when the object is clicked. | 
| set | Button | Sets an action that executes when the object is clicked. | 
| set | Button | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Button | Sets a URL to be opened when the object is clicked. | 
| set | Button | Sets a pop-up menu to be opened when the object is clicked. | 
ButtonSet 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Button | Adds a button. | 
CalendarEventActionResponse   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
CalendarEventActionResponseBuilder    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Calendar | Specifies that the response should add the attachments to the Calendar event when the associated UI action is taken. | 
| add | Calendar | Specifies that the response should add the indicated attendees to the Calendar event when the associated UI action is taken. | 
| build() | Calendar | Builds the current Calendar event action response and validates it. | 
| set | 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 | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
CardAction 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Card | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Card | Sets an action that composes a draft email when the object is clicked. | 
| set | Card | Sets an action that executes when the object is clicked. | 
| set | Card | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Card | Sets a URL to be opened when the object is clicked. | 
| set | Card | Sets the menu text for this action. | 
CardBuilder 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Card | Adds a Cardto this Card. | 
| add | Card | Adds a section to this card. | 
| build() | Card | Builds the current card and validates it. | 
| set | Card | Sets the display style for this card. | 
| set | Card | Sets a fixed footer for this card. | 
| set | Card | Sets the header for this card. | 
| set | Card | Sets the name for this card. | 
| set | Card | Sets the peek card header. | 
CardHeader 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Card | Sets the alternative text for the header image. | 
| set | Card | Sets the cropping of the icon in the card header. | 
| set | Card | Sets the image to use in the header by providing its URL or data string. | 
| set | Card | Sets the subtitle of the card header. | 
| set | Card | Sets the title of the card header. | 
CardSection 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Card | Adds the given widget to this section. | 
| set | Card | Sets the customizable expand and collapse buttons of the section. | 
| set | Card | Sets whether the section can be collapsed. | 
| set | Card | Sets the header of the section. | 
| set | Card | Sets the number of widgets that are still shown when this section is collapsed. | 
CardService 
Properties
| Property | Type | Description | 
|---|---|---|
| Border | Border | The Borderenumeration. | 
| Chip | Chip | The Chipenumeration. | 
| Composed | Composed | The Composedenumeration. | 
| Content | Content | The Contentenumeration. | 
| Expression | Expression | The Expressionenumeration. | 
| Expression | Expression | The Expressionenumeration. | 
| Grid | Grid | The Gridenumeration. | 
| Horizontal | Horizontal | The Horizontalenumeration. | 
| Icon | Icon | The Iconenumeration. | 
| Image | Image | The Imageenumeration. | 
| Image | Image | The Imageenumeration. | 
| Image | Image | The Imageenumeration. | 
| Input | Input | The Inputenumeration. | 
| Load | Load | The Loadenumeration. | 
| On | On | The Onenumeration. | 
| Open | Open | The Openenumeration. | 
| Selection | Selection | The Selectionenumeration. | 
| Text | Text | The Textenumeration. | 
| Update | Update | The Updateenumeration. | 
| Visibility | Visibility | The Visibilityenumeration. | 
| Workflow | Workflow | The Workflowenumeration. | 
Methods
CardWithId  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Card | Sets the card of the card. | 
| set | Card | Sets the unique card ID of the card. | 
Carousel
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Carousel | Adds a carousel card. | 
CarouselCard 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Carousel | Adds the given widget to the footer of this carousel card. | 
| add | Carousel | Adds the given widget to this carousel card. | 
ChatActionResponse  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Chat | Sets the dialog action to an event related to a dialog. | 
| set | Chat | The type of Chat app response. | 
| set | Chat | Sets the updated widget, used to provide autocomplete options for a widget. | 
| set | Chat | The URL for users to authenticate or configure. | 
ChatClientDataSource   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Chat | A data source that populates Google Chat spaces as selection items for a multiselect menu. | 
ChatResponse 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
ChatResponseBuilder  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Chat | Sets the card field of the message. | 
| build() | Chat | Builds the current action response and validates it. | 
| set | Chat | Sets the action response field of the message. | 
| set | Chat | Sets the text of the Chat message. | 
ChatSpaceDataSource   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | 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 | 
|---|---|---|
| set | Chip | Sets the alternative text of the chip for accessibility. | 
| set | Chip | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Chip | Sets an action that composes a draft email when the object is clicked. | 
| set | Chip | Sets whether the chip is disabled. | 
| set | Chip | Sets the icon to be used as the chip. | 
| set | Chip | Sets the title of the chip. | 
| set | Chip | Sets an action that executes when the object is clicked. | 
| set | Chip | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Chip | Sets a URL to be opened when the object is clicked. | 
ChipList 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Chip | Adds a chip. | 
| set | Chip | Sets the chip list layout. | 
ChipListLayout  
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. | 
CollapseControl 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Collapse | Sets the Buttonthat is displayed for "show less" button. | 
| set | Collapse | Sets the Buttonthat is displayed for "show more" button. | 
| set | Collapse | Sets the Horizontalof theCollapse. | 
Column
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Column | Adds a widget to the column. | 
| set | Column | Sets the Horizontalof theColumn. | 
| set | Column | Sets the Horizontalof the Column. | 
| set | Column | Sets the Verticalof theColumn. | 
Columns
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Columns | Adds a Columnto the Columns widget. | 
| set | Columns | Sets the wrap style of the columns, controls how the column resizes based on screen width. | 
CommonDataSource  
Properties
| Property | Type | Description | 
|---|---|---|
| UNKNOWN | Enum | Default value. | 
| USER | Enum | Google Workspace users. | 
CommonWidgetAction  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Common | Sets the update visibility action for widgets. | 
ComposeActionResponse  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
ComposeActionResponseBuilder   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Compose | Builds the current compose action response and validates it. | 
| set | Compose | Sets the draft Gmailcreated
usingGmailor
similar functions. | 
ComposedEmailType  
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 | 
|---|---|---|
| set | Condition | The unique ID of the action rule to run in response to the condition. | 
| set | Condition | Sets the CEL expression validation condition used to determine whether the event action should run. | 
ContentType 
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. | 
DatePicker 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Date | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. | 
| set | Date | Sets an Actionthat the script performs whenever the picker input changes. | 
| set | Date | Sets the title displayed above the input field. | 
| set | Date | Sets the prefilled value to be set in the input field. | 
| set | Date | Sets the prefilled value to be set in the input field. | 
DateTimePicker  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Date | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. | 
| set | Date | In a Google Workspace flow, lets input variables accept datetime outputs from other steps in the flow. | 
| set | Date | Sets an Actionthat the script performs whenever the picker input changes. | 
| set | Date | Sets the number of minutes that the time zone should be offset from UTC. | 
| set | Date | Sets the title displayed above the input field. | 
| set | Date | Sets the prefilled value to be set in the input field. | 
| set | Date | Sets the prefilled value to be set in the input field. | 
DecoratedText 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Decorated | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Decorated | Sets the label text to be used as the key and is displayed below the text content. | 
| set | Decorated | Sets the Buttonthat is displayed to the right of the text. | 
| set | Decorated | Sets an action that composes a draft email when the object is clicked. | 
| set | Decorated | Sets the optional Iconthat is displayed to the right of the content. | 
| set | Decorated | Sets an action that executes when the object is clicked. | 
| set | Decorated | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Decorated | Sets a URL to be opened when the object is clicked. | 
| set | Decorated | Sets the optional Iconto display before the text content. | 
| set | Decorated | Sets the Switchthat is displayed to the right of the content. | 
| set | Decorated | Sets the text to be used as the value. | 
| set | Decorated | Sets the label text to be used as the key and is displayed above the text content. | 
| set | Decorated | Sets whether the value text should be displayed on a single line or multiple lines. | 
Dialog
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Dialog | Sets the card of the Dialog. | 
DialogAction 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Dialog | Sets the action status of Dialog. | 
| set | Dialog | Sets the dialog of the Dialog. | 
DisplayStyle 
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
DriveItemsSelectedActionResponse    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
DriveItemsSelectedActionResponseBuilder     
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Drive | Builds the current Drive action response. | 
| request | Drive | Specifies that the response requests file scope for the contextually-relevant item in Drive. | 
EditorFileScopeActionResponse    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
EditorFileScopeActionResponseBuilder     
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Editor | Builds the current Editor action response. | 
| request | Editor | Requests the drive.filescope for the current active Editor document. | 
EventAction 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Event | Adds a CEL expression validation condition to evaluate after the event action runs. | 
| set | Event | Sets a unique identifier for the event action. | 
| set | Event | Set the common widget action for widgets. | 
| set | Event | Sets the CEL expression validation data action for widgets. | 
ExpressionData 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Expression | Adds a condition to the current expression data. | 
| add | Expression | Adds an event action to the current expression data. | 
| set | Expression | Sets the expression data value. | 
| set | Expression | Sets the expression data id. | 
ExpressionDataAction  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Expression | Sets the type of the expression data action. | 
ExpressionDataActionType   
Properties
| Property | Type | Description | 
|---|---|---|
| ACTION_TYPE_UNSPECIFIED | Enum | The unspecified action type. | 
| START_EXPRESSION_EVALUATION | Enum | The action to start the CEL expression validation. | 
ExpressionDataCondition  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Expression | Sets condition type for a CEL expression validation to indicate whether the expression evaluated successfully. | 
ExpressionDataConditionType   
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. | 
FixedFooter 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Fixed | Set the primary button in the fixed footer. | 
| set | Fixed | Set the secondary button in the fixed footer. | 
Grid
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Grid | Adds a new grid item to the grid. | 
| set | Grid | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Grid | Sets the border style applied to each grid item. | 
| set | Grid | Sets an action that composes a draft email when the object is clicked. | 
| set | Grid | The number of columns to display in the grid. | 
| set | Grid | Sets an action that executes when the object is clicked. | 
| set | Grid | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Grid | Sets a URL to be opened when the object is clicked. | 
| set | Grid | Sets the title text of the grid. | 
GridItem 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Grid | Sets the identifier for the grid item. | 
| set | Grid | Sets the image for this grid item. | 
| set | Grid | Sets the layout of text and image for the grid item. | 
| set | Grid | Sets the subtitle of the grid item. | 
| set | Grid | Sets the horizontal alignment of the grid item. | 
| set | Grid | Sets the title text of the grid item. | 
GridItemLayout  
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. | 
HorizontalAlignment 
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. | 
HorizontalSizeStyle  
Properties
| Property | Type | Description | 
|---|---|---|
| FILL_AVAILABLE_SPACE | Enum | Sizes the Widgetto fill the available horizontal space of aColumn. | 
| FILL_MINIMUM_SPACE | Enum | Resizes the Widgetto fill the least amount of horizontal space in aColumn. | 
HostAppDataSource   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Host | Sets the data source from Google Chat. | 
| set | 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 |  | 
IconImage 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Icon | Sets the alternative text of the URL which is used for accessibility. | 
| set | Icon | Sets the predefined icon if the URL is not set. | 
| set | Icon | Sets the URL of the icon if the icon is not set. | 
| set | Icon | Sets the crop style for the image. | 
| set | Icon | Sets the material design icon. | 
Image
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Image | Sets the alternative text of the image for accessibility. | 
| set | Image | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Image | Sets an action that composes a draft email when the object is clicked. | 
| set | Image | Sets the image to use by providing its URL or data string. | 
| set | Image | Sets an action that executes when the object is clicked. | 
| set | Image | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Image | Sets a URL to be opened when the object is clicked. | 
ImageButton 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Image | Sets the alternative text of the button for accessibility. | 
| set | Image | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Image | Sets an action that composes a draft email when the object is clicked. | 
| set | Image | Sets a predefined Iconto display on the button. | 
| set | Image | Sets the URL of an image to use as this button's icon. | 
| set | Image | Sets the button style. | 
| set | Image | Sets the material design icon. | 
| set | Image | Sets an action that executes when the object is clicked. | 
| set | Image | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Image | Sets a URL to be opened when the object is clicked. | 
| set | Image | Sets a pop-up menu to be opened when the object is clicked. | 
ImageButtonStyle  
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. | 
ImageComponent 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Image | Sets the alternative text of the image. | 
| set | Image | Sets the border style applied to the image. | 
| set | Image | Sets the crop style for the image. | 
| set | Image | Sets the URL of the image. | 
ImageCropStyle  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Image | Sets the aspect ratio to use if the crop type is RECTANGLE_CUSTOM. | 
| set | Image | Sets the crop type for the image. | 
ImageCropType  
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. | 
ImageStyle 
Properties
| Property | Type | Description | 
|---|---|---|
| SQUARE | Enum | No cropping. | 
| CIRCLE | Enum | Crop to a circle shape. | 
InputType 
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. | 
KeyValue 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set |  | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set |  | Sets an action that composes a draft email when the object is clicked. | 
| set |  | Sets an action that executes when the object is clicked. | 
| set |  | Sets an action that opens a URL in a tab when the object is clicked. | 
| set |  | Sets a URL to be opened when the object is clicked. | 
LinkPreview 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
| set | Link | Sets the title that displays in the link preview above the preview card. | 
| set | Link | Sets the card that displays information about a link from a third-party or non-Google service. | 
| set | Link | Sets the title that displays in the smart chip for the link preview. | 
LoadIndicator 
Properties
| Property | Type | Description | 
|---|---|---|
| SPINNER | Enum | Use a spinner indicator. | 
| NONE | Enum | Do not use an indicator. | 
MaterialIcon 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Material | Whether the icon renders as filled. | 
| set | Material | Weight and grade affect a symbol’s thickness. | 
| set | Material | Sets the name of the icon. | 
| set | Material | The stroke weight of the icon. | 
Navigation
Methods
| Method | Return type | Brief description | 
|---|---|---|
| pop | Navigation | Pops a card from the navigation stack. | 
| pop | Navigation | Pops to the specified card by its card name. | 
| pop | Navigation | Pops the card stack to the root card. | 
| print | String | Prints the JSON representation of this object. | 
| push | Navigation | Pushes the given card onto the stack. | 
| update | Navigation | Does an in-place replacement of the current card. | 
Notification
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Notification | Sets the text to show in the notification. | 
OnClose 
Properties
| Property | Type | Description | 
|---|---|---|
| NOTHING | Enum | Do nothing on close. | 
| RELOAD | Enum | Reloads the add-on on when the window closes. | 
OpenAs 
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. | 
OpenLink 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Open | Sets the behavior of the URL action when the URL window or tab is closed. | 
| set | Open | Sets the behavior of URL when it is opened. | 
| set | Open | Sets the URL to be opened. | 
OverflowMenu 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Overflow | Adds a menu item. | 
OverflowMenuItem  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Overflow | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Overflow | Sets an action that composes a draft email when the object is clicked. | 
| set | Overflow | Sets whether the menu item is disabled. | 
| set | Overflow | Sets an action that executes when the object is clicked. | 
| set | Overflow | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Overflow | Sets a URL to be opened when the object is clicked. | 
| set | Overflow | Sets the menu item's leading icon. | 
| set | Overflow | Sets the title of the menu item. | 
PlatformDataSource  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Platform | Sets the data source from Google Workspace. | 
| set | Platform | Used to populate spaces in multiselect menu. | 
ResponseType 
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. | 
SelectionInput 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Selection | Adds a new item that can be selected. | 
| add | Selection | Adds a new item that can be selected, for multi-select menus. | 
| set | Selection | Sets external data source, such as a relational data base. | 
| set | Selection | Sets the key that identifies this selection input in the event object that is generated when there is a UI interaction. | 
| set | Selection | Sets the maximum number of items that a user can select. | 
| set | Selection | Sets the number of text characters that a user inputs before the app queries autocomplete and displays suggested items on the card. | 
| set | Selection | Sets an Actionto be performed whenever the selection input changes. | 
| set | Selection | Sets a data source from Google Workspace. | 
| set | Selection | Sets the title to be shown ahead of the input field. | 
| set | Selection | Sets the type of this input. | 
SelectionInputType  
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 | 
|---|---|---|
| add | Suggestions | Add a text suggestion. | 
| add | Suggestions | Add a list of text suggestions. | 
SuggestionsResponse 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
SuggestionsResponseBuilder  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Suggestions | Builds the current suggestions response and validates it. | 
| set | Suggestions | Sets the suggestions used in auto complete in text fields. | 
Switch
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Switch | Sets the control type of the switch. | 
| set | Switch | Sets the key that identifies this switch in the event object that is generated when there is a UI interaction. | 
| set | Switch | Sets the action to take when the switch is toggled. | 
| set | Switch | Sets whether this switch should start as selected or unselected. | 
| set | Switch | Sets the value that is sent as the form input when this switch is toggled on. | 
SwitchControlType  
Properties
| Property | Type | Description | 
|---|---|---|
| SWITCH | Enum | Toggle-styled control for a switch widget. | 
| CHECK_BOX | Enum | Checkbox-styled control for a switch widget. | 
TextButton 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Text | Sets the alternative text of the button for accessibility. | 
| set | Text | Sets an authorization action that opens a URL to the authorization flow when the object is clicked. | 
| set | Text | Sets the background color for Textbutton. | 
| set | Text | Sets an action that composes a draft email when the object is clicked. | 
| set | Text | Sets whether the button is disabled. | 
| set | Text | Sets a predefined Iconto display on the button. | 
| set | Text | Sets the URL of an image to use as this button's icon. | 
| set | Text | Sets the material design icon. | 
| set | Text | Sets an action that executes when the object is clicked. | 
| set | Text | Sets an action that opens a URL in a tab when the object is clicked. | 
| set | Text | Sets a URL to be opened when the object is clicked. | 
| set | Text | Sets a pop-up menu to be opened when the object is clicked. | 
| set | Text | Sets the text that displays on the button. | 
| set | Text | Sets the button style. | 
TextButtonStyle  
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. | 
TextInput 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Text | Sets the key that identifies this text input in the event object that is generated when there is a UI interaction. | 
| set | Text | Sets a hint for the text input. | 
| set | Text | Sets a data source from Google Workspace applications. | 
| set | Text | Sets whether the input text shows on one line or multiple lines. | 
| set | Text | Sets an action to be performed whenever the text input changes. | 
| set | Text | Sets the suggestions for autocompletion in the text field. | 
| set | Text | Sets the callback action to fetch suggestions based on user input for autocompletion. | 
| set | Text | Sets the title to be shown above the input field. | 
| set | Text | Sets the validation rule for this widget. | 
| set | Text | Sets the pre-filled value to be set in the input field. | 
TextParagraph 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Text | Sets the maximum number of lines of text that are displayed in the widget. | 
| set | Text | Sets the text of the paragraph. | 
TimePicker 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Time | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. | 
| set | Time | Sets the prefilled hours value to set in the input field. | 
| set | Time | Sets the prefilled minutes value to set in the input field. | 
| set | Time | Sets an Actionthat the script performs whenever the picker input changes. | 
| set | Time | Sets the title displayed above the input field. | 
Trigger
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Trigger | Sets the action rule id for the trigger. | 
UniversalActionResponse  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
UniversalActionResponseBuilder   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Universal | Builds the current universal action response and validates it. | 
| display | Universal | Displays the add-on with the specified cards. | 
| set | Universal | Sets the URL to open when the universal action is selected. | 
UpdateDraftActionResponse   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| print | String | Prints the JSON representation of this object. | 
UpdateDraftActionResponseBuilder    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| build() | Update | Builds the current update draft action response and validates it. | 
| set | Update | Sets an action that updates the email Bcc recipients of a draft. | 
| set | Update | Set an action that updates the email body of a draft. | 
| set | Update | Sets an action that updates the Cc recipients of a draft. | 
| set | Update | Sets an action that updates the subject line of a draft. | 
| set | Update | Sets an action that updates the To recipients of a draft. | 
UpdateDraftBccRecipientsAction    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Update | Updates the Bcc recipients of an email draft. | 
UpdateDraftBodyAction   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Update | Adds the specified content to the draft body. | 
| set | Update | Sets the Updateof this update action on the draft body. | 
UpdateDraftBodyType   
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. | 
UpdateDraftCcRecipientsAction    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Update | Updates the Cc recipients of an email draft. | 
UpdateDraftSubjectAction   
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Update | Updates the subject line of an email draft. | 
UpdateDraftToRecipientsAction    
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Update | Updates the To recipients of an email draft. | 
UpdateVisibilityAction  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Update | Sets the visibility of widgets to visible or hidden. | 
UpdatedWidget 
Methods
| Method | Return type | Brief description | 
|---|---|---|
| add | Updated | Adds a new item that can be selected. | 
Validation
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Validation | Sets the character limit of the widget. | 
| set | Validation | Sets the input type of the widget. | 
VariableButtonSize  
Properties
| Property | Type | Description | 
|---|---|---|
| UNSPECIFIED | Enum | Automatically chooses COMPACTfor Sidepanel, choosesFULL_SIZEotherwise. | 
| COMPACT | Enum | For buttons labeled `+` | 
| FULL_SIZE | Enum | For buttons labeled `+ variable` | 
VerticalAlignment 
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
WorkflowDataSource  
Methods
| Method | Return type | Brief description | 
|---|---|---|
| set | Workflow | Whether to include variables from the previous step in the data source. | 
| set | Workflow | Sets the type of the workflow data source. | 
| set | Workflow | Sets the label of the variable picker button, which will be displayed after the `+` sign in FULL_SIZE button size. | 
| set | 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. | 
WorkflowDataSourceType   
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. | 
WrapStyle 
Properties
| Property | Type | Description | 
|---|---|---|
| NOWRAP | Enum | No wrapping. | 
| WRAP | Enum | Wraps the content for any widgets in a column. |