google-apis-chat_v1 0.45.0 → 0.47.0

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

@@ -164,7 +164,8 @@ module Google
       class Attachment
         include Google::Apis::Core::Hashable
       
-        # A reference to the data of an attachment.
+        # A reference to the attachment data. This 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
@@ -226,7 +227,7 @@ module Google
         end
       end
       
-      # A reference to the data of an attachment.
+      # 
       class AttachmentDataRef
         include Google::Apis::Core::Hashable
       
@@ -310,7 +311,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
       
@@ -378,24 +379,29 @@ module Google
       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" ` ```
+        # 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. In Google Chat,
+        # cards appear in several places: - As stand-alone messages. - Accompanying a
+        # text message, just beneath the text message. - As a [dialog](https://
+        # developers.google.com/chat/how-tos/dialogs). The following example JSON
+        # creates a "contact card" that features: - A header with the contact's name,
+        # job title, avatar picture. - A section with the contact information, including
+        # formatted text. - Buttons that users can click to share the contact or see
+        # more or less info. ![Example contact card](https://developers.google.com/chat/
+        # images/card_api_reference.png) ``` ` "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
@@ -775,24 +781,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" ` ```
+        # 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. In Google Chat,
+        # cards appear in several places: - As stand-alone messages. - Accompanying a
+        # text message, just beneath the text message. - As a [dialog](https://
+        # developers.google.com/chat/how-tos/dialogs). The following example JSON
+        # creates a "contact card" that features: - A header with the contact's name,
+        # job title, avatar picture. - A section with the contact information, including
+        # formatted text. - Buttons that users can click to share the contact or see
+        # more or less info. ![Example contact card](https://developers.google.com/chat/
+        # images/card_api_reference.png) ``` ` "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
@@ -903,12 +914,27 @@ module Google
       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 button on 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 is not 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`
@@ -931,7 +957,7 @@ module Google
         # 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.
+        # being processed. Not supported by Chat apps.
         # Corresponds to the JSON property `persistValues`
         # @return [Boolean]
         attr_accessor :persist_values
@@ -944,6 +970,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)
@@ -953,7 +980,9 @@ module Google
       # 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.
+      # 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 +1007,7 @@ module Google
         end
       end
       
-      # Represents the complete border style applied to widgets.
+      # Represents the complete border style applied to items in a widget.
       class GoogleAppsCardV1BorderStyle
         include Google::Apis::Core::Hashable
       
@@ -1053,12 +1082,17 @@ module Google
         end
       end
       
-      # A button. Can be a text button or an image button.
+      # A text, icon, or text + icon button that users can click. 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 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". Has no effect
+        # when an icon is set; use `icon.alt_text` instead.
         # Corresponds to the JSON property `altText`
         # @return [String]
         attr_accessor :alt_text
@@ -1112,24 +1146,28 @@ 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. Supports [standard](https://
+        # developers.google.com/chat/api/guides/message-formats/cards) 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
@@ -1168,30 +1206,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" ` ```
+      # 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. In Google Chat,
+      # cards appear in several places: - As stand-alone messages. - Accompanying a
+      # text message, just beneath the text message. - As a [dialog](https://
+      # developers.google.com/chat/how-tos/dialogs). The following example JSON
+      # creates a "contact card" that features: - A header with the contact's name,
+      # job title, avatar picture. - A section with the contact information, including
+      # formatted text. - Buttons that users can click to share the contact or see
+      # more or less info. ![Example contact card](https://developers.google.com/chat/
+      # images/card_api_reference.png) ``` ` "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[]` is not 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,12 +1244,17 @@ 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.
+        # Setting `fixedFooter` without specifying a `primaryButton` or a `
+        # secondaryButton` causes an error. Chat apps support `fixedFooter` in [dialogs](
+        # https://developers.google.com/chat/how-tos/dialogs), but not in [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
@@ -1215,7 +1264,8 @@ module Google
         # @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
@@ -1225,7 +1275,8 @@ module Google
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardHeader]
         attr_accessor :peek_card_header
       
-        # Sections are separated by a line divider.
+        # Contains a collection of widgets. Each section has its own, optional header.
+        # Sections are visually separated by a line divider.
         # Corresponds to the JSON property `sections`
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Section>]
         attr_accessor :sections
@@ -1248,7 +1299,7 @@ module Google
       
       # 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 +1308,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 +1325,24 @@ 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.
+      # Setting `fixedFooter` without specifying a `primaryButton` or a `
+      # secondaryButton` causes an error. Chat apps support `fixedFooter` in [dialogs](
+      # https://developers.google.com/chat/how-tos/dialogs), but not in [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 + icon button that users can click. 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 + icon button that users can click. 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
@@ -1307,17 +1367,18 @@ module Google
         # @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,18 +1404,25 @@ module Google
         end
       end
       
-      # The widget that lets users to specify a date and time. Not supported by Google
-      # Chat apps.
+      # Lets users specify a date, a time, or both a date and a time. Accepts text
+      # input from users, but features an interactive date and time selector that
+      # helps users enter correctly-formatted dates and times. If users enter a date
+      # or time incorrectly, the widget shows an error that prompts users to enter the
+      # correct format. Not supported by Chat apps. Support by Chat apps coming soon.
       class GoogleAppsCardV1DateTimePicker
         include Google::Apis::Core::Hashable
       
-        # The label for the field that displays to the user.
+        # The text that prompts users to enter a date, time, or datetime. Specify text
+        # that helps the user enter the information your app needs. For example, if
+        # users are setting an appointment, then a label like "Appointment date" or "
+        # Appointment date and time" might work well.
         # 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 datetime picker is identified in a form input event. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1372,16 +1440,17 @@ module Google
         # @return [Fixnum]
         attr_accessor :timezone_offset_date
       
-        # The type of the date/time picker.
+        # What kind of date and time input the datetime picker supports.
         # 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 value displayed as the default value before user input or previous user
+        # input, represented in milliseconds ([Epoch time](https://en.wikipedia.org/wiki/
+        # Unix_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, to represent 3:00 AM, set
+        # epoch time to `3 * 60 * 60 * 1000`.
         # Corresponds to the JSON property `valueMsEpoch`
         # @return [Fixnum]
         attr_accessor :value_ms_epoch
@@ -1407,53 +1476,73 @@ module Google
       class GoogleAppsCardV1DecoratedText
         include Google::Apis::Core::Hashable
       
-        # The formatted text label that shows below the main text.
+        # The text that appears below `text`. Always truncates. Supports simple
+        # formatting. See Text formatting for formatting details.
         # 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 + icon button that users can click. 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. Supports [standard](https://
+        # developers.google.com/chat/api/guides/message-formats/cards) 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. Supports [standard](https://
+        # developers.google.com/chat/api/guides/message-formats/cards) 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. Supports [standard](https://
+        # developers.google.com/chat/api/guides/message-formats/cards) 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 on the `decoratedText` widget. Currently supported in [dialogs](
+        # https://developers.google.com/chat/how-tos/dialogs). Support for [card
+        # messages](https://developers.google.com/chat/api/guides/message-formats/cards)
+        # is coming soon.
         # 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. See Text formatting
+        # for formatting details.
         # 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. Supports simple
+        # formatting. See Text formatting for formatting details.
         # 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 +1567,8 @@ module Google
         end
       end
       
-      # A divider that appears in between widgets.
+      # Displays a divider between widgets, a horizontal line. For example, the
+      # following JSON creates a divider: ``` "divider": ` ` ```
       class GoogleAppsCardV1Divider
         include Google::Apis::Core::Hashable
       
@@ -1491,11 +1581,23 @@ module Google
         end
       end
       
-      # Represents a Grid widget that displays items in a configurable grid layout.
+      # Displays a grid with a collection of items. 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. Currently supported in [dialogs](https://developers.
+      # google.com/chat/how-tos/dialogs). Support for [card messages](https://
+      # developers.google.com/chat/api/guides/message-formats/cards) is coming soon.
+      # For example, the following JSON creates a 2 column grid with a single item: ```
+      # "grid": ` "title": "A fine collection of items", "numColumns": 2, "
+      # borderStyle": ` "type": "STROKE", "cornerRadius": 4.0 `, "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.
+        # Represents the complete border style applied to items in a widget.
         # Corresponds to the JSON property `borderStyle`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1BorderStyle]
         attr_accessor :border_style
@@ -1512,7 +1614,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
@@ -1561,11 +1664,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,22 +1679,33 @@ 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. Supports [standard](https://
+      # developers.google.com/chat/api/guides/message-formats/cards) 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, a
+        # default value is provided. As a best practice, you should set a helpful
+        # description. For example, if an icon displays a user's account portrait, you
+        # could describe it as "A user's account portrait." If the icon displays in a
+        # Button, this alt text takes precedence and overwrites the button's alt text,
+        # so you should write alt text for the button: 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
       
-        # 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
@@ -1607,7 +1716,10 @@ module Google
         # @return [String]
         attr_accessor :image_type
       
-        # The icon specified by the string name of a list of known icons.
+        # Display one of the standard 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 [standard icons](https://developers.google.
+        # com/chat/api/guides/message-formats/cards).
         # Corresponds to the JSON property `knownIcon`
         # @return [String]
         attr_accessor :known_icon
@@ -1634,12 +1746,14 @@ module Google
         # @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 +1779,14 @@ module Google
         # @return [String]
         attr_accessor :alt_text
       
-        # Represents the complete border style applied to widgets.
+        # Represents the complete border style applied to items in a widget.
         # 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 by 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 +1809,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 by 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 by 9 aspect ratio: ``` cropStyle ` "type": "
+        # RECTANGLE_CUSTOM", "aspectRatio": 16/9 ` ```
         # Corresponds to the JSON property `aspectRatio`
         # @return [Float]
         attr_accessor :aspect_ratio
@@ -1718,7 +1838,8 @@ 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
       
@@ -1728,24 +1849,29 @@ module Google
         # @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" ` ```
+        # 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. In Google Chat,
+        # cards appear in several places: - As stand-alone messages. - Accompanying a
+        # text message, just beneath the text message. - As a [dialog](https://
+        # developers.google.com/chat/how-tos/dialogs). The following example JSON
+        # creates a "contact card" that features: - A header with the contact's name,
+        # job title, avatar picture. - A section with the contact information, including
+        # formatted text. - Buttons that users can click to share the contact or see
+        # more or less info. ![Example contact card](https://developers.google.com/chat/
+        # images/card_api_reference.png) ``` ` "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
@@ -1807,33 +1933,38 @@ module Google
       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 are 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](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 1 widget.
         # Corresponds to the JSON property `widgets`
         # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Widget>]
         attr_accessor :widgets
@@ -1852,21 +1983,34 @@ module Google
       end
       
       # A widget that creates a UI item with options for users to select. For example,
-      # a dropdown menu.
+      # a dropdown menu or check list. 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/how-tos/
+      # dialogs#receive_form_data_from_dialogs). When you need to collect data from
+      # users that matches options you set, use a selection input. To collect abstract
+      # data from users, use the text input widget instead. Only supported in [dialogs]
+      # (https://developers.google.com/chat/how-tos/dialogs). Support for [card
+      # messages](https://developers.google.com/chat/api/guides/message-formats/cards)
+      # coming soon.
       class GoogleAppsCardV1SelectionInput
         include Google::Apis::Core::Hashable
       
-        # An array of the selected items.
+        # An array of the selected items. For example, all the selected check boxes.
         # 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`.
+        # The name by which the selection input is identified in a form input event. For
+        # details about working with form inputs, see [Receive form data](https://
+        # developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1877,7 +2021,11 @@ module Google
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :on_change_action
       
-        # The type of the selection.
+        # The way that an option appears to users. Different options support different
+        # types of interactions. For example, users can enable multiple check boxes, but
+        # can only select one value from a dropdown menu. Each selection input supports
+        # one type of selection. Mixing check boxes and switches, for example, is not
+        # supported.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1896,24 +2044,27 @@ module Google
         end
       end
       
-      # A selectable item in the switch control.
+      # A selectable item in a selection input, such as a check box or a 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.
+        # When `true`, more than one item is selected. If more than one item is selected
+        # for radio buttons and dropdown menus, the first selected item is received and
+        # the ones after are ignored.
         # Corresponds to the JSON property `selected`
         # @return [Boolean]
         attr_accessor :selected
         alias_method :selected?, :selected
       
-        # The text to be displayed.
+        # The text displayed 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/how-tos/dialogs#
+        # receive_form_data_from_dialogs).
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1930,11 +2081,12 @@ module Google
         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 would enter themselves.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -1949,12 +2101,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 just 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 is 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,16 +2130,22 @@ 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 on the `decoratedText` widget. Currently supported in [dialogs](
+      # https://developers.google.com/chat/how-tos/dialogs). Support for [card
+      # messages](https://developers.google.com/chat/api/guides/message-formats/cards)
+      # is coming soon.
       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/how-tos/dialogs#receive_form_data_from_dialogs).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1989,13 +2156,15 @@ module Google
         # @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/how-tos/dialogs#receive_form_data_from_dialogs).
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2014,8 +2183,15 @@ 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. 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/how-tos/dialogs#
+      # receive_form_data_from_dialogs). When you need to collect abstract data from
+      # users, use a text input. To collect defined data from users, use the selection
+      # input widget instead. Only supported in [dialogs](https://developers.google.
+      # com/chat/how-tos/dialogs). Support for [card messages](https://developers.
+      # google.com/chat/api/guides/message-formats/cards) coming soon.
       class GoogleAppsCardV1TextInput
         include Google::Apis::Core::Hashable
       
@@ -2025,23 +2201,39 @@ module Google
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
         attr_accessor :auto_complete_action
       
-        # The hint text.
+        # Text that appears inside the text input field meant to assist users by
+        # prompting them to enter a certain value. This text is not visible after users
+        # begin typing. 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 just 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 is 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/how-tos/dialogs#receive_form_data_from_dialogs).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2052,12 +2244,15 @@ module Google
         # @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/how-tos/dialogs#receive_form_data_from_dialogs).
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2100,7 +2295,8 @@ 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
       
@@ -2109,8 +2305,11 @@ module Google
         # @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.
+        # Lets users specify a date, a time, or both a date and a time. Accepts text
+        # input from users, but features an interactive date and time selector that
+        # helps users enter correctly-formatted dates and times. If users enter a date
+        # or time incorrectly, the widget shows an error that prompts users to enter the
+        # correct format. Not supported by Chat apps. Support by Chat apps coming soon.
         # Corresponds to the JSON property `dateTimePicker`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
         attr_accessor :date_time_picker
@@ -2122,34 +2321,57 @@ module Google
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
         attr_accessor :decorated_text
       
-        # A divider that appears in between widgets.
+        # Displays a divider between widgets, a horizontal line. 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. 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. Currently supported in [dialogs](https://developers.
+        # google.com/chat/how-tos/dialogs). Support for [card messages](https://
+        # developers.google.com/chat/api/guides/message-formats/cards) is coming soon.
+        # For example, the following JSON creates a 2 column grid with a single item: ```
+        # "grid": ` "title": "A fine collection of items", "numColumns": 2, "
+        # borderStyle": ` "type": "STROKE", "cornerRadius": 4.0 `, "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.
-        # 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.
         # 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 dropdown menu or check list. 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/how-tos/
+        # dialogs#receive_form_data_from_dialogs). When you need to collect data from
+        # users that matches options you set, use a selection input. To collect abstract
+        # data from users, use the text input widget instead. Only supported in [dialogs]
+        # (https://developers.google.com/chat/how-tos/dialogs). Support for [card
+        # messages](https://developers.google.com/chat/api/guides/message-formats/cards)
+        # coming soon.
         # 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. 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/how-tos/dialogs#
+        # receive_form_data_from_dialogs). When you need to collect abstract data from
+        # users, use a text input. To collect defined data from users, use the selection
+        # input widget instead. Only supported in [dialogs](https://developers.google.
+        # com/chat/how-tos/dialogs). Support for [card messages](https://developers.
+        # google.com/chat/api/guides/message-formats/cards) coming soon.
         # Corresponds to the JSON property `textInput`
         # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
         attr_accessor :text_input
@@ -2172,7 +2394,6 @@ module Google
           @decorated_text = args[:decorated_text] if args.key?(:decorated_text)
           @divider = args[:divider] if args.key?(:divider)
           @grid = args[:grid] if args.key?(:grid)
-          @horizontal_alignment = args[:horizontal_alignment] if args.key?(:horizontal_alignment)
           @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)
@@ -2364,8 +2585,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 can be sent 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
@@ -2385,9 +2606,8 @@ module Google
       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.
+        # A token that can be sent 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
@@ -2518,9 +2738,10 @@ module Google
         # @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
+        # 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.
         # Corresponds to the JSON property `cards`
         # @return [Array<Google::Apis::ChatV1::Card>]
         attr_accessor :cards
@@ -2532,11 +2753,20 @@ module Google
         # (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`
+        # DecoratedText` - `Image` - `ButtonList` - `Divider`
         # Corresponds to the JSON property `cardsV2`
         # @return [Array<Google::Apis::ChatV1::CardWithId>]
         attr_accessor :cards_v2
       
+        # 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. For example usage, see [Name a created message](https://
+        # developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).
+        # Corresponds to the JSON property `clientAssignedMessageId`
+        # @return [String]
+        attr_accessor :client_assigned_message_id
+      
         # Output only. The time at which the message was created in Google Chat server.
         # Corresponds to the JSON property `createTime`
         # @return [String]
@@ -2595,6 +2825,15 @@ module Google
         # @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
@@ -2607,6 +2846,7 @@ module Google
           @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)
           @fallback_text = args[:fallback_text] if args.key?(:fallback_text)
           @last_update_time = args[:last_update_time] if args.key?(:last_update_time)
@@ -2617,6 +2857,7 @@ module Google
           @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
       
@@ -2783,7 +3024,13 @@ module Google
         # @return [Google::Apis::ChatV1::SpaceDetails]
         attr_accessor :space_details
       
-        # Output only. Whether messages are threaded in this space.
+        # Output only. The threading state in the Chat space.
+        # Corresponds to the JSON property `spaceThreadingState`
+        # @return [String]
+        attr_accessor :space_threading_state
+      
+        # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages
+        # are threaded in this space.
         # Corresponds to the JSON property `threaded`
         # @return [Boolean]
         attr_accessor :threaded
@@ -2805,6 +3052,7 @@ module Google
           @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_threading_state = args[:space_threading_state] if args.key?(:space_threading_state)
           @threaded = args[:threaded] if args.key?(:threaded)
           @type = args[:type] if args.key?(:type)
         end
@@ -2944,12 +3192,20 @@ module Google
       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. Opaque thread identifier. To start or add to a thread, create a
+        # message and specify a `threadKey` or the thread.name. For example usage, see [
+        # Start or reply to a message thread](/chat/api/guides/crudl/messages#
+        # start_or_reply_to_a_message_thread). For other requests, this is an output
+        # only field.
+        # Corresponds to the JSON property `threadKey`
+        # @return [String]
+        attr_accessor :thread_key
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2957,6 +3213,7 @@ 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
       
@@ -3033,10 +3290,8 @@ 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. For human users, represents a person in
+        # the People API or a user in the Admin SDK Directory API. Format: `users/`user``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name