google-apis-chat_v1 0.44.0 → 0.69.0

data/lib/google/apis/chat_v1/classes.rb

@@ -23,9 +23,9 @@ module Google
     module ChatV1
       
       # List of string parameters to supply when the action method is invoked. For
-      # example, consider three snooze buttons: snooze now, snooze 1 day, snooze next
-      # week. You might use action method = snooze(), passing the snooze type and
-      # snooze time in the list of string parameters.
+      # example, consider three snooze buttons: snooze now, snooze one day, snooze
+      # next week. You might use `action method = snooze()`, passing the snooze type
+      # and snooze time in the list of string parameters.
       class ActionParameter
         include Google::Apis::Core::Hashable
       
@@ -50,7 +50,7 @@ module Google
         end
       end
       
-      # Parameters that a Chat app can use to configure how it's response is posted.
+      # Parameters that a Chat app can use to configure how its response is posted.
       class ActionResponse
         include Google::Apis::Core::Hashable
       
@@ -65,8 +65,8 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Input only. URL for users to auth or config. (Only for REQUEST_CONFIG response
-        # types.)
+        # Input only. URL for users to authenticate or configure. (Only for `
+        # REQUEST_CONFIG` response types.)
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -113,9 +113,9 @@ module Google
       # Annotations associated with the plain-text body of the message. Example plain-
       # text message body: ``` Hello @FooBot how are you!" ``` The corresponding
       # annotations metadata: ``` "annotations":[` "type":"USER_MENTION", "startIndex":
-      # 6, "length":7, "userMention": ` "user": ` "name":"users/107946847022116401880",
-      # "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" `, "
-      # type":"MENTION" ` `] ```
+      # 6, "length":7, "userMention": ` "user": ` "name":"users/`user`", "displayName":
+      # "FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" `, "type":"MENTION"
+      # ` `] ```
       class Annotation
         include Google::Apis::Core::Hashable
       
@@ -160,27 +160,47 @@ module Google
         end
       end
       
+      # A GIF image that's specified by a URL.
+      class AttachedGif
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The URL that hosts the GIF image.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # An attachment in Google Chat.
       class Attachment
         include Google::Apis::Core::Hashable
       
-        # A reference to the data of an attachment.
+        # A reference to the attachment data. This field is used with the media API to
+        # download the attachment data.
         # Corresponds to the JSON property `attachmentDataRef`
         # @return [Google::Apis::ChatV1::AttachmentDataRef]
         attr_accessor :attachment_data_ref
       
-        # The original file name for the content, not the full path.
+        # Output only. The original file name for the content, not the full path.
         # Corresponds to the JSON property `contentName`
         # @return [String]
         attr_accessor :content_name
       
-        # The content type (MIME type) of the file.
+        # Output only. The content type (MIME type) of the file.
         # Corresponds to the JSON property `contentType`
         # @return [String]
         attr_accessor :content_type
       
         # Output only. The download URL which should be used to allow a human user to
-        # download the attachment. Chat apps should not use this URL to download
+        # download the attachment. Chat apps shouldn't use this URL to download
         # attachment content.
         # Corresponds to the JSON property `downloadUri`
         # @return [String]
@@ -191,19 +211,19 @@ module Google
         # @return [Google::Apis::ChatV1::DriveDataRef]
         attr_accessor :drive_data_ref
       
-        # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*
-        # ".
+        # Resource name of the attachment, in the form `spaces/*/messages/*/attachments/*
+        # `.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The source of the attachment.
+        # Output only. The source of the attachment.
         # Corresponds to the JSON property `source`
         # @return [String]
         attr_accessor :source
       
         # Output only. The thumbnail URL which should be used to preview the attachment
-        # to a human user. Chat apps should not use this URL to download attachment
+        # to a human user. Chat apps shouldn't use this URL to download attachment
         # content.
         # Corresponds to the JSON property `thumbnailUri`
         # @return [String]
@@ -226,12 +246,19 @@ module Google
         end
       end
       
-      # A reference to the data of an attachment.
+      # 
       class AttachmentDataRef
         include Google::Apis::Core::Hashable
       
-        # The resource name of the attachment data. This is used with the media API to
-        # download the attachment data.
+        # Opaque token containing a reference to an uploaded attachment. Treated by
+        # clients as an opaque string and used to create or update Chat messages with
+        # attachments.
+        # Corresponds to the JSON property `attachmentUploadToken`
+        # @return [String]
+        attr_accessor :attachment_upload_token
+      
+        # The resource name of the attachment data. This field is used with the media
+        # API to download the attachment data.
         # Corresponds to the JSON property `resourceName`
         # @return [String]
         attr_accessor :resource_name
@@ -242,6 +269,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @attachment_upload_token = args[:attachment_upload_token] if args.key?(:attachment_upload_token)
           @resource_name = args[:resource_name] if args.key?(:resource_name)
         end
       end
@@ -250,12 +278,12 @@ module Google
       class Button
         include Google::Apis::Core::Hashable
       
-        # An image button with an onclick action.
+        # An image button with an `onclick` action.
         # Corresponds to the JSON property `imageButton`
         # @return [Google::Apis::ChatV1::ImageButton]
         attr_accessor :image_button
       
-        # A button with text and onclick action.
+        # A button with text and `onclick` action.
         # Corresponds to the JSON property `textButton`
         # @return [Google::Apis::ChatV1::TextButton]
         attr_accessor :text_button
@@ -271,7 +299,7 @@ module Google
         end
       end
       
-      # A card is a UI element that can contain UI widgets such as texts, images.
+      # A card is a UI element that can contain UI widgets such as text and images.
       class Card
         include Google::Apis::Core::Hashable
       
@@ -310,7 +338,7 @@ module Google
       
       # A card action is the action associated with the card. For an invoice card, a
       # typical action would be: delete invoice, email invoice or open the invoice in
-      # browser.
+      # browser. Not supported by Google Chat apps.
       class CardAction
         include Google::Apis::Core::Hashable
       
@@ -319,7 +347,7 @@ module Google
         # @return [String]
         attr_accessor :action_label
       
-        # An onclick action (e.g. open a link).
+        # An `onclick` action (for example, open a link).
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::OnClick]
         attr_accessor :on_click
@@ -339,7 +367,7 @@ module Google
       class CardHeader
         include Google::Apis::Core::Hashable
       
-        # The image's type (e.g. square border or circular border).
+        # The image's type (for example, square border or circular border).
         # Corresponds to the JSON property `imageStyle`
         # @return [String]
         attr_accessor :image_style
@@ -355,8 +383,8 @@ module Google
         attr_accessor :subtitle
       
         # The title must be specified. The header has a fixed height: if both a title
-        # and subtitle is specified, each will take up 1 line. If only the title is
-        # specified, it will take up both lines.
+        # and subtitle is specified, each takes up one line. If only the title is
+        # specified, it takes up both lines.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -374,34 +402,42 @@ module Google
         end
       end
       
-      # Widgets for Chat apps to specify.
+      # A [card](https://developers.google.com/chat/api/reference/rest/v1/cards) in a
+      # Google Chat message. Only Chat apps can create cards. If your Chat app [
+      # authenticates as a user](https://developers.google.com/chat/api/guides/auth/
+      # users), the message can't contain cards.
       class CardWithId
         include Google::Apis::Core::Hashable
       
-        # A card is a UI element that can contain UI widgets such as text and images.
-        # For more information, see Cards . For example, the following JSON creates a
-        # card that has a header with the name, position, icons, and link for a contact,
-        # followed by a section with contact information like email and phone number. ```
-        # ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "imageStyle":
-        # "ImageStyle.AVATAR", "imageUrl": "https://example.com/sasha.png", "
-        # imageAltText": "Avatar for Sasha" `, "sections" : [ ` "header": "Contact Info",
-        # "widgets": [ ` "decorated_text": ` "icon": ` "knownIcon": "EMAIL" `, "content"
-        # : "sasha@example.com" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "PERSON"
-        # `, "content": "Online" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "
-        # PHONE" `, "content": "+1 (555) 555-1234" ` `, ` "buttons": [ ` "textButton": `
-        # "text": "Share", `, "onClick": ` "openLink": ` "url": "https://example.com/
-        # share" ` ` `, ` "textButton": ` "text": "Edit", `, "onClick": ` "action": ` "
-        # function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT" ` ]
-        # , "loadIndicator": "LoadIndicator.SPINNER" ` ` ` ] ` ], "collapsible": true, "
-        # uncollapsibleWidgetsCount": 3 ` ], "cardActions": [ ` "actionLabel": "Send
-        # Feedback", "onClick": ` "openLink": ` "url": "https://example.com/feedback" ` `
-        # ` ], "name": "contact-card-K3wB6arF2H9L" ` ```
+        # A card interface displayed in a Google Chat message or Google Workspace Add-on.
+        # Cards support a defined layout, interactive UI elements like buttons, and
+        # rich media like images. Use cards to present detailed information, gather
+        # information from users, and guide users to take a next step. To learn how to
+        # build cards, see the following documentation: * For Google Chat apps, see [
+        # Design dynamic, interactive, and consistent UIs with cards](https://developers.
+        # google.com/chat/ui). * For Google Workspace Add-ons, see [Card-based
+        # interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards).
+        # **Example: Card message for a Google Chat app** ![Example contact card](https:/
+        # /developers.google.com/chat/images/card_api_reference.png) To create the
+        # sample card message in Google Chat, use the following JSON: ``` ` "cardsV2": [
+        # ` "cardId": "unique-card-id", "card": ` "header": ` "title": "Sasha", "
+        # subtitle": "Software Engineer", "imageUrl": "https://developers.google.com/
+        # chat/images/quickstart-app-avatar.png", "imageType": "CIRCLE", "imageAltText":
+        # "Avatar for Sasha", `, "sections": [ ` "header": "Contact Info", "collapsible":
+        # true, "uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "
+        # startIcon": ` "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "
+        # decoratedText": ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `,
+        # `, ` "decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (
+        # 555) 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "
+        # onClick": ` "openLink": ` "url": "https://example.com/share", ` ` `, ` "text":
+        # "Edit", "onClick": ` "action": ` "function": "goToView", "parameters": [ ` "
+        # key": "viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
         # Corresponds to the JSON property `card`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Card]
         attr_accessor :card
       
-        # Required for `cardsV2` messages. Chat app-specified identifier for this widget.
-        # Scoped within a message.
+        # Required if the message contains multiple cards. A unique identifier for a
+        # card in a message.
         # Corresponds to the JSON property `cardId`
         # @return [String]
         attr_accessor :card_id
@@ -457,19 +493,42 @@ module Google
         end
       end
       
+      # Chat apps only. For a `SelectionInput` widget that uses a multi-select menu, a
+      # data source from Google Chat. For example, a list of Google Chat spaces of
+      # which the user is a member. [Developer Preview](https://developers.google.com/
+      # workspace/preview).
+      class ChatClientDataSourceMarkup
+        include Google::Apis::Core::Hashable
+      
+        # A data source representing a Google Chat space. Format: spaces/`space` [
+        # Developer Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `spaceDataSource`
+        # @return [Google::Apis::ChatV1::SpaceDataSource]
+        attr_accessor :space_data_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @space_data_source = args[:space_data_source] if args.key?(:space_data_source)
+        end
+      end
+      
       # Represents a color in the RGBA color space. This representation is designed
-      # for simplicity of conversion to/from color representations in various
+      # for simplicity of conversion to and from color representations in various
       # languages over compactness. For example, the fields of this representation can
       # be trivially provided to the constructor of `java.awt.Color` in Java; it can
       # also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
       # method in iOS; and, with just a little work, it can be easily formatted into a
-      # CSS `rgba()` string in JavaScript. This reference page doesn't carry
+      # CSS `rgba()` string in JavaScript. This reference page doesn't have
       # information about the absolute color space that should be used to interpret
-      # the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default,
+      # the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default,
       # applications should assume the sRGB color space. When color equality needs to
       # be decided, implementations, unless documented otherwise, treat two colors as
-      # equal if all their red, green, blue, and alpha values each differ by at most
-      # 1e-5. Example (Java): import com.google.type.Color; // ... public static java.
+      # equal if all their red, green, blue, and alpha values each differ by at most `
+      # 1e-5`. Example (Java): import com.google.type.Color; // ... public static java.
       # awt.Color fromProto(Color protocolor) ` float alpha = protocolor.hasAlpha() ?
       # protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.
       # getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); ` public static
@@ -588,14 +647,17 @@ module Google
         # @return [String]
         attr_accessor :platform
       
-        # The timezone ID and offset from Coordinated Universal Time (UTC). Not
-        # supported by Chat apps.
+        # The timezone ID and offset from Coordinated Universal Time (UTC). Only
+        # supported for the event types [`CARD_CLICKED`](https://developers.google.com/
+        # chat/api/reference/rest/v1/EventType#ENUM_VALUES.CARD_CLICKED) and [`
+        # SUBMIT_DIALOG`](https://developers.google.com/chat/api/reference/rest/v1/
+        # DialogEventType#ENUM_VALUES.SUBMIT_DIALOG).
         # Corresponds to the JSON property `timeZone`
         # @return [Google::Apis::ChatV1::TimeZone]
         attr_accessor :time_zone
       
         # The full `locale.displayName` in the format of [ISO 639 language code]-[ISO
-        # 3166 country/region code] such as "en-US". Not supported by Chat apps.
+        # 3166 country/region code] such as "en-US".
         # Corresponds to the JSON property `userLocale`
         # @return [String]
         attr_accessor :user_locale
@@ -616,7 +678,26 @@ module Google
         end
       end
       
-      # Date input values. Not supported by Chat apps.
+      # Represents a custom emoji.
+      class CustomEmoji
+        include Google::Apis::Core::Hashable
+      
+        # Unique key for the custom emoji resource.
+        # Corresponds to the JSON property `uid`
+        # @return [String]
+        attr_accessor :uid
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @uid = args[:uid] if args.key?(:uid)
+        end
+      end
+      
+      # Date input values.
       class DateInput
         include Google::Apis::Core::Hashable
       
@@ -635,7 +716,7 @@ module Google
         end
       end
       
-      # Date and time input values. Not supported by Chat apps.
+      # Date and time input values.
       class DateTimeInput
         include Google::Apis::Core::Hashable
       
@@ -668,12 +749,37 @@ module Google
         end
       end
       
-      # Google Chat events.
+      # Information about a deleted message. A message is deleted when `delete_time`
+      # is set.
+      class DeletionMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Indicates who deleted the message.
+        # Corresponds to the JSON property `deletionType`
+        # @return [String]
+        attr_accessor :deletion_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deletion_type = args[:deletion_type] if args.key?(:deletion_type)
+        end
+      end
+      
+      # A Google Chat app interaction event. To learn about interaction events, see [
+      # Receive and respond to interactions with your Google Chat app](https://
+      # developers.google.com/chat/api/guides/message-formats). To learn about event
+      # types and for example event payloads, see [Types of Google Chat app
+      # interaction events](https://developers.google.com/chat/api/guides/message-
+      # formats/events).
       class DeprecatedEvent
         include Google::Apis::Core::Hashable
       
         # A form action describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke Apps Script to handle the form.
         # Corresponds to the JSON property `action`
         # @return [Google::Apis::ChatV1::FormAction]
         attr_accessor :action
@@ -687,32 +793,32 @@ module Google
         attr_accessor :common
       
         # The URL the Chat app should redirect the user to after they have completed an
-        # authorization or configuration flow outside of Google Chat. See the [
-        # Authorizing access to 3p services guide](/chat/how-tos/auth-3p) for more
-        # information.
+        # authorization or configuration flow outside of Google Chat. For more
+        # information, see [Connect a Chat app with other services & tools](https://
+        # developers.google.com/chat/how-tos/connect-web-services-tools).
         # Corresponds to the JSON property `configCompleteRedirectUrl`
         # @return [String]
         attr_accessor :config_complete_redirect_url
       
-        # The type of [dialog](https://developers.google.com/chat/how-tos/dialogs) event
-        # received.
+        # The type of [dialog](https://developers.google.com/chat/how-tos/dialogs)
+        # interaction event received.
         # Corresponds to the JSON property `dialogEventType`
         # @return [String]
         attr_accessor :dialog_event_type
       
-        # The timestamp indicating when the event occurred.
+        # The timestamp indicating when the interaction event occurred.
         # Corresponds to the JSON property `eventTime`
         # @return [String]
         attr_accessor :event_time
       
-        # True when the event is related to [dialogs](https://developers.google.com/chat/
-        # how-tos/dialogs).
+        # For `CARD_CLICKED` interaction events, whether the user interacted with a [
+        # dialog](https://developers.google.com/chat/how-tos/dialogs).
         # Corresponds to the JSON property `isDialogEvent`
         # @return [Boolean]
         attr_accessor :is_dialog_event
         alias_method :is_dialog_event?, :is_dialog_event
       
-        # A message in Google Chat.
+        # A message in a Google Chat space.
         # Corresponds to the JSON property `message`
         # @return [Google::Apis::ChatV1::Message]
         attr_accessor :message
@@ -723,8 +829,9 @@ module Google
         # @return [Google::Apis::ChatV1::Space]
         attr_accessor :space
       
-        # The Chat app-defined key for the thread related to the event. See the
-        # thread_key field of the `spaces.message.create` request for more information.
+        # The Chat app-defined key for the thread related to the interaction event. See [
+        # `spaces.messages.thread.threadKey`](/chat/api/reference/rest/v1/spaces.
+        # messages#Thread.FIELDS.thread_key) for more information.
         # Corresponds to the JSON property `threadKey`
         # @return [String]
         attr_accessor :thread_key
@@ -740,12 +847,17 @@ module Google
         # @return [String]
         attr_accessor :token
       
-        # The type of the event.
+        # The type of interaction event. For details, see [Types of Google Chat app
+        # interaction events](https://developers.google.com/chat/api/guides/message-
+        # formats/events).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # A user in Google Chat.
+        # A user in Google Chat. When returned as an output from a request, if your Chat
+        # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+        # auth/users), the output for a `User` resource only populates the user's `name`
+        # and `type`.
         # Corresponds to the JSON property `user`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :user
@@ -775,24 +887,29 @@ module Google
       class Dialog
         include Google::Apis::Core::Hashable
       
-        # A card is a UI element that can contain UI widgets such as text and images.
-        # For more information, see Cards . For example, the following JSON creates a
-        # card that has a header with the name, position, icons, and link for a contact,
-        # followed by a section with contact information like email and phone number. ```
-        # ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "imageStyle":
-        # "ImageStyle.AVATAR", "imageUrl": "https://example.com/sasha.png", "
-        # imageAltText": "Avatar for Sasha" `, "sections" : [ ` "header": "Contact Info",
-        # "widgets": [ ` "decorated_text": ` "icon": ` "knownIcon": "EMAIL" `, "content"
-        # : "sasha@example.com" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "PERSON"
-        # `, "content": "Online" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "
-        # PHONE" `, "content": "+1 (555) 555-1234" ` `, ` "buttons": [ ` "textButton": `
-        # "text": "Share", `, "onClick": ` "openLink": ` "url": "https://example.com/
-        # share" ` ` `, ` "textButton": ` "text": "Edit", `, "onClick": ` "action": ` "
-        # function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT" ` ]
-        # , "loadIndicator": "LoadIndicator.SPINNER" ` ` ` ] ` ], "collapsible": true, "
-        # uncollapsibleWidgetsCount": 3 ` ], "cardActions": [ ` "actionLabel": "Send
-        # Feedback", "onClick": ` "openLink": ` "url": "https://example.com/feedback" ` `
-        # ` ], "name": "contact-card-K3wB6arF2H9L" ` ```
+        # A card interface displayed in a Google Chat message or Google Workspace Add-on.
+        # Cards support a defined layout, interactive UI elements like buttons, and
+        # rich media like images. Use cards to present detailed information, gather
+        # information from users, and guide users to take a next step. To learn how to
+        # build cards, see the following documentation: * For Google Chat apps, see [
+        # Design dynamic, interactive, and consistent UIs with cards](https://developers.
+        # google.com/chat/ui). * For Google Workspace Add-ons, see [Card-based
+        # interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards).
+        # **Example: Card message for a Google Chat app** ![Example contact card](https:/
+        # /developers.google.com/chat/images/card_api_reference.png) To create the
+        # sample card message in Google Chat, use the following JSON: ``` ` "cardsV2": [
+        # ` "cardId": "unique-card-id", "card": ` "header": ` "title": "Sasha", "
+        # subtitle": "Software Engineer", "imageUrl": "https://developers.google.com/
+        # chat/images/quickstart-app-avatar.png", "imageType": "CIRCLE", "imageAltText":
+        # "Avatar for Sasha", `, "sections": [ ` "header": "Contact Info", "collapsible":
+        # true, "uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "
+        # startIcon": ` "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "
+        # decoratedText": ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `,
+        # `, ` "decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (
+        # 555) 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "
+        # onClick": ` "openLink": ` "url": "https://example.com/share", ` ` `, ` "text":
+        # "Edit", "onClick": ` "action": ` "function": "goToView", "parameters": [ ` "
+        # key": "viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
         # Corresponds to the JSON property `body`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Card]
         attr_accessor :body
@@ -838,7 +955,7 @@ module Google
       class DriveDataRef
         include Google::Apis::Core::Hashable
       
-        # The id for the drive file, for use with the Drive API.
+        # The ID for the drive file. Use with the Drive API.
         # Corresponds to the JSON property `driveFileId`
         # @return [String]
         attr_accessor :drive_file_id
@@ -853,6 +970,56 @@ module Google
         end
       end
       
+      # An emoji that is used as a reaction to a message.
+      class Emoji
+        include Google::Apis::Core::Hashable
+      
+        # Represents a custom emoji.
+        # Corresponds to the JSON property `customEmoji`
+        # @return [Google::Apis::ChatV1::CustomEmoji]
+        attr_accessor :custom_emoji
+      
+        # A basic emoji represented by a unicode string.
+        # Corresponds to the JSON property `unicode`
+        # @return [String]
+        attr_accessor :unicode
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @custom_emoji = args[:custom_emoji] if args.key?(:custom_emoji)
+          @unicode = args[:unicode] if args.key?(:unicode)
+        end
+      end
+      
+      # The number of people who reacted to a message with a specific emoji.
+      class EmojiReactionSummary
+        include Google::Apis::Core::Hashable
+      
+        # An emoji that is used as a reaction to a message.
+        # Corresponds to the JSON property `emoji`
+        # @return [Google::Apis::ChatV1::Emoji]
+        attr_accessor :emoji
+      
+        # The total number of reactions using the associated emoji.
+        # Corresponds to the JSON property `reactionCount`
+        # @return [Fixnum]
+        attr_accessor :reaction_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @emoji = args[:emoji] if args.key?(:emoji)
+          @reaction_count = args[:reaction_count] if args.key?(:reaction_count)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -870,14 +1037,14 @@ module Google
       end
       
       # A form action describes the behavior when the form is submitted. For example,
-      # an Apps Script can be invoked to handle the form.
+      # you can invoke Apps Script to handle the form.
       class FormAction
         include Google::Apis::Core::Hashable
       
         # The method name is used to identify which part of the form triggered the form
         # submission. This information is echoed back to the Chat app as part of the
-        # card click event. The same method name can be used for several elements that
-        # trigger a common behavior if desired.
+        # card click event. You can use the same method name for several elements that
+        # trigger a common behavior.
         # Corresponds to the JSON property `actionMethodName`
         # @return [String]
         attr_accessor :action_method_name
@@ -899,16 +1066,32 @@ module Google
       end
       
       # An action that describes the behavior when the form is submitted. For example,
-      # an Apps Script can be invoked to handle the form.
+      # you can invoke an Apps Script script to handle the form. If the action is
+      # triggered, the form values are sent to the server.
       class GoogleAppsCardV1Action
         include Google::Apis::Core::Hashable
       
-        # Apps Script function to invoke when the containing element is clicked/
-        # activated.
+        # A custom function to invoke when the containing element is clicked or othrwise
+        # activated. For example usage, see [Create interactive cards](https://
+        # developers.google.com/chat/how-tos/cards-onclick).
         # Corresponds to the JSON property `function`
         # @return [String]
         attr_accessor :function
       
+        # Optional. Required when opening a [dialog](https://developers.google.com/chat/
+        # how-tos/dialogs). What to do in response to an interaction with a user, such
+        # as a user clicking a button in a card message. If unspecified, the app
+        # responds by executing an `action`—like opening a link or running a function—as
+        # normal. By specifying an `interaction`, the app can respond in special
+        # interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the
+        # app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs).
+        # When specified, a loading indicator isn't shown. Supported by Chat apps, but
+        # not Google Workspace Add-ons. If specified for an add-on, the entire card is
+        # stripped and nothing is shown in the client.
+        # Corresponds to the JSON property `interaction`
+        # @return [String]
+        attr_accessor :interaction
+      
         # Specifies the loading indicator that the action displays while making the call
         # to the action.
         # Corresponds to the JSON property `loadIndicator`
@@ -921,17 +1104,19 @@ module Google
         attr_accessor :parameters
       
         # Indicates whether form values persist after the action. The default value is `
-        # false`. If `true`, form values remain after the action is triggered. When
-        # using [LoadIndicator.NONE](https://developers.google.com/workspace/add-ons/
-        # reference/rpc/google.apps.card.v1#loadindicator) for actions, `persist_values`
-        # = `true`is recommended, as it ensures that any changes made by the user after
-        # form or on change actions are sent to the server are not overwritten by the
-        # response. If `false`, the form values are cleared when the action is triggered.
-        # When `persist_values` is set to `false`, it is strongly recommended that the
-        # card use [LoadIndicator.SPINNER](https://developers.google.com/workspace/add-
-        # ons/reference/rpc/google.apps.card.v1#loadindicator) for all actions, as this
-        # locks the UI to ensure no changes are made by the user while the action is
-        # being processed. Not supported by Google Chat apps.
+        # false`. If `true`, form values remain after the action is triggered. To let
+        # the user make changes while the action is being processed, set [`LoadIndicator`
+        # ](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.
+        # card.v1#loadindicator) to `NONE`. For [card messages](https://developers.
+        # google.com/chat/api/guides/message-formats/cards) in Chat apps, you must also
+        # set the action's [`ResponseType`](https://developers.google.com/chat/api/
+        # reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use
+        # the same [`card_id`](https://developers.google.com/chat/api/reference/rest/v1/
+        # spaces.messages#CardWithId) from the card that contained the action. If `false`
+        # , the form values are cleared when the action is triggered. To prevent the
+        # user from making changes while the action is being processed, set [`
+        # LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/
+        # google.apps.card.v1#loadindicator) to `SPINNER`.
         # Corresponds to the JSON property `persistValues`
         # @return [Boolean]
         attr_accessor :persist_values
@@ -944,6 +1129,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @function = args[:function] if args.key?(:function)
+          @interaction = args[:interaction] if args.key?(:interaction)
           @load_indicator = args[:load_indicator] if args.key?(:load_indicator)
           @parameters = args[:parameters] if args.key?(:parameters)
           @persist_values = args[:persist_values] if args.key?(:persist_values)
@@ -951,9 +1137,11 @@ module Google
       end
       
       # List of string parameters to supply when the action method is invoked. For
-      # example, consider three snooze buttons: snooze now, snooze 1 day, snooze next
-      # week. You might use action method = snooze(), passing the snooze type and
-      # snooze time in the list of string parameters.
+      # example, consider three snooze buttons: snooze now, snooze one day, or snooze
+      # next week. You might use `action method = snooze()`, passing the snooze type
+      # and snooze time in the list of string parameters. To learn more, see [`
+      # CommonEventObject`](https://developers.google.com/chat/api/reference/rest/v1/
+      # Event#commoneventobject).
       class GoogleAppsCardV1ActionParameter
         include Google::Apis::Core::Hashable
       
@@ -978,7 +1166,8 @@ module Google
         end
       end
       
-      # Represents the complete border style applied to widgets.
+      # The style options for the border of a card or widget, including the border
+      # type and color.
       class GoogleAppsCardV1BorderStyle
         include Google::Apis::Core::Hashable
       
@@ -988,18 +1177,18 @@ module Google
         attr_accessor :corner_radius
       
         # Represents a color in the RGBA color space. This representation is designed
-        # for simplicity of conversion to/from color representations in various
+        # for simplicity of conversion to and from color representations in various
         # languages over compactness. For example, the fields of this representation can
         # be trivially provided to the constructor of `java.awt.Color` in Java; it can
         # also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
         # method in iOS; and, with just a little work, it can be easily formatted into a
-        # CSS `rgba()` string in JavaScript. This reference page doesn't carry
+        # CSS `rgba()` string in JavaScript. This reference page doesn't have
         # information about the absolute color space that should be used to interpret
-        # the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default,
+        # the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default,
         # applications should assume the sRGB color space. When color equality needs to
         # be decided, implementations, unless documented otherwise, treat two colors as
-        # equal if all their red, green, blue, and alpha values each differ by at most
-        # 1e-5. Example (Java): import com.google.type.Color; // ... public static java.
+        # equal if all their red, green, blue, and alpha values each differ by at most `
+        # 1e-5`. Example (Java): import com.google.type.Color; // ... public static java.
         # awt.Color fromProto(Color protocolor) ` float alpha = protocolor.hasAlpha() ?
         # protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.
         # getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); ` public static
@@ -1053,29 +1242,34 @@ module Google
         end
       end
       
-      # A button. Can be a text button or an image button.
+      # A text, icon, or text and icon button that users can click. For an example in
+      # Google Chat apps, see [Button list](https://developers.google.com/chat/ui/
+      # widgets/button-list). To make an image a clickable button, specify an `Image` (
+      # not an `ImageComponent`) and set an `onClick` action.
       class GoogleAppsCardV1Button
         include Google::Apis::Core::Hashable
       
-        # The alternative text used for accessibility. Has no effect when an icon is set;
-        # use `icon.alt_text` instead.
+        # The alternative text that's used for accessibility. Set descriptive text that
+        # lets users know what the button does. For 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/chat".
         # Corresponds to the JSON property `altText`
         # @return [String]
         attr_accessor :alt_text
       
         # Represents a color in the RGBA color space. This representation is designed
-        # for simplicity of conversion to/from color representations in various
+        # for simplicity of conversion to and from color representations in various
         # languages over compactness. For example, the fields of this representation can
         # be trivially provided to the constructor of `java.awt.Color` in Java; it can
         # also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
         # method in iOS; and, with just a little work, it can be easily formatted into a
-        # CSS `rgba()` string in JavaScript. This reference page doesn't carry
+        # CSS `rgba()` string in JavaScript. This reference page doesn't have
         # information about the absolute color space that should be used to interpret
-        # the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default,
+        # the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default,
         # applications should assume the sRGB color space. When color equality needs to
         # be decided, implementations, unless documented otherwise, treat two colors as
-        # equal if all their red, green, blue, and alpha values each differ by at most
-        # 1e-5. Example (Java): import com.google.type.Color; // ... public static java.
+        # equal if all their red, green, blue, and alpha values each differ by at most `
+        # 1e-5`. Example (Java): import com.google.type.Color; // ... public static java.
         # awt.Color fromProto(Color protocolor) ` float alpha = protocolor.hasAlpha() ?
         # protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.
         # getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); ` public static
@@ -1112,24 +1306,29 @@ module Google
         # @return [Google::Apis::ChatV1::Color]
         attr_accessor :color
       
-        # If `true`, the button is displayed in a disabled state and doesn't respond to
+        # If `true`, the button is displayed in an inactive state and doesn't respond to
         # user actions.
         # Corresponds to the JSON property `disabled`
         # @return [Boolean]
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # The icon image.
+        # An icon displayed in a widget on a card. For an example in Google Chat apps,
+        # see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [
+        # built-in](https://developers.google.com/chat/api/guides/message-formats/cards#
+        # builtinicons) and [custom](https://developers.google.com/chat/api/guides/
+        # message-formats/cards#customicons) icons.
         # Corresponds to the JSON property `icon`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
         attr_accessor :icon
       
-        # Represents the response to an `onClick` event.
+        # Represents how to respond when users click an interactive element on a card,
+        # such as a button.
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
         attr_accessor :on_click
       
-        # The text of the button.
+        # The text displayed inside the button.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -1149,7 +1348,8 @@ module Google
         end
       end
       
-      # A list of buttons layed out horizontally.
+      # A list of buttons layed out horizontally. For an example in Google Chat apps,
+      # see [Button list](https://developers.google.com/chat/ui/widgets/button-list).
       class GoogleAppsCardV1ButtonList
         include Google::Apis::Core::Hashable
       
@@ -1168,30 +1368,36 @@ module Google
         end
       end
       
-      # A card is a UI element that can contain UI widgets such as text and images.
-      # For more information, see Cards . For example, the following JSON creates a
-      # card that has a header with the name, position, icons, and link for a contact,
-      # followed by a section with contact information like email and phone number. ```
-      # ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "imageStyle":
-      # "ImageStyle.AVATAR", "imageUrl": "https://example.com/sasha.png", "
-      # imageAltText": "Avatar for Sasha" `, "sections" : [ ` "header": "Contact Info",
-      # "widgets": [ ` "decorated_text": ` "icon": ` "knownIcon": "EMAIL" `, "content"
-      # : "sasha@example.com" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "PERSON"
-      # `, "content": "Online" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "
-      # PHONE" `, "content": "+1 (555) 555-1234" ` `, ` "buttons": [ ` "textButton": `
-      # "text": "Share", `, "onClick": ` "openLink": ` "url": "https://example.com/
-      # share" ` ` `, ` "textButton": ` "text": "Edit", `, "onClick": ` "action": ` "
-      # function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT" ` ]
-      # , "loadIndicator": "LoadIndicator.SPINNER" ` ` ` ] ` ], "collapsible": true, "
-      # uncollapsibleWidgetsCount": 3 ` ], "cardActions": [ ` "actionLabel": "Send
-      # Feedback", "onClick": ` "openLink": ` "url": "https://example.com/feedback" ` `
-      # ` ], "name": "contact-card-K3wB6arF2H9L" ` ```
+      # A card interface displayed in a Google Chat message or Google Workspace Add-on.
+      # Cards support a defined layout, interactive UI elements like buttons, and
+      # rich media like images. Use cards to present detailed information, gather
+      # information from users, and guide users to take a next step. To learn how to
+      # build cards, see the following documentation: * For Google Chat apps, see [
+      # Design dynamic, interactive, and consistent UIs with cards](https://developers.
+      # google.com/chat/ui). * For Google Workspace Add-ons, see [Card-based
+      # interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards).
+      # **Example: Card message for a Google Chat app** ![Example contact card](https:/
+      # /developers.google.com/chat/images/card_api_reference.png) To create the
+      # sample card message in Google Chat, use the following JSON: ``` ` "cardsV2": [
+      # ` "cardId": "unique-card-id", "card": ` "header": ` "title": "Sasha", "
+      # subtitle": "Software Engineer", "imageUrl": "https://developers.google.com/
+      # chat/images/quickstart-app-avatar.png", "imageType": "CIRCLE", "imageAltText":
+      # "Avatar for Sasha", `, "sections": [ ` "header": "Contact Info", "collapsible":
+      # true, "uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "
+      # startIcon": ` "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "
+      # decoratedText": ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `,
+      # `, ` "decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (
+      # 555) 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "
+      # onClick": ` "openLink": ` "url": "https://example.com/share", ` ` `, ` "text":
+      # "Edit", "onClick": ` "action": ` "function": "goToView", "parameters": [ ` "
+      # key": "viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
       class GoogleAppsCardV1Card
         include Google::Apis::Core::Hashable
       
-        # The card's actions. Actions are added to the card's generated toolbar menu.
-        # For example, the following JSON constructs a card action menu with Settings
-        # and Send Feedback options: ``` "card_actions": [ ` "actionLabel": "Settings", "
+        # The card's actions. Actions are added to the card's toolbar menu. Because Chat
+        # app cards have no toolbar, `cardActions[]` isn't supported by Chat apps. For
+        # example, the following JSON constructs a card action menu with `Settings` and `
+        # Send Feedback` options: ``` "card_actions": [ ` "actionLabel": "Settings", "
         # onClick": ` "action": ` "functionName": "goToView", "parameters": [ ` "key": "
         # viewType", "value": "SETTING" ` ], "loadIndicator": "LoadIndicator.SPINNER" ` `
         # `, ` "actionLabel": "Send Feedback", "onClick": ` "openLink": ` "url": "https:
@@ -1200,32 +1406,51 @@ module Google
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1CardAction>]
         attr_accessor :card_actions
       
-        # The `peekCardHeader` display style for. Not supported by Google Chat apps.
+        # In Google Workspace add-ons, sets the display properties of the `
+        # peekCardHeader`. Not supported by Chat apps.
         # Corresponds to the JSON property `displayStyle`
         # @return [String]
         attr_accessor :display_style
       
-        # A persistent (sticky) footer that is added to the bottom of the card.
+        # A persistent (sticky) footer that that appears at the bottom of the card. For
+        # an example in Google Chat apps, see [Card footer](https://developers.google.
+        # com/chat/ui/widgets/card-fixed-footer). Setting `fixedFooter` without
+        # specifying a `primaryButton` or a `secondaryButton` causes an error. Supported
+        # by Google Workspace Add-ons and Chat apps. For Chat apps, you can use fixed
+        # footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but
+        # not [card messages](https://developers.google.com/chat/api/guides/message-
+        # formats/cards).
         # Corresponds to the JSON property `fixedFooter`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardFixedFooter]
         attr_accessor :fixed_footer
       
-        # Represents a card header.
+        # Represents a card header. For an example in Google Chat apps, see [Card header]
+        # (https://developers.google.com/chat/ui/widgets/card-header).
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardHeader]
         attr_accessor :header
       
-        # Name of the card. Used as a card identifier in card navigation.
+        # Name of the card. Used as a card identifier in card navigation. Because Chat
+        # apps don't support card navigation, they ignore this field.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Represents a card header.
+        # Represents a card header. For an example in Google Chat apps, see [Card header]
+        # (https://developers.google.com/chat/ui/widgets/card-header).
         # Corresponds to the JSON property `peekCardHeader`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardHeader]
         attr_accessor :peek_card_header
       
-        # Sections are separated by a line divider.
+        # The divider style between sections.
+        # Corresponds to the JSON property `sectionDividerStyle`
+        # @return [String]
+        attr_accessor :section_divider_style
+      
+        # Contains a collection of widgets. Each section has its own, optional header.
+        # Sections are visually separated by a line divider. For an example in Google
+        # Chat apps, see [Card section](https://developers.google.com/chat/ui/widgets/
+        # card-section).
         # Corresponds to the JSON property `sections`
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Section>]
         attr_accessor :sections
@@ -1242,13 +1467,14 @@ module Google
           @header = args[:header] if args.key?(:header)
           @name = args[:name] if args.key?(:name)
           @peek_card_header = args[:peek_card_header] if args.key?(:peek_card_header)
+          @section_divider_style = args[:section_divider_style] if args.key?(:section_divider_style)
           @sections = args[:sections] if args.key?(:sections)
         end
       end
       
       # A card action is the action associated with the card. For example, an invoice
       # card might include actions such as delete invoice, email invoice, or open the
-      # invoice in a browser.
+      # invoice in a browser. Not supported by Chat apps.
       class GoogleAppsCardV1CardAction
         include Google::Apis::Core::Hashable
       
@@ -1257,7 +1483,8 @@ module Google
         # @return [String]
         attr_accessor :action_label
       
-        # Represents the response to an `onClick` event.
+        # Represents how to respond when users click an interactive element on a card,
+        # such as a button.
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
         attr_accessor :on_click
@@ -1273,16 +1500,29 @@ module Google
         end
       end
       
-      # A persistent (sticky) footer that is added to the bottom of the card.
+      # A persistent (sticky) footer that that appears at the bottom of the card. For
+      # an example in Google Chat apps, see [Card footer](https://developers.google.
+      # com/chat/ui/widgets/card-fixed-footer). Setting `fixedFooter` without
+      # specifying a `primaryButton` or a `secondaryButton` causes an error. Supported
+      # by Google Workspace Add-ons and Chat apps. For Chat apps, you can use fixed
+      # footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but
+      # not [card messages](https://developers.google.com/chat/api/guides/message-
+      # formats/cards).
       class GoogleAppsCardV1CardFixedFooter
         include Google::Apis::Core::Hashable
       
-        # A button. Can be a text button or an image button.
+        # A text, icon, or text and icon button that users can click. For an example in
+        # Google Chat apps, see [Button list](https://developers.google.com/chat/ui/
+        # widgets/button-list). To make an image a clickable button, specify an `Image` (
+        # not an `ImageComponent`) and set an `onClick` action.
         # Corresponds to the JSON property `primaryButton`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
         attr_accessor :primary_button
       
-        # A button. Can be a text button or an image button.
+        # A text, icon, or text and icon button that users can click. For an example in
+        # Google Chat apps, see [Button list](https://developers.google.com/chat/ui/
+        # widgets/button-list). To make an image a clickable button, specify an `Image` (
+        # not an `ImageComponent`) and set an `onClick` action.
         # Corresponds to the JSON property `secondaryButton`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
         attr_accessor :secondary_button
@@ -1298,26 +1538,28 @@ module Google
         end
       end
       
-      # Represents a card header.
+      # Represents a card header. For an example in Google Chat apps, see [Card header]
+      # (https://developers.google.com/chat/ui/widgets/card-header).
       class GoogleAppsCardV1CardHeader
         include Google::Apis::Core::Hashable
       
-        # The alternative text of this image which is used for accessibility.
+        # The alternative text of this image that's used for accessibility.
         # Corresponds to the JSON property `imageAltText`
         # @return [String]
         attr_accessor :image_alt_text
       
-        # The image's type.
+        # The shape used to crop the image.
         # Corresponds to the JSON property `imageType`
         # @return [String]
         attr_accessor :image_type
       
-        # The URL of the image in the card header.
+        # The HTTPS URL of the image in the card header.
         # Corresponds to the JSON property `imageUrl`
         # @return [String]
         attr_accessor :image_url
       
-        # The subtitle of the card header.
+        # The subtitle of the card header. If specified, appears on its own line below
+        # the `title`.
         # Corresponds to the JSON property `subtitle`
         # @return [String]
         attr_accessor :subtitle
@@ -1343,45 +1585,127 @@ module Google
         end
       end
       
-      # The widget that lets users to specify a date and time. Not supported by Google
-      # Chat apps.
+      # A column.
+      class GoogleAppsCardV1Column
+        include Google::Apis::Core::Hashable
+      
+        # Specifies whether widgets align to the left, right, or center of a column.
+        # Corresponds to the JSON property `horizontalAlignment`
+        # @return [String]
+        attr_accessor :horizontal_alignment
+      
+        # Specifies how a column fills the width of the card.
+        # Corresponds to the JSON property `horizontalSizeStyle`
+        # @return [String]
+        attr_accessor :horizontal_size_style
+      
+        # Specifies whether widgets align to the top, bottom, or center of a column.
+        # Corresponds to the JSON property `verticalAlignment`
+        # @return [String]
+        attr_accessor :vertical_alignment
+      
+        # An array of widgets included in a column. Widgets appear in the order that
+        # they are specified.
+        # Corresponds to the JSON property `widgets`
+        # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Widgets>]
+        attr_accessor :widgets
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @horizontal_alignment = args[:horizontal_alignment] if args.key?(:horizontal_alignment)
+          @horizontal_size_style = args[:horizontal_size_style] if args.key?(:horizontal_size_style)
+          @vertical_alignment = args[:vertical_alignment] if args.key?(:vertical_alignment)
+          @widgets = args[:widgets] if args.key?(:widgets)
+        end
+      end
+      
+      # The `Columns` widget displays up to 2 columns in a card message or dialog. You
+      # can add widgets to each column; the widgets appear in the order that they are
+      # specified. For an example in Google Chat apps, see [Columns](https://
+      # developers.google.com/chat/ui/widgets/columns). The height of each column is
+      # determined by the taller column. For example, if the first column is taller
+      # than the second column, both columns have the height of the first column.
+      # Because each column can contain a different number of widgets, you can't
+      # define rows or align widgets between the columns. Columns are displayed side-
+      # by-side. You can customize the width of each column using the `
+      # HorizontalSizeStyle` field. If the user's screen width is too narrow, the
+      # second column wraps below the first: * On web, the second column wraps if the
+      # screen width is less than or equal to 480 pixels. * On iOS devices, the second
+      # column wraps if the screen width is less than or equal to 300 pt. * 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 `Grid` widget.
+      # Supported by Chat apps, but not Google Workspace Add-ons.
+      class GoogleAppsCardV1Columns
+        include Google::Apis::Core::Hashable
+      
+        # An array of columns. You can include up to 2 columns in a card or dialog.
+        # Corresponds to the JSON property `columnItems`
+        # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Column>]
+        attr_accessor :column_items
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @column_items = args[:column_items] if args.key?(:column_items)
+        end
+      end
+      
+      # Lets users input a date, a time, or both a date and a time. For an example in
+      # Google Chat apps, see [Date time picker](https://developers.google.com/chat/ui/
+      # widgets/date-time-picker). Users can input text or use the picker to select
+      # dates and times. If users input an invalid date or time, the picker shows an
+      # error that prompts users to input the information correctly.
       class GoogleAppsCardV1DateTimePicker
         include Google::Apis::Core::Hashable
       
-        # The label for the field that displays to the user.
+        # The text that prompts users to input a date, a time, or a date and time. For
+        # example, if users are scheduling an appointment, use a label such as `
+        # Appointment date` or `Appointment date and time`.
         # Corresponds to the JSON property `label`
         # @return [String]
         attr_accessor :label
       
-        # The name of the text input that's used in `formInput`, and uniquely identifies
-        # this input.
+        # The name by which the `DateTimePicker` is identified in a form input event.
+        # For details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `onChangeAction`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :on_change_action
       
         # The number representing the time zone offset from UTC, in minutes. If set, the
-        # `value_ms_epoch` is displayed in the specified time zone. If not set, it uses
-        # the user's time zone setting on the client side.
+        # `value_ms_epoch` is displayed in the specified time zone. If unset, the value
+        # defaults to the user's time zone setting.
         # Corresponds to the JSON property `timezoneOffsetDate`
         # @return [Fixnum]
         attr_accessor :timezone_offset_date
       
-        # The type of the date/time picker.
+        # Whether the widget supports inputting a date, a time, or the date and time.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # The value to display as the default value before user input or previous user
-        # input. It is represented in milliseconds (Epoch time). For `DATE_AND_TIME`
-        # type, the full epoch value is used. For `DATE_ONLY` type, only date of the
-        # epoch time is used. For `TIME_ONLY` type, only time of the epoch time is used.
-        # For example, you can set epoch time to `3 * 60 * 60 * 1000` to represent 3am.
+        # 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`): * `DATE_AND_TIME`: a calendar date and
+        # time in UTC. For example, to represent January 1, 2023 at 12:00 PM UTC, use `
+        # 1672574400000`. * `DATE_ONLY`: a calendar date at 00:00:00 UTC. For example,
+        # to represent 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`).
         # Corresponds to the JSON property `valueMsEpoch`
         # @return [Fixnum]
         attr_accessor :value_ms_epoch
@@ -1402,58 +1726,81 @@ module Google
       end
       
       # A widget that displays text with optional decorations such as a label above or
-      # below the text, an icon in front of the text, a selection widget or a button
-      # after the text.
+      # below the text, an icon in front of the text, a selection widget, or a button
+      # after the text. For an example in Google Chat apps, see [Decorated text](https:
+      # //developers.google.com/chat/ui/widgets/decorated-text).
       class GoogleAppsCardV1DecoratedText
         include Google::Apis::Core::Hashable
       
-        # The formatted text label that shows below the main text.
+        # The text that appears below `text`. Always wraps.
         # Corresponds to the JSON property `bottomLabel`
         # @return [String]
         attr_accessor :bottom_label
       
-        # A button. Can be a text button or an image button.
+        # A text, icon, or text and icon button that users can click. For an example in
+        # Google Chat apps, see [Button list](https://developers.google.com/chat/ui/
+        # widgets/button-list). To make an image a clickable button, specify an `Image` (
+        # not an `ImageComponent`) and set an `onClick` action.
         # Corresponds to the JSON property `button`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
         attr_accessor :button
       
-        # An icon displayed after the text.
+        # An icon displayed in a widget on a card. For an example in Google Chat apps,
+        # see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [
+        # built-in](https://developers.google.com/chat/api/guides/message-formats/cards#
+        # builtinicons) and [custom](https://developers.google.com/chat/api/guides/
+        # message-formats/cards#customicons) icons.
         # Corresponds to the JSON property `endIcon`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
         attr_accessor :end_icon
       
-        # Deprecated in favor of start_icon.
+        # An icon displayed in a widget on a card. For an example in Google Chat apps,
+        # see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [
+        # built-in](https://developers.google.com/chat/api/guides/message-formats/cards#
+        # builtinicons) and [custom](https://developers.google.com/chat/api/guides/
+        # message-formats/cards#customicons) icons.
         # Corresponds to the JSON property `icon`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
         attr_accessor :icon
       
-        # Represents the response to an `onClick` event.
+        # Represents how to respond when users click an interactive element on a card,
+        # such as a button.
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
         attr_accessor :on_click
       
-        # The icon displayed in front of the text.
+        # An icon displayed in a widget on a card. For an example in Google Chat apps,
+        # see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [
+        # built-in](https://developers.google.com/chat/api/guides/message-formats/cards#
+        # builtinicons) and [custom](https://developers.google.com/chat/api/guides/
+        # message-formats/cards#customicons) icons.
         # Corresponds to the JSON property `startIcon`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
         attr_accessor :start_icon
       
-        # Either a toggle-style switch or a checkbox.
+        # Either a toggle-style switch or a checkbox inside a `decoratedText` widget.
+        # Only supported in the `decoratedText` widget.
         # Corresponds to the JSON property `switchControl`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1SwitchControl]
         attr_accessor :switch_control
       
-        # Required. The main widget formatted text. See Text formatting for details.
+        # Required. The primary text. Supports simple formatting. For more information
+        # about formatting text, see [Formatting text in Google Chat apps](https://
+        # developers.google.com/chat/api/guides/message-formats/cards#card-formatting)
+        # and [Formatting text in Google Workspace Add-ons](https://developers.google.
+        # com/apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # The formatted text label that shows above the main text.
+        # The text that appears above `text`. Always truncates.
         # Corresponds to the JSON property `topLabel`
         # @return [String]
         attr_accessor :top_label
       
-        # The wrap text setting. If `true`, the text is wrapped and displayed in
-        # multiline. Otherwise, the text is truncated.
+        # The wrap text setting. If `true`, the text wraps and displays on multiple
+        # lines. Otherwise, the text is truncated. Only applies to `text`, not `topLabel`
+        # and `bottomLabel`.
         # Corresponds to the JSON property `wrapText`
         # @return [Boolean]
         attr_accessor :wrap_text
@@ -1478,7 +1825,10 @@ module Google
         end
       end
       
-      # A divider that appears in between widgets.
+      # Displays a divider between widgets as a horizontal line. For an example in
+      # Google Chat apps, see [Divider](https://developers.google.com/chat/ui/widgets/
+      # divider). For example, the following JSON creates a divider: ``` "divider": ``
+      # ```
       class GoogleAppsCardV1Divider
         include Google::Apis::Core::Hashable
       
@@ -1491,11 +1841,24 @@ module Google
         end
       end
       
-      # Represents a Grid widget that displays items in a configurable grid layout.
+      # Displays a grid with a collection of items. Items can only include text or
+      # images. For responsive columns, or to include more than text or images, use `
+      # Columns`. For an example in Google Chat apps, see [Grid](https://developers.
+      # google.com/chat/ui/widgets/grid). A grid supports any number of columns and
+      # items. The number of rows is determined by items divided by columns. A grid
+      # with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has
+      # 6 rows. For example, the following JSON creates a 2 column grid with a single
+      # item: ``` "grid": ` "title": "A fine collection of items", "columnCount": 2, "
+      # borderStyle": ` "type": "STROKE", "cornerRadius": 4 `, "items": [ ` "image": `
+      # "imageUri": "https://www.example.com/image.png", "cropStyle": ` "type": "
+      # SQUARE" `, "borderStyle": ` "type": "STROKE" ` `, "title": "An item", "
+      # textAlignment": "CENTER" ` ], "onClick": ` "openLink": ` "url": "https://www.
+      # example.com" ` ` ` ```
       class GoogleAppsCardV1Grid
         include Google::Apis::Core::Hashable
       
-        # Represents the complete border style applied to widgets.
+        # The style options for the border of a card or widget, including the border
+        # type and color.
         # Corresponds to the JSON property `borderStyle`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1BorderStyle]
         attr_accessor :border_style
@@ -1512,7 +1875,8 @@ module Google
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1GridItem>]
         attr_accessor :items
       
-        # Represents the response to an `onClick` event.
+        # Represents how to respond when users click an interactive element on a card,
+        # such as a button.
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
         attr_accessor :on_click
@@ -1536,12 +1900,13 @@ module Google
         end
       end
       
-      # Represents a single item in the grid layout.
+      # Represents an item in a grid layout. Items can contain text, an image, or both
+      # text and an image.
       class GoogleAppsCardV1GridItem
         include Google::Apis::Core::Hashable
       
         # A user-specified identifier for this grid item. This identifier is returned in
-        # the parent Grid's onClick callback parameters.
+        # the parent grid's `onClick` callback parameters.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -1561,11 +1926,6 @@ module Google
         # @return [String]
         attr_accessor :subtitle
       
-        # The horizontal alignment of the grid item's text.
-        # Corresponds to the JSON property `textAlignment`
-        # @return [String]
-        attr_accessor :text_alignment
-      
         # The grid item's title.
         # Corresponds to the JSON property `title`
         # @return [String]
@@ -1581,33 +1941,47 @@ module Google
           @image = args[:image] if args.key?(:image)
           @layout = args[:layout] if args.key?(:layout)
           @subtitle = args[:subtitle] if args.key?(:subtitle)
-          @text_alignment = args[:text_alignment] if args.key?(:text_alignment)
           @title = args[:title] if args.key?(:title)
         end
       end
       
-      # 
+      # An icon displayed in a widget on a card. For an example in Google Chat apps,
+      # see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [
+      # built-in](https://developers.google.com/chat/api/guides/message-formats/cards#
+      # builtinicons) and [custom](https://developers.google.com/chat/api/guides/
+      # message-formats/cards#customicons) icons.
       class GoogleAppsCardV1Icon
         include Google::Apis::Core::Hashable
       
-        # The description of the icon, used for accessibility. The default value is
-        # provided if you don't specify one.
+        # Optional. A description of the icon used for accessibility. If unspecified,
+        # the default value `Button` is provided. As a best practice, you should set a
+        # helpful description for what the icon displays, and if applicable, what it
+        # does. For example, `A user's account portrait`, or `Opens a new browser tab
+        # and navigates to the Google Chat developer documentation at https://developers.
+        # google.com/chat`. If the icon is set in a `Button`, the `altText` appears as
+        # helper text when the user hovers over the button. However, if the button also
+        # sets `text`, the icon's `altText` is ignored.
         # Corresponds to the JSON property `altText`
         # @return [String]
         attr_accessor :alt_text
       
-        # The icon specified by a URL.
+        # Display a custom icon hosted at an HTTPS URL. For example: ``` "iconUrl": "
+        # https://developers.google.com/chat/images/quickstart-app-avatar.png" ```
+        # Supported file types include `.png` and `.jpg`.
         # Corresponds to the JSON property `iconUrl`
         # @return [String]
         attr_accessor :icon_url
       
         # The crop style applied to the image. In some cases, applying a `CIRCLE` crop
-        # causes the image to be drawn larger than a standard icon.
+        # causes the image to be drawn larger than a built-in icon.
         # Corresponds to the JSON property `imageType`
         # @return [String]
         attr_accessor :image_type
       
-        # The icon specified by the string name of a list of known icons.
+        # Display one of the built-in icons provided by Google Workspace. For example,
+        # to display an airplane icon, specify `AIRPLANE`. For a bus, specify `BUS`. For
+        # a full list of supported icons, see [built-in icons](https://developers.google.
+        # com/chat/api/guides/message-formats/cards#builtinicons).
         # Corresponds to the JSON property `knownIcon`
         # @return [String]
         attr_accessor :known_icon
@@ -1625,21 +1999,24 @@ module Google
         end
       end
       
-      # An image that is specified by a URL and can have an `onClick` action.
+      # An image that is specified by a URL and can have an `onClick` action. For an
+      # example, see [Image](https://developers.google.com/chat/ui/widgets/image).
       class GoogleAppsCardV1Image
         include Google::Apis::Core::Hashable
       
-        # The alternative text of this image, used for accessibility.
+        # The alternative text of this image that's used for accessibility.
         # Corresponds to the JSON property `altText`
         # @return [String]
         attr_accessor :alt_text
       
-        # An image URL.
+        # The HTTPS URL that hosts the image. For example: ``` https://developers.google.
+        # com/chat/images/quickstart-app-avatar.png ```
         # Corresponds to the JSON property `imageUrl`
         # @return [String]
         attr_accessor :image_url
       
-        # Represents the response to an `onClick` event.
+        # Represents how to respond when users click an interactive element on a card,
+        # such as a button.
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
         attr_accessor :on_click
@@ -1665,12 +2042,15 @@ module Google
         # @return [String]
         attr_accessor :alt_text
       
-        # Represents the complete border style applied to widgets.
+        # The style options for the border of a card or widget, including the border
+        # type and color.
         # Corresponds to the JSON property `borderStyle`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1BorderStyle]
         attr_accessor :border_style
       
-        # Represents the crop style applied to an image.
+        # Represents the crop style applied to an image. For example, here's how to
+        # apply a 16:9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM", "
+        # aspectRatio": 16/9 ` ```
         # Corresponds to the JSON property `cropStyle`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1ImageCropStyle]
         attr_accessor :crop_style
@@ -1693,11 +2073,15 @@ module Google
         end
       end
       
-      # Represents the crop style applied to an image.
+      # Represents the crop style applied to an image. For example, here's how to
+      # apply a 16:9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM", "
+      # aspectRatio": 16/9 ` ```
       class GoogleAppsCardV1ImageCropStyle
         include Google::Apis::Core::Hashable
       
-        # The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`.
+        # The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. For example,
+        # here's how to apply a 16:9 aspect ratio: ``` cropStyle ` "type": "
+        # RECTANGLE_CUSTOM", "aspectRatio": 16/9 ` ```
         # Corresponds to the JSON property `aspectRatio`
         # @return [Float]
         attr_accessor :aspect_ratio
@@ -1718,40 +2102,48 @@ module Google
         end
       end
       
-      # Represents the response to an `onClick` event.
+      # Represents how to respond when users click an interactive element on a card,
+      # such as a button.
       class GoogleAppsCardV1OnClick
         include Google::Apis::Core::Hashable
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `action`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :action
       
-        # A card is a UI element that can contain UI widgets such as text and images.
-        # For more information, see Cards . For example, the following JSON creates a
-        # card that has a header with the name, position, icons, and link for a contact,
-        # followed by a section with contact information like email and phone number. ```
-        # ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "imageStyle":
-        # "ImageStyle.AVATAR", "imageUrl": "https://example.com/sasha.png", "
-        # imageAltText": "Avatar for Sasha" `, "sections" : [ ` "header": "Contact Info",
-        # "widgets": [ ` "decorated_text": ` "icon": ` "knownIcon": "EMAIL" `, "content"
-        # : "sasha@example.com" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "PERSON"
-        # `, "content": "Online" ` `, ` "decoratedText": ` "icon": ` "knownIcon": "
-        # PHONE" `, "content": "+1 (555) 555-1234" ` `, ` "buttons": [ ` "textButton": `
-        # "text": "Share", `, "onClick": ` "openLink": ` "url": "https://example.com/
-        # share" ` ` `, ` "textButton": ` "text": "Edit", `, "onClick": ` "action": ` "
-        # function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT" ` ]
-        # , "loadIndicator": "LoadIndicator.SPINNER" ` ` ` ] ` ], "collapsible": true, "
-        # uncollapsibleWidgetsCount": 3 ` ], "cardActions": [ ` "actionLabel": "Send
-        # Feedback", "onClick": ` "openLink": ` "url": "https://example.com/feedback" ` `
-        # ` ], "name": "contact-card-K3wB6arF2H9L" ` ```
+        # A card interface displayed in a Google Chat message or Google Workspace Add-on.
+        # Cards support a defined layout, interactive UI elements like buttons, and
+        # rich media like images. Use cards to present detailed information, gather
+        # information from users, and guide users to take a next step. To learn how to
+        # build cards, see the following documentation: * For Google Chat apps, see [
+        # Design dynamic, interactive, and consistent UIs with cards](https://developers.
+        # google.com/chat/ui). * For Google Workspace Add-ons, see [Card-based
+        # interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards).
+        # **Example: Card message for a Google Chat app** ![Example contact card](https:/
+        # /developers.google.com/chat/images/card_api_reference.png) To create the
+        # sample card message in Google Chat, use the following JSON: ``` ` "cardsV2": [
+        # ` "cardId": "unique-card-id", "card": ` "header": ` "title": "Sasha", "
+        # subtitle": "Software Engineer", "imageUrl": "https://developers.google.com/
+        # chat/images/quickstart-app-avatar.png", "imageType": "CIRCLE", "imageAltText":
+        # "Avatar for Sasha", `, "sections": [ ` "header": "Contact Info", "collapsible":
+        # true, "uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "
+        # startIcon": ` "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "
+        # decoratedText": ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `,
+        # `, ` "decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (
+        # 555) 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "
+        # onClick": ` "openLink": ` "url": "https://example.com/share", ` ` `, ` "text":
+        # "Edit", "onClick": ` "action": ` "function": "goToView", "parameters": [ ` "
+        # key": "viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
         # Corresponds to the JSON property `card`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Card]
         attr_accessor :card
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `openDynamicLinkAction`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :open_dynamic_link_action
@@ -1806,34 +2198,75 @@ module Google
         end
       end
       
+      # Chat apps only. For a `SelectionInput` widget that uses a multi-select menu,
+      # the data from a [Google Workspace host application](https://developers.google.
+      # com/chat/api/reference/rest/v1/HostApp). Used to populate the items in the
+      # multi-select menu. [Developer Preview](https://developers.google.com/workspace/
+      # preview).
+      class GoogleAppsCardV1PlatformDataSource
+        include Google::Apis::Core::Hashable
+      
+        # For a `SelectionInput` widget that uses a multi-select menu, a data source
+        # shared by all Google Workspace host applications, such as users in a Google
+        # Workspace organization. [Developer Preview](https://developers.google.com/
+        # workspace/preview).
+        # Corresponds to the JSON property `commonDataSource`
+        # @return [String]
+        attr_accessor :common_data_source
+      
+        # Chat apps only. For a `SelectionInput` widget that uses a multi-select menu, a
+        # data source from a Google Workspace host application. [Developer Preview](
+        # https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `hostAppDataSource`
+        # @return [Google::Apis::ChatV1::HostAppDataSourceMarkup]
+        attr_accessor :host_app_data_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @common_data_source = args[:common_data_source] if args.key?(:common_data_source)
+          @host_app_data_source = args[:host_app_data_source] if args.key?(:host_app_data_source)
+        end
+      end
+      
       # A section contains a collection of widgets that are rendered vertically in the
-      # order that they are specified. Across all platforms, cards have a narrow fixed
-      # width, so there is currently no need for layout properties, for example, float.
+      # order that they're specified.
       class GoogleAppsCardV1Section
         include Google::Apis::Core::Hashable
       
-        # Indicates whether this section is collapsible. If a section is collapsible,
-        # the description must be given.
+        # Indicates whether this section is collapsible. Collapsible sections hide some
+        # or all widgets, but users can expand the section to reveal the hidden widgets
+        # by clicking **Show more**. Users can hide the widgets again by clicking **Show
+        # less**. To determine which widgets are hidden, specify `
+        # uncollapsibleWidgetsCount`.
         # Corresponds to the JSON property `collapsible`
         # @return [Boolean]
         attr_accessor :collapsible
         alias_method :collapsible?, :collapsible
       
-        # The header of the section. Formatted text is supported.
+        # Text that appears at the top of a section. Supports simple HTML formatted text.
+        # For more information about formatting text, see [Formatting text in Google
+        # Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#
+        # card-formatting) and [Formatting text in Google Workspace Add-ons](https://
+        # developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `header`
         # @return [String]
         attr_accessor :header
       
-        # The number of uncollapsible widgets. For example, when a section contains five
-        # widgets and the `uncollapsibleWidgetsCount` is set to `2`, the first two
-        # widgets are always shown and the last three are collapsed as default. The `
+        # The number of uncollapsible widgets which remain visible even when a section
+        # is collapsed. For example, when a section contains five widgets and the `
+        # uncollapsibleWidgetsCount` is set to `2`, 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`.
         # Corresponds to the JSON property `uncollapsibleWidgetsCount`
         # @return [Fixnum]
         attr_accessor :uncollapsible_widgets_count
       
-        # A section must contain at least 1 widget.
+        # All the widgets in the section. Must contain at least one widget.
         # Corresponds to the JSON property `widgets`
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Widget>]
         attr_accessor :widgets
@@ -1851,33 +2284,81 @@ module Google
         end
       end
       
-      # A widget that creates a UI item with options for users to select. For example,
-      # a dropdown menu.
+      # 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 [
+      # Selection input](https://developers.google.com/chat/ui/widgets/selection-input)
+      # . Chat apps can process the value of items that users select or input. For
+      # details about working with form inputs, see [Receive form data](https://
+      # developers.google.com/chat/ui/read-form-data). To collect undefined or
+      # abstract data from users, use the TextInput widget.
       class GoogleAppsCardV1SelectionInput
         include Google::Apis::Core::Hashable
       
-        # An array of the selected items.
+        # An action that describes the behavior when the form is submitted. 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.
+        # Corresponds to the JSON property `externalDataSource`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
+        attr_accessor :external_data_source
+      
+        # An array of selectable items. For example, an array of radio buttons or
+        # checkboxes. Supports up to 100 items.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1SelectionItem>]
         attr_accessor :items
       
-        # The label displayed ahead of the switch control.
+        # The text that appears above the selection input field in the user interface.
+        # Specify text that helps the user enter the information your app needs. For
+        # example, if users are selecting the urgency of a work ticket from a drop-down
+        # menu, the label might be "Urgency" or "Select urgency".
         # Corresponds to the JSON property `label`
         # @return [String]
         attr_accessor :label
       
-        # The name of the text input which is used in `formInput`.
+        # For multi-select menus, the maximum number of items that a user can select.
+        # Minimum value is 1 item. If unspecified, set to 3 items. [Developer Preview](
+        # https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `multiSelectMaxSelectedItems`
+        # @return [Fixnum]
+        attr_accessor :multi_select_max_selected_items
+      
+        # For multi-select menus, the number of text characters that a user inputs
+        # before the Chat app queries autocomplete and displays suggested items on the
+        # card. If unspecified, set to 0 characters for static data sources and 3
+        # characters for external data sources. [Developer Preview](https://developers.
+        # google.com/workspace/preview).
+        # Corresponds to the JSON property `multiSelectMinQueryLength`
+        # @return [Fixnum]
+        attr_accessor :multi_select_min_query_length
+      
+        # 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/chat/ui/read-form-data).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `onChangeAction`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :on_change_action
       
-        # The type of the selection.
+        # Chat apps only. For a `SelectionInput` widget that uses a multi-select menu,
+        # the data from a [Google Workspace host application](https://developers.google.
+        # com/chat/api/reference/rest/v1/HostApp). Used to populate the items in the
+        # multi-select menu. [Developer Preview](https://developers.google.com/workspace/
+        # preview).
+        # Corresponds to the JSON property `platformDataSource`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1PlatformDataSource]
+        attr_accessor :platform_data_source
+      
+        # The type of items that are displayed to users in a `SelectionInput` widget.
+        # Selection types support different types of interactions. For example, users
+        # can select one or more checkboxes, but they can only select one value from a
+        # dropdown menu.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1888,32 +2369,54 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @external_data_source = args[:external_data_source] if args.key?(:external_data_source)
           @items = args[:items] if args.key?(:items)
           @label = args[:label] if args.key?(:label)
+          @multi_select_max_selected_items = args[:multi_select_max_selected_items] if args.key?(:multi_select_max_selected_items)
+          @multi_select_min_query_length = args[:multi_select_min_query_length] if args.key?(:multi_select_min_query_length)
           @name = args[:name] if args.key?(:name)
           @on_change_action = args[:on_change_action] if args.key?(:on_change_action)
+          @platform_data_source = args[:platform_data_source] if args.key?(:platform_data_source)
           @type = args[:type] if args.key?(:type)
         end
       end
       
-      # A selectable item in the switch control.
+      # An item that users can select in a selection input, such as a checkbox or
+      # switch.
       class GoogleAppsCardV1SelectionItem
         include Google::Apis::Core::Hashable
       
-        # If more than one item is selected for `RADIO_BUTTON` and `DROPDOWN`, the first
-        # selected item is treated as selected and the ones after are ignored.
+        # For multi-select menus, a text description or label that's displayed below the
+        # item's `text` field. [Developer Preview](https://developers.google.com/
+        # workspace/preview).
+        # Corresponds to the JSON property `bottomText`
+        # @return [String]
+        attr_accessor :bottom_text
+      
+        # Whether the item is selected by default. If the selection input only accepts
+        # one value (such as for radio buttons or a dropdown menu), only set this field
+        # for one item.
         # Corresponds to the JSON property `selected`
         # @return [Boolean]
         attr_accessor :selected
         alias_method :selected?, :selected
       
-        # The text to be displayed.
+        # For multi-select 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/chat/images/quickstart-app-avatar.png`. [
+        # Developer Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `startIconUri`
+        # @return [String]
+        attr_accessor :start_icon_uri
+      
+        # The text that identifies or describes the item to users.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
         # The value associated with this item. The client should use this as a form
-        # input value.
+        # input value. For details about working with form inputs, see [Receive form
+        # data](https://developers.google.com/chat/ui/read-form-data).
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1924,17 +2427,20 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @bottom_text = args[:bottom_text] if args.key?(:bottom_text)
           @selected = args[:selected] if args.key?(:selected)
+          @start_icon_uri = args[:start_icon_uri] if args.key?(:start_icon_uri)
           @text = args[:text] if args.key?(:text)
           @value = args[:value] if args.key?(:value)
         end
       end
       
-      # A suggestion item.
+      # One suggested value that users can enter in a text input field.
       class GoogleAppsCardV1SuggestionItem
         include Google::Apis::Core::Hashable
       
-        # The suggested autocomplete result.
+        # The value of a suggested input to a text input field. This is equivalent to
+        # what users enter themselves.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -1949,12 +2455,21 @@ module Google
         end
       end
       
-      # A container wrapping elements necessary for showing suggestion items used in
-      # text input autocomplete.
+      # Suggested values that users can enter. These values appear when users click
+      # inside the text input field. As users type, the suggested values dynamically
+      # filter to match what the users have typed. For example, a text input field for
+      # programming language might suggest Java, JavaScript, Python, and C++. When
+      # users start typing `Jav`, the list of suggestions filters to show `Java` and `
+      # JavaScript`. Suggested values help guide users to enter values that your app
+      # can make sense of. When referring to JavaScript, some users might enter `
+      # javascript` and others `java script`. Suggesting `JavaScript` can standardize
+      # how users interact with your app. When specified, `TextInput.type` is always `
+      # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`.
       class GoogleAppsCardV1Suggestions
         include Google::Apis::Core::Hashable
       
-        # A list of suggestions used for autocomplete recommendations.
+        # A list of suggestions used for autocomplete recommendations in text input
+        # fields.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1SuggestionItem>]
         attr_accessor :items
@@ -1969,33 +2484,39 @@ module Google
         end
       end
       
-      # Either a toggle-style switch or a checkbox.
+      # Either a toggle-style switch or a checkbox inside a `decoratedText` widget.
+      # Only supported in the `decoratedText` widget.
       class GoogleAppsCardV1SwitchControl
         include Google::Apis::Core::Hashable
       
-        # The control type, either switch or checkbox.
+        # How the switch appears in the user interface.
         # Corresponds to the JSON property `controlType`
         # @return [String]
         attr_accessor :control_type
       
-        # The name of the switch widget that's used in `formInput`.
+        # The name by which the switch widget is identified in a form input event. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `onChangeAction`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :on_change_action
       
-        # If the switch is selected.
+        # When `true`, the switch is selected.
         # Corresponds to the JSON property `selected`
         # @return [Boolean]
         attr_accessor :selected
         alias_method :selected?, :selected
       
-        # The value is what is passed back in the callback.
+        # The value entered by a user, returned as part of a form input event. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data).
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2014,50 +2535,77 @@ module Google
         end
       end
       
-      # A text input is a UI item where users can input text. A text input can also
-      # have an onChange action and suggestions.
+      # A field in which users can enter text. Supports suggestions and on-change
+      # actions. For an example in Google Chat apps, see [Text input](https://
+      # developers.google.com/chat/ui/widgets/text-input). Chat apps receive and can
+      # process the value of entered text during form input events. For details about
+      # working with form inputs, see [Receive form data](https://developers.google.
+      # com/chat/ui/read-form-data). When you need to collect undefined or abstract
+      # data from users, use a text input. To collect defined or enumerated data from
+      # users, use the SelectionInput widget.
       class GoogleAppsCardV1TextInput
         include Google::Apis::Core::Hashable
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `autoCompleteAction`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :auto_complete_action
       
-        # The hint text.
+        # Text that appears below the text input field meant to assist users by
+        # prompting them to enter a certain value. This text is always visible. Required
+        # if `label` is unspecified. Otherwise, optional.
         # Corresponds to the JSON property `hintText`
         # @return [String]
         attr_accessor :hint_text
       
-        # A container wrapping elements necessary for showing suggestion items used in
-        # text input autocomplete.
+        # Suggested values that users can enter. These values appear when users click
+        # inside the text input field. As users type, the suggested values dynamically
+        # filter to match what the users have typed. For example, a text input field for
+        # programming language might suggest Java, JavaScript, Python, and C++. When
+        # users start typing `Jav`, the list of suggestions filters to show `Java` and `
+        # JavaScript`. Suggested values help guide users to enter values that your app
+        # can make sense of. When referring to JavaScript, some users might enter `
+        # javascript` and others `java script`. Suggesting `JavaScript` can standardize
+        # how users interact with your app. When specified, `TextInput.type` is always `
+        # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`.
         # Corresponds to the JSON property `initialSuggestions`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Suggestions]
         attr_accessor :initial_suggestions
       
-        # At least one of label and hintText must be specified.
+        # The text that appears above the text input field in the user interface.
+        # Specify text that helps the user enter the information your app needs. For
+        # example, if you are asking someone's name, but specifically need their surname,
+        # write `surname` instead of `name`. Required if `hintText` is unspecified.
+        # Otherwise, optional.
         # Corresponds to the JSON property `label`
         # @return [String]
         attr_accessor :label
       
-        # The name of the text input which is used in `formInput`.
+        # The name by which the text input is identified in a form input event. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # An action that describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke an Apps Script script to handle the form. If the action is
+        # triggered, the form values are sent to the server.
         # Corresponds to the JSON property `onChangeAction`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :on_change_action
       
-        # The style of the text, for example, a single line or multiple lines.
+        # How a text input field appears in the user interface. For example, whether the
+        # field is single or multi-line.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # The default value when there is no input from the user.
+        # The value entered by a user, returned as part of a form input event. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data).
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2079,9 +2627,13 @@ module Google
         end
       end
       
-      # A paragraph of text that supports formatting. See [Text formatting](https://
-      # developers.google.com/workspace/add-ons/concepts/widgets#text_formatting) for
-      # details.
+      # A paragraph of text that supports formatting. For an example in Google Chat
+      # apps, see [Text paragraph](https://developers.google.com/chat/ui/widgets/text-
+      # paragraph). For more information about formatting text, see [Formatting text
+      # in Google Chat apps](https://developers.google.com/chat/api/guides/message-
+      # formats/cards##card-formatting) and [Formatting text in Google Workspace Add-
+      # ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#
+      # text_formatting).
       class GoogleAppsCardV1TextParagraph
         include Google::Apis::Core::Hashable
       
@@ -2100,63 +2652,121 @@ module Google
         end
       end
       
-      # A widget is a UI element that presents texts, images, etc.
+      # Each card is made up of widgets. A widget is a composite object that can
+      # represent one of text, images, buttons, and other object types.
       class GoogleAppsCardV1Widget
         include Google::Apis::Core::Hashable
       
-        # A list of buttons layed out horizontally.
+        # A list of buttons layed out horizontally. For an example in Google Chat apps,
+        # see [Button list](https://developers.google.com/chat/ui/widgets/button-list).
         # Corresponds to the JSON property `buttonList`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
         attr_accessor :button_list
       
-        # The widget that lets users to specify a date and time. Not supported by Google
-        # Chat apps.
+        # The `Columns` widget displays up to 2 columns in a card message or dialog. You
+        # can add widgets to each column; the widgets appear in the order that they are
+        # specified. For an example in Google Chat apps, see [Columns](https://
+        # developers.google.com/chat/ui/widgets/columns). The height of each column is
+        # determined by the taller column. For example, if the first column is taller
+        # than the second column, both columns have the height of the first column.
+        # Because each column can contain a different number of widgets, you can't
+        # define rows or align widgets between the columns. Columns are displayed side-
+        # by-side. You can customize the width of each column using the `
+        # HorizontalSizeStyle` field. If the user's screen width is too narrow, the
+        # second column wraps below the first: * On web, the second column wraps if the
+        # screen width is less than or equal to 480 pixels. * On iOS devices, the second
+        # column wraps if the screen width is less than or equal to 300 pt. * 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 `Grid` widget.
+        # Supported by Chat apps, but not Google Workspace Add-ons.
+        # Corresponds to the JSON property `columns`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1Columns]
+        attr_accessor :columns
+      
+        # Lets users input a date, a time, or both a date and a time. For an example in
+        # Google Chat apps, see [Date time picker](https://developers.google.com/chat/ui/
+        # widgets/date-time-picker). Users can input text or use the picker to select
+        # dates and times. If users input an invalid date or time, the picker shows an
+        # error that prompts users to input the information correctly.
         # Corresponds to the JSON property `dateTimePicker`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
         attr_accessor :date_time_picker
       
         # A widget that displays text with optional decorations such as a label above or
-        # below the text, an icon in front of the text, a selection widget or a button
-        # after the text.
+        # below the text, an icon in front of the text, a selection widget, or a button
+        # after the text. For an example in Google Chat apps, see [Decorated text](https:
+        # //developers.google.com/chat/ui/widgets/decorated-text).
         # Corresponds to the JSON property `decoratedText`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
         attr_accessor :decorated_text
       
-        # A divider that appears in between widgets.
+        # Displays a divider between widgets as a horizontal line. For an example in
+        # Google Chat apps, see [Divider](https://developers.google.com/chat/ui/widgets/
+        # divider). For example, the following JSON creates a divider: ``` "divider": ``
+        # ```
         # Corresponds to the JSON property `divider`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Divider]
         attr_accessor :divider
       
-        # Represents a Grid widget that displays items in a configurable grid layout.
+        # Displays a grid with a collection of items. Items can only include text or
+        # images. For responsive columns, or to include more than text or images, use `
+        # Columns`. For an example in Google Chat apps, see [Grid](https://developers.
+        # google.com/chat/ui/widgets/grid). A grid supports any number of columns and
+        # items. The number of rows is determined by items divided by columns. A grid
+        # with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has
+        # 6 rows. For example, the following JSON creates a 2 column grid with a single
+        # item: ``` "grid": ` "title": "A fine collection of items", "columnCount": 2, "
+        # borderStyle": ` "type": "STROKE", "cornerRadius": 4 `, "items": [ ` "image": `
+        # "imageUri": "https://www.example.com/image.png", "cropStyle": ` "type": "
+        # SQUARE" `, "borderStyle": ` "type": "STROKE" ` `, "title": "An item", "
+        # textAlignment": "CENTER" ` ], "onClick": ` "openLink": ` "url": "https://www.
+        # example.com" ` ` ` ```
         # Corresponds to the JSON property `grid`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Grid]
         attr_accessor :grid
       
-        # The horizontal alignment of this widget.
+        # Specifies whether widgets align to the left, right, or center of a column.
         # Corresponds to the JSON property `horizontalAlignment`
         # @return [String]
         attr_accessor :horizontal_alignment
       
-        # An image that is specified by a URL and can have an `onClick` action.
+        # An image that is specified by a URL and can have an `onClick` action. For an
+        # example, see [Image](https://developers.google.com/chat/ui/widgets/image).
         # Corresponds to the JSON property `image`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
         attr_accessor :image
       
-        # A widget that creates a UI item with options for users to select. For example,
-        # a dropdown menu.
+        # 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 [
+        # Selection input](https://developers.google.com/chat/ui/widgets/selection-input)
+        # . Chat apps can process the value of items that users select or input. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data). To collect undefined or
+        # abstract data from users, use the TextInput widget.
         # Corresponds to the JSON property `selectionInput`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1SelectionInput]
         attr_accessor :selection_input
       
-        # A text input is a UI item where users can input text. A text input can also
-        # have an onChange action and suggestions.
+        # A field in which users can enter text. Supports suggestions and on-change
+        # actions. For an example in Google Chat apps, see [Text input](https://
+        # developers.google.com/chat/ui/widgets/text-input). Chat apps receive and can
+        # process the value of entered text during form input events. For details about
+        # working with form inputs, see [Receive form data](https://developers.google.
+        # com/chat/ui/read-form-data). When you need to collect undefined or abstract
+        # data from users, use a text input. To collect defined or enumerated data from
+        # users, use the SelectionInput widget.
         # Corresponds to the JSON property `textInput`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
         attr_accessor :text_input
       
-        # A paragraph of text that supports formatting. See [Text formatting](https://
-        # developers.google.com/workspace/add-ons/concepts/widgets#text_formatting) for
-        # details.
+        # A paragraph of text that supports formatting. For an example in Google Chat
+        # apps, see [Text paragraph](https://developers.google.com/chat/ui/widgets/text-
+        # paragraph). For more information about formatting text, see [Formatting text
+        # in Google Chat apps](https://developers.google.com/chat/api/guides/message-
+        # formats/cards##card-formatting) and [Formatting text in Google Workspace Add-
+        # ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#
+        # text_formatting).
         # Corresponds to the JSON property `textParagraph`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
         attr_accessor :text_paragraph
@@ -2168,6 +2778,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @button_list = args[:button_list] if args.key?(:button_list)
+          @columns = args[:columns] if args.key?(:columns)
           @date_time_picker = args[:date_time_picker] if args.key?(:date_time_picker)
           @decorated_text = args[:decorated_text] if args.key?(:decorated_text)
           @divider = args[:divider] if args.key?(:divider)
@@ -2180,14 +2791,122 @@ module Google
         end
       end
       
-      # An image that is specified by a URL and can have an onclick action.
+      # The supported widgets that you can include in a column.
+      class GoogleAppsCardV1Widgets
+        include Google::Apis::Core::Hashable
+      
+        # A list of buttons layed out horizontally. For an example in Google Chat apps,
+        # see [Button list](https://developers.google.com/chat/ui/widgets/button-list).
+        # Corresponds to the JSON property `buttonList`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
+        attr_accessor :button_list
+      
+        # Lets users input a date, a time, or both a date and a time. For an example in
+        # Google Chat apps, see [Date time picker](https://developers.google.com/chat/ui/
+        # widgets/date-time-picker). Users can input text or use the picker to select
+        # dates and times. If users input an invalid date or time, the picker shows an
+        # error that prompts users to input the information correctly.
+        # Corresponds to the JSON property `dateTimePicker`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
+        attr_accessor :date_time_picker
+      
+        # A widget that displays text with optional decorations such as a label above or
+        # below the text, an icon in front of the text, a selection widget, or a button
+        # after the text. For an example in Google Chat apps, see [Decorated text](https:
+        # //developers.google.com/chat/ui/widgets/decorated-text).
+        # Corresponds to the JSON property `decoratedText`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
+        attr_accessor :decorated_text
+      
+        # An image that is specified by a URL and can have an `onClick` action. For an
+        # example, see [Image](https://developers.google.com/chat/ui/widgets/image).
+        # Corresponds to the JSON property `image`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
+        attr_accessor :image
+      
+        # 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 [
+        # Selection input](https://developers.google.com/chat/ui/widgets/selection-input)
+        # . Chat apps can process the value of items that users select or input. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/ui/read-form-data). To collect undefined or
+        # abstract data from users, use the TextInput widget.
+        # Corresponds to the JSON property `selectionInput`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1SelectionInput]
+        attr_accessor :selection_input
+      
+        # A field in which users can enter text. Supports suggestions and on-change
+        # actions. For an example in Google Chat apps, see [Text input](https://
+        # developers.google.com/chat/ui/widgets/text-input). Chat apps receive and can
+        # process the value of entered text during form input events. For details about
+        # working with form inputs, see [Receive form data](https://developers.google.
+        # com/chat/ui/read-form-data). When you need to collect undefined or abstract
+        # data from users, use a text input. To collect defined or enumerated data from
+        # users, use the SelectionInput widget.
+        # Corresponds to the JSON property `textInput`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
+        attr_accessor :text_input
+      
+        # A paragraph of text that supports formatting. For an example in Google Chat
+        # apps, see [Text paragraph](https://developers.google.com/chat/ui/widgets/text-
+        # paragraph). For more information about formatting text, see [Formatting text
+        # in Google Chat apps](https://developers.google.com/chat/api/guides/message-
+        # formats/cards##card-formatting) and [Formatting text in Google Workspace Add-
+        # ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#
+        # text_formatting).
+        # Corresponds to the JSON property `textParagraph`
+        # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
+        attr_accessor :text_paragraph
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @button_list = args[:button_list] if args.key?(:button_list)
+          @date_time_picker = args[:date_time_picker] if args.key?(:date_time_picker)
+          @decorated_text = args[:decorated_text] if args.key?(:decorated_text)
+          @image = args[:image] if args.key?(:image)
+          @selection_input = args[:selection_input] if args.key?(:selection_input)
+          @text_input = args[:text_input] if args.key?(:text_input)
+          @text_paragraph = args[:text_paragraph] if args.key?(:text_paragraph)
+        end
+      end
+      
+      # Chat apps only. For a `SelectionInput` widget that uses a multi-select menu, a
+      # data source from a Google Workspace host application. [Developer Preview](
+      # https://developers.google.com/workspace/preview).
+      class HostAppDataSourceMarkup
+        include Google::Apis::Core::Hashable
+      
+        # Chat apps only. For a `SelectionInput` widget that uses a multi-select menu, a
+        # data source from Google Chat. For example, a list of Google Chat spaces of
+        # which the user is a member. [Developer Preview](https://developers.google.com/
+        # workspace/preview).
+        # Corresponds to the JSON property `chatDataSource`
+        # @return [Google::Apis::ChatV1::ChatClientDataSourceMarkup]
+        attr_accessor :chat_data_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @chat_data_source = args[:chat_data_source] if args.key?(:chat_data_source)
+        end
+      end
+      
+      # An image that's specified by a URL and can have an `onclick` action.
       class Image
         include Google::Apis::Core::Hashable
       
-        # The aspect ratio of this image (width/height). This field allows clients to
-        # reserve the right height for the image while waiting for it to load. It's not
-        # meant to override the native aspect ratio of the image. If unset, the server
-        # fills it by prefetching the image.
+        # The aspect ratio of this image (width and height). This field lets you reserve
+        # the right height for the image while waiting for it to load. It's not meant to
+        # override the built-in aspect ratio of the image. If unset, the server fills it
+        # by prefetching the image.
         # Corresponds to the JSON property `aspectRatio`
         # @return [Float]
         attr_accessor :aspect_ratio
@@ -2197,7 +2916,7 @@ module Google
         # @return [String]
         attr_accessor :image_url
       
-        # An onclick action (e.g. open a link).
+        # An `onclick` action (for example, open a link).
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::OnClick]
         attr_accessor :on_click
@@ -2214,11 +2933,11 @@ module Google
         end
       end
       
-      # An image button with an onclick action.
+      # An image button with an `onclick` action.
       class ImageButton
         include Google::Apis::Core::Hashable
       
-        # The icon specified by an enum that indices to an icon provided by Chat API.
+        # The icon specified by an `enum` that indices to an icon provided by Chat API.
         # Corresponds to the JSON property `icon`
         # @return [String]
         attr_accessor :icon
@@ -2228,13 +2947,13 @@ module Google
         # @return [String]
         attr_accessor :icon_url
       
-        # The name of this image_button which will be used for accessibility. Default
-        # value will be provided if developers don't specify.
+        # The name of this `image_button` that's used for accessibility. Default value
+        # is provided if this name isn't specified.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # An onclick action (e.g. open a link).
+        # An `onclick` action (for example, open a link).
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::OnClick]
         attr_accessor :on_click
@@ -2252,16 +2971,18 @@ module Google
         end
       end
       
-      # Types of data inputs for widgets. Users enter data with these inputs.
+      # Types of data that users can enter on cards or dialogs. To learn how to
+      # process information from users, see [Read form data input by users on cards](
+      # https://developers.google.com/chat/ui/read-form-data).
       class Inputs
         include Google::Apis::Core::Hashable
       
-        # Date input values. Not supported by Chat apps.
+        # Date input values.
         # Corresponds to the JSON property `dateInput`
         # @return [Google::Apis::ChatV1::DateInput]
         attr_accessor :date_input
       
-        # Date and time input values. Not supported by Chat apps.
+        # Date and time input values.
         # Corresponds to the JSON property `dateTimeInput`
         # @return [Google::Apis::ChatV1::DateTimeInput]
         attr_accessor :date_time_input
@@ -2273,7 +2994,7 @@ module Google
         # @return [Google::Apis::ChatV1::StringInputs]
         attr_accessor :string_inputs
       
-        # Time input values. Not supported by Chat apps.
+        # Time input values.
         # Corresponds to the JSON property `timeInput`
         # @return [Google::Apis::ChatV1::TimeInput]
         attr_accessor :time_input
@@ -2291,12 +3012,16 @@ module Google
         end
       end
       
-      # A UI element contains a key (label) and a value (content). And this element
-      # may also contain some actions such as onclick button.
+      # A UI element contains a key (label) and a value (content). This element can
+      # also contain some actions such as `onclick` button.
       class KeyValue
         include Google::Apis::Core::Hashable
       
-        # The text of the bottom label. Formatted text supported.
+        # The text of the bottom label. Formatted text supported. For more information
+        # about formatting text, see [Formatting text in Google Chat apps](https://
+        # developers.google.com/chat/api/guides/message-formats/cards#
+        # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
+        # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `bottomLabel`
         # @return [String]
         attr_accessor :bottom_label
@@ -2306,7 +3031,11 @@ module Google
         # @return [Google::Apis::ChatV1::Button]
         attr_accessor :button
       
-        # The text of the content. Formatted text supported and always required.
+        # The text of the content. Formatted text supported and always required. For
+        # more information about formatting text, see [Formatting text in Google Chat
+        # apps](https://developers.google.com/chat/api/guides/message-formats/cards#
+        # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
+        # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
@@ -2317,8 +3046,8 @@ module Google
         attr_accessor :content_multiline
         alias_method :content_multiline?, :content_multiline
       
-        # An enum value that will be replaced by the Chat API with the corresponding
-        # icon image.
+        # An enum value that's replaced by the Chat API with the corresponding icon
+        # image.
         # Corresponds to the JSON property `icon`
         # @return [String]
         attr_accessor :icon
@@ -2328,12 +3057,16 @@ module Google
         # @return [String]
         attr_accessor :icon_url
       
-        # An onclick action (e.g. open a link).
+        # An `onclick` action (for example, open a link).
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::OnClick]
         attr_accessor :on_click
       
-        # The text of the top label. Formatted text supported.
+        # The text of the top label. Formatted text supported. For more information
+        # about formatting text, see [Formatting text in Google Chat apps](https://
+        # developers.google.com/chat/api/guides/message-formats/cards#
+        # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
+        # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `topLabel`
         # @return [String]
         attr_accessor :top_label
@@ -2364,8 +3097,8 @@ module Google
         # @return [Array<Google::Apis::ChatV1::Membership>]
         attr_accessor :memberships
       
-        # Continuation token to retrieve the next page of results. It will be empty for
-        # the last page of results.
+        # A token that you can send as `pageToken` to retrieve the next page of results.
+        # If empty, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2381,13 +3114,64 @@ module Google
         end
       end
       
+      # 
+      class ListMessagesResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of messages.
+        # Corresponds to the JSON property `messages`
+        # @return [Array<Google::Apis::ChatV1::Message>]
+        attr_accessor :messages
+      
+        # You can send a token as `pageToken` to retrieve the next page of results. If
+        # empty, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @messages = args[:messages] if args.key?(:messages)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # 
+      class ListReactionsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Continuation token to retrieve the next page of results. It's empty for the
+        # last page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # List of reactions in the requested (or first) page.
+        # Corresponds to the JSON property `reactions`
+        # @return [Array<Google::Apis::ChatV1::Reaction>]
+        attr_accessor :reactions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @reactions = args[:reactions] if args.key?(:reactions)
+        end
+      end
+      
       # 
       class ListSpacesResponse
         include Google::Apis::Core::Hashable
       
-        # Continuation token to retrieve the next page of results. It will be empty for
-        # the last page of results. Tokens expire in an hour. An error is thrown if an
-        # expired token is passed.
+        # You can send a token as `pageToken` to retrieve the next page of results. If
+        # empty, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2408,13 +3192,13 @@ module Google
         end
       end
       
-      # A matched url in a Chat message. Chat apps can preview matched URLs. For more
-      # information, refer to [Preview links](https://developers.google.com/chat/how-
-      # tos/preview-links).
+      # A matched URL in a Chat message. Chat apps can preview matched URLs. For more
+      # information, see [Preview links](https://developers.google.com/chat/how-tos/
+      # preview-links).
       class MatchedUrl
         include Google::Apis::Core::Hashable
       
-        # Output only. The url that was matched.
+        # Output only. The URL that was matched.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -2459,12 +3243,16 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # A user in Google Chat.
+        # A user in Google Chat. When returned as an output from a request, if your Chat
+        # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+        # auth/users), the output for a `User` resource only populates the user's `name`
+        # and `type`.
         # Corresponds to the JSON property `member`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :member
       
-        # Resource name of the membership. Format: spaces/`space`/members/`member`
+        # Resource name of the membership, assigned by the server. Format: `spaces/`
+        # space`/members/`member``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2494,56 +3282,98 @@ module Google
         end
       end
       
-      # A message in Google Chat.
+      # A message in a Google Chat space.
       class Message
         include Google::Apis::Core::Hashable
       
-        # Parameters that a Chat app can use to configure how it's response is posted.
+        # Parameters that a Chat app can use to configure how its response is posted.
         # Corresponds to the JSON property `actionResponse`
         # @return [Google::Apis::ChatV1::ActionResponse]
         attr_accessor :action_response
       
-        # Output only. Annotations associated with the text in this message.
+        # Output only. Annotations associated with the `text` in this message.
         # Corresponds to the JSON property `annotations`
         # @return [Array<Google::Apis::ChatV1::Annotation>]
         attr_accessor :annotations
       
-        # Plain-text body of the message with all Chat app mentions stripped out.
+        # Output only. Plain-text body of the message with all Chat app mentions
+        # stripped out.
         # Corresponds to the JSON property `argumentText`
         # @return [String]
         attr_accessor :argument_text
       
-        # User uploaded attachment.
+        # Output only. GIF images that are attached to the message.
+        # Corresponds to the JSON property `attachedGifs`
+        # @return [Array<Google::Apis::ChatV1::AttachedGif>]
+        attr_accessor :attached_gifs
+      
+        # User-uploaded attachment.
         # Corresponds to the JSON property `attachment`
         # @return [Array<Google::Apis::ChatV1::Attachment>]
         attr_accessor :attachment
       
-        # Rich, formatted and interactive cards that can be used to display UI elements
-        # such as: formatted texts, buttons, clickable images. Cards are normally
-        # displayed below the plain-text body of the message.
+        # Deprecated: Use `cards_v2` instead. Rich, formatted, and interactive cards
+        # that you can use to display UI elements such as: formatted texts, buttons, and
+        # clickable images. Cards are normally displayed below the plain-text body of
+        # the message. `cards` and `cards_v2` can have a maximum size of 32 KB.
         # Corresponds to the JSON property `cards`
         # @return [Array<Google::Apis::ChatV1::Card>]
         attr_accessor :cards
       
-        # Richly formatted and interactive cards that display UI elements and editable
-        # widgets, such as: - Formatted text - Buttons - Clickable images - Checkboxes -
-        # Radio buttons - Input widgets. Cards are usually displayed below the text-body
-        # of a Chat message, but can situationally appear other places, such as [dialogs]
-        # (https://developers.google.com/chat/how-tos/dialogs). The `cardId` is a unique
-        # identifier among cards in the same message and for identifying user input
-        # values. Currently supported widgets include: - `TextParagraph` - `
-        # DecoratedText` - `Image` - `ButtonList`
+        # An array of [cards](https://developers.google.com/chat/api/reference/rest/v1/
+        # cards). Only Chat apps can create cards. If your Chat app [authenticates as a
+        # user](https://developers.google.com/chat/api/guides/auth/users), the messages
+        # can't contain cards. To learn about cards and how to create them, see [Design
+        # dynamic, interactive, and consistent UIs with cards](https://developers.google.
+        # com/chat/ui).
         # Corresponds to the JSON property `cardsV2`
         # @return [Array<Google::Apis::ChatV1::CardWithId>]
         attr_accessor :cards_v2
       
-        # Output only. The time at which the message was created in Google Chat server.
+        # A custom name for a Chat message assigned at creation. Must start with `client-
+        # ` and contain only lowercase letters, numbers, and hyphens up to 63 characters
+        # in length. Specify this field to get, update, or delete the message with the
+        # specified value. Assigning a custom name lets a Chat app recall the message
+        # without saving the message `name` from the [response body](/chat/api/reference/
+        # rest/v1/spaces.messages/get#response-body) returned when creating the message.
+        # Assigning a custom name doesn't replace the generated `name` field, the
+        # message's resource name. Instead, it sets the custom name as the `
+        # clientAssignedMessageId` field, which you can reference while processing later
+        # operations, like updating or deleting the message. For example usage, see [
+        # Name a created message](https://developers.google.com/chat/api/guides/v1/
+        # messages/create#name_a_created_message).
+        # Corresponds to the JSON property `clientAssignedMessageId`
+        # @return [String]
+        attr_accessor :client_assigned_message_id
+      
+        # For spaces created in Chat, the time at which the message was created. This
+        # field is output only, except when used in imported spaces. [Developer Preview](
+        # https://developers.google.com/workspace/preview): For imported spaces, set
+        # this field to the historical timestamp at which the message was created in the
+        # source in order to preserve the original creation time.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
+        # Output only. The time at which the message was deleted in Google Chat. If the
+        # message is never deleted, this field is empty.
+        # Corresponds to the JSON property `deleteTime`
+        # @return [String]
+        attr_accessor :delete_time
+      
+        # Information about a deleted message. A message is deleted when `delete_time`
+        # is set.
+        # Corresponds to the JSON property `deletionMetadata`
+        # @return [Google::Apis::ChatV1::DeletionMetadata]
+        attr_accessor :deletion_metadata
+      
+        # Output only. The list of emoji reaction summaries on the message.
+        # Corresponds to the JSON property `emojiReactionSummaries`
+        # @return [Array<Google::Apis::ChatV1::EmojiReactionSummary>]
+        attr_accessor :emoji_reaction_summaries
+      
         # A plain-text description of the message's cards, used when the actual cards
-        # cannot be displayed (e.g. mobile notifications).
+        # can't be displayed—for example, mobile notifications.
         # Corresponds to the JSON property `fallbackText`
         # @return [String]
         attr_accessor :fallback_text
@@ -2554,9 +3384,9 @@ module Google
         # @return [String]
         attr_accessor :last_update_time
       
-        # A matched url in a Chat message. Chat apps can preview matched URLs. For more
-        # information, refer to [Preview links](https://developers.google.com/chat/how-
-        # tos/preview-links).
+        # A matched URL in a Chat message. Chat apps can preview matched URLs. For more
+        # information, see [Preview links](https://developers.google.com/chat/how-tos/
+        # preview-links).
         # Corresponds to the JSON property `matchedUrl`
         # @return [Google::Apis::ChatV1::MatchedUrl]
         attr_accessor :matched_url
@@ -2567,7 +3397,15 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # A user in Google Chat.
+        # Information about a quoted message.
+        # Corresponds to the JSON property `quotedMessageMetadata`
+        # @return [Google::Apis::ChatV1::QuotedMessageMetadata]
+        attr_accessor :quoted_message_metadata
+      
+        # A user in Google Chat. When returned as an output from a request, if your Chat
+        # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+        # auth/users), the output for a `User` resource only populates the user's `name`
+        # and `type`.
         # Corresponds to the JSON property `sender`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :sender
@@ -2584,17 +3422,31 @@ module Google
         # @return [Google::Apis::ChatV1::Space]
         attr_accessor :space
       
-        # Plain-text body of the message. The first link to an image, video, web page,
-        # or other preview-able item generates a preview chip.
+        # Plain-text body of the message. The first link to an image, video, or web page
+        # generates a preview chip. You can also @mention a Google Chat user, or
+        # everyone in the space. To learn about creating text messages, see [Create a
+        # text message](https://developers.google.com/chat/api/guides/message-formats/
+        # text).
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # A thread in Google Chat.
+        # A thread in a Google Chat space. For example usage, see [Start or reply to a
+        # message thread](https://developers.google.com/chat/api/guides/crudl/messages#
+        # start_or_reply_to_a_message_thread).
         # Corresponds to the JSON property `thread`
         # @return [Google::Apis::ChatV1::Thread]
         attr_accessor :thread
       
+        # Output only. When `true`, the message is a response in a reply thread. When `
+        # false`, the message is visible in the space's top-level conversation as either
+        # the first message of a thread or a message with no threaded replies. If the
+        # space doesn't support reply in threads, this field is always `false`.
+        # Corresponds to the JSON property `threadReply`
+        # @return [Boolean]
+        attr_accessor :thread_reply
+        alias_method :thread_reply?, :thread_reply
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2604,28 +3456,35 @@ module Google
           @action_response = args[:action_response] if args.key?(:action_response)
           @annotations = args[:annotations] if args.key?(:annotations)
           @argument_text = args[:argument_text] if args.key?(:argument_text)
+          @attached_gifs = args[:attached_gifs] if args.key?(:attached_gifs)
           @attachment = args[:attachment] if args.key?(:attachment)
           @cards = args[:cards] if args.key?(:cards)
           @cards_v2 = args[:cards_v2] if args.key?(:cards_v2)
+          @client_assigned_message_id = args[:client_assigned_message_id] if args.key?(:client_assigned_message_id)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @delete_time = args[:delete_time] if args.key?(:delete_time)
+          @deletion_metadata = args[:deletion_metadata] if args.key?(:deletion_metadata)
+          @emoji_reaction_summaries = args[:emoji_reaction_summaries] if args.key?(:emoji_reaction_summaries)
           @fallback_text = args[:fallback_text] if args.key?(:fallback_text)
           @last_update_time = args[:last_update_time] if args.key?(:last_update_time)
           @matched_url = args[:matched_url] if args.key?(:matched_url)
           @name = args[:name] if args.key?(:name)
+          @quoted_message_metadata = args[:quoted_message_metadata] if args.key?(:quoted_message_metadata)
           @sender = args[:sender] if args.key?(:sender)
           @slash_command = args[:slash_command] if args.key?(:slash_command)
           @space = args[:space] if args.key?(:space)
           @text = args[:text] if args.key?(:text)
           @thread = args[:thread] if args.key?(:thread)
+          @thread_reply = args[:thread_reply] if args.key?(:thread_reply)
         end
       end
       
-      # An onclick action (e.g. open a link).
+      # An `onclick` action (for example, open a link).
       class OnClick
         include Google::Apis::Core::Hashable
       
         # A form action describes the behavior when the form is submitted. For example,
-        # an Apps Script can be invoked to handle the form.
+        # you can invoke Apps Script to handle the form.
         # Corresponds to the JSON property `action`
         # @return [Google::Apis::ChatV1::FormAction]
         attr_accessor :action
@@ -2665,18 +3524,85 @@ module Google
         end
       end
       
+      # Information about a quoted message.
+      class QuotedMessageMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The timestamp when the quoted message was created or when the
+        # quoted message was last updated.
+        # Corresponds to the JSON property `lastUpdateTime`
+        # @return [String]
+        attr_accessor :last_update_time
+      
+        # Output only. Resource name of the quoted message. Format: `spaces/`space`/
+        # messages/`message``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @last_update_time = args[:last_update_time] if args.key?(:last_update_time)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # A reaction to a message.
+      class Reaction
+        include Google::Apis::Core::Hashable
+      
+        # An emoji that is used as a reaction to a message.
+        # Corresponds to the JSON property `emoji`
+        # @return [Google::Apis::ChatV1::Emoji]
+        attr_accessor :emoji
+      
+        # The resource name of the reaction. Format: `spaces/`space`/messages/`message`/
+        # reactions/`reaction``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A user in Google Chat. When returned as an output from a request, if your Chat
+        # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+        # auth/users), the output for a `User` resource only populates the user's `name`
+        # and `type`.
+        # Corresponds to the JSON property `user`
+        # @return [Google::Apis::ChatV1::User]
+        attr_accessor :user
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @emoji = args[:emoji] if args.key?(:emoji)
+          @name = args[:name] if args.key?(:name)
+          @user = args[:user] if args.key?(:user)
+        end
+      end
+      
       # A section contains a collection of widgets that are rendered (vertically) in
       # the order that they are specified. Across all platforms, cards have a narrow
-      # fixed width, so there is currently no need for layout properties (e.g. float).
+      # fixed width, so there's currently no need for layout properties (for example,
+      # float).
       class Section
         include Google::Apis::Core::Hashable
       
-        # The header of the section, text formatted supported.
+        # The header of the section. Formatted text is supported. For more information
+        # about formatting text, see [Formatting text in Google Chat apps](https://
+        # developers.google.com/chat/api/guides/message-formats/cards#
+        # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
+        # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `header`
         # @return [String]
         attr_accessor :header
       
-        # A section must contain at least 1 widget.
+        # A section must contain at least one widget.
         # Corresponds to the JSON property `widgets`
         # @return [Array<Google::Apis::ChatV1::WidgetMarkup>]
         attr_accessor :widgets
@@ -2692,12 +3618,62 @@ module Google
         end
       end
       
+      # 
+      class SetUpSpaceRequest
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The Google Chat users to invite to join the space. Omit the calling
+        # user, as they are added automatically. The set currently allows up to 20
+        # memberships (in addition to the caller). The `Membership.member` field must
+        # contain a `user` with `name` populated (format: `users/`user``) and `type` set
+        # to `User.Type.HUMAN`. You can only add human users when setting up a space (
+        # adding Chat apps is only supported for direct message setup with the calling
+        # app). You can also add members using the user's email as an alias for `user`.
+        # For example, the `user.name` can be `users/example@gmail.com`." To invite
+        # Gmail users or users from external Google Workspace domains, user's email must
+        # be used for ``user``. Optional when setting `Space.spaceType` to `SPACE`.
+        # Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least
+        # two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE`
+        # with a human user, along with exactly one membership. Must be empty when
+        # creating a 1:1 conversation between a human and the calling Chat app (when
+        # setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `
+        # true`).
+        # Corresponds to the JSON property `memberships`
+        # @return [Array<Google::Apis::ChatV1::Membership>]
+        attr_accessor :memberships
+      
+        # Optional. A unique identifier for this request. A random UUID is recommended.
+        # Specifying an existing request ID returns the space created with that ID
+        # instead of creating a new space. Specifying an existing request ID from the
+        # same Chat app with a different authenticated user returns an error.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        # A space in Google Chat. Spaces are conversations between two or more users or
+        # 1:1 messages between a user and a Chat app.
+        # Corresponds to the JSON property `space`
+        # @return [Google::Apis::ChatV1::Space]
+        attr_accessor :space
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @memberships = args[:memberships] if args.key?(:memberships)
+          @request_id = args[:request_id] if args.key?(:request_id)
+          @space = args[:space] if args.key?(:space)
+        end
+      end
+      
       # A [slash command](https://developers.google.com/chat/how-tos/slash-commands)
       # in Google Chat.
       class SlashCommand
         include Google::Apis::Core::Hashable
       
-        # The id of the slash command invoked.
+        # The ID of the slash command invoked.
         # Corresponds to the JSON property `commandId`
         # @return [Fixnum]
         attr_accessor :command_id
@@ -2716,12 +3692,15 @@ module Google
       class SlashCommandMetadata
         include Google::Apis::Core::Hashable
       
-        # A user in Google Chat.
+        # A user in Google Chat. When returned as an output from a request, if your Chat
+        # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+        # auth/users), the output for a `User` resource only populates the user's `name`
+        # and `type`.
         # Corresponds to the JSON property `bot`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :bot
       
-        # The command id of the invoked slash command.
+        # The command ID of the invoked slash command.
         # Corresponds to the JSON property `commandId`
         # @return [Fixnum]
         attr_accessor :command_id
@@ -2731,7 +3710,7 @@ module Google
         # @return [String]
         attr_accessor :command_name
       
-        # Indicating whether the slash command is for a dialog.
+        # Indicates whether the slash command is for a dialog.
         # Corresponds to the JSON property `triggersDialog`
         # @return [Boolean]
         attr_accessor :triggers_dialog
@@ -2761,13 +3740,37 @@ module Google
       class Space
         include Google::Apis::Core::Hashable
       
-        # The space's display name. For direct messages between humans, this field might
-        # be empty.
+        # Output only. Whether the Chat app was installed by a Google Workspace
+        # administrator. Administrators can install a Chat app for their domain,
+        # organizational unit, or a group of users. Administrators can only install Chat
+        # apps for direct messaging between users and the app. To support admin install,
+        # your app must feature direct messaging.
+        # Corresponds to the JSON property `adminInstalled`
+        # @return [Boolean]
+        attr_accessor :admin_installed
+        alias_method :admin_installed?, :admin_installed
+      
+        # The space's display name. Required when [creating a space](https://developers.
+        # google.com/chat/api/reference/rest/v1/spaces/create). If you receive the error
+        # message `ALREADY_EXISTS` when creating a space or updating the `displayName`,
+        # try a different `displayName`. An existing space within the Google Workspace
+        # organization might already use this display name. For direct messages, this
+        # field might be empty. Supports up to 128 characters.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Resource name of the space. Format: spaces/`space`
+        # Immutable. Whether this space permits any Google Chat user as a member. Input
+        # when creating a space in a Google Workspace organization. For Google Chat
+        # users that use a Google Account, omit this field when creating a space (By
+        # default, the space permits any Google Chat user). For existing spaces, this
+        # field is output only.
+        # Corresponds to the JSON property `externalUserAllowed`
+        # @return [Boolean]
+        attr_accessor :external_user_allowed
+        alias_method :external_user_allowed?, :external_user_allowed
+      
+        # Resource name of the space. Format: `spaces/`space``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2783,14 +3786,30 @@ module Google
         # @return [Google::Apis::ChatV1::SpaceDetails]
         attr_accessor :space_details
       
-        # Output only. Whether messages are threaded in this space.
+        # The message history state for messages and threads in this space.
+        # Corresponds to the JSON property `spaceHistoryState`
+        # @return [String]
+        attr_accessor :space_history_state
+      
+        # Output only. The threading state in the Chat space.
+        # Corresponds to the JSON property `spaceThreadingState`
+        # @return [String]
+        attr_accessor :space_threading_state
+      
+        # The type of space. Required when creating a space or updating the space type
+        # of a space. Output only for other usage.
+        # Corresponds to the JSON property `spaceType`
+        # @return [String]
+        attr_accessor :space_type
+      
+        # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages
+        # are threaded in this space.
         # Corresponds to the JSON property `threaded`
         # @return [Boolean]
         attr_accessor :threaded
         alias_method :threaded?, :threaded
       
-        # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer
-        # preview) instead. The type of a space.
+        # Output only. Deprecated: Use `space_type` instead. The type of a space.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2801,26 +3820,56 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @admin_installed = args[:admin_installed] if args.key?(:admin_installed)
           @display_name = args[:display_name] if args.key?(:display_name)
+          @external_user_allowed = args[:external_user_allowed] if args.key?(:external_user_allowed)
           @name = args[:name] if args.key?(:name)
           @single_user_bot_dm = args[:single_user_bot_dm] if args.key?(:single_user_bot_dm)
           @space_details = args[:space_details] if args.key?(:space_details)
+          @space_history_state = args[:space_history_state] if args.key?(:space_history_state)
+          @space_threading_state = args[:space_threading_state] if args.key?(:space_threading_state)
+          @space_type = args[:space_type] if args.key?(:space_type)
           @threaded = args[:threaded] if args.key?(:threaded)
           @type = args[:type] if args.key?(:type)
         end
       end
       
+      # A data source representing a Google Chat space. Format: spaces/`space` [
+      # Developer Preview](https://developers.google.com/workspace/preview).
+      class SpaceDataSource
+        include Google::Apis::Core::Hashable
+      
+        # When `true`, uses the card's Google Chat space as the default selection. The
+        # default value is `false`. [Developer Preview](https://developers.google.com/
+        # workspace/preview).
+        # Corresponds to the JSON property `defaultToCurrentSpace`
+        # @return [Boolean]
+        attr_accessor :default_to_current_space
+        alias_method :default_to_current_space?, :default_to_current_space
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @default_to_current_space = args[:default_to_current_space] if args.key?(:default_to_current_space)
+        end
+      end
+      
       # Details about the space including description and rules.
       class SpaceDetails
         include Google::Apis::Core::Hashable
       
-        # Optional. A description of the space. It could describe the space's discussion
-        # topic, functional purpose, or participants.
+        # Optional. A description of the space. For example, describe the space's
+        # discussion topic, functional purpose, or participants. Supports up to 150
+        # characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Optional. The space's rules, expectations, and etiquette.
+        # Optional. The space's rules, expectations, and etiquette. Supports up to 5,000
+        # characters.
         # Corresponds to the JSON property `guidelines`
         # @return [String]
         attr_accessor :guidelines
@@ -2896,11 +3945,11 @@ module Google
         end
       end
       
-      # A button with text and onclick action.
+      # A button with text and `onclick` action.
       class TextButton
         include Google::Apis::Core::Hashable
       
-        # An onclick action (e.g. open a link).
+        # An `onclick` action (for example, open a link).
         # Corresponds to the JSON property `onClick`
         # @return [Google::Apis::ChatV1::OnClick]
         attr_accessor :on_click
@@ -2921,7 +3970,11 @@ module Google
         end
       end
       
-      # A paragraph of text. Formatted text supported.
+      # A paragraph of text. Formatted text supported. For more information about
+      # formatting text, see [Formatting text in Google Chat apps](https://developers.
+      # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
+      # Formatting text in Google Workspace Add-ons](https://developers.google.com/
+      # apps-script/add-ons/concepts/widgets#text_formatting).
       class TextParagraph
         include Google::Apis::Core::Hashable
       
@@ -2940,16 +3993,23 @@ module Google
         end
       end
       
-      # A thread in Google Chat.
+      # A thread in a Google Chat space. For example usage, see [Start or reply to a
+      # message thread](https://developers.google.com/chat/api/guides/crudl/messages#
+      # start_or_reply_to_a_message_thread).
       class Thread
         include Google::Apis::Core::Hashable
       
-        # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/
-        # threads/TTTTTTTTTTT
+        # Resource name of the thread. Example: `spaces/`space`/threads/`thread``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
+        # Optional. ID for the thread. Supports up to 4000 characters. Input for
+        # creating or updating a thread. Otherwise, output only.
+        # Corresponds to the JSON property `threadKey`
+        # @return [String]
+        attr_accessor :thread_key
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2957,10 +4017,11 @@ module Google
         # Update properties of this object
         def update!(**args)
           @name = args[:name] if args.key?(:name)
+          @thread_key = args[:thread_key] if args.key?(:thread_key)
         end
       end
       
-      # Time input values. Not supported by Chat apps.
+      # Time input values.
       class TimeInput
         include Google::Apis::Core::Hashable
       
@@ -2985,8 +4046,11 @@ module Google
         end
       end
       
-      # The timezone ID and offset from Coordinated Universal Time (UTC). Not
-      # supported by Chat apps.
+      # The timezone ID and offset from Coordinated Universal Time (UTC). Only
+      # supported for the event types [`CARD_CLICKED`](https://developers.google.com/
+      # chat/api/reference/rest/v1/EventType#ENUM_VALUES.CARD_CLICKED) and [`
+      # SUBMIT_DIALOG`](https://developers.google.com/chat/api/reference/rest/v1/
+      # DialogEventType#ENUM_VALUES.SUBMIT_DIALOG).
       class TimeZone
         include Google::Apis::Core::Hashable
       
@@ -3013,7 +4077,48 @@ module Google
         end
       end
       
-      # A user in Google Chat.
+      # 
+      class UploadAttachmentRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The filename of the attachment, including the file extension.
+        # Corresponds to the JSON property `filename`
+        # @return [String]
+        attr_accessor :filename
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @filename = args[:filename] if args.key?(:filename)
+        end
+      end
+      
+      # 
+      class UploadAttachmentResponse
+        include Google::Apis::Core::Hashable
+      
+        # Reference to the uploaded attachment.
+        # Corresponds to the JSON property `attachmentDataRef`
+        # @return [Google::Apis::ChatV1::AttachmentDataRef]
+        attr_accessor :attachment_data_ref
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attachment_data_ref = args[:attachment_data_ref] if args.key?(:attachment_data_ref)
+        end
+      end
+      
+      # A user in Google Chat. When returned as an output from a request, if your Chat
+      # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+      # auth/users), the output for a `User` resource only populates the user's `name`
+      # and `type`.
       class User
         include Google::Apis::Core::Hashable
       
@@ -3033,10 +4138,14 @@ module Google
         attr_accessor :is_anonymous
         alias_method :is_anonymous?, :is_anonymous
       
-        # Resource name for a Google Chat user. Represents a [person](https://developers.
-        # google.com/people/api/rest/v1/people#Person) in the People API or a [user](
-        # https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in
-        # the Admin SDK Directory API. Formatted as: `users/`user``
+        # Resource name for a Google Chat user. Format: `users/`user``. `users/app` can
+        # be used as an alias for the calling app bot user. For human users, ``user`` is
+        # the same user identifier as: - the ``person_id`` for the [Person](https://
+        # developers.google.com/people/api/rest/v1/people) in the People API, where the
+        # Person `resource_name` is `people/`person_id``. For example, `users/123456789`
+        # in Chat API represents the same person as `people/123456789` in People API. -
+        # the `id` for a [user](https://developers.google.com/admin-sdk/directory/
+        # reference/rest/v1/users) in the Admin SDK Directory API.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3069,7 +4178,10 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # A user in Google Chat.
+        # A user in Google Chat. When returned as an output from a request, if your Chat
+        # app [authenticates as a user](https://developers.google.com/chat/api/guides/
+        # auth/users), the output for a `User` resource only populates the user's `name`
+        # and `type`.
         # Corresponds to the JSON property `user`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :user
@@ -3085,28 +4197,32 @@ module Google
         end
       end
       
-      # A widget is a UI element that presents texts, images, etc.
+      # A widget is a UI element that presents text and images.
       class WidgetMarkup
         include Google::Apis::Core::Hashable
       
-        # A list of buttons. Buttons is also oneof data and only one of these fields
+        # A list of buttons. Buttons is also `oneof data` and only one of these fields
         # should be set.
         # Corresponds to the JSON property `buttons`
         # @return [Array<Google::Apis::ChatV1::Button>]
         attr_accessor :buttons
       
-        # An image that is specified by a URL and can have an onclick action.
+        # An image that's specified by a URL and can have an `onclick` action.
         # Corresponds to the JSON property `image`
         # @return [Google::Apis::ChatV1::Image]
         attr_accessor :image
       
-        # A UI element contains a key (label) and a value (content). And this element
-        # may also contain some actions such as onclick button.
+        # A UI element contains a key (label) and a value (content). This element can
+        # also contain some actions such as `onclick` button.
         # Corresponds to the JSON property `keyValue`
         # @return [Google::Apis::ChatV1::KeyValue]
         attr_accessor :key_value
       
-        # A paragraph of text. Formatted text supported.
+        # A paragraph of text. Formatted text supported. For more information about
+        # formatting text, see [Formatting text in Google Chat apps](https://developers.
+        # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
+        # Formatting text in Google Workspace Add-ons](https://developers.google.com/
+        # apps-script/add-ons/concepts/widgets#text_formatting).
         # Corresponds to the JSON property `textParagraph`
         # @return [Google::Apis::ChatV1::TextParagraph]
         attr_accessor :text_paragraph