Card Service
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. |
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. |
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. |
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. |
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. |
Updated
|
The response of the updated widget. |
Validation
|
An object that defines the validation rule for the widget that it is attached to. |
Vertical
|
An enum that sets the vertical alignment of widgets in a column. |
Widget
|
Base class for all widgets that can be added to a Card
. |
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. |
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. |
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. |
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. |
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
|
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. |
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. |
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. |
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 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. |
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. |
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. |
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. |
Widget
Wrap
Style
Properties
Property | Type | Description |
---|---|---|
NOWRAP
|
Enum
|
No wrapping. |
WRAP
|
Enum
|
Wraps the content for any widgets in a column. |