google-api-python-client 2.152.0__py2.py3-none-any.whl → 2.154.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/chat.v1.json

@@ -290,7 +290,7 @@
 ]
 },
 "create": {
-"description": "Creates a space with no members. Can be used to create a named space. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. If you're a member of the [Developer Preview program](https://developers.google.com/workspace/preview), you can create a group chat in import mode using `spaceType.GROUP_CHAT`. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) When authenticating as an app, the `space.customer` field must be set in the request.",
+"description": "Creates a space with no members. Can be used to create a named space, or a group chat in `Import mode`. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) When authenticating as an app, the `space.customer` field must be set in the request.",
 "flatPath": "v1/spaces",
 "httpMethod": "POST",
 "id": "chat.spaces.create",
@@ -334,7 +334,7 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).",
+"description": "Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).",
 "location": "query",
 "type": "boolean"
 }
@@ -390,7 +390,7 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` or `chat.admin.spaces.readonly` [OAuth 2.0 scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).",
+"description": "Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` or `chat.admin.spaces.readonly` [OAuth 2.0 scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).",
 "location": "query",
 "type": "boolean"
 }
@@ -452,7 +452,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.",
+"description": "Identifier. Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.",
 "location": "path",
 "pattern": "^spaces/[^/]+$",
 "required": true,
@@ -465,7 +465,7 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). Some `FieldMask` values are not supported using admin access. For details, see the description of `update_mask`.",
+"description": "Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). Some `FieldMask` values are not supported using admin access. For details, see the description of `update_mask`.",
 "location": "query",
 "type": "boolean"
 }
@@ -763,7 +763,7 @@
 "messages": {
 "methods": {
 "create": {
-"description": "Creates a message in a Google Chat space. For an example, see [Send a message](https://developers.google.com/workspace/chat/create-messages). The `create()` method requires either [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) or [app authentication](https://developers.google.com/workspace/chat/authorize-import). Chat attributes the message sender differently depending on the type of authentication that you use in your request. The following image shows how Chat attributes a message when you use app authentication. Chat displays the Chat app as the message sender. The content of the message can contain text (`text`), cards (`cardsV2`), and accessory widgets (`accessoryWidgets`). ![Message sent with app authentication](https://developers.google.com/workspace/chat/images/message-app-auth.svg) The following image shows how Chat attributes a message when you use user authentication. Chat displays the user as the message sender and attributes the Chat app to the message by displaying its name. The content of message can only contain text (`text`). ![Message sent with user authentication](https://developers.google.com/workspace/chat/images/message-user-auth.svg) The maximum message size, including the message contents, is 32,000 bytes.",
+"description": "Creates a message in a Google Chat space. For an example, see [Send a message](https://developers.google.com/workspace/chat/create-messages). The `create()` method requires either [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) or [app authentication](https://developers.google.com/workspace/chat/authorize-import). Chat attributes the message sender differently depending on the type of authentication that you use in your request. The following image shows how Chat attributes a message when you use app authentication. Chat displays the Chat app as the message sender. The content of the message can contain text (`text`), cards (`cardsV2`), and accessory widgets (`accessoryWidgets`). ![Message sent with app authentication](https://developers.google.com/workspace/chat/images/message-app-auth.svg) The following image shows how Chat attributes a message when you use user authentication. Chat displays the user as the message sender and attributes the Chat app to the message by displaying its name. The content of message can only contain text (`text`). ![Message sent with user authentication](https://developers.google.com/workspace/chat/images/message-user-auth.svg) The maximum message size, including the message contents, is 32,000 bytes. For [webhook](https://developers.google.com/workspace/chat/quickstart/webhooks) requests, the response doesn't contain the full message. The response only populates the `name` and `thread.name` fields in addition to the information that was in the request.",
 "flatPath": "v1/spaces/{spacesId}/messages",
 "httpMethod": "POST",
 "id": "chat.spaces.messages.create",
@@ -777,7 +777,7 @@
 "type": "string"
 },
 "messageReplyOption": {
-"description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.",
+"description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. When [responding to user interactions](https://developers.google.com/workspace/chat/receive-respond-interactions), this field is ignored. For interactions within a thread, the reply is created in the same thread. Otherwise, the reply is created as a new thread.",
 "enum": [
 "MESSAGE_REPLY_OPTION_UNSPECIFIED",
 "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD",
@@ -834,7 +834,7 @@
 ],
 "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/workspace/chat/authenticate-authorize-chat-user). Has no effect when [authenticating as a Chat app] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
+"description": "Optional. 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/workspace/chat/authenticate-authorize-chat-user). Has no effect when [authenticating as a Chat app] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
 "location": "query",
 "type": "boolean"
 },
@@ -893,23 +893,23 @@
 ],
 "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.",
+"description": "Optional. 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`.",
+"description": "Optional. 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 1000. If you use a value more than 1000, it's automatically changed to 1000. Negative values return an `INVALID_ARGUMENT` error.",
+"description": "Optional. 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 1000. If you use a value more than 1000, it's automatically changed to 1000. 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.",
+"description": "Optional. 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"
 },
@@ -921,7 +921,7 @@
 "type": "string"
 },
 "showDeleted": {
-"description": "Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.",
+"description": "Optional. Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.",
 "location": "query",
 "type": "boolean"
 }
@@ -951,7 +951,7 @@
 "type": "boolean"
 },
 "name": {
-"description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
+"description": "Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
 "location": "path",
 "pattern": "^spaces/[^/]+/messages/[^/]+$",
 "required": true,
@@ -992,7 +992,7 @@
 "type": "boolean"
 },
 "name": {
-"description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
+"description": "Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
 "location": "path",
 "pattern": "^spaces/[^/]+/messages/[^/]+$",
 "required": true,
@@ -1344,7 +1344,7 @@
 }
 }
 },
-"revision": "20241029",
+"revision": "20241110",
 "rootUrl": "https://chat.googleapis.com/",
 "schemas": {
 "AccessSettings": {
@@ -1556,7 +1556,7 @@
 "properties": {
 "attachmentDataRef": {
 "$ref": "AttachmentDataRef",
-"description": "A reference to the attachment data. This field is used with the media API to download the attachment data."
+"description": "Optional. A reference to the attachment data. This field is used to create or update messages with attachments, or with the media API to download the attachment data."
 },
 "contentName": {
 "description": "Output only. The original file name for the content, not the full path.",
@@ -1579,7 +1579,7 @@
 "readOnly": true
 },
 "name": {
-"description": "Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`.",
+"description": "Optional. Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`.",
 "type": "string"
 },
 "source": {
@@ -1610,11 +1610,11 @@
 "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.",
+"description": "Optional. 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.",
 "type": "string"
 },
 "resourceName": {
-"description": "The resource name of the attachment data. This field is used with the media API to download the attachment data.",
+"description": "Optional. The resource name of the attachment data. This field is used with the media API to download the attachment data.",
 "type": "string"
 }
 },
@@ -2117,7 +2117,7 @@
 "readOnly": true
 },
 "unicode": {
-"description": "A basic emoji represented by a unicode string.",
+"description": "Optional. A basic emoji represented by a unicode string.",
 "type": "string"
 }
 },
@@ -2129,11 +2129,13 @@
 "properties": {
 "emoji": {
 "$ref": "Emoji",
-"description": "Emoji associated with the reactions."
+"description": "Output only. Emoji associated with the reactions.",
+"readOnly": true
 },
 "reactionCount": {
-"description": "The total number of reactions using the associated emoji.",
+"description": "Output only. The total number of reactions using the associated emoji.",
 "format": "int32",
+"readOnly": true,
 "type": "integer"
 }
 },
@@ -3068,7 +3070,7 @@
 "properties": {
 "externalDataSource": {
 "$ref": "GoogleAppsCardV1Action",
-"description": "An external data source, such as a relational data base."
+"description": "An external data source, such as a relational database."
 },
 "items": {
 "description": "An array of selectable items. For example, an array of radio buttons or checkboxes. Supports up to 100 items.",
@@ -3087,7 +3089,7 @@
 "type": "integer"
 },
 "multiSelectMinQueryLength": {
-"description": "For multiselect menus, the number of text characters that a user inputs before the app queries autocomplete and displays suggested items in the menu. If unspecified, defaults to 0 characters for static data sources and 3 characters for external data sources.",
+"description": "For multiselect menus, the number of text characters that a user inputs before the menu returns suggested selection items. If unset, the multiselect menu uses the following default values: * If the menu uses a static array of `SelectionInput` items, defaults to 0 characters and immediately populates items from the array. * If the menu uses a dynamic data source (`multi_select_data_source`), defaults to 3 characters before querying the data source to return suggested items.",
 "format": "int32",
 "type": "integer"
 },
@@ -3117,7 +3119,7 @@
 "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.",
-"A multiselect menu for static or dynamic data. From the menu bar, users select one or more items. Users can also input values to populate dynamic data. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To populate items for a multiselect menu, you can use one of the following types of data sources: * Static data: Items are specified as `SelectionItem` objects in the widget. Up to 100 items. * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus, see [Add a multiselect menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):"
+"A menu with a text box. Users can type and select one or more items. For Google Workspace Add-ons, you must populate items using a static array of `SelectionItem` objects. For Google Chat apps, you can also populate items using a dynamic data source and autosuggest items as users type in the menu. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To dynamically populate items for a multiselect menu, use one of the following types of data sources: * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus for Chat apps, see [Add a multiselect menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):"
 ],
 "type": "string"
 }
@@ -3125,7 +3127,7 @@
 "type": "object"
 },
 "GoogleAppsCardV1SelectionItem": {
-"description": "An item that users can select in a selection input, such as a checkbox or switch. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
+"description": "An item that users can select in a selection input, such as a checkbox or switch. Supports up to 100 items. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
 "id": "GoogleAppsCardV1SelectionItem",
 "properties": {
 "bottomText": {
@@ -3865,13 +3867,15 @@
 "id": "MembershipCount",
 "properties": {
 "joinedDirectHumanUserCount": {
-"description": "Count of human users that have directly joined the space, not counting users joined by having membership in a joined group.",
+"description": "Output only. Count of human users that have directly joined the space, not counting users joined by having membership in a joined group.",
 "format": "int32",
+"readOnly": true,
 "type": "integer"
 },
 "joinedGroupCount": {
-"description": "Count of all groups that have directly joined the space.",
+"description": "Output only. Count of all groups that have directly joined the space.",
 "format": "int32",
+"readOnly": true,
 "type": "integer"
 }
 },
@@ -3915,7 +3919,7 @@
 "id": "Message",
 "properties": {
 "accessoryWidgets": {
-"description": "One or more interactive widgets that appear at the bottom of a message. You can add accessory widgets to messages that contain text, cards, or both text and cards. Not supported for messages that contain dialogs. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). Creating a message with accessory widgets requires [app authentication] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
+"description": "Optional. One or more interactive widgets that appear at the bottom of a message. You can add accessory widgets to messages that contain text, cards, or both text and cards. Not supported for messages that contain dialogs. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). Creating a message with accessory widgets requires [app authentication] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
 "items": {
 "$ref": "AccessoryWidget"
 },
@@ -3947,7 +3951,7 @@
 "type": "array"
 },
 "attachment": {
-"description": "User-uploaded attachment.",
+"description": "Optional. User-uploaded attachment.",
 "items": {
 "$ref": "Attachment"
 },
@@ -3962,7 +3966,7 @@
 "type": "array"
 },
 "cardsV2": {
-"description": "An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn how to create a message that contains cards, see [Send a message](https://developers.google.com/workspace/chat/create-messages). [Card builder](https://addons.gsuite.google.com/uikit/builder)",
+"description": "Optional. An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn how to create a message that contains cards, see [Send a message](https://developers.google.com/workspace/chat/create-messages). [Card builder](https://addons.gsuite.google.com/uikit/builder)",
 "items": {
 "$ref": "CardWithId"
 },
@@ -3997,7 +4001,7 @@
 "type": "array"
 },
 "fallbackText": {
-"description": "A plain-text description of the message's cards, used when the actual cards can't be displayed\u2014for example, mobile notifications.",
+"description": "Optional. A plain-text description of the message's cards, used when the actual cards can't be displayed\u2014for example, mobile notifications.",
 "type": "string"
 },
 "formattedText": {
@@ -4017,12 +4021,12 @@
 "readOnly": true
 },
 "name": {
-"description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
+"description": "Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
 "type": "string"
 },
 "privateMessageViewer": {
 "$ref": "User",
-"description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)."
+"description": "Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)."
 },
 "quotedMessageMetadata": {
 "$ref": "QuotedMessageMetadata",
@@ -4041,10 +4045,11 @@
 },
 "space": {
 "$ref": "Space",
-"description": "If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`."
+"description": "Output only. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.",
+"readOnly": true
 },
 "text": {
-"description": "Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a message](https://developers.google.com/workspace/chat/create-messages).",
+"description": "Optional. Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a message](https://developers.google.com/workspace/chat/create-messages).",
 "type": "string"
 },
 "thread": {
@@ -4165,11 +4170,11 @@
 "id": "PermissionSetting",
 "properties": {
 "managersAllowed": {
-"description": "Whether spaces managers have this permission.",
+"description": "Optional. Whether spaces managers have this permission.",
 "type": "boolean"
 },
 "membersAllowed": {
-"description": "Whether non-manager members have this permission.",
+"description": "Optional. Whether non-manager members have this permission.",
 "type": "boolean"
 }
 },
@@ -4181,19 +4186,19 @@
 "properties": {
 "manageApps": {
 "$ref": "PermissionSetting",
-"description": "Setting for managing apps in a space."
+"description": "Optional. Setting for managing apps in a space."
 },
 "manageMembersAndGroups": {
 "$ref": "PermissionSetting",
-"description": "Setting for managing members and groups in a space."
+"description": "Optional. Setting for managing members and groups in a space."
 },
 "manageWebhooks": {
 "$ref": "PermissionSetting",
-"description": "Setting for managing webhooks in a space."
+"description": "Optional. Setting for managing webhooks in a space."
 },
 "modifySpaceDetails": {
 "$ref": "PermissionSetting",
-"description": "Setting for updating space name, avatar, description and guidelines."
+"description": "Optional. Setting for updating space name, avatar, description and guidelines."
 },
 "postMessages": {
 "$ref": "PermissionSetting",
@@ -4202,15 +4207,15 @@
 },
 "replyMessages": {
 "$ref": "PermissionSetting",
-"description": "Setting for replying to messages in a space."
+"description": "Optional. Setting for replying to messages in a space."
 },
 "toggleHistory": {
 "$ref": "PermissionSetting",
-"description": "Setting for toggling space history on and off."
+"description": "Optional. Setting for toggling space history on and off."
 },
 "useAtMentionAll": {
 "$ref": "PermissionSetting",
-"description": "Setting for using @all in a space."
+"description": "Optional. Setting for using @all in a space."
 }
 },
 "type": "object"
@@ -4239,10 +4244,10 @@
 "properties": {
 "emoji": {
 "$ref": "Emoji",
-"description": "The emoji used in the reaction."
+"description": "Required. The emoji used in the reaction."
 },
 "name": {
-"description": "The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`",
+"description": "Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`",
 "type": "string"
 },
 "user": {
@@ -4482,11 +4487,11 @@
 "type": "string"
 },
 "displayName": {
-"description": "The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.",
+"description": "Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.",
 "type": "string"
 },
 "externalUserAllowed": {
-"description": "Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.",
+"description": "Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.",
 "type": "boolean"
 },
 "importMode": {
@@ -4505,7 +4510,7 @@
 "readOnly": true
 },
 "name": {
-"description": "Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.",
+"description": "Identifier. Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.",
 "type": "string"
 },
 "permissionSettings": {
@@ -4532,10 +4537,10 @@
 },
 "spaceDetails": {
 "$ref": "SpaceDetails",
-"description": "Details about the space including description and rules."
+"description": "Optional. Details about the space including description and rules."
 },
 "spaceHistoryState": {
-"description": "The message history state for messages and threads in this space.",
+"description": "Optional. The message history state for messages and threads in this space.",
 "enum": [
 "HISTORY_STATE_UNSPECIFIED",
 "HISTORY_OFF",
@@ -4566,7 +4571,7 @@
 "type": "string"
 },
 "spaceType": {
-"description": "The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.",
+"description": "Optional. The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.",
 "enum": [
 "SPACE_TYPE_UNSPECIFIED",
 "SPACE",
@@ -4841,7 +4846,7 @@
 "id": "Thread",
 "properties": {
 "name": {
-"description": "Resource name of the thread. Example: `spaces/{space}/threads/{thread}`",
+"description": "Identifier. Resource name of the thread. Example: `spaces/{space}/threads/{thread}`",
 "type": "string"
 },
 "threadKey": {
@@ -4901,7 +4906,7 @@
 "type": "object"
 },
 "UpdatedWidget": {
-"description": "The response of the updated widget. Used to provide autocomplete options for a widget.",
+"description": "For `selectionInput` widgets, returns autocomplete suggestions for a multiselect menu.",
 "id": "UpdatedWidget",
 "properties": {
 "suggestions": {

googleapiclient/discovery_cache/documents/checks.v1alpha.json

@@ -160,7 +160,7 @@
 "operations": {
 "methods": {
 "cancel": {
-"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
 "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}:cancel",
 "httpMethod": "POST",
 "id": "checks.accounts.apps.operations.cancel",
@@ -463,7 +463,7 @@
 }
 }
 },
-"revision": "20241029",
+"revision": "20241114",
 "rootUrl": "https://checks.googleapis.com/",
 "schemas": {
 "CancelOperationRequest": {

googleapiclient/discovery_cache/documents/chromemanagement.v1.json

@@ -1172,7 +1172,7 @@
 }
 }
 },
-"revision": "20241023",
+"revision": "20241107",
 "rootUrl": "https://chromemanagement.googleapis.com/",
 "schemas": {
 "GoogleChromeManagementV1AndroidAppInfo": {
@@ -3778,7 +3778,8 @@
 "APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR",
 "APPLICATION_LAUNCH_SOURCE_FOCUS_MODE",
 "APPLICATION_LAUNCH_SOURCE_SPARKY",
-"APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING"
+"APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING",
+"APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API"
 ],
 "enumDescriptions": [
 "Application launch source unknown.",
@@ -3823,7 +3824,8 @@
 "Application launched from welcome tour.",
 "Applicationed launched from focus panel.",
 "Application launched from experimental feature Sparky.",
-"Application launched from navigation capturing."
+"Application launched from navigation capturing.",
+"Application launched from web install API."
 ],
 "type": "string"
 },

googleapiclient/discovery_cache/documents/cloudasset.v1.json

@@ -1095,7 +1095,7 @@
 }
 }
 },
-"revision": "20240831",
+"revision": "20241110",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AccessSelector": {
@@ -1170,7 +1170,7 @@
 "description": "The main analysis that matches the original request."
 },
 "serviceAccountImpersonationAnalysis": {
-"description": "The service account impersonation analysis if AnalyzeIamPolicyRequest.analyze_service_account_impersonation is enabled.",
+"description": "The service account impersonation analysis if IamPolicyAnalysisQuery.Options.analyze_service_account_impersonation is enabled.",
 "items": {
 "$ref": "IamPolicyAnalysis"
 },
@@ -1620,7 +1620,7 @@
 "id": "EffectiveTagDetails",
 "properties": {
 "attachedResource": {
-"description": "The [full resource name](https://cloud.google.com/asset-inventory/docs/resource-name-format) of the ancestor from which an effective_tag is inherited, according to [tag inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).",
+"description": "The [full resource name](https://cloud.google.com/asset-inventory/docs/resource-name-format) of the ancestor from which effective_tags are inherited, according to [tag inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).",
 "type": "string"
 },
 "effectiveTags": {
@@ -1884,7 +1884,7 @@
 "description": "A Google Cloud resource governed by the organization policies of the AnalyzeOrgPolicyGovernedAssetsRequest.constraint."
 },
 "policyBundle": {
-"description": "The ordered list of all organization policies from the AnalyzeOrgPoliciesResponse.OrgPolicyResult.consolidated_policy.attached_resource to the scope specified in the request. If the constraint is defined with default policy, it will also appear in the list.",
+"description": "The ordered list of all organization policies from the consolidated_policy.attached_resource to the scope specified in the request. If the constraint is defined with default policy, it will also appear in the list.",
 "items": {
 "$ref": "AnalyzerOrgPolicy"
 },
@@ -2174,7 +2174,7 @@
 "type": "string"
 },
 "policyBundle": {
-"description": "The ordered list of all organization policies from the AnalyzeOrgPoliciesResponse.OrgPolicyResult.consolidated_policy.attached_resource. to the scope specified in the request. If the constraint is defined with default policy, it will also appear in the list.",
+"description": "The ordered list of all organization policies from the consolidated_policy.attached_resource. to the scope specified in the request. If the constraint is defined with default policy, it will also appear in the list.",
 "items": {
 "$ref": "AnalyzerOrgPolicy"
 },
@@ -3062,6 +3062,10 @@
 "description": "Description of the `ServicePerimeter` and its use. Does not affect behavior.",
 "type": "string"
 },
+"etag": {
+"description": "Optional. An opaque identifier for the current version of the `ServicePerimeter`. Clients should not expect this to be in any specific format. If etag is not provided, the operation will be performed as if a valid etag is provided.",
+"type": "string"
+},
 "name": {
 "description": "Identifier. Resource name for the `ServicePerimeter`. Format: `accessPolicies/{access_policy}/servicePerimeters/{service_perimeter}`. The `service_perimeter` component must begin with a letter, followed by alphanumeric characters or `_`. After you create a `ServicePerimeter`, you cannot change its `name`.",
 "type": "string"
@@ -3658,7 +3662,7 @@
 "properties": {
 "consolidatedPolicy": {
 "$ref": "AnalyzerOrgPolicy",
-"description": "The consolidated organization policy for the analyzed resource. The consolidated organization policy is computed by merging and evaluating AnalyzeOrgPoliciesResponse.policy_bundle. The evaluation will respect the organization policy [hierarchy rules](https://cloud.google.com/resource-manager/docs/organization-policy/understanding-hierarchy)."
+"description": "The consolidated organization policy for the analyzed resource. The consolidated organization policy is computed by merging and evaluating policy_bundle. The evaluation will respect the organization policy [hierarchy rules](https://cloud.google.com/resource-manager/docs/organization-policy/understanding-hierarchy)."
 },
 "folders": {
 "description": "The folder(s) that this consolidated policy belongs to, in the format of folders/{FOLDER_NUMBER}. This field is available when the consolidated policy belongs (directly or cascadingly) to one or more folders.",
@@ -3672,7 +3676,7 @@
 "type": "string"
 },
 "policyBundle": {
-"description": "The ordered list of all organization policies from the AnalyzeOrgPoliciesResponse.OrgPolicyResult.consolidated_policy.attached_resource. to the scope specified in the request. If the constraint is defined with default policy, it will also appear in the list.",
+"description": "The ordered list of all organization policies from the consolidated_policy.attached_resource. to the scope specified in the request. If the constraint is defined with default policy, it will also appear in the list.",
 "items": {
 "$ref": "AnalyzerOrgPolicy"
 },

googleapiclient/discovery_cache/documents/cloudasset.v1beta1.json

@@ -411,7 +411,7 @@
 }
 }
 },
-"revision": "20240803",
+"revision": "20241110",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AnalyzeIamPolicyLongrunningMetadata": {
@@ -1372,6 +1372,10 @@
 "description": "Description of the `ServicePerimeter` and its use. Does not affect behavior.",
 "type": "string"
 },
+"etag": {
+"description": "Optional. An opaque identifier for the current version of the `ServicePerimeter`. Clients should not expect this to be in any specific format. If etag is not provided, the operation will be performed as if a valid etag is provided.",
+"type": "string"
+},
 "name": {
 "description": "Identifier. Resource name for the `ServicePerimeter`. Format: `accessPolicies/{access_policy}/servicePerimeters/{service_perimeter}`. The `service_perimeter` component must begin with a letter, followed by alphanumeric characters or `_`. After you create a `ServicePerimeter`, you cannot change its `name`.",
 "type": "string"