@google-apps/chat 0.19.1 → 0.20.0

package/build/protos/google/apps/card/v1/card.proto

@@ -27,7 +27,7 @@ option php_namespace = "Google\\Apps\\Card\\V1";
 option ruby_package = "Google::Apps::Card::V1";
 
 // A card interface displayed in a Google Chat message or Google Workspace
-// Add-on.
+// add-on.
 //
 // Cards support a defined layout, interactive UI elements like buttons, and
 // rich media like images. Use cards to present detailed information,
@@ -40,9 +40,13 @@ option ruby_package = "Google::Apps::Card::V1";
 //
 // * For Google Chat apps, see [Design the components of a card or
 //   dialog](https://developers.google.com/workspace/chat/design-components-card-dialog).
-// * For Google Workspace Add-ons, see [Card-based
+// * For Google Workspace add-ons, see [Card-based
 // interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards).
 //
+// Note: You can add up to 100 widgets per card. Any widgets beyond this
+// limit are ignored. This limit applies to both card messages and dialogs
+// in Google Chat apps, and to cards in Google Workspace add-ons.
+//
 // **Example: Card message for a Google Chat app**
 //
 // ![Example contact
@@ -134,7 +138,7 @@ message Card {
   // Represents a card header. For an example in Google Chat apps, see [Add a
   // header](https://developers.google.com/workspace/chat/design-components-card-dialog#add_a_header).
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message CardHeader {
     // Required. The title of the card header.
@@ -149,7 +153,7 @@ message Card {
 
     // The shape used to crop the image.
     //
-    // [Google Workspace Add-ons and Chat
+    // [Google Workspace add-ons and Chat
     // apps](https://developers.google.com/workspace/extend):
     Widget.ImageType image_type = 3;
 
@@ -163,7 +167,7 @@ message Card {
   // A section contains a collection of widgets that are rendered
   // vertically in the order that they're specified.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message Section {
     // Text that appears at the top of a section.
@@ -174,7 +178,7 @@ message Card {
     // and
     // [Formatting
     // text in Google Workspace
-    // Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
+    // add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
     string header = 1;
 
     // All the widgets in the section.
@@ -200,21 +204,27 @@ message Card {
     // by default. The `uncollapsibleWidgetsCount` is taken into account only
     // when `collapsible` is `true`.
     int32 uncollapsible_widgets_count = 6;
+
+    // Optional. Define the expand and collapse button of the section.
+    // This button will be shown only if the section is collapsible.
+    // If this field isn't set, the default button is used.
+    CollapseControl collapse_control = 8;
   }
 
   // The divider style of a card. Currently only used for dividers betweens card
   // sections.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   enum DividerStyle {
     // Don't use. Unspecified.
     DIVIDER_STYLE_UNSPECIFIED = 0;
 
-    // Default option. Render a solid divider between sections.
+    // Default option. Render a solid divider.
     SOLID_DIVIDER = 1;
 
-    // If set, no divider is rendered between sections.
+    // If set, no divider is rendered. This style completely removes the divider
+    // from the layout. The result is equivalent to not adding a divider at all.
     NO_DIVIDER = 2;
   }
 
@@ -223,7 +233,7 @@ message Card {
   // invoice, or open the invoice in a browser.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   message CardAction {
     // The label that displays as the action menu item.
     string action_label = 1;
@@ -232,6 +242,22 @@ message Card {
     OnClick on_click = 2;
   }
 
+  // A list of widgets that can be displayed in a containing layout, such
+  // as a `CarouselCard`.
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  message NestedWidget {
+    oneof data {
+      // A text paragraph widget.
+      TextParagraph text_paragraph = 1;
+
+      // A button list widget.
+      ButtonList button_list = 3;
+
+      // An image widget.
+      Image image = 10;
+    }
+  }
+
   // A persistent (sticky) footer that that appears at the bottom of the card.
   //
   // Setting `fixedFooter` without specifying a `primaryButton` or a
@@ -244,7 +270,7 @@ message Card {
   // For an example in Google Chat apps, see [Add a persistent
   // footer](https://developers.google.com/workspace/chat/design-components-card-dialog#add_a_persistent_footer).
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message CardFixedFooter {
     // The primary button of the fixed footer. The button must be a text button
@@ -257,11 +283,11 @@ message Card {
     Button secondary_button = 2;
   }
 
-  // In Google Workspace Add-ons,
+  // In Google Workspace add-ons,
   // determines how a card is displayed.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   enum DisplayStyle {
     // Don't use. Unspecified.
     DISPLAY_STYLE_UNSPECIFIED = 0;
@@ -287,13 +313,13 @@ message Card {
   // card](https://developers.google.com/workspace/chat/design-components-card-dialog#define_a_section_of_a_card).
   repeated Section sections = 2;
 
-  // The divider style between sections.
+  // The divider style between the header, sections and footer.
   DividerStyle section_divider_style = 9;
 
   // The card's actions. Actions are added to the card's toolbar menu.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   //
   // For example, the following JSON constructs a card action menu with
   // `Settings` and `Send Feedback` options:
@@ -330,7 +356,7 @@ message Card {
   // Name of the card. Used as a card identifier in card navigation.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   string name = 4;
 
   // The fixed footer shown at the bottom of this card.
@@ -342,15 +368,15 @@ message Card {
   // [card
   // messages](https://developers.google.com/workspace/chat/create-messages#create).
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   CardFixedFooter fixed_footer = 5;
 
-  // In Google Workspace Add-ons, sets the display properties of the
+  // In Google Workspace add-ons, sets the display properties of the
   // `peekCardHeader`.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   DisplayStyle display_style = 6;
 
   // When displaying contextual content, the peek card header acts as a
@@ -358,7 +384,7 @@ message Card {
   // cards and the contextual cards.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   CardHeader peek_card_header = 7;
 }
 
@@ -369,7 +395,7 @@ message Card {
 message Widget {
   // The shape used to crop the image.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   enum ImageType {
     // Default value. Applies a square mask to the image. For example, a 4x3
@@ -402,6 +428,21 @@ message Widget {
     END = 3;
   }
 
+  // Represents vertical alignment attribute.
+  enum VerticalAlignment {
+    // Unspecified type. Do not use.
+    VERTICAL_ALIGNMENT_UNSPECIFIED = 0;
+
+    // Alignment to the top position.
+    TOP = 1;
+
+    // Alignment to the middle position.
+    MIDDLE = 2;
+
+    // Alignment to the bottom position.
+    BOTTOM = 3;
+  }
+
   // A widget can only have one of the following items. You can use multiple
   // widget fields to display more items.
   oneof data {
@@ -412,7 +453,7 @@ message Widget {
     // and
     // [Formatting
     // text in Google Workspace
-    // Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
+    // add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
     //
     // For example, the following JSON creates a bolded text:
     // ```
@@ -470,7 +511,6 @@ message Widget {
     //         "red": 0,
     //         "green": 0,
     //         "blue": 1,
-    //         "alpha": 1
     //       },
     //       "disabled": true,
     //     },
@@ -576,7 +616,7 @@ message Widget {
     //   "name": "appointment_time",
     //   "label": "Book your appointment at:",
     //   "type": "DATE_AND_TIME",
-    //   "valueMsEpoch": "796435200000"
+    //   "valueMsEpoch": 796435200000
     // }
     // ```
     DateTimePicker date_time_picker = 7;
@@ -597,7 +637,7 @@ message Widget {
     // of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11
     // items and 2 columns has 6 rows.
     //
-    // [Google Workspace Add-ons and
+    // [Google Workspace add-ons and
     // Chat apps](https://developers.google.com/workspace/extend):
     //
     // For example, the following JSON creates a 2 column grid with a single
@@ -673,6 +713,56 @@ message Widget {
     // }
     // ```
     Columns columns = 11;
+
+    // A carousel contains a collection of nested widgets.
+    // For example, this is a JSON representation of a carousel that contains
+    // two text paragraphs.
+    //
+    // ```
+    // {
+    //   "widgets": [
+    //     {
+    //       "textParagraph": {
+    //         "text": "First text paragraph in the carousel."
+    //       }
+    //     },
+    //     {
+    //       "textParagraph": {
+    //         "text": "Second text paragraph in the carousel."
+    //       }
+    //     }
+    //   ]
+    // }
+    // ```
+    Carousel carousel = 13;
+
+    // A list of chips.
+    //
+    // For example, the following JSON creates two chips. The first
+    // is a text chip and the second is an icon chip that opens a
+    // link:
+    // ```
+    // "chipList": {
+    //   "chips": [
+    //     {
+    //       "text": "Edit",
+    //       "disabled": true,
+    //     },
+    //     {
+    //       "icon": {
+    //         "knownIcon": "INVITE",
+    //         "altText": "check calendar"
+    //       },
+    //       "onClick": {
+    //         "openLink": {
+    //           "url": "https://example.com/calendar"
+    //         }
+    //       }
+    //     }
+    //   ]
+    // }
+    // ```
+    ChipList chip_list = 14;
   }
 
   // Specifies whether widgets align to the left, right, or center of a column.
@@ -689,20 +779,49 @@ message Widget {
 // and
 // [Formatting
 // text in Google Workspace
-// Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
+// add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
 //
-// [Google Workspace Add-ons and
+// [Google Workspace add-ons and
 // Chat apps](https://developers.google.com/workspace/extend):
 message TextParagraph {
+  // Syntax to use for formatting text.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  enum TextSyntax {
+    // The text is rendered as HTML if unspecified.
+    TEXT_SYNTAX_UNSPECIFIED = 0;
+
+    // The text is rendered as HTML. This is the default value.
+    HTML = 1;
+
+    // The text is rendered as Markdown.
+    MARKDOWN = 2;
+  }
+
   // The text that's shown in the widget.
   string text = 1;
+
+  // The maximum number of lines of text that are displayed in the widget. If
+  // the text exceeds the specified maximum number of lines, the excess
+  // content is concealed behind a **show more** button. If the text is equal or
+  // shorter than the specified maximum number of lines, a **show more** button
+  // isn't displayed.
+  //
+  // The default value is 0, in which case
+  // all context is displayed. Negative values are ignored.
+  int32 max_lines = 2;
+
+  // The syntax of the text. If not set, the text is rendered as HTML.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  TextSyntax text_syntax = 4;
 }
 
 // An image that is specified by a URL and can have an `onClick` action. For an
 // example, see [Add an
 // image](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_an_image).
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message Image {
   // The HTTPS URL that hosts the image.
@@ -726,7 +845,7 @@ message Image {
 // [Add a horizontal divider between
 // widgets](https://developers.google.com/workspace/chat/format-structure-card-dialog#add_a_horizontal_divider_between_widgets).
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 //
 // For example, the following JSON creates a divider:
@@ -742,19 +861,19 @@ message Divider {}
 // Google Chat apps, see [Display text with decorative
 // text](https://developers.google.com/workspace/chat/add-text-image-card-dialog#display_text_with_decorative_elements).
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message DecoratedText {
   // Either a toggle-style switch or a checkbox inside a `decoratedText` widget.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   //
   // Only supported in the `decoratedText` widget.
   message SwitchControl {
     // How the switch appears in the user interface.
     //
-    // [Google Workspace Add-ons
+    // [Google Workspace add-ons
     // and Chat apps](https://developers.google.com/workspace/extend):
     enum ControlType {
       // A toggle-style switch.
@@ -788,7 +907,7 @@ message DecoratedText {
 
     // How the switch appears in the user interface.
     //
-    // [Google Workspace Add-ons
+    // [Google Workspace add-ons
     // and Chat apps](https://developers.google.com/workspace/extend):
     ControlType control_type = 5;
   }
@@ -799,9 +918,21 @@ message DecoratedText {
   // The icon displayed in front of the text.
   Icon start_icon = 12;
 
+  // Optional. Vertical alignment of the start icon. If not set, the icon
+  // will be vertically centered.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  Widget.VerticalAlignment start_icon_vertical_alignment = 13;
+
   // The text that appears above `text`. Always truncates.
   string top_label = 3;
 
+  // `TextParagraph` equivalent of `top_label`. Always truncates. Allows for
+  // more complex formatting than `top_label`.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  TextParagraph top_label_text = 17;
+
   // Required. The primary text.
   //
   // Supports simple formatting. For more information
@@ -811,9 +942,15 @@ message DecoratedText {
   // and
   // [Formatting
   // text in Google Workspace
-  // Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
+  // add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
   string text = 4;
 
+  // `TextParagraph` equivalent of `text`. Allows for more complex formatting
+  // than `text`.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  TextParagraph content_text = 18;
+
   // The wrap text setting. If `true`, the text wraps and displays on
   // multiple lines. Otherwise, the text is truncated.
   //
@@ -823,6 +960,12 @@ message DecoratedText {
   // The text that appears below `text`. Always wraps.
   string bottom_label = 6;
 
+  // `TextParagraph` equivalent of `bottom_label`. Always wraps. Allows for
+  // more complex formatting than `bottom_label`.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  TextParagraph bottom_label_text = 19;
+
   // This action is triggered when users click `topLabel` or `bottomLabel`.
   OnClick on_click = 7;
 
@@ -848,8 +991,11 @@ message DecoratedText {
 }
 
 // A field in which users can enter text. Supports suggestions and on-change
-// actions. For an example in Google Chat apps, see [Add a field in which a user
-// can enter
+// actions.
+// Supports form submission validation. When `Action.all_widgets_are_required`
+// is set to `true` or this widget is specified in `Action.required_widgets`,
+// the submission action is blocked unless a value is entered. For an example in
+// Google Chat apps, see [Add a field in which a user can enter
 // text](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text).
 //
 // Chat apps receive and can process the value of entered text during form input
@@ -860,7 +1006,7 @@ message DecoratedText {
 // use a text input. To collect defined or enumerated data from users, use the
 // [SelectionInput][google.apps.card.v1.SelectionInput] widget.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message TextInput {
   // How a text input field appears in the user interface. For example,
@@ -868,7 +1014,7 @@ message TextInput {
   // `initialSuggestions` is specified, `type` is always `SINGLE_LINE`,
   // even if it's set to `MULTIPLE_LINE`.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   enum Type {
     // The text input field has a fixed height of one line.
@@ -934,7 +1080,7 @@ message TextInput {
   // to `MULTIPLE_LINE`.
   //
   // [Google Workspace
-  // Add-ons and Chat apps](https://developers.google.com/workspace/extend):
+  // add-ons and Chat apps](https://developers.google.com/workspace/extend):
   Suggestions initial_suggestions = 7;
 
   // Optional. Specify what action to take when the text input field provides
@@ -947,9 +1093,15 @@ message TextInput {
   // a custom function.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   Action auto_complete_action = 8;
 
+  // Specify the input format validation necessary for this text field.
+  //
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend):
+  Validation validation = 11;
+
   // Text that appears in the text input field when the field is empty.
   // Use this text to prompt users to enter a value. For example, `Enter a
   // number from 0 to 100`.
@@ -975,11 +1127,11 @@ message TextInput {
 // to `MULTIPLE_LINE`.
 //
 // [Google Workspace
-// Add-ons and Chat apps](https://developers.google.com/workspace/extend):
+// add-ons and Chat apps](https://developers.google.com/workspace/extend):
 message Suggestions {
   // One suggested value that users can enter in a text input field.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message SuggestionItem {
     oneof content {
@@ -999,7 +1151,7 @@ message Suggestions {
 // [Add a
 // button](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_button).
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message ButtonList {
   // An array of buttons.
@@ -1007,9 +1159,12 @@ message ButtonList {
 }
 
 // A widget that creates one or more UI items that users can select.
-// For example, a dropdown menu or checkboxes. You can use this widget to
-// collect data that can be predicted or enumerated. For an example in Google
-// Chat apps, see [Add selectable UI
+// Supports form submission validation for `dropdown` and `multiselect` menus
+// only. When `Action.all_widgets_are_required` is set to `true` or this widget
+// is specified in `Action.required_widgets`, the submission action is blocked
+// unless a value is selected. For example, a dropdown menu or checkboxes. You
+// can use this widget to collect data that can be predicted or enumerated. For
+// an example in Google Chat apps, see [Add selectable UI
 // elements](/workspace/chat/design-interactive-card-dialog#add_selectable_ui_elements).
 //
 // Chat apps can process the value of items that users select or input. For
@@ -1019,7 +1174,7 @@ message ButtonList {
 // To collect undefined or abstract data from users, use
 // the [TextInput][google.apps.card.v1.TextInput] widget.
 //
-// [Google Workspace Add-ons
+// [Google Workspace add-ons
 // and Chat apps](https://developers.google.com/workspace/extend):
 message SelectionInput {
   // The format for the items that users can select. Different options support
@@ -1029,7 +1184,7 @@ message SelectionInput {
   // Each selection input supports one type of selection. Mixing checkboxes
   // and switches, for example, isn't supported.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   enum SelectionType {
     // A set of checkboxes. Users can select one or more checkboxes.
@@ -1044,36 +1199,34 @@ message SelectionInput {
     // A dropdown menu. Users can select one item from the menu.
     DROPDOWN = 3;
 
-    // A multiselect menu for static or dynamic data. From the menu bar,
-    // users select one or more items. Users can also input values to populate
-    // dynamic data. For example, users can start typing the name of a Google
-    // Chat space and the widget autosuggests the space.
+    // A menu with a text box. Users can type and select one or more items.
+    // For Google Workspace add-ons, you must populate items using a static
+    // array of `SelectionItem` objects.
     //
-    // To populate items for a multiselect menu, you can use one of the
-    // following types of data sources:
+    // For Google Chat apps, you can also populate items using a dynamic data
+    // source and autosuggest items as users type in the menu. For example,
+    // users can start typing the name of a Google Chat space and the widget
+    // autosuggests the space. To dynamically populate items for a multiselect
+    // menu, use one of the following types of data sources:
     //
-    //  * Static data: Items are specified as `SelectionItem` objects in the
-    //    widget. Up to 100 items.
     //  * Google Workspace data: Items are populated using data from Google
     //    Workspace, such as Google Workspace users or Google Chat spaces.
     //  * External data: Items are populated from an external data
     //    source outside of Google Workspace.
     //
-    // For examples of how to implement multiselect menus, see
+    // For examples of how to implement multiselect menus for Chat apps, see
     // [Add a multiselect
     // menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu).
     //
-    // [Google Workspace Add-ons and Chat
+    // [Google Workspace add-ons and Chat
     // apps](https://developers.google.com/workspace/extend):
-    // Multiselect for Google Workspace Add-ons are in
-    // Developer Preview.
     MULTI_SELECT = 4;
   }
 
   // An item that users can select in a selection input, such as a checkbox
-  // or switch.
+  // or switch. Supports up to 100 items.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message SelectionItem {
     // The text that identifies or describes the item to users.
@@ -1095,7 +1248,9 @@ message SelectionInput {
     // the item's `text` field. Supports PNG and JPEG files. Must be an `HTTPS`
     // URL. For example,
     // `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`.
-    string start_icon_uri = 4;
+    oneof start_icon {
+      string start_icon_uri = 4;
+    }
 
     // For multiselect menus, a text description or label that's
     // displayed below the item's `text` field.
@@ -1131,7 +1286,8 @@ message SelectionInput {
     }
   }
 
-  // The name that identifies the selection input in a form input event.
+  // Required. The name that identifies the selection input in a form input
+  // event.
   //
   // For details about working with form inputs, see [Receive form
   // data](https://developers.google.com/workspace/chat/read-form-data).
@@ -1164,22 +1320,26 @@ message SelectionInput {
 
   // For multiselect menus, the maximum number of items that a user can select.
   // Minimum value is 1 item. If unspecified, defaults to 3 items.
-  int32 multi_select_max_selected_items = 6;
+  optional int32 multi_select_max_selected_items = 6;
 
   // For multiselect menus, the number of text characters that a user inputs
-  // before the app queries autocomplete and displays suggested items
-  // in the menu.
+  // before the menu returns suggested selection items.
+  //
+  // If unset, the multiselect menu uses the following default values:
   //
-  // If unspecified, defaults to 0 characters for static data sources and 3
-  // characters for external data sources.
+  // * If the menu uses a static array of `SelectionInput` items, defaults to
+  //   0 characters and immediately populates items from the array.
+  // * If the menu uses a dynamic data source (`multi_select_data_source`),
+  //  defaults to 3 characters before querying the data source to return
+  //  suggested items.
   int32 multi_select_min_query_length = 7;
 
-  // For a multiselect menu, the data source that populates
+  // For a multiselect menu, a data source that dynamically populates
   // selection items.
   //
   // [Google Chat apps](https://developers.google.com/workspace/chat):
   oneof multi_select_data_source {
-    // An external data source, such as a relational data base.
+    // An external data source, such as a relational database.
     Action external_data_source = 8;
 
     // A data source from Google Workspace.
@@ -1187,8 +1347,11 @@ message SelectionInput {
   }
 }
 
-// Lets users input a date, a time, or both a date and a time. For an example in
-// Google Chat apps, see [Let a user pick a date and
+// Lets users input a date, a time, or both a date and a time.
+// Supports form submission validation. When `Action.all_widgets_are_required`
+// is set to `true` or this widget is specified in `Action.required_widgets`,
+// the submission action is blocked unless a value is selected. For an example
+// in Google Chat apps, see [Let a user pick a date and
 // time](https://developers.google.com/workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time).
 //
 // Users can input text or use the picker to select dates and times. If users
@@ -1196,12 +1359,12 @@ message SelectionInput {
 // to input the information correctly.
 //
 // [Google Workspace
-// Add-ons and Chat apps](https://developers.google.com/workspace/extend):
+// add-ons and Chat apps](https://developers.google.com/workspace/extend):
 message DateTimePicker {
   // The format for the date and time in the `DateTimePicker` widget.
   // Determines whether users can input a date, a time, or both a date and time.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   enum DateTimePickerType {
     // Users input a date and time.
@@ -1228,8 +1391,8 @@ message DateTimePicker {
   // Whether the widget supports inputting a date, a time, or the date and time.
   DateTimePickerType type = 3;
 
-  // The default value displayed in the widget, in milliseconds since [Unix
-  // epoch time](https://en.wikipedia.org/wiki/Unix_time).
+  // Optional. The default value displayed in the widget, in milliseconds since
+  // [Unix epoch time](https://en.wikipedia.org/wiki/Unix_time).
   //
   // Specify the value based on the type of picker (`DateTimePickerType`):
   //
@@ -1239,7 +1402,7 @@ message DateTimePicker {
   //   January 1, 2023, use `1672531200000`.
   // * `TIME_ONLY`: a time in UTC. For example, to represent 12:00 PM, use
   //   `43200000` (or `12 * 60 * 60 * 1000`).
-  int64 value_ms_epoch = 4;
+  optional int64 value_ms_epoch = 4;
 
   // The number representing the time zone offset from UTC, in minutes.
   // If set, the `value_ms_epoch` is displayed in the specified time zone.
@@ -1251,6 +1414,40 @@ message DateTimePicker {
   Action on_change_action = 6;
 }
 
+// A widget that presents a pop-up menu with one or more actions that users can
+// invoke. For example, showing non-primary actions in a card. You can use this
+// widget when actions don't fit in the available space. To use, specify this
+// widget in the `OnClick` action of widgets that support it. For example, in a
+// `Button`.
+//
+// [Google Workspace add-ons and Chat
+// apps](https://developers.google.com/workspace/extend):
+message OverflowMenu {
+  // An option that users can invoke in an overflow menu.
+  //
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend):
+  message OverflowMenuItem {
+    // The icon displayed in front of the text.
+    Icon start_icon = 1;
+
+    // Required. The text that identifies or describes the item to users.
+    string text = 2;
+
+    // Required. The action invoked when a menu option is selected.
+    // This `OnClick` cannot contain an `OverflowMenu`, any specified
+    // `OverflowMenu` is dropped and the menu item disabled.
+    OnClick on_click = 3;
+
+    // Whether the menu option is disabled.
+    // Defaults to false.
+    bool disabled = 4;
+  }
+
+  // Required. The list of menu options.
+  repeated OverflowMenuItem items = 1;
+}
+
 // A text, icon, or text and icon button that users can click. For an example in
 // Google Chat apps, see
 // [Add a
@@ -1262,47 +1459,68 @@ message DateTimePicker {
 // `onClick` action.
 //
 // [Google Workspace
-// Add-ons and Chat apps](https://developers.google.com/workspace/extend):
+// add-ons and Chat apps](https://developers.google.com/workspace/extend):
 message Button {
+  // Optional. The
+  // [type](https://m3.material.io/components/all-buttons#9134ac95-678e-49ae-a50a-e71948011b05)
+  // of a button. If `color` field is set, the `type` is forced to `FILLED`.
+  //
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  enum Type {
+    // Don't use. Unspecified.
+    TYPE_UNSPECIFIED = 0;
+
+    // Outlined buttons are medium-emphasis buttons. They usually contain
+    // actions that are important, but aren’t the primary action in a Chat app
+    // or an add-on.
+    OUTLINED = 1;
+
+    // A filled button has a container with a solid color. It has the most
+    // visual impact and is recommended for the important and primary action in
+    // a Chat app or an add-on.
+    FILLED = 2;
+
+    // A filled tonal button is an alternative middle ground between filled and
+    // outlined buttons. They’re useful in contexts where a lower-priority
+    // button requires slightly more emphasis than an outline button would give.
+    FILLED_TONAL = 3;
+
+    // A button does not have an invisible container in its default state. It is
+    // often used for the lowest priority actions, especially when presenting
+    // multiple options.
+    BORDERLESS = 4;
+  }
+
   // The text displayed inside the button.
   string text = 1;
 
-  // The icon image. If both `icon` and `text` are set, then the icon appears
-  // before the text.
+  // An icon displayed inside the button. If both `icon` and `text` are set,
+  // then the icon appears before the text.
   Icon icon = 2;
 
-  // If set, the button is filled with a solid background color and the font
-  // color changes to maintain contrast with the background color. For example,
-  // setting a blue background likely results in white text.
-  //
-  // If unset, the image background is white and the font color is blue.
-  //
-  // For red, green, and blue, the value of each field is a `float` number that
-  // you can express in either of two ways: as a number between 0 and 255
-  // divided by 255 (153/255), or as a value between 0 and 1 (0.6). 0 represents
-  // the absence of a color and 1 or 255/255 represent the full presence of that
-  // color on the RGB scale.
+  // Optional. The color of the button. If set, the button `type` is set to
+  // `FILLED` and the color of `text` and `icon` fields are set to a
+  // contrasting color for readability. For example, if the button color is
+  // set to blue, any text or icons in the button are set to white.
   //
-  // Optionally set `alpha`, which sets a level of transparency using this
-  // equation:
-  //
-  // ```
-  // pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-  // ```
-  //
-  // For `alpha`, a value of `1` corresponds with a solid color, and a value of
-  // `0` corresponds with a completely transparent color.
+  // To set the button color, specify a value for the `red`, `green`, and `blue`
+  // fields.
+  // The value must be a float number between 0 and 1 based on the RGB color
+  // value, where `0` (0/255) represents the absence of color  and `1` (255/255)
+  // represents the maximum intensity of the color.
   //
-  // For example, the following color represents a half transparent red:
+  // For example, the following sets the color to red at its maximum intensity:
   //
   // ```
   // "color": {
   //    "red": 1,
   //    "green": 0,
   //    "blue": 0,
-  //    "alpha": 0.5
   // }
   // ```
+  //
+  // The `alpha` field is unavailable for button color. If specified, this field
+  // is ignored.
   google.type.Color color = 3;
 
   // Required. The action to perform when a user clicks the button, such as
@@ -1320,6 +1538,11 @@ message Button {
   // browser tab and navigates to the Google Chat developer documentation at
   // https://developers.google.com/workspace/chat".
   string alt_text = 6;
+
+  // Optional. The type of a button. If unset, button type defaults to
+  // `OUTLINED`. If the `color` field is set, the button type is forced to
+  // `FILLED` and any value set for this field is ignored.
+  Type type = 7;
 }
 
 // An icon displayed in a widget on a card. For an example in Google Chat apps,
@@ -1332,7 +1555,7 @@ message Button {
 // [custom](https://developers.google.com/workspace/chat/format-messages#customicons)
 // icons.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message Icon {
   // The icon displayed in the widget on the card.
@@ -1445,7 +1668,7 @@ message MaterialIcon {
 
 // Represents the crop style applied to an image.
 //
-// [Google Workspace Add-ons and
+// [Google Workspace add-ons and
 // Chat apps](https://developers.google.com/workspace/extend):
 //
 // For example, here's how to apply a 16:9 aspect ratio:
@@ -1459,7 +1682,7 @@ message MaterialIcon {
 message ImageCropStyle {
   // Represents the crop style applied to an image.
   //
-  // [Google Workspace Add-ons
+  // [Google Workspace add-ons
   // and Chat apps](https://developers.google.com/workspace/extend):
   enum ImageCropType {
     // Don't use. Unspecified.
@@ -1498,21 +1721,21 @@ message ImageCropStyle {
 // The style options for the border of a card or widget, including the border
 // type and color.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message BorderStyle {
   // Represents the border types applied to widgets.
   //
-  // [Google Workspace Add-ons
+  // [Google Workspace add-ons
   // and Chat apps](https://developers.google.com/workspace/extend):
   enum BorderType {
     // Don't use. Unspecified.
     BORDER_TYPE_UNSPECIFIED = 0;
 
-    // Default value. No border.
+    // No border.
     NO_BORDER = 1;
 
-    // Outline.
+    // Default value. Outline.
     STROKE = 2;
   }
 
@@ -1520,6 +1743,25 @@ message BorderStyle {
   BorderType type = 1;
 
   // The colors to use when the type is `BORDER_TYPE_STROKE`.
+  //
+  // To set the stroke color, specify a value for the `red`, `green`, and `blue`
+  // fields.
+  // The value must be a float number between 0 and 1 based on the RGB color
+  // value, where `0` (0/255) represents the absence of color  and `1` (255/255)
+  // represents the maximum intensity of the color.
+  //
+  // For example, the following sets the color to red at its maximum intensity:
+  //
+  // ```
+  // "color": {
+  //    "red": 1,
+  //    "green": 0,
+  //    "blue": 0,
+  // }
+  // ```
+  //
+  // The `alpha` field is unavailable for stroke color. If specified, this field
+  // is ignored.
   google.type.Color stroke_color = 2;
 
   // The corner radius for the border.
@@ -1528,7 +1770,7 @@ message BorderStyle {
 
 // Represents an image.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message ImageComponent {
   // The image URL.
@@ -1555,7 +1797,7 @@ message ImageComponent {
 // 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns
 // has 6 rows.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 //
 // For example, the following JSON creates a 2 column grid with a single
@@ -1595,12 +1837,12 @@ message Grid {
   // Represents an item in a grid layout. Items can contain text, an image, or
   // both text and an image.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message GridItem {
     // Represents the various layout options available for a grid item.
     //
-    // [Google Workspace Add-ons and Chat
+    // [Google Workspace add-ons and Chat
     // apps](https://developers.google.com/workspace/extend):
     enum GridItemLayout {
       // Don't use. Unspecified.
@@ -1673,29 +1915,28 @@ message Grid {
 // * On Android devices, the second column wraps if the screen width is
 //   less than or equal to 320 dp.
 //
-// To include more than 2 columns, or to use rows, use the
+// To include more than two columns, or to use rows, use the
 // [`Grid`][google.apps.card.v1.Grid] widget.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
-// Columns for Google Workspace Add-ons are in
-// Developer Preview.
+// The add-on UIs that support columns include:
+//
+// * The dialog displayed when users open the add-on from an email draft.
+// * The dialog displayed when users open the add-on from the
+// **Add attachment** menu in a Google Calendar event.
 message Columns {
   // A column.
   //
-  // [Google Workspace Add-ons and Chat
-  // apps](https://developers.google.com/workspace/extend):
-  // Columns for Google Workspace Add-ons are in
-  // Developer Preview.
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend)
   message Column {
     // Specifies how a column fills the width of the card. The width of each
     // column depends on both the `HorizontalSizeStyle` and the width of the
     // widgets within the column.
     //
-    // [Google Workspace Add-ons and Chat
-    // apps](https://developers.google.com/workspace/extend):
-    // Columns for Google Workspace Add-ons are in
-    // Developer Preview.
+    // [Google Workspace add-ons and Chat
+    // apps](https://developers.google.com/workspace/extend)
     enum HorizontalSizeStyle {
       // Don't use. Unspecified.
       HORIZONTAL_SIZE_STYLE_UNSPECIFIED = 0;
@@ -1713,10 +1954,8 @@ message Columns {
     // Specifies whether widgets align to the top, bottom, or center of a
     // column.
     //
-    // [Google Workspace Add-ons and Chat
-    // apps](https://developers.google.com/workspace/extend):
-    // Columns for Google Workspace Add-ons are in
-    // Developer Preview.
+    // [Google Workspace add-ons and Chat
+    // apps](https://developers.google.com/workspace/extend)
     enum VerticalAlignment {
       // Don't use. Unspecified.
       VERTICAL_ALIGNMENT_UNSPECIFIED = 0;
@@ -1733,10 +1972,8 @@ message Columns {
 
     // The supported widgets that you can include in a column.
     //
-    // [Google Workspace Add-ons and Chat
-    // apps](https://developers.google.com/workspace/extend):
-    // Columns for Google Workspace Add-ons are in
-    // Developer Preview.
+    // [Google Workspace add-ons and Chat
+    // apps](https://developers.google.com/workspace/extend)
     message Widgets {
       oneof data {
         // [TextParagraph][google.apps.card.v1.TextParagraph] widget.
@@ -1759,6 +1996,9 @@ message Columns {
 
         // [DateTimePicker][google.apps.card.v1.DateTimePicker] widget.
         DateTimePicker date_time_picker = 7;
+
+        // [ChipList][google.apps.card.v1.ChipList] widget.
+        ChipList chip_list = 8;
       }
     }
 
@@ -1782,10 +2022,89 @@ message Columns {
   repeated Column column_items = 2;
 }
 
+// A carousel, also known as a slider, rotates and displays a list of widgets in
+// a slideshow format, with buttons navigating to the previous or next widget.
+//
+// For example, this is a JSON representation of a carousel that contains three
+// text paragraph widgets.
+//
+// ```
+// {
+//   "carouselCards": [
+//     {
+//       "widgets": [
+//         {
+//           "textParagraph": {
+//             "text": "First text paragraph in carousel",
+//           }
+//         }
+//       ]
+//     },
+//     {
+//       "widgets": [
+//         {
+//           "textParagraph": {
+//             "text": "Second text paragraph in carousel",
+//           }
+//         }
+//       ]
+//     },
+//     {
+//       "widgets": [
+//         {
+//           "textParagraph": {
+//             "text": "Third text paragraph in carousel",
+//           }
+//         }
+//       ]
+//     }
+//   ]
+// }
+// ```
+//
+// [Google Chat apps](https://developers.google.com/workspace/chat):
+message Carousel {
+  // A card that can be displayed as a carousel item.
+  // [Google Chat apps](https://developers.google.com/workspace/chat):
+  message CarouselCard {
+    // A list of widgets displayed in the carousel card. The widgets are
+    // displayed in the order that they are specified.
+    repeated Card.NestedWidget widgets = 1;
+
+    // A list of widgets displayed at the bottom of the carousel card. The
+    // widgets are displayed in the order that they are specified.
+    repeated Card.NestedWidget footer_widgets = 2;
+  }
+
+  // A list of cards included in the carousel.
+  repeated CarouselCard carousel_cards = 4;
+}
+
+// Represent an expand and collapse control.
+//
+// [Google Workspace add-ons and Chat
+// apps](https://developers.google.com/workspace/extend):
+message CollapseControl {
+  // The horizontal alignment of the expand and collapse button.
+  Widget.HorizontalAlignment horizontal_alignment = 1;
+
+  // Optional. Define a customizable button to expand the section.
+  // Both expand_button and collapse_button field must be set. Only one
+  // field set will not take into effect.
+  // If this field isn't set, the default button is used.
+  Button expand_button = 2;
+
+  // Optional. Define a customizable button to collapse the section.
+  // Both expand_button and collapse_button field must be set. Only one
+  // field set will not take into effect.
+  // If this field isn't set, the default button is used.
+  Button collapse_button = 3;
+}
+
 // Represents how to respond when users click an interactive element on
 // a card, such as a button.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message OnClick {
   oneof data {
@@ -1801,20 +2120,23 @@ message OnClick {
     // web client to do before the open link action response comes back.
     //
     // [Google Workspace
-    // Add-ons](https://developers.google.com/workspace/add-ons):
+    // add-ons](https://developers.google.com/workspace/add-ons):
     Action open_dynamic_link_action = 3;
 
     // A new card is pushed to the card stack after clicking if specified.
     //
     // [Google Workspace
-    // Add-ons](https://developers.google.com/workspace/add-ons):
+    // add-ons](https://developers.google.com/workspace/add-ons):
     Card card = 4;
+
+    // If specified, this `onClick` opens an overflow menu.
+    OverflowMenu overflow_menu = 8;
   }
 }
 
 // Represents an `onClick` event that opens a hyperlink.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message OpenLink {
   // When an `OnClick` action opens a link, then the client can either open it
@@ -1824,7 +2146,7 @@ message OpenLink {
   // client doesn't support it. `FULL_SIZE` is supported by all clients.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   enum OpenAs {
     // The link opens as a full-size window (if that's the frame used by the
     // client).
@@ -1843,7 +2165,7 @@ message OpenLink {
   // can't support both values, `OnClose` takes precedence.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   enum OnClose {
     // Default value. The card doesn't reload; nothing happens.
     NOTHING = 0;
@@ -1863,14 +2185,14 @@ message OpenLink {
   // How to open a link.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   OpenAs open_as = 2;
 
   // Whether the client forgets about a link after opening it, or observes it
   // until the window closes.
   //
   // [Google Workspace
-  // Add-ons](https://developers.google.com/workspace/add-ons):
+  // add-ons](https://developers.google.com/workspace/add-ons):
   OnClose on_close = 3;
 }
 
@@ -1878,7 +2200,7 @@ message OpenLink {
 // For example, you can invoke an Apps Script script to handle the form.
 // If the action is triggered, the form values are sent to the server.
 //
-// [Google Workspace Add-ons and Chat
+// [Google Workspace add-ons and Chat
 // apps](https://developers.google.com/workspace/extend):
 message Action {
   // List of string parameters to supply when the action method is invoked.
@@ -1889,7 +2211,7 @@ message Action {
   // To learn more, see
   // [`CommonEventObject`](https://developers.google.com/workspace/chat/api/reference/rest/v1/Event#commoneventobject).
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   message ActionParameter {
     // The name of the parameter for the action script.
@@ -1902,7 +2224,7 @@ message Action {
   // Specifies the loading indicator that the action displays while
   // making the call to the action.
   //
-  // [Google Workspace Add-ons and Chat
+  // [Google Workspace add-ons and Chat
   // apps](https://developers.google.com/workspace/extend):
   enum LoadIndicator {
     // Displays a spinner to indicate that content is loading.
@@ -1946,7 +2268,7 @@ message Action {
   }
 
   // A custom function to invoke when the containing element is
-  // clicked or othrwise activated.
+  // clicked or otherwise activated.
   //
   // For example usage, see [Read form
   // data](https://developers.google.com/workspace/chat/read-form-data).
@@ -1997,4 +2319,121 @@ message Action {
   //
   // [Google Chat apps](https://developers.google.com/workspace/chat):
   Interaction interaction = 5;
+
+  // Optional. Fill this list with the names of widgets that this Action
+  // needs for a valid submission.
+  //
+  // If the widgets listed here don't have a value when this Action is invoked,
+  // the form submission is aborted.
+  //
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend):
+  repeated string required_widgets = 6;
+
+  // Optional. If this is true, then all widgets are considered required by
+  // this action.
+  //
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend):
+  bool all_widgets_are_required = 7;
+}
+
+// Represents the necessary data for validating the widget it's attached to.
+//
+// [Google Workspace add-ons and Chat
+// apps](https://developers.google.com/workspace/extend):
+message Validation {
+  // The type of the input widget.
+  enum InputType {
+    // Unspecified type. Do not use.
+    INPUT_TYPE_UNSPECIFIED = 0;
+
+    // Regular text that accepts all characters.
+    TEXT = 1;
+
+    // An integer value.
+    INTEGER = 2;
+
+    // A float value.
+    FLOAT = 3;
+
+    // An email address.
+    EMAIL = 4;
+
+    // A emoji selected from system-provided emoji picker.
+    EMOJI_PICKER = 5;
+  }
+
+  // Specify the character limit for text input widgets.  Note that this is
+  // only used for text input and is ignored for other widgets.
+  //
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend):
+  int32 character_limit = 1;
+
+  // Specify the type of the input widgets.
+  //
+  // [Google Workspace add-ons and Chat
+  // apps](https://developers.google.com/workspace/extend):
+  InputType input_type = 2;
+}
+
+// A list of chips layed out horizontally, which can either scroll horizontally
+// or wrap to the next line.
+//
+// [Google Workspace add-ons and Chat
+// apps](https://developers.google.com/workspace/extend):
+message ChipList {
+  // The chip list layout.
+  enum Layout {
+    // Don't use. Unspecified.
+    LAYOUT_UNSPECIFIED = 0;
+
+    // Default value. The chip list wraps to the next line if there isn't enough
+    // horizontal space.
+    WRAPPED = 1;
+
+    // The chips scroll horizontally if they don't fit in the available space.
+    HORIZONTAL_SCROLLABLE = 2;
+  }
+
+  // Specified chip list layout.
+  Layout layout = 1;
+
+  // An array of chips.
+  repeated Chip chips = 2;
+}
+
+// A text, icon, or text and icon chip that users can click.
+//
+// [Google Workspace add-ons and Chat
+// apps](https://developers.google.com/workspace/extend):
+message Chip {
+  // The icon image. If both `icon` and `text` are set, then the icon appears
+  // before the text.
+  Icon icon = 1;
+
+  // The text displayed inside the chip.
+  string label = 2;
+
+  // Optional. The action to perform when a user clicks the chip, such as
+  // opening a hyperlink or running a custom function.
+  OnClick on_click = 3;
+
+  // Whether the chip is in an active state and responds to user actions.
+  // Defaults to `true`.
+  // Deprecated. Use `disabled` instead.
+  bool enabled = 4 [deprecated = true];
+
+  // Whether the chip is in an inactive state and ignores user actions.
+  // Defaults to `false`.
+  bool disabled = 6;
+
+  // The alternative text that's used for accessibility.
+  //
+  // Set descriptive text that lets users know what the chip does. For
+  // example, if a chip opens a hyperlink, write: "Opens a new
+  // browser tab and navigates to the Google Chat developer documentation at
+  // https://developers.google.com/workspace/chat".
+  string alt_text = 5;
 }