RubyGems - google-apps-chat-v1 - Versions diffs - 0.15.0 → 0.17.0 - Mend

google-apps-chat-v1 0.15.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

checksums.yaml +4 -4
data/lib/google/apps/chat/v1/chat_service/client.rb +20 -3
data/lib/google/apps/chat/v1/version.rb +1 -1
data/lib/google/chat/v1/membership_pb.rb +1 -1
data/lib/google/chat/v1/space_pb.rb +1 -1
data/proto_docs/google/apps/card/v1/card.rb +640 -167
data/proto_docs/google/chat/v1/deletion_metadata.rb +1 -1
data/proto_docs/google/chat/v1/membership.rb +56 -6
data/proto_docs/google/chat/v1/space.rb +11 -2
metadata +3 -3

data/proto_docs/google/apps/card/v1/card.rb CHANGED Viewed

@@ -22,7 +22,7 @@ module Google
     module Card
       module 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,
@@ -35,9 +35,13 @@ module Google
         #
         # * 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
@@ -137,13 +141,13 @@ module Google
         #     card](https://developers.google.com/workspace/chat/design-components-card-dialog#define_a_section_of_a_card).
         # @!attribute [rw] section_divider_style
         #   @return [::Google::Apps::Card::V1::Card::DividerStyle]
-        #     The divider style between sections.
+        #     The divider style between the header, sections and footer.
         # @!attribute [rw] card_actions
         #   @return [::Array<::Google::Apps::Card::V1::Card::CardAction>]
         #     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:
@@ -180,7 +184,7 @@ module Google
         #     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):
         # @!attribute [rw] fixed_footer
         #   @return [::Google::Apps::Card::V1::Card::CardFixedFooter]
         #     The fixed footer shown at the bottom of this card.
@@ -192,15 +196,15 @@ module Google
         #     [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):
         # @!attribute [rw] display_style
         #   @return [::Google::Apps::Card::V1::Card::DisplayStyle]
-        #     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):
         # @!attribute [rw] peek_card_header
         #   @return [::Google::Apps::Card::V1::Card::CardHeader]
         #     When displaying contextual content, the peek card header acts as a
@@ -208,7 +212,7 @@ module Google
         #     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):
         class Card
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -216,7 +220,7 @@ module Google
           # 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):
           # @!attribute [rw] title
           #   @return [::String]
@@ -232,7 +236,7 @@ module Google
           #   @return [::Google::Apps::Card::V1::Widget::ImageType]
           #     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):
           # @!attribute [rw] image_url
           #   @return [::String]
@@ -248,7 +252,7 @@ module Google
           # 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):
           # @!attribute [rw] header
           #   @return [::String]
@@ -260,7 +264,7 @@ module Google
           #     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).
           # @!attribute [rw] widgets
           #   @return [::Array<::Google::Apps::Card::V1::Widget>]
           #     All the widgets in the section.
@@ -285,6 +289,11 @@ module Google
           #     the first two widgets are always shown and the last three are collapsed
           #     by default. The `uncollapsibleWidgetsCount` is taken into account only
           #     when `collapsible` is `true`.
+          # @!attribute [rw] collapse_control
+          #   @return [::Google::Apps::Card::V1::CollapseControl]
+          #     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.
           class Section
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -295,7 +304,7 @@ module Google
           # 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):
           # @!attribute [rw] action_label
           #   @return [::String]
           #     The label that displays as the action menu item.
@@ -307,6 +316,29 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+          # 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):
+          # @!attribute [rw] text_paragraph
+          #   @return [::Google::Apps::Card::V1::TextParagraph]
+          #     A text paragraph widget.
+          #
+          #     Note: The following fields are mutually exclusive: `text_paragraph`, `button_list`, `image`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] button_list
+          #   @return [::Google::Apps::Card::V1::ButtonList]
+          #     A button list widget.
+          #
+          #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] image
+          #   @return [::Google::Apps::Card::V1::Image]
+          #     An image widget.
+          #
+          #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `button_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          class NestedWidget
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
           # A persistent (sticky) footer that that appears at the bottom of the card.
           #
           # Setting `fixedFooter` without specifying a `primaryButton` or a
@@ -319,7 +351,7 @@ module Google
           # 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):
           # @!attribute [rw] primary_button
           #   @return [::Google::Apps::Card::V1::Button]
@@ -338,24 +370,25 @@ module Google
           # 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):
           module 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
           end
-          # 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):
           module DisplayStyle
             # Don't use. Unspecified.
             DISPLAY_STYLE_UNSPECIFIED = 0
@@ -385,7 +418,7 @@ module Google
         #     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:
         #     ```
@@ -394,7 +427,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] image
         #   @return [::Google::Apps::Card::V1::Image]
         #     Displays an image.
@@ -408,7 +441,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] decorated_text
         #   @return [::Google::Apps::Card::V1::DecoratedText]
         #     Displays a decorated text item.
@@ -432,7 +465,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] button_list
         #   @return [::Google::Apps::Card::V1::ButtonList]
         #     A list of buttons.
@@ -449,7 +482,6 @@ module Google
         #             "red": 0,
         #             "green": 0,
         #             "blue": 1,
-        #             "alpha": 1
         #           },
         #           "disabled": true,
         #         },
@@ -468,7 +500,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] text_input
         #   @return [::Google::Apps::Card::V1::TextInput]
         #     Displays a text box that users can type into.
@@ -508,7 +540,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] selection_input
         #   @return [::Google::Apps::Card::V1::SelectionInput]
         #     Displays a selection control that lets users select items. Selection
@@ -547,7 +579,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] date_time_picker
         #   @return [::Google::Apps::Card::V1::DateTimePicker]
         #     Displays a widget that lets users input a date, time, or date and time.
@@ -561,11 +593,11 @@ module Google
         #       "name": "appointment_time",
         #       "label": "Book your appointment at:",
         #       "type": "DATE_AND_TIME",
-        #       "valueMsEpoch": "796435200000"
+        #       "valueMsEpoch": 796435200000
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] divider
         #   @return [::Google::Apps::Card::V1::Divider]
         #     Displays a horizontal line divider between widgets.
@@ -576,7 +608,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `divider`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `divider`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] grid
         #   @return [::Google::Apps::Card::V1::Grid]
         #     Displays a grid with a collection of items.
@@ -586,7 +618,7 @@ module Google
         #     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
@@ -623,7 +655,7 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `grid`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `grid`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] columns
         #   @return [::Google::Apps::Card::V1::Columns]
         #     Displays up to 2 columns.
@@ -664,7 +696,61 @@ module Google
         #     }
         #     ```
         #
-        #     Note: The following fields are mutually exclusive: `columns`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `columns`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] carousel
+        #   @return [::Google::Apps::Card::V1::Carousel]
+        #     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."
+        #           }
+        #         }
+        #       ]
+        #     }
+        #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `carousel`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] chip_list
+        #   @return [::Google::Apps::Card::V1::ChipList]
+        #     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"
+        #             }
+        #           }
+        #         }
+        #       ]
+        #     }
+        #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `chip_list`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] horizontal_alignment
         #   @return [::Google::Apps::Card::V1::Widget::HorizontalAlignment]
         #     Specifies whether widgets align to the left, right, or center of a column.
@@ -674,7 +760,7 @@ module Google
           # 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):
           module ImageType
             # Default value. Applies a square mask to the image. For example, a 4x3
@@ -706,6 +792,21 @@ module Google
             # widgets to the left.
             HorizontalAlignment::END = 3
           end
+          # Represents vertical alignment attribute.
+          module 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
+          end
         end
         # A paragraph of text that supports formatting. For an example in
@@ -718,23 +819,52 @@ module Google
         # 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):
         # @!attribute [rw] text
         #   @return [::String]
         #     The text that's shown in the widget.
+        # @!attribute [rw] max_lines
+        #   @return [::Integer]
+        #     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.
+        # @!attribute [rw] text_syntax
+        #   @return [::Google::Apps::Card::V1::TextParagraph::TextSyntax]
+        #     The syntax of the text. If not set, the text is rendered as HTML.
+        #
+        #     [Google Chat apps](https://developers.google.com/workspace/chat):
         class TextParagraph
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+          # Syntax to use for formatting text.
+          #
+          # [Google Chat apps](https://developers.google.com/workspace/chat):
+          module 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
+          end
         end
         # 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):
         # @!attribute [rw] image_url
         #   @return [::String]
@@ -761,7 +891,7 @@ module Google
         # [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:
@@ -780,7 +910,7 @@ module Google
         # 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):
         # @!attribute [rw] icon
         #   @deprecated This field is deprecated and may be removed in the next major version update.
@@ -789,9 +919,21 @@ module Google
         # @!attribute [rw] start_icon
         #   @return [::Google::Apps::Card::V1::Icon]
         #     The icon displayed in front of the text.
+        # @!attribute [rw] start_icon_vertical_alignment
+        #   @return [::Google::Apps::Card::V1::Widget::VerticalAlignment]
+        #     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):
         # @!attribute [rw] top_label
         #   @return [::String]
         #     The text that appears above `text`. Always truncates.
+        # @!attribute [rw] top_label_text
+        #   @return [::Google::Apps::Card::V1::TextParagraph]
+        #     `TextParagraph` equivalent of `top_label`. Always truncates. Allows for
+        #     more complex formatting than `top_label`.
+        #
+        #     [Google Chat apps](https://developers.google.com/workspace/chat):
         # @!attribute [rw] text
         #   @return [::String]
         #     Required. The primary text.
@@ -803,7 +945,13 @@ module Google
         #     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).
+        # @!attribute [rw] content_text
+        #   @return [::Google::Apps::Card::V1::TextParagraph]
+        #     `TextParagraph` equivalent of `text`. Allows for more complex formatting
+        #     than `text`.
+        #
+        #     [Google Chat apps](https://developers.google.com/workspace/chat):
         # @!attribute [rw] wrap_text
         #   @return [::Boolean]
         #     The wrap text setting. If `true`, the text wraps and displays on
@@ -813,6 +961,12 @@ module Google
         # @!attribute [rw] bottom_label
         #   @return [::String]
         #     The text that appears below `text`. Always wraps.
+        # @!attribute [rw] bottom_label_text
+        #   @return [::Google::Apps::Card::V1::TextParagraph]
+        #     `TextParagraph` equivalent of `bottom_label`. Always wraps. Allows for
+        #     more complex formatting than `bottom_label`.
+        #
+        #     [Google Chat apps](https://developers.google.com/workspace/chat):
         # @!attribute [rw] on_click
         #   @return [::Google::Apps::Card::V1::OnClick]
         #     This action is triggered when users click `topLabel` or `bottomLabel`.
@@ -844,7 +998,7 @@ module Google
           # 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.
@@ -871,7 +1025,7 @@ module Google
           #   @return [::Google::Apps::Card::V1::DecoratedText::SwitchControl::ControlType]
           #     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):
           class SwitchControl
             include ::Google::Protobuf::MessageExts
@@ -879,7 +1033,7 @@ module Google
             # 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):
             module ControlType
               # A toggle-style switch.
@@ -895,8 +1049,11 @@ module Google
         end
         # 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
@@ -907,7 +1064,7 @@ module Google
         # use a text input. To collect defined or enumerated data from users, use the
         # {::Google::Apps::Card::V1::SelectionInput SelectionInput} widget.
         #
-        # [Google Workspace Add-ons and Chat
+        # [Google Workspace add-ons and Chat
         # apps](https://developers.google.com/workspace/extend):
         # @!attribute [rw] name
         #   @return [::String]
@@ -967,7 +1124,7 @@ module Google
         #     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):
         # @!attribute [rw] auto_complete_action
         #   @return [::Google::Apps::Card::V1::Action]
         #     Optional. Specify what action to take when the text input field provides
@@ -980,7 +1137,13 @@ module Google
         #     a custom function.
         #
         #     [Google Workspace
-        #     Add-ons](https://developers.google.com/workspace/add-ons):
+        #     add-ons](https://developers.google.com/workspace/add-ons):
+        # @!attribute [rw] validation
+        #   @return [::Google::Apps::Card::V1::Validation]
+        #     Specify the input format validation necessary for this text field.
+        #
+        #     [Google Workspace add-ons and Chat
+        #     apps](https://developers.google.com/workspace/extend):
         # @!attribute [rw] placeholder_text
         #   @return [::String]
         #     Text that appears in the text input field when the field is empty.
@@ -997,7 +1160,7 @@ module Google
           # `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):
           module Type
             # The text input field has a fixed height of one line.
@@ -1025,7 +1188,7 @@ module Google
         # 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):
         # @!attribute [rw] items
         #   @return [::Array<::Google::Apps::Card::V1::Suggestions::SuggestionItem>]
         #     A list of suggestions used for autocomplete recommendations in text input
@@ -1036,7 +1199,7 @@ module Google
           # 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):
           # @!attribute [rw] text
           #   @return [::String]
@@ -1053,7 +1216,7 @@ module Google
         # [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):
         # @!attribute [rw] buttons
         #   @return [::Array<::Google::Apps::Card::V1::Button>]
@@ -1064,9 +1227,12 @@ module Google
         end
         # 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
@@ -1076,11 +1242,12 @@ module Google
         # To collect undefined or abstract data from users, use
         # the {::Google::Apps::Card::V1::TextInput TextInput} widget.
         #
-        # [Google Workspace Add-ons
+        # [Google Workspace add-ons
         # and Chat apps](https://developers.google.com/workspace/extend):
         # @!attribute [rw] name
         #   @return [::String]
-        #     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).
@@ -1116,14 +1283,18 @@ module Google
         # @!attribute [rw] multi_select_min_query_length
         #   @return [::Integer]
         #     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.
         # @!attribute [rw] external_data_source
         #   @return [::Google::Apps::Card::V1::Action]
-        #     An external data source, such as a relational data base.
+        #     An external data source, such as a relational database.
         #
         #     Note: The following fields are mutually exclusive: `external_data_source`, `platform_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] platform_data_source
@@ -1136,9 +1307,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
           # 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):
           # @!attribute [rw] text
           #   @return [::String]
@@ -1157,10 +1328,6 @@ module Google
           #     set this field for one item.
           # @!attribute [rw] start_icon_uri
           #   @return [::String]
-          #     For multiselect menus, the URL for the icon displayed next to
-          #     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`.
           # @!attribute [rw] bottom_text
           #   @return [::String]
           #     For multiselect menus, a text description or label that's
@@ -1206,7 +1373,7 @@ module Google
           # 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):
           module SelectionType
             # A set of checkboxes. Users can select one or more checkboxes.
@@ -1221,35 +1388,36 @@ module Google
             # 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
           end
         end
-        # 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
@@ -1257,7 +1425,7 @@ module Google
         # 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):
         # @!attribute [rw] name
         #   @return [::String]
         #     The name by which the `DateTimePicker` is identified in a form input event.
@@ -1274,8 +1442,8 @@ module Google
         #     Whether the widget supports inputting a date, a time, or the date and time.
         # @!attribute [rw] value_ms_epoch
         #   @return [::Integer]
-        #     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`):
         #
@@ -1301,7 +1469,7 @@ module Google
           # 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):
           module DateTimePickerType
             # Users input a date and time.
@@ -1315,6 +1483,46 @@ module Google
           end
         end
+        # 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):
+        # @!attribute [rw] items
+        #   @return [::Array<::Google::Apps::Card::V1::OverflowMenu::OverflowMenuItem>]
+        #     Required. The list of menu options.
+        class OverflowMenu
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+          # An option that users can invoke in an overflow menu.
+          #
+          # [Google Workspace add-ons and Chat
+          # apps](https://developers.google.com/workspace/extend):
+          # @!attribute [rw] start_icon
+          #   @return [::Google::Apps::Card::V1::Icon]
+          #     The icon displayed in front of the text.
+          # @!attribute [rw] text
+          #   @return [::String]
+          #     Required. The text that identifies or describes the item to users.
+          # @!attribute [rw] on_click
+          #   @return [::Google::Apps::Card::V1::OnClick]
+          #     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.
+          # @!attribute [rw] disabled
+          #   @return [::Boolean]
+          #     Whether the menu option is disabled.
+          #     Defaults to false.
+          class OverflowMenuItem
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
         # A text, icon, or text and icon button that users can click. For an example in
         # Google Chat apps, see
         # [Add a
@@ -1326,48 +1534,39 @@ module Google
         # `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):
         # @!attribute [rw] text
         #   @return [::String]
         #     The text displayed inside the button.
         # @!attribute [rw] icon
         #   @return [::Google::Apps::Card::V1::Icon]
-        #     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.
         # @!attribute [rw] color
         #   @return [::Google::Type::Color]
-        #     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.
         # @!attribute [rw] on_click
         #   @return [::Google::Apps::Card::V1::OnClick]
         #     Required. The action to perform when a user clicks the button, such as
@@ -1384,9 +1583,44 @@ module Google
         #     example, if a button opens a hyperlink, you might write: "Opens a new
         #     browser tab and navigates to the Google Chat developer documentation at
         #     https://developers.google.com/workspace/chat".
+        # @!attribute [rw] type
+        #   @return [::Google::Apps::Card::V1::Button::Type]
+        #     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.
         class Button
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+          # 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):
+          module 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
+          end
         end
         # An icon displayed in a widget on a card. For an example in Google Chat apps,
@@ -1399,7 +1633,7 @@ module Google
         # [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):
         # @!attribute [rw] known_icon
         #   @return [::String]
@@ -1521,7 +1755,7 @@ module Google
         # 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:
@@ -1553,7 +1787,7 @@ module Google
           # 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):
           module ImageCropType
             # Don't use. Unspecified.
@@ -1577,7 +1811,7 @@ module Google
         # 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):
         # @!attribute [rw] type
         #   @return [::Google::Apps::Card::V1::BorderStyle::BorderType]
@@ -1585,6 +1819,25 @@ module Google
         # @!attribute [rw] stroke_color
         #   @return [::Google::Type::Color]
         #     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.
         # @!attribute [rw] corner_radius
         #   @return [::Integer]
         #     The corner radius for the border.
@@ -1594,23 +1847,23 @@ module Google
           # Represents the border types applied to widgets.
           #
-          # [Google Workspace Add-ons
+          # [Google Workspace add-ons
           # and Chat apps](https://developers.google.com/workspace/extend):
           module BorderType
             # Don't use. Unspecified.
             BORDER_TYPE_UNSPECIFIED = 0
-            # Default value. No border.
+            # No border.
             NO_BORDER = 1
-            # Outline.
+            # Default value. Outline.
             STROKE = 2
           end
         end
         # Represents an image.
         #
-        # [Google Workspace Add-ons and Chat
+        # [Google Workspace add-ons and Chat
         # apps](https://developers.google.com/workspace/extend):
         # @!attribute [rw] image_uri
         #   @return [::String]
@@ -1640,7 +1893,7 @@ module Google
         # 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
@@ -1702,7 +1955,7 @@ module Google
           # 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):
           # @!attribute [rw] id
           #   @return [::String]
@@ -1726,7 +1979,7 @@ module Google
             # 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):
             module GridItemLayout
               # Don't use. Unspecified.
@@ -1764,13 +2017,16 @@ module Google
         # * 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
         # {::Google::Apps::Card::V1::Grid `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.
         # @!attribute [rw] column_items
         #   @return [::Array<::Google::Apps::Card::V1::Columns::Column>]
         #     An array of columns. You can include up to 2 columns in a card or dialog.
@@ -1780,10 +2036,8 @@ module Google
           # 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)
           # @!attribute [rw] horizontal_size_style
           #   @return [::Google::Apps::Card::V1::Columns::Column::HorizontalSizeStyle]
           #     Specifies how a column fills the width of the card.
@@ -1805,45 +2059,48 @@ module Google
             # 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)
             # @!attribute [rw] text_paragraph
             #   @return [::Google::Apps::Card::V1::TextParagraph]
             #     {::Google::Apps::Card::V1::TextParagraph TextParagraph} widget.
             #
-            #     Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] image
             #   @return [::Google::Apps::Card::V1::Image]
             #     {::Google::Apps::Card::V1::Image Image} widget.
             #
-            #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] decorated_text
             #   @return [::Google::Apps::Card::V1::DecoratedText]
             #     {::Google::Apps::Card::V1::DecoratedText DecoratedText} widget.
             #
-            #     Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] button_list
             #   @return [::Google::Apps::Card::V1::ButtonList]
             #     {::Google::Apps::Card::V1::ButtonList ButtonList} widget.
             #
-            #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] text_input
             #   @return [::Google::Apps::Card::V1::TextInput]
             #     {::Google::Apps::Card::V1::TextInput TextInput} widget.
             #
-            #     Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] selection_input
             #   @return [::Google::Apps::Card::V1::SelectionInput]
             #     {::Google::Apps::Card::V1::SelectionInput SelectionInput} widget.
             #
-            #     Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] date_time_picker
             #   @return [::Google::Apps::Card::V1::DateTimePicker]
             #     {::Google::Apps::Card::V1::DateTimePicker DateTimePicker} widget.
             #
-            #     Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] chip_list
+            #   @return [::Google::Apps::Card::V1::ChipList]
+            #     {::Google::Apps::Card::V1::ChipList ChipList} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `chip_list`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             class Widgets
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1853,10 +2110,8 @@ module Google
             # 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)
             module HorizontalSizeStyle
               # Don't use. Unspecified.
               HORIZONTAL_SIZE_STYLE_UNSPECIFIED = 0
@@ -1874,10 +2129,8 @@ module Google
             # 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)
             module VerticalAlignment
               # Don't use. Unspecified.
               VERTICAL_ALIGNMENT_UNSPECIFIED = 0
@@ -1894,21 +2147,109 @@ module Google
           end
         end
+        # 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):
+        # @!attribute [rw] carousel_cards
+        #   @return [::Array<::Google::Apps::Card::V1::Carousel::CarouselCard>]
+        #     A list of cards included in the carousel.
+        class Carousel
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+          # A card that can be displayed as a carousel item.
+          # [Google Chat apps](https://developers.google.com/workspace/chat):
+          # @!attribute [rw] widgets
+          #   @return [::Array<::Google::Apps::Card::V1::Card::NestedWidget>]
+          #     A list of widgets displayed in the carousel card. The widgets are
+          #     displayed in the order that they are specified.
+          # @!attribute [rw] footer_widgets
+          #   @return [::Array<::Google::Apps::Card::V1::Card::NestedWidget>]
+          #     A list of widgets displayed at the bottom of the carousel card. The
+          #     widgets are displayed in the order that they are specified.
+          class CarouselCard
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+        # Represent an expand and collapse control.
+        #
+        # [Google Workspace add-ons and Chat
+        # apps](https://developers.google.com/workspace/extend):
+        # @!attribute [rw] horizontal_alignment
+        #   @return [::Google::Apps::Card::V1::Widget::HorizontalAlignment]
+        #     The horizontal alignment of the expand and collapse button.
+        # @!attribute [rw] expand_button
+        #   @return [::Google::Apps::Card::V1::Button]
+        #     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.
+        # @!attribute [rw] collapse_button
+        #   @return [::Google::Apps::Card::V1::Button]
+        #     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.
+        class CollapseControl
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
         # 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):
         # @!attribute [rw] action
         #   @return [::Google::Apps::Card::V1::Action]
         #     If specified, an action is triggered by this `onClick`.
         #
-        #     Note: The following fields are mutually exclusive: `action`, `open_link`, `open_dynamic_link_action`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `action`, `open_link`, `open_dynamic_link_action`, `card`, `overflow_menu`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] open_link
         #   @return [::Google::Apps::Card::V1::OpenLink]
         #     If specified, this `onClick` triggers an open link action.
         #
-        #     Note: The following fields are mutually exclusive: `open_link`, `action`, `open_dynamic_link_action`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `open_link`, `action`, `open_dynamic_link_action`, `card`, `overflow_menu`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] open_dynamic_link_action
         #   @return [::Google::Apps::Card::V1::Action]
         #     An add-on triggers this action when the action needs to open a
@@ -1917,17 +2258,22 @@ module Google
         #     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):
         #
-        #     Note: The following fields are mutually exclusive: `open_dynamic_link_action`, `action`, `open_link`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `open_dynamic_link_action`, `action`, `open_link`, `card`, `overflow_menu`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] card
         #   @return [::Google::Apps::Card::V1::Card]
         #     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):
         #
-        #     Note: The following fields are mutually exclusive: `card`, `action`, `open_link`, `open_dynamic_link_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `card`, `action`, `open_link`, `open_dynamic_link_action`, `overflow_menu`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] overflow_menu
+        #   @return [::Google::Apps::Card::V1::OverflowMenu]
+        #     If specified, this `onClick` opens an overflow menu.
+        #
+        #     Note: The following fields are mutually exclusive: `overflow_menu`, `action`, `open_link`, `open_dynamic_link_action`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class OnClick
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1935,7 +2281,7 @@ module Google
         # 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):
         # @!attribute [rw] url
         #   @return [::String]
@@ -1945,14 +2291,14 @@ module Google
         #     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):
         # @!attribute [rw] on_close
         #   @return [::Google::Apps::Card::V1::OpenLink::OnClose]
         #     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):
         class OpenLink
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1964,7 +2310,7 @@ module Google
           # 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):
           module OpenAs
             # The link opens as a full-size window (if that's the frame used by the
             # client).
@@ -1983,7 +2329,7 @@ module Google
           # 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):
           module OnClose
             # Default value. The card doesn't reload; nothing happens.
             NOTHING = 0
@@ -2002,12 +2348,12 @@ module Google
         # 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):
         # @!attribute [rw] function
         #   @return [::String]
         #     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).
@@ -2057,6 +2403,23 @@ module Google
         #     an add-on, the entire card is stripped and nothing is shown in the client.
         #
         #     [Google Chat apps](https://developers.google.com/workspace/chat):
+        # @!attribute [rw] required_widgets
+        #   @return [::Array<::String>]
+        #     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):
+        # @!attribute [rw] all_widgets_are_required
+        #   @return [::Boolean]
+        #     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):
         class Action
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2069,7 +2432,7 @@ module Google
           # 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):
           # @!attribute [rw] key
           #   @return [::String]
@@ -2085,7 +2448,7 @@ module Google
           # 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):
           module LoadIndicator
             # Displays a spinner to indicate that content is loading.
@@ -2128,6 +2491,116 @@ module Google
             OPEN_DIALOG = 1
           end
         end
+        # 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):
+        # @!attribute [rw] character_limit
+        #   @return [::Integer]
+        #     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):
+        # @!attribute [rw] input_type
+        #   @return [::Google::Apps::Card::V1::Validation::InputType]
+        #     Specify the type of the input widgets.
+        #
+        #     [Google Workspace add-ons and Chat
+        #     apps](https://developers.google.com/workspace/extend):
+        class Validation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+          # The type of the input widget.
+          module 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
+          end
+        end
+        # 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):
+        # @!attribute [rw] layout
+        #   @return [::Google::Apps::Card::V1::ChipList::Layout]
+        #     Specified chip list layout.
+        # @!attribute [rw] chips
+        #   @return [::Array<::Google::Apps::Card::V1::Chip>]
+        #     An array of chips.
+        class ChipList
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+          # The chip list layout.
+          module 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
+          end
+        end
+        # 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):
+        # @!attribute [rw] icon
+        #   @return [::Google::Apps::Card::V1::Icon]
+        #     The icon image. If both `icon` and `text` are set, then the icon appears
+        #     before the text.
+        # @!attribute [rw] label
+        #   @return [::String]
+        #     The text displayed inside the chip.
+        # @!attribute [rw] on_click
+        #   @return [::Google::Apps::Card::V1::OnClick]
+        #     Optional. The action to perform when a user clicks the chip, such as
+        #     opening a hyperlink or running a custom function.
+        # @!attribute [rw] enabled
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
+        #   @return [::Boolean]
+        #     Whether the chip is in an active state and responds to user actions.
+        #     Defaults to `true`.
+        #     Deprecated. Use `disabled` instead.
+        # @!attribute [rw] disabled
+        #   @return [::Boolean]
+        #     Whether the chip is in an inactive state and ignores user actions.
+        #     Defaults to `false`.
+        # @!attribute [rw] alt_text
+        #   @return [::String]
+        #     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".
+        class Chip
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end