RubyGems - google-apis-chat_v1 - Versions diffs - 0.45.0 → 0.47.0 - Mend

google-apis-chat_v1 0.45.0 → 0.47.0

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

Files changed (8) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +9 -0
data/lib/google/apis/chat_v1/classes.rb +469 -214
data/lib/google/apis/chat_v1/gem_version.rb +3 -3
data/lib/google/apis/chat_v1/representations.rb +5 -2
data/lib/google/apis/chat_v1/service.rb +314 -81
data/lib/google/apis/chat_v1.rb +12 -0
metadata +5 -5

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

@@ -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