google-api-python-client 2.86.0__py2.py3-none-any.whl → 2.87.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/chat.v1.json

@@ -5,9 +5,15 @@
         "https://www.googleapis.com/auth/chat.bot": {
           "description": "Private Service: https://www.googleapis.com/auth/chat.bot"
         },
+        "https://www.googleapis.com/auth/chat.delete": {
+          "description": "Delete conversations and spaces & remove access to associated files in Google Chat"
+        },
         "https://www.googleapis.com/auth/chat.memberships": {
           "description": "View, add, and remove members from conversations in Google Chat"
         },
+        "https://www.googleapis.com/auth/chat.memberships.app": {
+          "description": "Add and remove itself from conversations in Google Chat"
+        },
         "https://www.googleapis.com/auth/chat.memberships.readonly": {
           "description": "View members in Google Chat conversations."
         },
@@ -17,12 +23,24 @@
         "https://www.googleapis.com/auth/chat.messages.create": {
           "description": "Compose and send messages in Google Chat"
         },
+        "https://www.googleapis.com/auth/chat.messages.reactions": {
+          "description": "View, add, and delete reactions to messages in Google Chat"
+        },
+        "https://www.googleapis.com/auth/chat.messages.reactions.create": {
+          "description": "Add reactions to messages in Google Chat"
+        },
+        "https://www.googleapis.com/auth/chat.messages.reactions.readonly": {
+          "description": "View reactions to messages in Google Chat"
+        },
         "https://www.googleapis.com/auth/chat.messages.readonly": {
           "description": "View messages and reactions in Google Chat"
         },
         "https://www.googleapis.com/auth/chat.spaces": {
           "description": "Create conversations and spaces and view or update metadata (including history settings) in Google Chat"
         },
+        "https://www.googleapis.com/auth/chat.spaces.create": {
+          "description": "Create new conversations in Google Chat"
+        },
         "https://www.googleapis.com/auth/chat.spaces.readonly": {
           "description": "View chat and spaces in Google Chat"
         }
@@ -155,11 +173,130 @@
             "https://www.googleapis.com/auth/chat.messages.readonly"
           ],
           "supportsMediaDownload": true
+        },
+        "upload": {
+          "description": "[Developer Preview](https://developers.google.com/workspace/preview): Uploads an attachment. Requires user [authentication](https://developers.google.com/chat/api/guides/auth/users). You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see [File types blocked by Google Chat](https://support.google.com/chat/answer/7651457?&co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).",
+          "flatPath": "v1/spaces/{spacesId}/attachments:upload",
+          "httpMethod": "POST",
+          "id": "chat.media.upload",
+          "mediaUpload": {
+            "accept": [
+              "*/*"
+            ],
+            "maxSize": "209715200",
+            "protocols": {
+              "resumable": {
+                "multipart": true,
+                "path": "/resumable/upload/v1/{+parent}/attachments:upload"
+              },
+              "simple": {
+                "multipart": true,
+                "path": "/upload/v1/{+parent}/attachments:upload"
+              }
+            }
+          },
+          "parameterOrder": [
+            "parent"
+          ],
+          "parameters": {
+            "parent": {
+              "description": "Required. Resource name of the Chat space in which the attachment is uploaded. Format \"spaces/{space}\".",
+              "location": "path",
+              "pattern": "^spaces/[^/]+$",
+              "required": true,
+              "type": "string"
+            }
+          },
+          "path": "v1/{+parent}/attachments:upload",
+          "request": {
+            "$ref": "UploadAttachmentRequest"
+          },
+          "response": {
+            "$ref": "UploadAttachmentResponse"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/chat.messages",
+            "https://www.googleapis.com/auth/chat.messages.create"
+          ],
+          "supportsMediaUpload": true
         }
       }
     },
     "spaces": {
       "methods": {
+        "create": {
+          "description": "[Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access aren't supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.",
+          "flatPath": "v1/spaces",
+          "httpMethod": "POST",
+          "id": "chat.spaces.create",
+          "parameterOrder": [],
+          "parameters": {
+            "requestId": {
+              "description": "Optional. A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space. Specifying an existing request ID from the same Chat app with a different authenticated user returns an error.",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          "path": "v1/spaces",
+          "request": {
+            "$ref": "Space"
+          },
+          "response": {
+            "$ref": "Space"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/chat.spaces",
+            "https://www.googleapis.com/auth/chat.spaces.create"
+          ]
+        },
+        "delete": {
+          "description": "[Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources\u2014like messages posted in the space and memberships in the space\u2014are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who has permission to delete the space, and the `chat.delete` scope.",
+          "flatPath": "v1/spaces/{spacesId}",
+          "httpMethod": "DELETE",
+          "id": "chat.spaces.delete",
+          "parameterOrder": [
+            "name"
+          ],
+          "parameters": {
+            "name": {
+              "description": "Required. Resource name of the space to delete. Format: `spaces/{space}`",
+              "location": "path",
+              "pattern": "^spaces/[^/]+$",
+              "required": true,
+              "type": "string"
+            }
+          },
+          "path": "v1/{+name}",
+          "response": {
+            "$ref": "Empty"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/chat.delete"
+          ]
+        },
+        "findDirectMessage": {
+          "description": "[Developer Preview](https://developers.google.com/workspace/preview): Returns the existing direct message with the specified user. With [user authentication](https://developers.google.com/chat/api/guides/auth/users), returns the direct message space between the specified user and the authenticated user. With [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts), returns the direct message space between the specified user and the calling Chat app. If no direct message space is found, returns a `404 NOT_FOUND` error. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) or [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).",
+          "flatPath": "v1/spaces:findDirectMessage",
+          "httpMethod": "GET",
+          "id": "chat.spaces.findDirectMessage",
+          "parameterOrder": [],
+          "parameters": {
+            "name": {
+              "description": "Required. Resource name of the user to find direct message with. Format: `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API `Person.resourceName` is `people/123456789`, you can find a direct message with that person by using `users/123456789` as the `name`.",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          "path": "v1/spaces:findDirectMessage",
+          "response": {
+            "$ref": "Space"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/chat.bot",
+            "https://www.googleapis.com/auth/chat.spaces",
+            "https://www.googleapis.com/auth/chat.spaces.readonly"
+          ]
+        },
         "get": {
           "description": "Returns a space. Requires [authentication](https://developers.google.com/chat/api/guides/auth). Fully supports [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). Supports [user authentication](https://developers.google.com/chat/api/guides/auth/users) as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. [User authentication](https://developers.google.com/chat/api/guides/auth/users) requires the `chat.spaces` or `chat.spaces.readonly` authorization scope.",
           "flatPath": "v1/spaces/{spacesId}",
@@ -170,7 +307,7 @@
           ],
           "parameters": {
             "name": {
-              "description": "Required. Resource name of the space, in the form \"spaces/*\". Format: spaces/{space}",
+              "description": "Required. Resource name of the space, in the form \"spaces/*\". Format: `spaces/{space}`",
               "location": "path",
               "pattern": "^spaces/[^/]+$",
               "required": true,
@@ -194,14 +331,19 @@
           "id": "chat.spaces.list",
           "parameterOrder": [],
           "parameters": {
+            "filter": {
+              "description": "Optional. A query filter. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users). You can filter spaces by the space type ([`space_type`](https://developers.google.com/chat/api/reference/rest/v1/spaces#spacetype)). To filter by space type, you must specify valid enum value, such as `SPACE` or `GROUP_CHAT` (the `space_type` can't be `SPACE_TYPE_UNSPECIFIED`). To query for multiple space types, use the `OR` operator. For example, the following queries are valid: ``` space_type = \"SPACE\" spaceType = \"GROUP_CHAT\" OR spaceType = \"DIRECT_MESSAGE\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error. With [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts), this field is ignored and the query always returns all spaces. But the Chat API still validates the query syntax with service accounts, so invalid queries are still rejected. [Developer Preview](https://developers.google.com/workspace/preview).",
+              "location": "query",
+              "type": "string"
+            },
             "pageSize": {
-              "description": "Optional. The maximum number of spaces to return. The service may return fewer than this value. If unspecified, at most 100 spaces are returned. The maximum value is 1000; values above 1000 are coerced to 1000. Negative values return an `INVALID_ARGUMENT` error.",
+              "description": "Optional. The maximum number of spaces to return. The service might return fewer than this value. If unspecified, at most 100 spaces are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.",
               "format": "int32",
               "location": "query",
               "type": "integer"
             },
             "pageToken": {
-              "description": "Optional. A page token, received from a previous list spaces call. Provide this to retrieve the subsequent page. When paginating, the filter value should match the call that provided the page token. Passing a different value may lead to unexpected results.",
+              "description": "Optional. A page token, received from a previous list spaces call. Provide this parameter to retrieve the subsequent page. When paginating, the filter value should match the call that provided the page token. Passing a different value may lead to unexpected results.",
               "location": "query",
               "type": "string"
             }
@@ -215,11 +357,119 @@
             "https://www.googleapis.com/auth/chat.spaces",
             "https://www.googleapis.com/auth/chat.spaces.readonly"
           ]
+        },
+        "patch": {
+          "description": "[Developer Preview](https://developers.google.com/workspace/preview): Updates a space. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces` scope.",
+          "flatPath": "v1/spaces/{spacesId}",
+          "httpMethod": "PATCH",
+          "id": "chat.spaces.patch",
+          "parameterOrder": [
+            "name"
+          ],
+          "parameters": {
+            "name": {
+              "description": "Resource name of the space. Format: `spaces/{space}`",
+              "location": "path",
+              "pattern": "^spaces/[^/]+$",
+              "required": true,
+              "type": "string"
+            },
+            "updateMask": {
+              "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.)",
+              "format": "google-fieldmask",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          "path": "v1/{+name}",
+          "request": {
+            "$ref": "Space"
+          },
+          "response": {
+            "$ref": "Space"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/chat.spaces"
+          ]
+        },
+        "setup": {
+          "description": "[Developer Preview](https://developers.google.com/workspace/preview): Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. To specify the human members to add, add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`. To add a human user, use `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. For example, if the People API `Person` `resourceName` is `people/123456789`, you can add the user to the space by including a membership with `users/123456789` as the `member.name`. For a space or group chat, if the caller blocks or is blocked by some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to true and don't specify any memberships. You can only use this method to add app memberships to DMs. To add the calling app as a member of other space types, use [create membership](https://developers.google.com/chat/api/reference/rest/v1/spaces.members/create) If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access aren't supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.",
+          "flatPath": "v1/spaces:setup",
+          "httpMethod": "POST",
+          "id": "chat.spaces.setup",
+          "parameterOrder": [],
+          "parameters": {},
+          "path": "v1/spaces:setup",
+          "request": {
+            "$ref": "SetUpSpaceRequest"
+          },
+          "response": {
+            "$ref": "Space"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/chat.spaces",
+            "https://www.googleapis.com/auth/chat.spaces.create"
+          ]
         }
       },
       "resources": {
         "members": {
           "methods": {
+            "create": {
+              "description": "[Developer Preview](https://developers.google.com/workspace/preview): Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.memberships` (for human membership) or `chat.memberships.app` (for app membership) scope. To specify the member to add, set the `membership.member.name` in the `CreateMembershipRequest`: - To add the calling app to the space, use `users/app`. - To add a human user, use `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API `Person` `resourceName` is `people/123456789`, you can add the user to the space by setting the `membership.member.name` to `users/123456789`.",
+              "flatPath": "v1/spaces/{spacesId}/members",
+              "httpMethod": "POST",
+              "id": "chat.spaces.members.create",
+              "parameterOrder": [
+                "parent"
+              ],
+              "parameters": {
+                "parent": {
+                  "description": "Required. The resource name of the space for which to create the membership. Format: spaces/{space}",
+                  "location": "path",
+                  "pattern": "^spaces/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1/{+parent}/members",
+              "request": {
+                "$ref": "Membership"
+              },
+              "response": {
+                "$ref": "Membership"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/chat.memberships",
+                "https://www.googleapis.com/auth/chat.memberships.app"
+              ]
+            },
+            "delete": {
+              "description": "[Developer Preview](https://developers.google.com/workspace/preview): Deletes a membership. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.memberships` or `chat.memberships.app` authorization scope.",
+              "flatPath": "v1/spaces/{spacesId}/members/{membersId}",
+              "httpMethod": "DELETE",
+              "id": "chat.spaces.members.delete",
+              "parameterOrder": [
+                "name"
+              ],
+              "parameters": {
+                "name": {
+                  "description": "Required. Resource name of the membership to delete. Chat apps can delete human users' or their own memberships. Chat apps can't delete other apps' memberships. When deleting a human membership, requires the `chat.memberships` scope and `spaces/{space}/members/{member}` format. When deleting an app membership, requires the `chat.memberships.app` scope and `spaces/{space}/members/app` format. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`",
+                  "location": "path",
+                  "pattern": "^spaces/[^/]+/members/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1/{+name}",
+              "response": {
+                "$ref": "Membership"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/chat.memberships",
+                "https://www.googleapis.com/auth/chat.memberships.app"
+              ]
+            },
             "get": {
               "description": "Returns a membership. Requires [authentication](https://developers.google.com/chat/api/guides/auth/). Fully supports [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). Supports [user authentication](https://developers.google.com/chat/api/guides/auth/users) as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. [User authentication](https://developers.google.com/chat/api/guides/auth/users) requires the `chat.memberships` or `chat.memberships.readonly` authorization scope.",
               "flatPath": "v1/spaces/{spacesId}/members/{membersId}",
@@ -230,7 +480,7 @@
               ],
               "parameters": {
                 "name": {
-                  "description": "Required. Resource name of the membership to retrieve. Format: spaces/{space}/members/{member}",
+                  "description": "Required. Resource name of the membership to retrieve. Format: `spaces/{space}/members/{member}`",
                   "location": "path",
                   "pattern": "^spaces/[^/]+/members/[^/]+$",
                   "required": true,
@@ -256,14 +506,19 @@
                 "parent"
               ],
               "parameters": {
+                "filter": {
+                  "description": "Optional. A query filter. You can filter memberships by a member's role ([`role`](https://developers.google.com/chat/api/reference/rest/v1/spaces.members#membershiprole)) and type ([`member.type`](https://developers.google.com/chat/api/reference/rest/v1/User#type)). To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN` or `BOT`. To filter by both role and type, use the `AND` operator. To filter by either role or type, use the `OR` operator. For example, the following queries are valid: ``` role = \"ROLE_MANAGER\" OR role = \"ROLE_MEMBER\" member.type = \"HUMAN\" AND role = \"ROLE_MANAGER\" ``` The following queries are invalid: ``` member.type = \"HUMAN\" AND member.type = \"BOT\" role = \"ROLE_MANAGER\" AND role = \"ROLE_MEMBER\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
+                  "location": "query",
+                  "type": "string"
+                },
                 "pageSize": {
-                  "description": "The maximum number of memberships to return. The service may return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1000; values above 1000 are coerced to 1000. Negative values return an INVALID_ARGUMENT error.",
+                  "description": "The maximum number of memberships to return. The service might return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.",
                   "format": "int32",
                   "location": "query",
                   "type": "integer"
                 },
                 "pageToken": {
-                  "description": "A page token, received from a previous call to list memberships. Provide this to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters may lead to unexpected results.",
+                  "description": "A page token, received from a previous call to list memberships. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.",
                   "location": "query",
                   "type": "string"
                 },
@@ -273,6 +528,11 @@
                   "pattern": "^spaces/[^/]+$",
                   "required": true,
                   "type": "string"
+                },
+                "showInvited": {
+                  "description": "Optional. When `true`, also returns memberships associated with invited members, in addition to other types of memberships. If a filter is set, invited memberships that don't match the filter criteria aren't returned. Currently requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
+                  "location": "query",
+                  "type": "boolean"
                 }
               },
               "path": "v1/{+parent}/members",
@@ -312,14 +572,14 @@
                   ],
                   "enumDescriptions": [
                     "Default. Starts a thread.",
-                    "Creates the message as a reply to the thread specified by thread ID or thread_key. If it fails, the message starts a new thread instead.",
-                    "Creates the message as a reply to the thread specified by thread ID or thread_key. If it fails, a NOT_FOUND error is returned instead."
+                    "Creates the message as a reply to the thread specified by thread ID or `thread_key`. If it fails, the message starts a new thread instead.",
+                    "Creates the message as a reply to the thread specified by thread ID or `thread_key`. If it fails, a `NOT_FOUND` error is returned instead."
                   ],
                   "location": "query",
                   "type": "string"
                 },
                 "parent": {
-                  "description": "Required. The resource name of the space in which to create a message. Format: spaces/{space}",
+                  "description": "Required. The resource name of the space in which to create a message. Format: `spaces/{space}`",
                   "location": "path",
                   "pattern": "^spaces/[^/]+$",
                   "required": true,
@@ -331,6 +591,7 @@
                   "type": "string"
                 },
                 "threadKey": {
+                  "deprecated": true,
                   "description": "Optional. Deprecated: Use thread.thread_key instead. 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](https://developers.google.com/chat/api/guides/crudl/messages#start_or_reply_to_a_message_thread).",
                   "location": "query",
                   "type": "string"
@@ -358,8 +619,13 @@
                 "name"
               ],
               "parameters": {
+                "force": {
+                  "description": "When `true`, deleting a message also deletes its threaded replies. When `false`, if a message has threaded replies, deletion fails. Only applies when [authenticating as a user](https://developers.google.com/chat/api/guides/auth/users). Has no effect when [authenticating with a service account] (https://developers.google.com/chat/api/guides/auth/service-accounts).",
+                  "location": "query",
+                  "type": "boolean"
+                },
                 "name": {
-                  "description": "Required. Resource name of the message to be deleted, in the form \"spaces/*/messages/*\" Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB",
+                  "description": "Required. Resource name of the message that you want to delete, in the form `spaces/*/messages/*` Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`",
                   "location": "path",
                   "pattern": "^spaces/[^/]+/messages/[^/]+$",
                   "required": true,
@@ -385,7 +651,7 @@
               ],
               "parameters": {
                 "name": {
-                  "description": "Required. Resource name of the message to retrieve. Format: spaces/{space}/messages/{message} If the message begins with `client-`, then it has a custom name assigned by a Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and name a message] (https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).",
+                  "description": "Required. Resource name of the message to retrieve. Format: `spaces/{space}/messages/{message}` If the message begins with `client-`, then it has a custom name assigned by a Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and name a message] (https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).",
                   "location": "path",
                   "pattern": "^spaces/[^/]+/messages/[^/]+$",
                   "required": true,
@@ -402,6 +668,58 @@
                 "https://www.googleapis.com/auth/chat.messages.readonly"
               ]
             },
+            "list": {
+              "description": "[Developer Preview](https://developers.google.com/workspace/preview): Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.readonly` authorization scope. This method is only supported in spaces that don't allow users from outside the Workspace organization to join.",
+              "flatPath": "v1/spaces/{spacesId}/messages",
+              "httpMethod": "GET",
+              "id": "chat.spaces.messages.list",
+              "parameterOrder": [
+                "parent"
+              ],
+              "parameters": {
+                "filter": {
+                  "description": "A query filter. You can filter messages by date (`create_time`) and thread (`thread.name`). To filter messages by the date they were created, specify the `create_time` with a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and double quotation marks. For example, `\"2023-04-21T11:30:00-04:00\"`. You can use the greater than operator `>` to list messages that were created after a timestamp, or the less than operator `<` to list messages that were created before a timestamp. To filter messages within a time interval, use the `AND` operator between two timestamps. To filter by thread, specify the `thread.name`, formatted as `spaces/{space}/threads/{thread}`. You can only specify one `thread.name` per query. To filter by both thread and date, use the `AND` operator in your query. For example, the following queries are valid: ``` create_time > \"2012-04-21T11:30:00-04:00\" create_time > \"2012-04-21T11:30:00-04:00\" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time > \"2012-04-21T11:30:00+00:00\" AND create_time < \"2013-01-01T00:00:00+00:00\" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123 ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
+                  "location": "query",
+                  "type": "string"
+                },
+                "orderBy": {
+                  "description": "Optional, if resuming from a previous query. How the list of messages is ordered. Specify a value to order by an ordering operation. Valid ordering operation values are as follows: - `ASC` for ascending. - `DESC` for descending. The default ordering is `create_time ASC`.",
+                  "location": "query",
+                  "type": "string"
+                },
+                "pageSize": {
+                  "description": "The maximum number of messages returned. The service might return fewer messages than this value. If unspecified, at most 25 are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.",
+                  "format": "int32",
+                  "location": "query",
+                  "type": "integer"
+                },
+                "pageToken": {
+                  "description": "Optional, if resuming from a previous query. A page token received from a previous list messages call. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.",
+                  "location": "query",
+                  "type": "string"
+                },
+                "parent": {
+                  "description": "Required. The resource name of the space to list messages from. Format: `spaces/{space}`",
+                  "location": "path",
+                  "pattern": "^spaces/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                },
+                "showDeleted": {
+                  "description": "Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.",
+                  "location": "query",
+                  "type": "boolean"
+                }
+              },
+              "path": "v1/{+parent}/messages",
+              "response": {
+                "$ref": "ListMessagesResponse"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/chat.messages",
+                "https://www.googleapis.com/auth/chat.messages.readonly"
+              ]
+            },
             "patch": {
               "description": "Updates a message. There's a difference between `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For example usage, see [Update a message](https://developers.google.com/chat/api/guides/crudl/messages#update_a_message). Requires [authentication](https://developers.google.com/chat/api/guides/auth/). Fully supports [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). Supports [user authentication](https://developers.google.com/chat/api/guides/auth/users) as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. [User authentication](https://developers.google.com/chat/api/guides/auth/users) requires the `chat.messages` authorization scope.",
               "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}",
@@ -412,7 +730,7 @@
               ],
               "parameters": {
                 "allowMissing": {
-                  "description": "Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.",
+                  "description": "Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.",
                   "location": "query",
                   "type": "boolean"
                 },
@@ -424,7 +742,7 @@
                   "type": "string"
                 },
                 "updateMask": {
-                  "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account authentication](/chat/api/guides/auth/service-accounts).) - cards_v2 ",
+                  "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `cards` (Requires [service account authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` ",
                   "format": "google-fieldmask",
                   "location": "query",
                   "type": "string"
@@ -452,7 +770,7 @@
               ],
               "parameters": {
                 "allowMissing": {
-                  "description": "Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.",
+                  "description": "Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.",
                   "location": "query",
                   "type": "boolean"
                 },
@@ -464,7 +782,7 @@
                   "type": "string"
                 },
                 "updateMask": {
-                  "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account authentication](/chat/api/guides/auth/service-accounts).) - cards_v2 ",
+                  "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `cards` (Requires [service account authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` ",
                   "format": "google-fieldmask",
                   "location": "query",
                   "type": "string"
@@ -496,7 +814,7 @@
                   ],
                   "parameters": {
                     "name": {
-                      "description": "Required. Resource name of the attachment, in the form \"spaces/*/messages/*/attachments/*\".",
+                      "description": "Required. Resource name of the attachment, in the form `spaces/*/messages/*/attachments/*`.",
                       "location": "path",
                       "pattern": "^spaces/[^/]+/messages/[^/]+/attachments/[^/]+$",
                       "required": true,
@@ -512,17 +830,121 @@
                   ]
                 }
               }
+            },
+            "reactions": {
+              "methods": {
+                "create": {
+                  "description": "[Developer Preview](https://developers.google.com/workspace/preview): Creates a reaction and adds it to a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages`, `chat.messages.reactions`, or `chat.messages.reactions.create` scope. Only unicode emoji are supported.",
+                  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/reactions",
+                  "httpMethod": "POST",
+                  "id": "chat.spaces.messages.reactions.create",
+                  "parameterOrder": [
+                    "parent"
+                  ],
+                  "parameters": {
+                    "parent": {
+                      "description": "Required. The message where the reaction is created. Format: `spaces/{space}/messages/{message}`",
+                      "location": "path",
+                      "pattern": "^spaces/[^/]+/messages/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+parent}/reactions",
+                  "request": {
+                    "$ref": "Reaction"
+                  },
+                  "response": {
+                    "$ref": "Reaction"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/chat.messages",
+                    "https://www.googleapis.com/auth/chat.messages.reactions",
+                    "https://www.googleapis.com/auth/chat.messages.reactions.create"
+                  ]
+                },
+                "delete": {
+                  "description": "[Developer Preview](https://developers.google.com/workspace/preview): Deletes a reaction to a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.reactions` scope.",
+                  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/reactions/{reactionsId}",
+                  "httpMethod": "DELETE",
+                  "id": "chat.spaces.messages.reactions.delete",
+                  "parameterOrder": [
+                    "name"
+                  ],
+                  "parameters": {
+                    "name": {
+                      "description": "Required. Name of the reaction to delete. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`",
+                      "location": "path",
+                      "pattern": "^spaces/[^/]+/messages/[^/]+/reactions/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+name}",
+                  "response": {
+                    "$ref": "Empty"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/chat.messages",
+                    "https://www.googleapis.com/auth/chat.messages.reactions"
+                  ]
+                },
+                "list": {
+                  "description": "[Developer Preview](https://developers.google.com/workspace/preview): Lists reactions to a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and `chat.messages`, `chat.messages.readonly`, `chat.messages.reactions`, or `chat.messages.reactions.readonly` scope.",
+                  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/reactions",
+                  "httpMethod": "GET",
+                  "id": "chat.spaces.messages.reactions.list",
+                  "parameterOrder": [
+                    "parent"
+                  ],
+                  "parameters": {
+                    "filter": {
+                      "description": "Optional. A query filter. You can filter reactions by [emoji](https://developers.google.com/chat/api/reference/rest/v1/Emoji) (either `emoji.unicode` or `emoji.custom_emoji.uid`) and [user](https://developers.google.com/chat/api/reference/rest/v1/User) (`user.name`). To filter reactions for multiple emojis or users, join similar fields with the `OR` operator, such as `emoji.unicode = \"\ud83d\ude42\" OR emoji.unicode = \"\ud83d\udc4d\"` and `user.name = \"users/AAAAAA\" OR user.name = \"users/BBBBBB\"`. To filter reactions by emoji and user, use the `AND` operator, such as `emoji.unicode = \"\ud83d\ude42\" AND user.name = \"users/AAAAAA\"`. If your query uses both `AND` and `OR`, group them with parentheses. For example, the following queries are valid: ``` user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.unicode = \"\ud83d\udc4d\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" AND user.name = \"users/{user}\" (emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\") AND user.name = \"users/{user}\" ``` The following queries are invalid: ``` emoji.unicode = \"\ud83d\ude42\" AND emoji.unicode = \"\ud83d\udc4d\" emoji.unicode = \"\ud83d\ude42\" AND emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" OR user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" OR user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" AND user.name = \"users/{user}\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
+                      "location": "query",
+                      "type": "string"
+                    },
+                    "pageSize": {
+                      "description": "Optional. The maximum number of reactions returned. The service can return fewer reactions than this value. If unspecified, the default value is 25. The maximum value is 200; values above 200 are changed to 200.",
+                      "format": "int32",
+                      "location": "query",
+                      "type": "integer"
+                    },
+                    "pageToken": {
+                      "description": "Optional. (If resuming from a previous query.) A page token received from a previous list reactions call. Provide this to retrieve the subsequent page. When paginating, the filter value should match the call that provided the page token. Passing a different value might lead to unexpected results.",
+                      "location": "query",
+                      "type": "string"
+                    },
+                    "parent": {
+                      "description": "Required. The message users reacted to. Format: `spaces/{space}/messages/{message}`",
+                      "location": "path",
+                      "pattern": "^spaces/[^/]+/messages/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+parent}/reactions",
+                  "response": {
+                    "$ref": "ListReactionsResponse"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/chat.messages",
+                    "https://www.googleapis.com/auth/chat.messages.reactions",
+                    "https://www.googleapis.com/auth/chat.messages.reactions.readonly",
+                    "https://www.googleapis.com/auth/chat.messages.readonly"
+                  ]
+                }
+              }
             }
           }
         }
       }
     }
   },
-  "revision": "20230413",
+  "revision": "20230521",
   "rootUrl": "https://chat.googleapis.com/",
   "schemas": {
     "ActionParameter": {
-      "description": "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.",
+      "description": "List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters.",
       "id": "ActionParameter",
       "properties": {
         "key": {
@@ -555,17 +977,17 @@
             "DIALOG"
           ],
           "enumDescriptions": [
-            "Default type; will be handled as NEW_MESSAGE.",
+            "Default type that's handled as `NEW_MESSAGE`.",
             "Post as a new message in the topic.",
-            "Update the Chat app's message. This is only permitted on a CARD_CLICKED event where the message sender type is BOT.",
-            "Update the cards on a user's message. This is only permitted as a response to a MESSAGE event with a matched url, or a CARD_CLICKED event where the message sender type is HUMAN. Text will be ignored.",
-            "Privately ask the user for additional auth or config.",
+            "Update the Chat app's message. This is only permitted on a `CARD_CLICKED` event where the message sender type is `BOT`.",
+            "Update the cards on a user's message. This is only permitted as a response to a `MESSAGE` event with a matched url, or a `CARD_CLICKED` event where the message sender type is `HUMAN`. Text is ignored.",
+            "Privately ask the user for additional authentication or configuration.",
             "Presents a [dialog](https://developers.google.com/chat/how-tos/dialogs)."
           ],
           "type": "string"
         },
         "url": {
-          "description": "Input only. URL for users to auth or config. (Only for REQUEST_CONFIG response types.)",
+          "description": "Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)",
           "type": "string"
         }
       },
@@ -650,7 +1072,7 @@
             "SLASH_COMMAND"
           ],
           "enumDescriptions": [
-            "Default value for the enum. DO NOT USE.",
+            "Default value for the enum. Don't use.",
             "A user is mentioned.",
             "A slash command is invoked."
           ],
@@ -669,7 +1091,7 @@
       "properties": {
         "attachmentDataRef": {
           "$ref": "AttachmentDataRef",
-          "description": "A reference to the attachment data. This is used with the media API to download the attachment data."
+          "description": "A reference to the attachment data. This field is used with the media API to download the attachment data."
         },
         "contentName": {
           "description": "The original file name for the content, not the full path.",
@@ -680,16 +1102,16 @@
           "type": "string"
         },
         "downloadUri": {
-          "description": "Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps should not use this URL to download attachment content.",
+          "description": "Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps shouldn't use this URL to download attachment content.",
           "readOnly": true,
           "type": "string"
         },
         "driveDataRef": {
           "$ref": "DriveDataRef",
-          "description": "A reference to the drive attachment. This is used with the Drive API."
+          "description": "A reference to the drive attachment. This field is used with the Drive API."
         },
         "name": {
-          "description": "Resource name of the attachment, in the form \"spaces/*/messages/*/attachments/*\".",
+          "description": "Resource name of the attachment, in the form `spaces/*/messages/*/attachments/*`.",
           "type": "string"
         },
         "source": {
@@ -707,7 +1129,7 @@
           "type": "string"
         },
         "thumbnailUri": {
-          "description": "Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps should not use this URL to download attachment content.",
+          "description": "Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps shouldn't use this URL to download attachment content.",
           "readOnly": true,
           "type": "string"
         }
@@ -717,8 +1139,12 @@
     "AttachmentDataRef": {
       "id": "AttachmentDataRef",
       "properties": {
+        "attachmentUploadToken": {
+          "description": "Opaque token containing a reference to an uploaded attachment. Treated by clients as an opaque string and used to create or update Chat messages with attachments. [Developer Preview](https://developers.google.com/workspace/preview).",
+          "type": "string"
+        },
         "resourceName": {
-          "description": "The resource name of the attachment data. This is used with the media API to download the attachment data.",
+          "description": "The resource name of the attachment data. This field is used with the media API to download the attachment data.",
           "type": "string"
         }
       },
@@ -730,17 +1156,17 @@
       "properties": {
         "imageButton": {
           "$ref": "ImageButton",
-          "description": "A button with image and onclick action."
+          "description": "A button with image and `onclick` action."
         },
         "textButton": {
           "$ref": "TextButton",
-          "description": "A button with text and onclick action."
+          "description": "A button with text and `onclick` action."
         }
       },
       "type": "object"
     },
     "Card": {
-      "description": "A card is a UI element that can contain UI widgets such as texts, images.",
+      "description": "A card is a UI element that can contain UI widgets such as text and images.",
       "id": "Card",
       "properties": {
         "cardActions": {
@@ -787,7 +1213,7 @@
       "id": "CardHeader",
       "properties": {
         "imageStyle": {
-          "description": "The image's type (e.g. square border or circular border).",
+          "description": "The image's type (for example, square border or circular border).",
           "enum": [
             "IMAGE_STYLE_UNSPECIFIED",
             "IMAGE",
@@ -809,7 +1235,7 @@
           "type": "string"
         },
         "title": {
-          "description": "The title must be specified. The header has a fixed height: if both a title and subtitle is specified, each will take up 1 line. If only the title is specified, it will take up both lines.",
+          "description": "The title must be specified. The header has a fixed height: if both a title and subtitle is specified, each takes up one line. If only the title is specified, it takes up both lines.",
           "type": "string"
         }
       },
@@ -850,7 +1276,7 @@
       "type": "object"
     },
     "Color": {
-      "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to/from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't carry information about the absolute color space that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most 1e-5. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha <= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red << 16) | (green << 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i < missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...",
+      "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value\u2014for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha <= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red << 16) | (green << 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i < missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...",
       "id": "Color",
       "properties": {
         "alpha": {
@@ -946,17 +1372,28 @@
         },
         "timeZone": {
           "$ref": "TimeZone",
-          "description": "The timezone ID and offset from Coordinated Universal Time (UTC)."
+          "description": "The timezone ID and offset from Coordinated Universal Time (UTC). Only supported for the event types [`CARD_CLICKED`](https://developers.google.com/chat/api/reference/rest/v1/EventType#ENUM_VALUES.CARD_CLICKED) and [`SUBMIT_DIALOG`](https://developers.google.com/chat/api/reference/rest/v1/DialogEventType#ENUM_VALUES.SUBMIT_DIALOG)."
         },
         "userLocale": {
-          "description": "The full `locale.displayName` in the format of [ISO 639 language code]-[ISO 3166 country/region code] such as \"en-US\". Not supported by Chat apps.",
+          "description": "The full `locale.displayName` in the format of [ISO 639 language code]-[ISO 3166 country/region code] such as \"en-US\".",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "CustomEmoji": {
+      "description": "Represents a custom emoji. [Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "CustomEmoji",
+      "properties": {
+        "uid": {
+          "description": "Unique key for the custom emoji resource.",
           "type": "string"
         }
       },
       "type": "object"
     },
     "DateInput": {
-      "description": "Date input values. Not supported by Chat apps.",
+      "description": "Date input values.",
       "id": "DateInput",
       "properties": {
         "msSinceEpoch": {
@@ -968,7 +1405,7 @@
       "type": "object"
     },
     "DateTimeInput": {
-      "description": "Date and time input values. Not supported by Chat apps.",
+      "description": "Date and time input values.",
       "id": "DateTimeInput",
       "properties": {
         "hasDate": {
@@ -987,6 +1424,35 @@
       },
       "type": "object"
     },
+    "DeletionMetadata": {
+      "description": "Information about a deleted message. A message is deleted when `delete_time` is set. [Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "DeletionMetadata",
+      "properties": {
+        "deletionType": {
+          "description": "Indicates who deleted the message.",
+          "enum": [
+            "DELETION_TYPE_UNSPECIFIED",
+            "CREATOR",
+            "SPACE_OWNER",
+            "ADMIN",
+            "APP_MESSAGE_EXPIRY",
+            "CREATOR_VIA_APP",
+            "SPACE_OWNER_VIA_APP"
+          ],
+          "enumDescriptions": [
+            "This value is unused.",
+            "User deleted their own message.",
+            "The space owner deleted the message.",
+            "A Google Workspace admin deleted the message.",
+            "A Chat app deleted its own message when it expired.",
+            "A Chat app deleted the message on behalf of the user.",
+            "A Chat app deleted the message on behalf of the space owner."
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "DeprecatedEvent": {
       "description": "Google Chat events.",
       "id": "DeprecatedEvent",
@@ -1075,7 +1541,7 @@
       "properties": {
         "body": {
           "$ref": "GoogleAppsCardV1Card",
-          "description": "Input only. Body of the dialog, which is rendered in a modal. Google Chat apps do not support the following card entities: `DateTimePicker`, `OnChangeAction`."
+          "description": "Input only. Body of the dialog, which is rendered in a modal. Google Chat apps don't support the following card entities: `DateTimePicker`, `OnChangeAction`."
         }
       },
       "type": "object"
@@ -1100,12 +1566,44 @@
       "id": "DriveDataRef",
       "properties": {
         "driveFileId": {
-          "description": "The id for the drive file, for use with the Drive API.",
+          "description": "The ID for the drive file. Use with the Drive API.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "Emoji": {
+      "description": "An emoji that is used as a reaction to a message. [Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "Emoji",
+      "properties": {
+        "customEmoji": {
+          "$ref": "CustomEmoji",
+          "description": "Output only. A custom emoji.",
+          "readOnly": true
+        },
+        "unicode": {
+          "description": "A basic emoji represented by a unicode string.",
           "type": "string"
         }
       },
       "type": "object"
     },
+    "EmojiReactionSummary": {
+      "description": "The number of people who reacted to a message with a specific emoji. [Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "EmojiReactionSummary",
+      "properties": {
+        "emoji": {
+          "$ref": "Emoji",
+          "description": "Emoji associated with the reactions."
+        },
+        "reactionCount": {
+          "description": "The total number of reactions using the associated emoji.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
     "Empty": {
       "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
       "id": "Empty",
@@ -1113,11 +1611,11 @@
       "type": "object"
     },
     "FormAction": {
-      "description": "A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form.",
+      "description": "A form action describes the behavior when the form is submitted. For example, you can invoke Apps Script to handle the form.",
       "id": "FormAction",
       "properties": {
         "actionMethodName": {
-          "description": "The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.",
+          "description": "The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. You can use the same method name for several elements that trigger a common behavior.",
           "type": "string"
         },
         "parameters": {
@@ -1131,7 +1629,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1Action": {
-      "description": "An action that describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. If the action is triggered, the form values are sent to the server.",
+      "description": "An action that describes the behavior when the form is submitted. For example, you can invoke an Apps Script script to handle the form. If the action is triggered, the form values are sent to the server.",
       "id": "GoogleAppsCardV1Action",
       "properties": {
         "function": {
@@ -1139,7 +1637,7 @@
           "type": "string"
         },
         "interaction": {
-          "description": "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.",
+          "description": "Optional. Required when opening a [dialog](https://developers.google.com/chat/how-tos/dialogs). What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an `action`\u2014like opening a link or running a function\u2014as normal. By specifying an `interaction`, the app can respond in special interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs). When specified, a loading indicator isn't shown. Supported by Chat apps, but not Google Workspace Add-ons. If specified for an add-on, the entire card is stripped and nothing is shown in the client.",
           "enum": [
             "INTERACTION_UNSPECIFIED",
             "OPEN_DIALOG"
@@ -1170,14 +1668,14 @@
           "type": "array"
         },
         "persistValues": {
-          "description": "Indicates whether form values persist after the action. The default value is `false`. If `true`, form values remain after the action is triggered. To let the user make changes while the action is being processed, set [LoadIndicator](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card messages](https://developers.google.com/chat/api/guides/message-formats/cards) in Chat apps, you must also set the action's [ResponseType](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same [`card_id`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#CardWithId) from the card that contained the action. If `false`, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set [LoadIndicator](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.",
+          "description": "Indicates whether form values persist after the action. The default value is `false`. If `true`, form values remain after the action is triggered. To let the user make changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card messages](https://developers.google.com/chat/api/guides/message-formats/cards) in Chat apps, you must also set the action's [`ResponseType`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same [`card_id`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#CardWithId) from the card that contained the action. If `false`, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.",
           "type": "boolean"
         }
       },
       "type": "object"
     },
     "GoogleAppsCardV1ActionParameter": {
-      "description": "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. To learn more, see [CommonEventObject](https://developers.google.com/chat/api/reference/rest/v1/Event#commoneventobject).",
+      "description": "List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, or snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters. To learn more, see [`CommonEventObject`](https://developers.google.com/chat/api/reference/rest/v1/Event#commoneventobject).",
       "id": "GoogleAppsCardV1ActionParameter",
       "properties": {
         "key": {
@@ -1222,16 +1720,16 @@
       "type": "object"
     },
     "GoogleAppsCardV1Button": {
-      "description": "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. Currently supported in Chat apps (including [dialogs] (https://developers.google.com/chat/how-tos/dialogs) and [card messages] (https://developers.google.com/chat/api/guides/message-formats/cards)) and Google Workspace Add-ons.",
+      "description": "A text, icon, or text and icon button that users can click. To make an image a clickable button, specify an `Image` (not an `ImageComponent`) and set an `onClick` action.",
       "id": "GoogleAppsCardV1Button",
       "properties": {
         "altText": {
-          "description": "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\".",
+          "description": "The alternative text that's used for accessibility. Set descriptive text that lets users know what the button does. For example, if a button opens a hyperlink, you might write: \"Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat\".",
           "type": "string"
         },
         "color": {
           "$ref": "Color",
-          "description": "If set, the button is filled with a solid background color and the font color changes to maintain contrast with the background color. For example, setting a blue background will likely result in white text. If unset, the image background is white and the font color is blue. For red, green and blue, the value of each field is a `float` number that can be expressed in either of two ways: as a number between 0 and 255 divided by 255 (153/255) or as a value between 0 and 1 (0.6). 0 represents the absence of a color and 1 or 255/255 represent the full presence of that color on the RGB scale. Optionally set alpha, which sets a level of transparency using this equation: ``` pixel color = alpha * (this color) + (1.0 - alpha) * (background color) ``` For alpha, a value of 1 corresponds with a solid color, and a value of 0 corresponds with a completely transparent color. For example, the following color represents a half transparent red: ``` \"color\": { \"red\": 1, \"green\": 0, \"blue\": 0, \"alpha\": 0.5 } ```"
+          "description": "If set, the button is filled with a solid background color and the font color changes to maintain contrast with the background color. For example, setting a blue background likely results in white text. If unset, the image background is white and the font color is blue. For red, green, and blue, the value of each field is a `float` number that you can express in either of two ways: as a number between 0 and 255 divided by 255 (153/255), or as a value between 0 and 1 (0.6). 0 represents the absence of a color and 1 or 255/255 represent the full presence of that color on the RGB scale. Optionally set `alpha`, which sets a level of transparency using this equation: ``` pixel color = alpha * (this color) + (1.0 - alpha) * (background color) ``` For `alpha`, a value of `1` corresponds with a solid color, and a value of `0` corresponds with a completely transparent color. For example, the following color represents a half transparent red: ``` \"color\": { \"red\": 1, \"green\": 0, \"blue\": 0, \"alpha\": 0.5 } ```"
         },
         "disabled": {
           "description": "If `true`, the button is displayed in an inactive state and doesn't respond to user actions.",
@@ -1243,7 +1741,7 @@
         },
         "onClick": {
           "$ref": "GoogleAppsCardV1OnClick",
-          "description": "Required. The action to perform when the button is clicked, such as opening a hyperlink or running a custom function."
+          "description": "Required. The action to perform when a user clicks the button, such as opening a hyperlink or running a custom function."
         },
         "text": {
           "description": "The text displayed inside the button.",
@@ -1267,11 +1765,11 @@
       "type": "object"
     },
     "GoogleAppsCardV1Card": {
-      "description": "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\", } ], } } }, ], } }, ], }, ], }, } ], } ```",
+      "description": "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, and 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 information. ![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\", } ], } } }, ], } }, ], }, ], }, } ], } ```",
       "id": "GoogleAppsCardV1Card",
       "properties": {
         "cardActions": {
-          "description": "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://example.com/feedback\" } } } ] ```",
+          "description": "The card's actions. Actions are added to the card's toolbar menu. Because Chat app cards have no toolbar, `cardActions[]` isn't supported by Chat apps. For example, the following JSON constructs a card action menu with `Settings` and `Send Feedback` options: ``` \"card_actions\": [ { \"actionLabel\": \"Settings\", \"onClick\": { \"action\": { \"functionName\": \"goToView\", \"parameters\": [ { \"key\": \"viewType\", \"value\": \"SETTING\" } ], \"loadIndicator\": \"LoadIndicator.SPINNER\" } } }, { \"actionLabel\": \"Send Feedback\", \"onClick\": { \"openLink\": { \"url\": \"https://example.com/feedback\" } } } ] ```",
           "items": {
             "$ref": "GoogleAppsCardV1CardAction"
           },
@@ -1285,7 +1783,7 @@
             "REPLACE"
           ],
           "enumDescriptions": [
-            "Do not use.",
+            "Don't use.",
             "The header of the card appears at the bottom of the sidebar, partially covering the current top card of the stack. Clicking the header pops the card into the card stack. If the card has no header, a generated header is used instead.",
             "Default value. The card is shown by replacing the view of the top card in the card stack."
           ],
@@ -1293,7 +1791,7 @@
         },
         "fixedFooter": {
           "$ref": "GoogleAppsCardV1CardFixedFooter",
-          "description": "The fixed footer shown at the bottom of this 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)."
+          "description": "The fixed footer shown at the bottom of this card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. Supported by Google Workspace Add-ons and Chat apps. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/message-formats/cards)."
         },
         "header": {
           "$ref": "GoogleAppsCardV1CardHeader",
@@ -1333,7 +1831,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1CardFixedFooter": {
-      "description": "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).",
+      "description": "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. Supported by Google Workspace Add-ons and Chat apps. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/message-formats/cards).",
       "id": "GoogleAppsCardV1CardFixedFooter",
       "properties": {
         "primaryButton": {
@@ -1342,7 +1840,14 @@
         },
         "secondaryButton": {
           "$ref": "GoogleAppsCardV1Button",
-          "description": "The secondary button of the fixed footer. The button must be a text button with text and color set. `primaryButton` must be set if `secondaryButton` is set."
+          "description": "The secondary button of the fixed footer. The button must be a text button with text and color set. If `secondaryButton` is set, you must also set `primaryButton`."
+        },
+        "widgets": {
+          "description": "A list of widgets included in the card footer. Primary button and secondary button are rendered below these widgets.",
+          "items": {
+            "$ref": "GoogleAppsCardV1FooterWidget"
+          },
+          "type": "array"
         }
       },
       "type": "object"
@@ -1352,7 +1857,7 @@
       "id": "GoogleAppsCardV1CardHeader",
       "properties": {
         "imageAltText": {
-          "description": "The alternative text of this image which is used for accessibility.",
+          "description": "The alternative text of this image that's used for accessibility.",
           "type": "string"
         },
         "imageType": {
@@ -1382,43 +1887,117 @@
       },
       "type": "object"
     },
+    "GoogleAppsCardV1Column": {
+      "description": "A column.",
+      "id": "GoogleAppsCardV1Column",
+      "properties": {
+        "horizontalAlignment": {
+          "description": "Specifies whether widgets align to the left, right, or center of a column.",
+          "enum": [
+            "HORIZONTAL_ALIGNMENT_UNSPECIFIED",
+            "START",
+            "CENTER",
+            "END"
+          ],
+          "enumDescriptions": [
+            "Unspecified. Do not use.",
+            "Default value. Aligns widgets to the start position of the column. For left-to-right layouts, aligns to the left. For right-to-left layouts, aligns to the right.",
+            "Aligns widgets to the center of the column.",
+            "Aligns widgets to the end position of the column. For left-to-right layouts, aligns widgets to the right. For right-to-left layouts, aligns widgets to the left."
+          ],
+          "type": "string"
+        },
+        "horizontalSizeStyle": {
+          "description": "Specifies how a column fills the width of the card.",
+          "enum": [
+            "HORIZONTAL_SIZE_STYLE_UNSPECIFIED",
+            "FILL_AVAILABLE_SPACE",
+            "FILL_MINIMUM_SPACE"
+          ],
+          "enumDescriptions": [
+            "Unspecified. Do not use.",
+            "Default value. Column fills the available space, up to 70% of the card's width. If both columns are set to `FILL_AVAILABLE_SPACE`, each column fills 50% of the space.",
+            "Column fills the least amount of space possible and no more than 30% of the card's width."
+          ],
+          "type": "string"
+        },
+        "verticalAlignment": {
+          "description": "Specifies whether widgets align to the top, bottom, or center of a column.",
+          "enum": [
+            "VERTICAL_ALIGNMENT_UNSPECIFIED",
+            "CENTER",
+            "TOP",
+            "BOTTOM"
+          ],
+          "enumDescriptions": [
+            "Unspecified. Don't use.",
+            "Default value. Aligns widgets to the center of a column.",
+            "Aligns widgets to the top of a column.",
+            "Aligns widgets to the bottom of a column."
+          ],
+          "type": "string"
+        },
+        "widgets": {
+          "description": "An array of widgets included in a column. Widgets appear in the order that they are specified.",
+          "items": {
+            "$ref": "GoogleAppsCardV1Widgets"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleAppsCardV1Columns": {
+      "description": "The `Columns` widget displays up to 2 columns in a card message or dialog. You can add widgets to each column; the widgets appear in the order that they are specified. The height of each column is determined by the taller column. For example, if the first column is taller than the second column, both columns have the height of the first column. Because each column can contain a different number of widgets, you can't define rows or align widgets between the columns. Columns are displayed side-by-side. You can customize the width of each column using the `HorizontalSizeStyle` field. If the user's screen width is too narrow, the second column wraps below the first: * On web, the second column wraps if the screen width is less than or equal to 480 pixels. * On iOS devices, the second column wraps if the screen width is less than or equal to 300 pt. * On Android devices, the second column wraps if the screen width is less than or equal to 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget. Supported by Chat apps, but not Google Workspace Add-ons.",
+      "id": "GoogleAppsCardV1Columns",
+      "properties": {
+        "columnItems": {
+          "description": "An array of columns. You can include up to 2 columns in a card or dialog.",
+          "items": {
+            "$ref": "GoogleAppsCardV1Column"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "GoogleAppsCardV1DateTimePicker": {
-      "description": "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.",
+      "description": "Lets users input a date, a time, or both a date and a time. Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly.",
       "id": "GoogleAppsCardV1DateTimePicker",
       "properties": {
         "label": {
-          "description": "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.",
+          "description": "The text that prompts users to input a date, a time, or a date and time. For example, if users are scheduling an appointment, use a label such as `Appointment date` or `Appointment date and time`.",
           "type": "string"
         },
         "name": {
-          "description": "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).",
+          "description": "The name by which the `DateTimePicker` is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs).",
           "type": "string"
         },
         "onChangeAction": {
           "$ref": "GoogleAppsCardV1Action",
-          "description": "Triggered when the user clicks **Save** or **Clear** from the datetime picker interface."
+          "description": "Triggered when the user clicks **Save** or **Clear** from the `DateTimePicker` interface."
         },
         "timezoneOffsetDate": {
-          "description": "The number representing the time zone offset from UTC, in minutes. If set, the `value_ms_epoch` is displayed in the specified time zone. If not set, it uses the user's time zone setting on the client side.",
+          "description": "The number representing the time zone offset from UTC, in minutes. If set, the `value_ms_epoch` is displayed in the specified time zone. If unset, the value defaults to the user's time zone setting.",
           "format": "int32",
           "type": "integer"
         },
         "type": {
-          "description": "What kind of date and time input the datetime picker supports.",
+          "description": "Whether the widget supports inputting a date, a time, or the date and time.",
           "enum": [
             "DATE_AND_TIME",
             "DATE_ONLY",
             "TIME_ONLY"
           ],
           "enumDescriptions": [
-            "The user can select a date and time.",
-            "The user can only select a date.",
-            "The user can only select a time."
+            "Users input a date and time.",
+            "Users input a date.",
+            "Users input a time."
           ],
           "type": "string"
         },
         "valueMsEpoch": {
-          "description": "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`.",
+          "description": "The default value displayed in the widget, in milliseconds since [Unix epoch time](https://en.wikipedia.org/wiki/Unix_time). Specify the value based on the type of picker (`DateTimePickerType`): * `DATE_AND_TIME`: a calendar date and time in UTC. For example, to represent January 1, 2023 at 12:00 PM UTC, use `1672574400000`. * `DATE_ONLY`: a calendar date at 00:00:00 UTC. For example, to represent January 1, 2023, use `1672531200000`. * `TIME_ONLY`: a time in UTC. For example, to represent 12:00 PM, use `43200000` (or `12 * 60 * 60 * 1000`).",
           "format": "int64",
           "type": "string"
         }
@@ -1426,7 +2005,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1DecoratedText": {
-      "description": "A widget that displays text with optional decorations such as a label above or below the text, an icon in front of the text, a selection widget or a button after the text.",
+      "description": "A widget that displays text with optional decorations such as a label above or below the text, an icon in front of the text, a selection widget, or a button after the text.",
       "id": "GoogleAppsCardV1DecoratedText",
       "properties": {
         "bottomLabel": {
@@ -1435,7 +2014,7 @@
         },
         "button": {
           "$ref": "GoogleAppsCardV1Button",
-          "description": "A button that can be clicked to trigger an action."
+          "description": "A button that a user can click to trigger an action."
         },
         "endIcon": {
           "$ref": "GoogleAppsCardV1Icon",
@@ -1447,7 +2026,7 @@
         },
         "onClick": {
           "$ref": "GoogleAppsCardV1OnClick",
-          "description": "When users click on `topLabel` or `bottomLabel`, this action triggers."
+          "description": "This action is triggered when users click `topLabel` or `bottomLabel`."
         },
         "startIcon": {
           "$ref": "GoogleAppsCardV1Icon",
@@ -1455,10 +2034,10 @@
         },
         "switchControl": {
           "$ref": "GoogleAppsCardV1SwitchControl",
-          "description": "A switch widget can be clicked to change its state and trigger an action."
+          "description": "A switch widget that a user can click to change its state and trigger an action."
         },
         "text": {
-          "description": "Required. The primary text. Supports simple formatting. See Text formatting for formatting details.",
+          "description": "Required. The primary text. Supports simple formatting. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
           "type": "string"
         },
         "topLabel": {
@@ -1473,13 +2052,40 @@
       "type": "object"
     },
     "GoogleAppsCardV1Divider": {
-      "description": "Displays a divider between widgets, a horizontal line. For example, the following JSON creates a divider: ``` \"divider\": {} ```",
+      "description": "Displays a divider between widgets as a horizontal line. For example, the following JSON creates a divider: ``` \"divider\": {} ```",
       "id": "GoogleAppsCardV1Divider",
       "properties": {},
       "type": "object"
     },
+    "GoogleAppsCardV1FooterWidget": {
+      "description": "The CardFixedFooter can contain a list of these widgets.",
+      "id": "GoogleAppsCardV1FooterWidget",
+      "properties": {
+        "buttonList": {
+          "$ref": "GoogleAppsCardV1ButtonList",
+          "description": "ButtonList widget."
+        },
+        "dateTimePicker": {
+          "$ref": "GoogleAppsCardV1DateTimePicker",
+          "description": "DateTimePicker widget."
+        },
+        "decoratedText": {
+          "$ref": "GoogleAppsCardV1DecoratedText",
+          "description": "DecoratedText widget."
+        },
+        "textInput": {
+          "$ref": "GoogleAppsCardV1TextInput",
+          "description": "TextInput widget."
+        },
+        "textParagraph": {
+          "$ref": "GoogleAppsCardV1TextParagraph",
+          "description": "TextParagraph widget."
+        }
+      },
+      "type": "object"
+    },
     "GoogleAppsCardV1Grid": {
-      "description": "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. For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```",
+      "description": "Displays a grid with a collection of items. Items can only include text or images. A grid supports any number of columns and items. The number of rows is determined by items divided by columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. For responsive columns, or to include more than text or images, use `Columns`. For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```",
       "id": "GoogleAppsCardV1Grid",
       "properties": {
         "borderStyle": {
@@ -1510,11 +2116,11 @@
       "type": "object"
     },
     "GoogleAppsCardV1GridItem": {
-      "description": "Represents a single item in the grid layout.",
+      "description": "Represents an item in a grid layout. Items can contain text, an image, or both text and an image.",
       "id": "GoogleAppsCardV1GridItem",
       "properties": {
         "id": {
-          "description": "A user-specified identifier for this grid item. This identifier is returned in the parent Grid's onClick callback parameters.",
+          "description": "A user-specified identifier for this grid item. This identifier is returned in the parent grid's `onClick` callback parameters.",
           "type": "string"
         },
         "image": {
@@ -1551,7 +2157,7 @@
       "id": "GoogleAppsCardV1Icon",
       "properties": {
         "altText": {
-          "description": "Optional. A description of the icon used for accessibility. If unspecified, the default value \"Button\" is provided. As a best practice, you should set a helpful description for what the icon displays, and if applicable, what it does. For example, `A user's account portrait`, or `Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat`. If the icon is set in a Button, the `altText` appears as helper text when the user hovers over the button. However, if the button also sets `text`, the icon's `altText` is ignored.",
+          "description": "Optional. A description of the icon used for accessibility. If unspecified, the default value `Button` is provided. As a best practice, you should set a helpful description for what the icon displays, and if applicable, what it does. For example, `A user's account portrait`, or `Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat`. If the icon is set in a `Button`, the `altText` appears as helper text when the user hovers over the button. However, if the button also sets `text`, the icon's `altText` is ignored.",
           "type": "string"
         },
         "iconUrl": {
@@ -1582,16 +2188,16 @@
       "id": "GoogleAppsCardV1Image",
       "properties": {
         "altText": {
-          "description": "The alternative text of this image, used for accessibility.",
+          "description": "The alternative text of this image that's used for accessibility.",
           "type": "string"
         },
         "imageUrl": {
-          "description": "The `https` URL that hosts the image. For example: ``` https://developers.google.com/chat/images/quickstart-app-avatar.png ```",
+          "description": "The HTTPS URL that hosts the image. For example: ``` https://developers.google.com/chat/images/quickstart-app-avatar.png ```",
           "type": "string"
         },
         "onClick": {
           "$ref": "GoogleAppsCardV1OnClick",
-          "description": "When a user clicks on the image, the click triggers this action."
+          "description": "When a user clicks the image, the click triggers this action."
         }
       },
       "type": "object"
@@ -1620,11 +2226,11 @@
       "type": "object"
     },
     "GoogleAppsCardV1ImageCropStyle": {
-      "description": "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 } ```",
+      "description": "Represents the crop style applied to an image. For example, here's how to apply a 16:9 aspect ratio: ``` cropStyle { \"type\": \"RECTANGLE_CUSTOM\", \"aspectRatio\": 16/9 } ```",
       "id": "GoogleAppsCardV1ImageCropStyle",
       "properties": {
         "aspectRatio": {
-          "description": "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 } ```",
+          "description": "The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. For example, here's how to apply a 16:9 aspect ratio: ``` cropStyle { \"type\": \"RECTANGLE_CUSTOM\", \"aspectRatio\": 16/9 } ```",
           "format": "double",
           "type": "number"
         },
@@ -1638,7 +2244,7 @@
             "RECTANGLE_4_3"
           ],
           "enumDescriptions": [
-            "No value specified. Do not use.",
+            "No value specified. Don't use.",
             "Default value. Applies a square crop.",
             "Applies a circular crop.",
             "Applies a rectangular crop with a custom aspect ratio. Set the custom aspect ratio with `aspectRatio`.",
@@ -1683,8 +2289,8 @@
             "RELOAD"
           ],
           "enumDescriptions": [
-            "Default value. The card does not reload; nothing happens.",
-            "Reloads the card after the child window closes. If used in conjunction with [OpenAs.OVERLAY](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#openas), the child window acts as a modal dialog and the parent card is blocked until the child window closes."
+            "Default value. The card doesn't reload; nothing happens.",
+            "Reloads the card after the child window closes. If used in conjunction with [`OpenAs.OVERLAY`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#openas), the child window acts as a modal dialog and the parent card is blocked until the child window closes."
           ],
           "type": "string"
         },
@@ -1695,7 +2301,7 @@
             "OVERLAY"
           ],
           "enumDescriptions": [
-            "The link opens as a full size window (if that's the frame used by the client.",
+            "The link opens as a full-size window (if that's the frame used by the client).",
             "The link opens as an overlay, such as a pop-up."
           ],
           "type": "string"
@@ -1708,7 +2314,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1Section": {
-      "description": "A section contains a collection of widgets that are rendered vertically in the order that they are specified.",
+      "description": "A section contains a collection of widgets that are rendered vertically in the order that they're specified.",
       "id": "GoogleAppsCardV1Section",
       "properties": {
         "collapsible": {
@@ -1716,7 +2322,7 @@
           "type": "boolean"
         },
         "header": {
-          "description": "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).",
+          "description": "Text that appears at the top of a section. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
           "type": "string"
         },
         "uncollapsibleWidgetsCount": {
@@ -1725,7 +2331,7 @@
           "type": "integer"
         },
         "widgets": {
-          "description": "All the widgets in the section. Must contain at least 1 widget.",
+          "description": "All the widgets in the section. Must contain at least one widget.",
           "items": {
             "$ref": "GoogleAppsCardV1Widget"
           },
@@ -1735,11 +2341,11 @@
       "type": "object"
     },
     "GoogleAppsCardV1SelectionInput": {
-      "description": "A widget that creates a UI item with options for users to select. For example, 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.",
+      "description": "A widget that creates one or more UI items that users can select. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs). To collect undefined or abstract data from users, use the TextInput widget.",
       "id": "GoogleAppsCardV1SelectionInput",
       "properties": {
         "items": {
-          "description": "An array of the selected items. For example, all the selected check boxes.",
+          "description": "An array of selectable items. For example, an array of radio buttons or checkboxes. Supports up to 100 items.",
           "items": {
             "$ref": "GoogleAppsCardV1SelectionItem"
           },
@@ -1750,7 +2356,7 @@
           "type": "string"
         },
         "name": {
-          "description": "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).",
+          "description": "The name that identifies the selection input in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs).",
           "type": "string"
         },
         "onChangeAction": {
@@ -1758,7 +2364,7 @@
           "description": "If specified, the form is submitted when the selection changes. If not specified, you must specify a separate button that submits the form. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs)."
         },
         "type": {
-          "description": "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.",
+          "description": "The type of items that are displayed to users in a `SelectionInput` widget. Selection types support different types of interactions. For example, users can select one or more checkboxes, but they can only select one value from a dropdown menu.",
           "enum": [
             "CHECK_BOX",
             "RADIO_BUTTON",
@@ -1766,10 +2372,10 @@
             "DROPDOWN"
           ],
           "enumDescriptions": [
-            "A set of checkboxes. Users can select multiple check boxes per selection input.",
-            "A set of radio buttons. Users can select one radio button per selection input.",
-            "A set of switches. Users can turn on multiple switches at once per selection input.",
-            "A dropdown menu. Users can select one dropdown menu item per selection input."
+            "A set of checkboxes. Users can select one or more checkboxes.",
+            "A set of radio buttons. Users can select one radio button.",
+            "A set of switches. Users can turn on one or more switches.",
+            "A dropdown menu. Users can select one item from the menu."
           ],
           "type": "string"
         }
@@ -1777,7 +2383,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1SelectionItem": {
-      "description": "A selectable item in a selection input, such as a check box or a switch.",
+      "description": "An item that users can select in a selection input, such as a checkbox or switch.",
       "id": "GoogleAppsCardV1SelectionItem",
       "properties": {
         "selected": {
@@ -1785,7 +2391,7 @@
           "type": "boolean"
         },
         "text": {
-          "description": "The text displayed to users.",
+          "description": "The text that identifies or describes the item to users.",
           "type": "string"
         },
         "value": {
@@ -1800,14 +2406,14 @@
       "id": "GoogleAppsCardV1SuggestionItem",
       "properties": {
         "text": {
-          "description": "The value of a suggested input to a text input field. This is equivalent to what users would enter themselves.",
+          "description": "The value of a suggested input to a text input field. This is equivalent to what users enter themselves.",
           "type": "string"
         }
       },
       "type": "object"
     },
     "GoogleAppsCardV1Suggestions": {
-      "description": "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`.",
+      "description": "Suggested values that users can enter. These values appear when users click inside the text input field. As users type, the suggested values dynamically filter to match what the users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing `Jav`, the list of suggestions filters to show `Java` and `JavaScript`. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter `javascript` and others `java script`. Suggesting `JavaScript` can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`.",
       "id": "GoogleAppsCardV1Suggestions",
       "properties": {
         "items": {
@@ -1821,7 +2427,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1SwitchControl": {
-      "description": "Either a toggle-style switch or a checkbox inside a `decoratedText` widget. Only supported on the `decoratedText` widget.",
+      "description": "Either a toggle-style switch or a checkbox inside a `decoratedText` widget. Only supported in the `decoratedText` widget.",
       "id": "GoogleAppsCardV1SwitchControl",
       "properties": {
         "controlType": {
@@ -1858,7 +2464,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1TextInput": {
-      "description": "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.",
+      "description": "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 undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget.",
       "id": "GoogleAppsCardV1TextInput",
       "properties": {
         "autoCompleteAction": {
@@ -1871,10 +2477,10 @@
         },
         "initialSuggestions": {
           "$ref": "GoogleAppsCardV1Suggestions",
-          "description": "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`."
+          "description": "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's set to `MULTIPLE_LINE`."
         },
         "label": {
-          "description": "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.",
+          "description": "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.",
           "type": "string"
         },
         "name": {
@@ -1883,7 +2489,7 @@
         },
         "onChangeAction": {
           "$ref": "GoogleAppsCardV1Action",
-          "description": "What to do when a change occurs in the text input field. Examples of changes include a user adding to the field, or deleting text. Examples of actions to take include running a custom function or opening a [dialog](https://developers.google.com/chat/how-tos/dialogs) in Google Chat."
+          "description": "What to do when a change occurs in the text input field. For example, a user adding to the field or deleting text. Examples of actions to take include running a custom function or opening a [dialog](https://developers.google.com/chat/how-tos/dialogs) in Google Chat."
         },
         "type": {
           "description": "How a text input field appears in the user interface. For example, whether the field is single or multi-line.",
@@ -1905,7 +2511,7 @@
       "type": "object"
     },
     "GoogleAppsCardV1TextParagraph": {
-      "description": "A paragraph of text that supports formatting. See [Text formatting](https://developers.google.com/workspace/add-ons/concepts/widgets#text_formatting) for details.",
+      "description": "A paragraph of text that supports formatting. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
       "id": "GoogleAppsCardV1TextParagraph",
       "properties": {
         "text": {
@@ -1923,9 +2529,13 @@
           "$ref": "GoogleAppsCardV1ButtonList",
           "description": "A list of buttons. For example, the following JSON creates two buttons. The first is a blue text button and the second is an image button that opens a link: ``` \"buttonList\": { \"buttons\": [ { \"text\": \"Edit\", \"color\": { \"red\": 0, \"green\": 0, \"blue\": 1, \"alpha\": 1 }, \"disabled\": true, }, { \"icon\": { \"knownIcon\": \"INVITE\", \"altText\": \"check calendar\" }, \"onClick\": { \"openLink\": { \"url\": \"https://example.com/calendar\" } } } ] } ```"
         },
+        "columns": {
+          "$ref": "GoogleAppsCardV1Columns",
+          "description": "Displays up to 2 columns. To include more than 2 columns, or to use rows, use the `Grid` widget. For example, the following JSON creates 2 columns that each contain text paragraphs: ``` \"columns\": { \"columnItems\": [ { \"horizontalSizeStyle\": \"FILL_AVAILABLE_SPACE\", \"horizontalAlignment\": \"CENTER\", \"verticalAlignment\": \"CENTER\", \"widgets\": [ { \"textParagraph\": { \"text\": \"First column text paragraph\" } } ] }, { \"horizontalSizeStyle\": \"FILL_AVAILABLE_SPACE\", \"horizontalAlignment\": \"CENTER\", \"verticalAlignment\": \"CENTER\", \"widgets\": [ { \"textParagraph\": { \"text\": \"Second column text paragraph\" } } ] } ] } ```"
+        },
         "dateTimePicker": {
           "$ref": "GoogleAppsCardV1DateTimePicker",
-          "description": "Displays a selection/input widget for date, time, or date and time. Not supported by Chat apps. Support by Chat apps is coming soon. For example, the following JSON creates a datetime picker to schedule an appointment: ``` \"dateTimePicker\": { \"name\": \"appointment_time\", \"label\": \"Book your appointment at:\", \"type\": \"DATE_AND_TIME\", \"valueMsEpoch\": \"796435200000\" } ```"
+          "description": "Displays a widget that lets users input a date, time, or date and time. For example, the following JSON creates a date time picker to schedule an appointment: ``` \"dateTimePicker\": { \"name\": \"appointment_time\", \"label\": \"Book your appointment at:\", \"type\": \"DATE_AND_TIME\", \"valueMsEpoch\": \"796435200000\" } ```"
         },
         "decoratedText": {
           "$ref": "GoogleAppsCardV1DecoratedText",
@@ -1939,13 +2549,29 @@
           "$ref": "GoogleAppsCardV1Grid",
           "description": "Displays a grid with a collection of items. A grid supports any number of columns and items. The number of rows is determined by the upper bounds of the number items divided by the number of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```"
         },
+        "horizontalAlignment": {
+          "description": "Specifies whether widgets align to the left, right, or center of a column.",
+          "enum": [
+            "HORIZONTAL_ALIGNMENT_UNSPECIFIED",
+            "START",
+            "CENTER",
+            "END"
+          ],
+          "enumDescriptions": [
+            "Unspecified. Do not use.",
+            "Default value. Aligns widgets to the start position of the column. For left-to-right layouts, aligns to the left. For right-to-left layouts, aligns to the right.",
+            "Aligns widgets to the center of the column.",
+            "Aligns widgets to the end position of the column. For left-to-right layouts, aligns widgets to the right. For right-to-left layouts, aligns widgets to the left."
+          ],
+          "type": "string"
+        },
         "image": {
           "$ref": "GoogleAppsCardV1Image",
           "description": "Displays an image. For example, the following JSON creates an image with alternative text: ``` \"image\": { \"imageUrl\": \"https://developers.google.com/chat/images/quickstart-app-avatar.png\", \"altText\": \"Chat app avatar\" } ```"
         },
         "selectionInput": {
           "$ref": "GoogleAppsCardV1SelectionInput",
-          "description": "Displays a selection control that lets users select items. Selection controls can be check boxes, radio buttons, switches, or dropdown menus. For example, the following JSON creates a dropdown menu that lets users choose a size: ``` \"selectionInput\": { \"name\": \"size\", \"label\": \"Size\" \"type\": \"DROPDOWN\", \"items\": [ { \"text\": \"S\", \"value\": \"small\", \"selected\": false }, { \"text\": \"M\", \"value\": \"medium\", \"selected\": true }, { \"text\": \"L\", \"value\": \"large\", \"selected\": false }, { \"text\": \"XL\", \"value\": \"extra_large\", \"selected\": false } ] } ```"
+          "description": "Displays a selection control that lets users select items. Selection controls can be checkboxes, radio buttons, switches, or dropdown menus. For example, the following JSON creates a dropdown menu that lets users choose a size: ``` \"selectionInput\": { \"name\": \"size\", \"label\": \"Size\" \"type\": \"DROPDOWN\", \"items\": [ { \"text\": \"S\", \"value\": \"small\", \"selected\": false }, { \"text\": \"M\", \"value\": \"medium\", \"selected\": true }, { \"text\": \"L\", \"value\": \"large\", \"selected\": false }, { \"text\": \"XL\", \"value\": \"extra_large\", \"selected\": false } ] } ```"
         },
         "textInput": {
           "$ref": "GoogleAppsCardV1TextInput",
@@ -1953,17 +2579,52 @@
         },
         "textParagraph": {
           "$ref": "GoogleAppsCardV1TextParagraph",
-          "description": "Displays a text paragraph. Supports [simple HTML formatted text](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). For example, the following JSON creates a bolded text: ``` \"textParagraph\": { \"text\": \" *bold text*\" } ```"
+          "description": "Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). For example, the following JSON creates a bolded text: ``` \"textParagraph\": { \"text\": \" *bold text*\" } ```"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleAppsCardV1Widgets": {
+      "description": "The supported widgets that you can include in a column.",
+      "id": "GoogleAppsCardV1Widgets",
+      "properties": {
+        "buttonList": {
+          "$ref": "GoogleAppsCardV1ButtonList",
+          "description": "ButtonList widget."
+        },
+        "dateTimePicker": {
+          "$ref": "GoogleAppsCardV1DateTimePicker",
+          "description": "DateTimePicker widget."
+        },
+        "decoratedText": {
+          "$ref": "GoogleAppsCardV1DecoratedText",
+          "description": "DecoratedText widget."
+        },
+        "image": {
+          "$ref": "GoogleAppsCardV1Image",
+          "description": "Image widget."
+        },
+        "selectionInput": {
+          "$ref": "GoogleAppsCardV1SelectionInput",
+          "description": "SelectionInput widget."
+        },
+        "textInput": {
+          "$ref": "GoogleAppsCardV1TextInput",
+          "description": "TextInput widget."
+        },
+        "textParagraph": {
+          "$ref": "GoogleAppsCardV1TextParagraph",
+          "description": "TextParagraph widget."
         }
       },
       "type": "object"
     },
     "Image": {
-      "description": "An image that is specified by a URL and can have an onclick action.",
+      "description": "An image that's specified by a URL and can have an `onclick` action.",
       "id": "Image",
       "properties": {
         "aspectRatio": {
-          "description": "The aspect ratio of this image (width/height). This field allows clients to reserve the right height for the image while waiting for it to load. It's not meant to override the native aspect ratio of the image. If unset, the server fills it by prefetching the image.",
+          "description": "The aspect ratio of this image (width and height). This field lets you reserve the right height for the image while waiting for it to load. It's not meant to override the built-in aspect ratio of the image. If unset, the server fills it by prefetching the image.",
           "format": "double",
           "type": "number"
         },
@@ -1973,17 +2634,17 @@
         },
         "onClick": {
           "$ref": "OnClick",
-          "description": "The onclick action."
+          "description": "The `onclick` action."
         }
       },
       "type": "object"
     },
     "ImageButton": {
-      "description": "An image button with an onclick action.",
+      "description": "An image button with an `onclick` action.",
       "id": "ImageButton",
       "properties": {
         "icon": {
-          "description": "The icon specified by an enum that indices to an icon provided by Chat API.",
+          "description": "The icon specified by an `enum` that indices to an icon provided by Chat API.",
           "enum": [
             "ICON_UNSPECIFIED",
             "AIRPLANE",
@@ -2057,12 +2718,12 @@
           "type": "string"
         },
         "name": {
-          "description": "The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.",
+          "description": "The name of this `image_button` that's used for accessibility. Default value is provided if this name isn't specified.",
           "type": "string"
         },
         "onClick": {
           "$ref": "OnClick",
-          "description": "The onclick action."
+          "description": "The `onclick` action."
         }
       },
       "type": "object"
@@ -2073,11 +2734,11 @@
       "properties": {
         "dateInput": {
           "$ref": "DateInput",
-          "description": "Date input values. Not supported by Chat apps."
+          "description": "Date input values."
         },
         "dateTimeInput": {
           "$ref": "DateTimeInput",
-          "description": "Date and time input values. Not supported by Chat apps."
+          "description": "Date and time input values."
         },
         "stringInputs": {
           "$ref": "StringInputs",
@@ -2085,17 +2746,17 @@
         },
         "timeInput": {
           "$ref": "TimeInput",
-          "description": "Time input values. Not supported by Chat apps."
+          "description": "Time input values."
         }
       },
       "type": "object"
     },
     "KeyValue": {
-      "description": "A UI element contains a key (label) and a value (content). And this element may also contain some actions such as onclick button.",
+      "description": "A UI element contains a key (label) and a value (content). This element can also contain some actions such as `onclick` button.",
       "id": "KeyValue",
       "properties": {
         "bottomLabel": {
-          "description": "The text of the bottom label. Formatted text supported.",
+          "description": "The text of the bottom label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
           "type": "string"
         },
         "button": {
@@ -2103,7 +2764,7 @@
           "description": "A button that can be clicked to trigger an action."
         },
         "content": {
-          "description": "The text of the content. Formatted text supported and always required.",
+          "description": "The text of the content. Formatted text supported and always required. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
           "type": "string"
         },
         "contentMultiline": {
@@ -2111,7 +2772,7 @@
           "type": "boolean"
         },
         "icon": {
-          "description": "An enum value that will be replaced by the Chat API with the corresponding icon image.",
+          "description": "An enum value that's replaced by the Chat API with the corresponding icon image.",
           "enum": [
             "ICON_UNSPECIFIED",
             "AIRPLANE",
@@ -2186,10 +2847,10 @@
         },
         "onClick": {
           "$ref": "OnClick",
-          "description": "The onclick action. Only the top label, bottom label and content region are clickable."
+          "description": "The `onclick` action. Only the top label, bottom label, and content region are clickable."
         },
         "topLabel": {
-          "description": "The text of the top label. Formatted text supported.",
+          "description": "The text of the top label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
           "type": "string"
         }
       },
@@ -2206,17 +2867,51 @@
           "type": "array"
         },
         "nextPageToken": {
-          "description": "A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.",
+          "description": "A token that you can send as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.",
           "type": "string"
         }
       },
       "type": "object"
     },
+    "ListMessagesResponse": {
+      "id": "ListMessagesResponse",
+      "properties": {
+        "messages": {
+          "description": "List of messages.",
+          "items": {
+            "$ref": "Message"
+          },
+          "type": "array"
+        },
+        "nextPageToken": {
+          "description": "You can send a token as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "ListReactionsResponse": {
+      "id": "ListReactionsResponse",
+      "properties": {
+        "nextPageToken": {
+          "description": "Continuation token to retrieve the next page of results. It's empty for the last page of results.",
+          "type": "string"
+        },
+        "reactions": {
+          "description": "List of reactions in the requested (or first) page.",
+          "items": {
+            "$ref": "Reaction"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "ListSpacesResponse": {
       "id": "ListSpacesResponse",
       "properties": {
         "nextPageToken": {
-          "description": "A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.",
+          "description": "You can send a token as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.",
           "type": "string"
         },
         "spaces": {
@@ -2230,11 +2925,11 @@
       "type": "object"
     },
     "MatchedUrl": {
-      "description": "A matched url in a Chat message. Chat apps can preview matched URLs. For more information, refer to [Preview links](https://developers.google.com/chat/how-tos/preview-links).",
+      "description": "A matched URL in a Chat message. Chat apps can preview matched URLs. For more information, see [Preview links](https://developers.google.com/chat/how-tos/preview-links).",
       "id": "MatchedUrl",
       "properties": {
         "url": {
-          "description": "Output only. The url that was matched.",
+          "description": "Output only. The URL that was matched.",
           "readOnly": true,
           "type": "string"
         }
@@ -2264,10 +2959,10 @@
         },
         "member": {
           "$ref": "User",
-          "description": "The Google Chat user or app the membership corresponds to."
+          "description": "The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output populates the [user](https://developers.google.com/chat/api/reference/rest/v1/User) `name` and `type`."
         },
         "name": {
-          "description": "Resource name of the membership, assigned by the server. Format: spaces/{space}/members/{member}",
+          "description": "Resource name of the membership, assigned by the server. Format: `spaces/{space}/members/{member}`",
           "type": "string"
         },
         "role": {
@@ -2280,7 +2975,7 @@
           "enumDescriptions": [
             "Default value. The user isn't a member of the space, but might be invited.",
             "A member of the space. The user has basic permissions, like sending messages to the space. In 1:1 and unnamed group conversations, everyone has this role.",
-            "A space manager. The user has all basic permissions plus administrative permissions that allow them to manage the space, like adding or removing members. Only supported in SpaceType.SPACE."
+            "A space manager. The user has all basic permissions plus administrative permissions that let them manage the space, like adding or removing members. Only supported in SpaceType.SPACE."
           ],
           "readOnly": true,
           "type": "string"
@@ -2294,10 +2989,10 @@
             "NOT_A_MEMBER"
           ],
           "enumDescriptions": [
-            "Default, do not use.",
+            "Default, don't use.",
             "The user has joined the space.",
-            "The user has been invited, is able to join the space, but currently has not joined.",
-            "The user is not a member of the space, has not been invited and is not able to join the space."
+            "The user has been invited, is able to join the space, but currently hasn't joined.",
+            "The user isn't a member of the space, hasn't been invited and isn't able to join the space."
           ],
           "readOnly": true,
           "type": "string"
@@ -2314,7 +3009,7 @@
           "description": "Input only. Parameters that a Chat app can use to configure how its response is posted."
         },
         "annotations": {
-          "description": "Output only. Annotations associated with the text in this message.",
+          "description": "Output only. Annotations associated with the `text` in this message.",
           "items": {
             "$ref": "Annotation"
           },
@@ -2334,7 +3029,7 @@
           "type": "array"
         },
         "cards": {
-          "description": "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. `cards` and `cards_v2` can have a maximum size of 32 KB.",
+          "description": "Deprecated: Use `cards_v2` instead. Rich, formatted, and interactive cards that you can use to display UI elements such as: formatted texts, buttons, and clickable images. Cards are normally displayed below the plain-text body of the message. `cards` and `cards_v2` can have a maximum size of 32 KB.",
           "items": {
             "$ref": "Card"
           },
@@ -2352,13 +3047,32 @@
           "type": "string"
         },
         "createTime": {
-          "description": "Output only. The time at which the message was created in Google Chat server.",
+          "description": "Output only. The time at which the message was created in Google Chat.",
           "format": "google-datetime",
           "readOnly": true,
           "type": "string"
         },
+        "deleteTime": {
+          "description": "Output only. The time at which the message was deleted in Google Chat server. If the message is never deleted, this field is empty. [Developer Preview](https://developers.google.com/workspace/preview).",
+          "format": "google-datetime",
+          "readOnly": true,
+          "type": "string"
+        },
+        "deletionMetadata": {
+          "$ref": "DeletionMetadata",
+          "description": "Output only. Information about a deleted message. A message is deleted when `delete_time` is set. [Developer Preview](https://developers.google.com/workspace/preview).",
+          "readOnly": true
+        },
+        "emojiReactionSummaries": {
+          "description": "Output only. The list of emoji reaction summaries on the message. [Developer Preview](https://developers.google.com/workspace/preview).",
+          "items": {
+            "$ref": "EmojiReactionSummary"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
         "fallbackText": {
-          "description": "A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications).",
+          "description": "A plain-text description of the message's cards, used when the actual cards can't be displayed\u2014for example, mobile notifications.",
           "type": "string"
         },
         "lastUpdateTime": {
@@ -2369,7 +3083,7 @@
         },
         "matchedUrl": {
           "$ref": "MatchedUrl",
-          "description": "Output only. A URL in `spaces.messages.text` that matches a link preview pattern. For more information, refer to [Preview links](https://developers.google.com/chat/how-tos/preview-links).",
+          "description": "Output only. A URL in `spaces.messages.text` that matches a link preview pattern. For more information, see [Preview links](https://developers.google.com/chat/how-tos/preview-links).",
           "readOnly": true
         },
         "name": {
@@ -2407,16 +3121,16 @@
       "type": "object"
     },
     "OnClick": {
-      "description": "An onclick action (e.g. open a link).",
+      "description": "An `onclick` action (for example, open a link).",
       "id": "OnClick",
       "properties": {
         "action": {
           "$ref": "FormAction",
-          "description": "A form action will be triggered by this onclick if specified."
+          "description": "A form action is triggered by this `onclick` action if specified."
         },
         "openLink": {
           "$ref": "OpenLink",
-          "description": "This onclick triggers an open link action if specified."
+          "description": "This `onclick` action triggers an open link action if specified."
         }
       },
       "type": "object"
@@ -2432,16 +3146,36 @@
       },
       "type": "object"
     },
+    "Reaction": {
+      "description": "A reaction to a message. [Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "Reaction",
+      "properties": {
+        "emoji": {
+          "$ref": "Emoji",
+          "description": "The emoji used in the reaction."
+        },
+        "name": {
+          "description": "The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`",
+          "type": "string"
+        },
+        "user": {
+          "$ref": "User",
+          "description": "Output only. The user who created the reaction.",
+          "readOnly": true
+        }
+      },
+      "type": "object"
+    },
     "Section": {
-      "description": "A section contains a collection of widgets that are rendered (vertically) in the order that they are specified. Across all platforms, cards have a narrow fixed width, so there is currently no need for layout properties (e.g. float).",
+      "description": "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's currently no need for layout properties (for example, float).",
       "id": "Section",
       "properties": {
         "header": {
-          "description": "The header of the section, text formatted supported.",
+          "description": "The header of the section. Formatted text is supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
           "type": "string"
         },
         "widgets": {
-          "description": "A section must contain at least 1 widget.",
+          "description": "A section must contain at least one widget.",
           "items": {
             "$ref": "WidgetMarkup"
           },
@@ -2450,12 +3184,34 @@
       },
       "type": "object"
     },
+    "SetUpSpaceRequest": {
+      "description": "[Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "SetUpSpaceRequest",
+      "properties": {
+        "memberships": {
+          "description": "Optional. The initial set of in-domain users invited to join the space. The calling user is automatically added to the space, and shouldn't be specified as a membership. The set currently allows up to 20 memberships (in addition to the caller). The `Membership.member` field must contain a user with `name` populated and `User.Type.HUMAN`. All other fields are ignored. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`). Not supported: Inviting guest users, or adding other Chat apps.",
+          "items": {
+            "$ref": "Membership"
+          },
+          "type": "array"
+        },
+        "requestId": {
+          "description": "Optional. A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space. Specifying an existing request ID from the same Chat app with a different authenticated user returns an error.",
+          "type": "string"
+        },
+        "space": {
+          "$ref": "Space",
+          "description": "Required. The `Space.spaceType` field is required. To create a space, set `Space.spaceType` to `SPACE` and set `Space.displayName`. To create a group chat, set `Space.spaceType` to `GROUP_CHAT`. Don't set `Space.displayName`. To create a 1:1 conversation between humans, set `Space.spaceType` to `DIRECT_MESSAGE` and set `Space.singleUserBotDm` to `false`. Don't set `Space.displayName` or `Space.spaceDetails`. To create an 1:1 conversation between a human and the calling Chat app, set `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`. Don't set `Space.displayName` or `Space.spaceDetails`. If a `DIRECT_MESSAGE` space already exists, that space is returned instead of creating a new space."
+        }
+      },
+      "type": "object"
+    },
     "SlashCommand": {
       "description": "A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat.",
       "id": "SlashCommand",
       "properties": {
         "commandId": {
-          "description": "The id of the slash command invoked.",
+          "description": "The ID of the slash command invoked.",
           "format": "int64",
           "type": "string"
         }
@@ -2471,7 +3227,7 @@
           "description": "The Chat app whose command was invoked."
         },
         "commandId": {
-          "description": "The command id of the invoked slash command.",
+          "description": "The command ID of the invoked slash command.",
           "format": "int64",
           "type": "string"
         },
@@ -2480,7 +3236,7 @@
           "type": "string"
         },
         "triggersDialog": {
-          "description": "Indicating whether the slash command is for a dialog.",
+          "description": "Indicates whether the slash command is for a dialog.",
           "type": "boolean"
         },
         "type": {
@@ -2491,7 +3247,7 @@
             "INVOKE"
           ],
           "enumDescriptions": [
-            "Default value for the enum. DO NOT USE.",
+            "Default value for the enum. Don't use.",
             "Add Chat app to space.",
             "Invoke slash command in space."
           ],
@@ -2510,11 +3266,11 @@
           "type": "boolean"
         },
         "displayName": {
-          "description": "The space's display name. Required when [creating a space](https://developers.google.com/chat/api/reference/rest/v1/spaces/create). For direct messages, this field may be empty. Supports up to 128 characters.",
+          "description": "The space's display name. Required when [creating a space](https://developers.google.com/chat/api/reference/rest/v1/spaces/create). For direct messages, this field might be empty. Supports up to 128 characters.",
           "type": "string"
         },
         "name": {
-          "description": "Resource name of the space. Format: spaces/{space}",
+          "description": "Resource name of the space. Format: `spaces/{space}`",
           "type": "string"
         },
         "singleUserBotDm": {
@@ -2525,6 +3281,20 @@
           "$ref": "SpaceDetails",
           "description": "Details about the space including description and rules."
         },
+        "spaceHistoryState": {
+          "description": "The message history state for messages and threads in this space. [Developer Preview](https://developers.google.com/workspace/preview).",
+          "enum": [
+            "HISTORY_STATE_UNSPECIFIED",
+            "HISTORY_OFF",
+            "HISTORY_ON"
+          ],
+          "enumDescriptions": [
+            "Default value. Do not use.",
+            "History off. [Messages and threads are kept for 24 hours](https://support.google.com/chat/answer/7664687).",
+            "History on. The organization's [Vault retention rules](https://support.google.com/vault/answer/7657597) specify for how long messages and threads are kept."
+          ],
+          "type": "string"
+        },
         "spaceThreadingState": {
           "description": "Output only. The threading state in the Chat space.",
           "enum": [
@@ -2542,6 +3312,22 @@
           "readOnly": true,
           "type": "string"
         },
+        "spaceType": {
+          "description": "The type of space. Required when creating or updating a space. Output only for other usage. [Developer Preview](https://developers.google.com/workspace/preview).",
+          "enum": [
+            "SPACE_TYPE_UNSPECIFIED",
+            "SPACE",
+            "GROUP_CHAT",
+            "DIRECT_MESSAGE"
+          ],
+          "enumDescriptions": [
+            "Reserved.",
+            "A place where people send messages, share files, and collaborate. A `SPACE` can include Chat apps.",
+            "Group conversations between 3 or more people. A `GROUP_CHAT` can include Chat apps.",
+            "1:1 messages between two humans or a human and a Chat app."
+          ],
+          "type": "string"
+        },
         "threaded": {
           "description": "Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space.",
           "readOnly": true,
@@ -2557,7 +3343,7 @@
           "enumDescriptions": [
             "",
             "Conversations between two or more humans.",
-            "1:1 Direct Message between a human and a Chat app, where all messages are flat. Note that this does not include direct messages between two humans."
+            "1:1 Direct Message between a human and a Chat app, where all messages are flat. Note that this doesn't include direct messages between two humans."
           ],
           "readOnly": true,
           "type": "string"
@@ -2570,7 +3356,7 @@
       "id": "SpaceDetails",
       "properties": {
         "description": {
-          "description": "Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. Supports up to 150 characters.",
+          "description": "Optional. A description of the space. For example, describe the space's discussion topic, functional purpose, or participants. Supports up to 150 characters.",
           "type": "string"
         },
         "guidelines": {
@@ -2622,12 +3408,12 @@
       "type": "object"
     },
     "TextButton": {
-      "description": "A button with text and onclick action.",
+      "description": "A button with text and `onclick` action.",
       "id": "TextButton",
       "properties": {
         "onClick": {
           "$ref": "OnClick",
-          "description": "The onclick action of the button."
+          "description": "The `onclick` action of the button."
         },
         "text": {
           "description": "The text of the button.",
@@ -2637,7 +3423,7 @@
       "type": "object"
     },
     "TextParagraph": {
-      "description": "A paragraph of text. Formatted text supported.",
+      "description": "A paragraph of text. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
       "id": "TextParagraph",
       "properties": {
         "text": {
@@ -2651,7 +3437,7 @@
       "id": "Thread",
       "properties": {
         "name": {
-          "description": "Resource name of the thread. Example: spaces/{space}/threads/{thread}",
+          "description": "Resource name of the thread. Example: `spaces/{space}/threads/{thread}`",
           "type": "string"
         },
         "threadKey": {
@@ -2662,7 +3448,7 @@
       "type": "object"
     },
     "TimeInput": {
-      "description": "Time input values. Not supported by Chat apps.",
+      "description": "Time input values.",
       "id": "TimeInput",
       "properties": {
         "hours": {
@@ -2679,7 +3465,7 @@
       "type": "object"
     },
     "TimeZone": {
-      "description": "The timezone ID and offset from Coordinated Universal Time (UTC). Not supported by Chat apps.",
+      "description": "The timezone ID and offset from Coordinated Universal Time (UTC). Only supported for the event types [`CARD_CLICKED`](https://developers.google.com/chat/api/reference/rest/v1/EventType#ENUM_VALUES.CARD_CLICKED) and [`SUBMIT_DIALOG`](https://developers.google.com/chat/api/reference/rest/v1/DialogEventType#ENUM_VALUES.SUBMIT_DIALOG).",
       "id": "TimeZone",
       "properties": {
         "id": {
@@ -2694,6 +3480,27 @@
       },
       "type": "object"
     },
+    "UploadAttachmentRequest": {
+      "description": "[Developer Preview](https://developers.google.com/workspace/preview).",
+      "id": "UploadAttachmentRequest",
+      "properties": {
+        "filename": {
+          "description": "Required. The filename of the attachment, including the file extension.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "UploadAttachmentResponse": {
+      "id": "UploadAttachmentResponse",
+      "properties": {
+        "attachmentDataRef": {
+          "$ref": "AttachmentDataRef",
+          "description": "Reference to the uploaded attachment."
+        }
+      },
+      "type": "object"
+    },
     "User": {
       "description": "A user in Google Chat.",
       "id": "User",
@@ -2745,7 +3552,7 @@
             "MENTION"
           ],
           "enumDescriptions": [
-            "Default value for the enum. DO NOT USE.",
+            "Default value for the enum. Don't use.",
             "Add user to space.",
             "Mention user in space."
           ],
@@ -2759,11 +3566,11 @@
       "type": "object"
     },
     "WidgetMarkup": {
-      "description": "A widget is a UI element that presents texts, images, etc.",
+      "description": "A widget is a UI element that presents text and images.",
       "id": "WidgetMarkup",
       "properties": {
         "buttons": {
-          "description": "A list of buttons. Buttons is also oneof data and only one of these fields should be set.",
+          "description": "A list of buttons. Buttons is also `oneof data` and only one of these fields should be set.",
           "items": {
             "$ref": "Button"
           },