google-api-python-client 2.131.0__py2.py3-none-any.whl → 2.133.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json

@@ -106,6 +106,36 @@
 "protocol": "rest",
 "resources": {
 "projects": {
+"methods": {
+"provision": {
+"description": "Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.",
+"flatPath": "v1beta/projects/{projectsId}:provision",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.provision",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Full resource name of a Project, such as `projects/{project_id_or_number}`.",
+"location": "path",
+"pattern": "^projects/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}:provision",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaProvisionProjectRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+},
 "resources": {
 "locations": {
 "resources": {
@@ -355,7 +385,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Filter by solution type . For example: filter = 'solution_type:SOLUTION_TYPE_SEARCH'",
+"description": "Filter by solution type . For example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'`",
 "location": "query",
 "type": "string"
 },
@@ -770,6 +800,168 @@
 }
 }
 },
+"controls": {
+"methods": {
+"create": {
+"description": "Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/controls",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.dataStores.controls.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"controlId": {
+"description": "Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/controls/{controlsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.collections.dataStores.controls.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/controls/{controlsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.dataStores.controls.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/controls",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.dataStores.controls.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaListControlsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/controls/{controlsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.dataStores.controls.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "conversations": {
 "methods": {
 "converse": {
@@ -2353,6 +2545,11 @@
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
 "type": "string"
+},
+"writeAsync": {
+"description": "If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write.",
+"location": "query",
+"type": "boolean"
 }
 },
 "path": "v1beta/{+parent}/userEvents:write",
@@ -2616,77 +2813,54 @@
 }
 },
 "resources": {
-"conversations": {
+"controls": {
 "methods": {
-"converse": {
-"description": "Converses a conversation.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}:converse",
-"httpMethod": "POST",
-"id": "discoveryengine.projects.locations.collections.engines.conversations.converse",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1beta/{+name}:converse",
-"request": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConverseConversationRequest"
-},
-"response": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConverseConversationResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
 "create": {
-"description": "Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations",
+"description": "Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls",
 "httpMethod": "POST",
-"id": "discoveryengine.projects.locations.collections.engines.conversations.create",
+"id": "discoveryengine.projects.locations.collections.engines.controls.create",
 "parameterOrder": [
 "parent"
 ],
 "parameters": {
+"controlId": {
+"description": "Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/.",
+"location": "query",
+"type": "string"
+},
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1beta/{+parent}/conversations",
+"path": "v1beta/{+parent}/controls",
 "request": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
 },
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
 "delete": {
-"description": "Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"description": "Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls/{controlsId}",
 "httpMethod": "DELETE",
-"id": "discoveryengine.projects.locations.collections.engines.conversations.delete",
+"id": "discoveryengine.projects.locations.collections.engines.controls.delete",
 "parameterOrder": [
 "name"
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
 "type": "string"
 }
@@ -2700,94 +2874,89 @@
 ]
 },
 "get": {
-"description": "Gets a Conversation.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"description": "Gets a Control.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls/{controlsId}",
 "httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.engines.conversations.get",
+"id": "discoveryengine.projects.locations.collections.engines.controls.get",
 "parameterOrder": [
 "name"
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
 "path": "v1beta/{+name}",
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
 "list": {
-"description": "Lists all Conversations by their parent DataStore.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations",
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls",
 "httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.engines.conversations.list",
+"id": "discoveryengine.projects.locations.collections.engines.controls.list",
 "parameterOrder": [
 "parent"
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
-"location": "query",
-"type": "string"
-},
-"orderBy": {
-"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: \"update_time desc\" \"create_time\"",
+"description": "Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.",
 "location": "query",
 "type": "string"
 },
 "pageSize": {
-"description": "Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"description": "Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
 "format": "int32",
 "location": "query",
 "type": "integer"
 },
 "pageToken": {
-"description": "A page token, received from a previous `ListConversations` call. Provide this to retrieve the subsequent page.",
+"description": "Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.",
 "location": "query",
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1beta/{+parent}/conversations",
+"path": "v1beta/{+parent}/controls",
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1betaListConversationsResponse"
+"$ref": "GoogleCloudDiscoveryengineV1betaListControlsResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
 "patch": {
-"description": "Updates a Conversation. Conversation action type cannot be changed. If the Conversation to update does not exist, a NOT_FOUND error is returned.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"description": "Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls/{controlsId}",
 "httpMethod": "PATCH",
-"id": "discoveryengine.projects.locations.collections.engines.conversations.patch",
+"id": "discoveryengine.projects.locations.collections.engines.controls.patch",
 "parameterOrder": [
 "name"
 ],
 "parameters": {
 "name": {
-"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/*` or `projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*`.",
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
 "type": "string"
 },
 "updateMask": {
-"description": "Indicates which fields in the provided Conversation to update. The following are NOT supported: * Conversation.name If not set or empty, all supported fields are updated.",
+"description": "Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -2795,10 +2964,10 @@
 },
 "path": "v1beta/{+name}",
 "request": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
 },
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
@@ -2806,40 +2975,230 @@
 }
 }
 },
-"operations": {
+"conversations": {
 "methods": {
-"get": {
-"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations/{operationsId}",
-"httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.engines.operations.get",
+"converse": {
+"description": "Converses a conversation.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}:converse",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.conversations.converse",
 "parameterOrder": [
 "name"
 ],
 "parameters": {
 "name": {
-"description": "The name of the operation resource.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/operations/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1beta/{+name}",
+"path": "v1beta/{+name}:converse",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConverseConversationRequest"
+},
 "response": {
-"$ref": "GoogleLongrunningOperation"
+"$ref": "GoogleCloudDiscoveryengineV1betaConverseConversationResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
-"list": {
-"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
-"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations",
-"httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.engines.operations.list",
+"create": {
+"description": "Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.conversations.create",
 "parameterOrder": [
-"name"
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/conversations",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.collections.engines.conversations.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Conversation.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.conversations.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Conversations by their parent DataStore.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.conversations.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: \"update_time desc\" \"create_time\"",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListConversations` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/conversations",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaListConversationsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates a Conversation. Conversation action type cannot be changed. If the Conversation to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.conversations.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/*` or `projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Indicates which fields in the provided Conversation to update. The following are NOT supported: * Conversation.name If not set or empty, all supported fields are updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConversation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
+"operations": {
+"methods": {
+"get": {
+"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations/{operationsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.operations.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.operations.list",
+"parameterOrder": [
+"name"
 ],
 "parameters": {
 "filter": {
@@ -3496,7 +3855,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Filter by solution type . For example: filter = 'solution_type:SOLUTION_TYPE_SEARCH'",
+"description": "Filter by solution type . For example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'`",
 "location": "query",
 "type": "string"
 },
@@ -3883,6 +4242,168 @@
 }
 }
 },
+"controls": {
+"methods": {
+"create": {
+"description": "Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/controls",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.controls.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"controlId": {
+"description": "Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/controls/{controlsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.dataStores.controls.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/controls/{controlsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.dataStores.controls.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/controls",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.dataStores.controls.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaListControlsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/controls/{controlsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.dataStores.controls.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "conversations": {
 "methods": {
 "converse": {
@@ -5159,6 +5680,11 @@
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
 "type": "string"
+},
+"writeAsync": {
+"description": "If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write.",
+"location": "query",
+"type": "boolean"
 }
 },
 "path": "v1beta/{+parent}/userEvents:write",
@@ -5312,6 +5838,47 @@
 },
 "userEvents": {
 "methods": {
+"collect": {
+"description": "Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a third-party domain. This method is used only by the Discovery Engine API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/userEvents:collect",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.userEvents.collect",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"ets": {
+"description": "The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.",
+"format": "int64",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent DataStore resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+},
+"uri": {
+"description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for third-party requests.",
+"location": "query",
+"type": "string"
+},
+"userEvent": {
+"description": "Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/userEvents:collect",
+"response": {
+"$ref": "GoogleApiHttpBody"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -5327,6 +5894,11 @@
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
 "type": "string"
+},
+"writeAsync": {
+"description": "If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write.",
+"location": "query",
+"type": "boolean"
 }
 },
 "path": "v1beta/{+parent}/userEvents:write",
@@ -5417,7 +5989,7 @@
 }
 }
 },
-"revision": "20240517",
+"revision": "20240607",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -5575,22 +6147,216 @@
 "format": "google-datetime",
 "type": "string"
 },
-"updateTime": {
-"description": "Operation last update time. If the operation is done, this is also the finish time.",
-"format": "google-datetime",
+"updateTime": {
+"description": "Operation last update time. If the operation is done, this is also the finish time.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1BatchCreateTargetSitesResponse": {
+"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
+"id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSitesResponse",
+"properties": {
+"targetSites": {
+"description": "TargetSites created.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1TargetSite"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1Condition": {
+"description": "Defines circumstances to be checked before allowing a behavior",
+"id": "GoogleCloudDiscoveryengineV1Condition",
+"properties": {
+"activeTimeRange": {
+"description": "Range of time(s) specifying when condition is active. Maximum of 10 time ranges.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1ConditionTimeRange"
+},
+"type": "array"
+},
+"queryTerms": {
+"description": "Search only A list of terms to match the query on. Maximum of 10 query terms.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1ConditionQueryTerm"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ConditionQueryTerm": {
+"description": "Matcher for search request query",
+"id": "GoogleCloudDiscoveryengineV1ConditionQueryTerm",
+"properties": {
+"fullMatch": {
+"description": "Whether the search query needs to exactly match the query term.",
+"type": "boolean"
+},
+"value": {
+"description": "The specific query value to match against Must be lowercase, must be UTF-8. Can have at most 3 space separated terms if full_match is true. Cannot be an empty string. Maximum length of 5000 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ConditionTimeRange": {
+"description": "Used for time-dependent conditions.",
+"id": "GoogleCloudDiscoveryengineV1ConditionTimeRange",
+"properties": {
+"endTime": {
+"description": "End of time range. Range is inclusive. Must be in the future.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Start of time range. Range is inclusive.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1Control": {
+"description": "Defines a conditioned behavior to employ during serving. Must be attached to a ServingConfig to be considered at serving time. Permitted actions dependent on `SolutionType`.",
+"id": "GoogleCloudDiscoveryengineV1Control",
+"properties": {
+"associatedServingConfigIds": {
+"description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"boostAction": {
+"$ref": "GoogleCloudDiscoveryengineV1ControlBoostAction",
+"description": "Defines a boost-type control"
+},
+"conditions": {
+"description": "Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1Condition"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+},
+"filterAction": {
+"$ref": "GoogleCloudDiscoveryengineV1ControlFilterAction",
+"description": "Defines a filter-type control Currently not supported by Recommendation"
+},
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
+"type": "string"
+},
+"redirectAction": {
+"$ref": "GoogleCloudDiscoveryengineV1ControlRedirectAction",
+"description": "Defines a redirect-type control."
+},
+"solutionType": {
+"description": "Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.",
+"enum": [
+"SOLUTION_TYPE_UNSPECIFIED",
+"SOLUTION_TYPE_RECOMMENDATION",
+"SOLUTION_TYPE_SEARCH",
+"SOLUTION_TYPE_CHAT",
+"SOLUTION_TYPE_GENERATIVE_CHAT"
+],
+"enumDescriptions": [
+"Default value.",
+"Used for Recommendations AI.",
+"Used for Discovery Search.",
+"Used for use cases related to the Generative AI agent.",
+"Used for use cases related to the Generative Chat agent. It's used for Generative chat engine only, the associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution."
+],
+"type": "string"
+},
+"synonymsAction": {
+"$ref": "GoogleCloudDiscoveryengineV1ControlSynonymsAction",
+"description": "Treats a group of terms as synonyms of one another."
+},
+"useCases": {
+"description": "Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.",
+"items": {
+"enum": [
+"SEARCH_USE_CASE_UNSPECIFIED",
+"SEARCH_USE_CASE_SEARCH",
+"SEARCH_USE_CASE_BROWSE"
+],
+"enumDescriptions": [
+"Value used when unset. Will not occur in CSS.",
+"Search use case. Expects the traffic has a non-empty query.",
+"Browse use case. Expects the traffic has an empty query."
+],
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ControlBoostAction": {
+"description": "Adjusts order of products in returned list.",
+"id": "GoogleCloudDiscoveryengineV1ControlBoostAction",
+"properties": {
+"boost": {
+"description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).",
+"format": "float",
+"type": "number"
+},
+"dataStore": {
+"description": "Required. Specifies which data store's documents can be boosted by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store",
+"type": "string"
+},
+"filter": {
+"description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ControlFilterAction": {
+"description": "Specified which products may be included in results. Uses same filter as boost.",
+"id": "GoogleCloudDiscoveryengineV1ControlFilterAction",
+"properties": {
+"dataStore": {
+"description": "Required. Specifies which data store's documents can be filtered by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store",
+"type": "string"
+},
+"filter": {
+"description": "Required. A filter to apply on the matching condition results. Required Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ControlRedirectAction": {
+"description": "Redirects a shopper to the provided URI.",
+"id": "GoogleCloudDiscoveryengineV1ControlRedirectAction",
+"properties": {
+"redirectUri": {
+"description": "Required. The URI to which the shopper will be redirected. Required. URI must have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
 "type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1BatchCreateTargetSitesResponse": {
-"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
-"id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSitesResponse",
+"GoogleCloudDiscoveryengineV1ControlSynonymsAction": {
+"description": "Creates a set of terms that will act as synonyms of one another. Example: \"happy\" will also be considered as \"glad\", \"glad\" will also be considered as \"happy\".",
+"id": "GoogleCloudDiscoveryengineV1ControlSynonymsAction",
 "properties": {
-"targetSites": {
-"description": "TargetSites created.",
+"synonyms": {
+"description": "Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown.",
 "items": {
-"$ref": "GoogleCloudDiscoveryengineV1TargetSite"
+"type": "string"
 },
 "type": "array"
 }
@@ -5847,6 +6613,10 @@
 "description": "A singleton resource of DataStore. It's empty when DataStore is created, which defaults to digital parser. The first call to DataStoreService.UpdateDocumentProcessingConfig method will initialize the config.",
 "id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfig",
 "properties": {
+"chunkingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigChunkingConfig",
+"description": "Whether chunking mode is enabled."
+},
 "defaultParsingConfig": {
 "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig",
 "description": "Configurations for default Document parser. If not specified, we will configure it as default DigitalParsingConfig, and the default parsing config will be applied to all file types for Document parsing."
@@ -5865,6 +6635,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1DocumentProcessingConfigChunkingConfig": {
+"description": "Configuration for chunking config.",
+"id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigChunkingConfig",
+"properties": {
+"layoutBasedChunkingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigChunkingConfigLayoutBasedChunkingConfig",
+"description": "Configuration for the layout based chunking."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1DocumentProcessingConfigChunkingConfigLayoutBasedChunkingConfig": {
+"description": "Configuration for the layout based chunking.",
+"id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigChunkingConfigLayoutBasedChunkingConfig",
+"properties": {
+"chunkSize": {
+"description": "The token size limit for each chunk. Supported values: 100-500 (inclusive). Default value: 500.",
+"format": "int32",
+"type": "integer"
+},
+"includeAncestorHeadings": {
+"description": "Whether to include appending different levels of headings to chunks from the middle of the document to prevent context loss. Default value: False.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig": {
 "description": "Related configurations applied to a specific type of document parser.",
 "id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig",
@@ -5873,6 +6670,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigDigitalParsingConfig",
 "description": "Configurations applied to digital parser."
 },
+"layoutParsingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig",
+"description": "Configurations applied to layout parser."
+},
 "ocrParsingConfig": {
 "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigOcrParsingConfig",
 "description": "Configurations applied to OCR parser. Currently it only applies to PDFs."
@@ -5886,6 +6687,12 @@
 "properties": {},
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig": {
+"description": "The layout parsing configurations for documents.",
+"id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig",
+"properties": {},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigOcrParsingConfig": {
 "description": "The OCR parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigOcrParsingConfig",
@@ -6067,7 +6874,7 @@
 "id": "GoogleCloudDiscoveryengineV1EngineCommonConfig",
 "properties": {
 "companyName": {
-"description": "Immutable. The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features.",
+"description": "The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features.",
 "type": "string"
 }
 },
@@ -6266,6 +7073,85 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1Project": {
+"description": "Metadata and configurations for a Google Cloud project in the service.",
+"id": "GoogleCloudDiscoveryengineV1Project",
+"properties": {
+"createTime": {
+"description": "Output only. The timestamp when this project is created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"readOnly": true,
+"type": "string"
+},
+"provisionCompletionTime": {
+"description": "Output only. The timestamp when this project is successfully provisioned. Empty value means this project is still provisioning and is not ready for use.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"serviceTermsMap": {
+"additionalProperties": {
+"$ref": "GoogleCloudDiscoveryengineV1ProjectServiceTerms"
+},
+"description": "Output only. A map of terms of services. The key is the `id` of ServiceTerms.",
+"readOnly": true,
+"type": "object"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ProjectServiceTerms": {
+"description": "Metadata about the terms of service.",
+"id": "GoogleCloudDiscoveryengineV1ProjectServiceTerms",
+"properties": {
+"acceptTime": {
+"description": "The last time when the project agreed to the terms of service.",
+"format": "google-datetime",
+"type": "string"
+},
+"declineTime": {
+"description": "The last time when the project declined or revoked the agreement to terms of service.",
+"format": "google-datetime",
+"type": "string"
+},
+"id": {
+"description": "The unique identifier of this terms of service. Available terms: * `GA_DATA_USE_TERMS`: [Terms for data use](https://cloud.google.com/retail/data-use-terms). When using this as `id`, the acceptable version to provide is `2022-11-23`.",
+"type": "string"
+},
+"state": {
+"description": "Whether the project has accepted/rejected the service terms or it is still pending.",
+"enum": [
+"STATE_UNSPECIFIED",
+"TERMS_ACCEPTED",
+"TERMS_PENDING",
+"TERMS_DECLINED"
+],
+"enumDescriptions": [
+"The default value of the enum. This value is not actually used.",
+"The project has given consent to the terms of service.",
+"The project is pending to review and accept the terms of service.",
+"The project has declined or revoked the agreement to terms of service."
+],
+"type": "string"
+},
+"version": {
+"description": "The version string of the terms of service. For acceptable values, see the comments for id above.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ProvisionProjectMetadata": {
+"description": "Metadata associated with a project provision operation.",
+"id": "GoogleCloudDiscoveryengineV1ProvisionProjectMetadata",
+"properties": {},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata": {
 "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata",
@@ -6776,6 +7662,14 @@
 "description": "Page identifier.",
 "type": "string"
 },
+"structData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result.",
+"type": "object"
+},
 "title": {
 "description": "Title.",
 "type": "string"
@@ -6802,6 +7696,14 @@
 "description": "Document resource name.",
 "type": "string"
 },
+"structData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result.",
+"type": "object"
+},
 "title": {
 "description": "Title.",
 "type": "string"
@@ -6990,14 +7892,208 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse": {
-"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
-"id": "GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse",
+"GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse": {
+"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
+"id": "GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse",
+"properties": {
+"targetSites": {
+"description": "TargetSites created.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaTargetSite"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaCondition": {
+"description": "Defines circumstances to be checked before allowing a behavior",
+"id": "GoogleCloudDiscoveryengineV1alphaCondition",
+"properties": {
+"activeTimeRange": {
+"description": "Range of time(s) specifying when condition is active. Maximum of 10 time ranges.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaConditionTimeRange"
+},
+"type": "array"
+},
+"queryTerms": {
+"description": "Search only A list of terms to match the query on. Maximum of 10 query terms.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaConditionQueryTerm"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaConditionQueryTerm": {
+"description": "Matcher for search request query",
+"id": "GoogleCloudDiscoveryengineV1alphaConditionQueryTerm",
+"properties": {
+"fullMatch": {
+"description": "Whether the search query needs to exactly match the query term.",
+"type": "boolean"
+},
+"value": {
+"description": "The specific query value to match against Must be lowercase, must be UTF-8. Can have at most 3 space separated terms if full_match is true. Cannot be an empty string. Maximum length of 5000 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaConditionTimeRange": {
+"description": "Used for time-dependent conditions.",
+"id": "GoogleCloudDiscoveryengineV1alphaConditionTimeRange",
+"properties": {
+"endTime": {
+"description": "End of time range. Range is inclusive. Must be in the future.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Start of time range. Range is inclusive.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaControl": {
+"description": "Defines a conditioned behavior to employ during serving. Must be attached to a ServingConfig to be considered at serving time. Permitted actions dependent on `SolutionType`.",
+"id": "GoogleCloudDiscoveryengineV1alphaControl",
+"properties": {
+"associatedServingConfigIds": {
+"description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"boostAction": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControlBoostAction",
+"description": "Defines a boost-type control"
+},
+"conditions": {
+"description": "Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaCondition"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+},
+"filterAction": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControlFilterAction",
+"description": "Defines a filter-type control Currently not supported by Recommendation"
+},
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
+"type": "string"
+},
+"redirectAction": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControlRedirectAction",
+"description": "Defines a redirect-type control."
+},
+"solutionType": {
+"description": "Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.",
+"enum": [
+"SOLUTION_TYPE_UNSPECIFIED",
+"SOLUTION_TYPE_RECOMMENDATION",
+"SOLUTION_TYPE_SEARCH",
+"SOLUTION_TYPE_CHAT",
+"SOLUTION_TYPE_GENERATIVE_CHAT"
+],
+"enumDescriptions": [
+"Default value.",
+"Used for Recommendations AI.",
+"Used for Discovery Search.",
+"Used for use cases related to the Generative AI agent.",
+"Used for use cases related to the Generative Chat agent. It's used for Generative chat engine only, the associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution."
+],
+"type": "string"
+},
+"synonymsAction": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControlSynonymsAction",
+"description": "Treats a group of terms as synonyms of one another."
+},
+"useCases": {
+"description": "Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.",
+"items": {
+"enum": [
+"SEARCH_USE_CASE_UNSPECIFIED",
+"SEARCH_USE_CASE_SEARCH",
+"SEARCH_USE_CASE_BROWSE"
+],
+"enumDescriptions": [
+"Value used when unset. Will not occur in CSS.",
+"Search use case. Expects the traffic has a non-empty query.",
+"Browse use case. Expects the traffic has an empty query."
+],
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaControlBoostAction": {
+"description": "Adjusts order of products in returned list.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlBoostAction",
+"properties": {
+"boost": {
+"description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).",
+"format": "float",
+"type": "number"
+},
+"dataStore": {
+"description": "Required. Specifies which data store's documents can be boosted by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store",
+"type": "string"
+},
+"filter": {
+"description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaControlFilterAction": {
+"description": "Specified which products may be included in results. Uses same filter as boost.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlFilterAction",
+"properties": {
+"dataStore": {
+"description": "Required. Specifies which data store's documents can be filtered by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store",
+"type": "string"
+},
+"filter": {
+"description": "Required. A filter to apply on the matching condition results. Required Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaControlRedirectAction": {
+"description": "Redirects a shopper to the provided URI.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlRedirectAction",
+"properties": {
+"redirectUri": {
+"description": "Required. The URI to which the shopper will be redirected. Required. URI must have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaControlSynonymsAction": {
+"description": "Creates a set of terms that will act as synonyms of one another. Example: \"happy\" will also be considered as \"glad\", \"glad\" will also be considered as \"happy\".",
+"id": "GoogleCloudDiscoveryengineV1alphaControlSynonymsAction",
 "properties": {
-"targetSites": {
-"description": "TargetSites created.",
+"synonyms": {
+"description": "Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown.",
 "items": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaTargetSite"
+"type": "string"
 },
 "type": "array"
 }
@@ -7096,7 +8192,7 @@
 "TRAINING_FAILED"
 ],
 "enumDescriptions": [
-"",
+"Default value.",
 "The model is in a paused training state.",
 "The model is currently training.",
 "The model has successfully completed training.",
@@ -7106,6 +8202,7 @@
 "type": "string"
 },
 "modelVersion": {
+"description": "The version of the model.",
 "format": "int64",
 "type": "string"
 },
@@ -7586,7 +8683,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaEngineCommonConfig",
 "properties": {
 "companyName": {
-"description": "Immutable. The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features.",
+"description": "The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features.",
 "type": "string"
 }
 },
@@ -7772,12 +8869,14 @@
 "enum": [
 "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED",
 "METATAGS",
-"PAGEMAP"
+"PAGEMAP",
+"SCHEMA_ORG"
 ],
 "enumDescriptions": [
 "Value used when unset.",
 "Retrieve value from meta tag.",
-"Retrieve value from page map."
+"Retrieve value from page map.",
+"Retrieve value from schema.org data."
 ],
 "type": "string"
 },
@@ -7887,6 +8986,13 @@
 ],
 "type": "string"
 },
+"schemaOrgPaths": {
+"description": "Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchableOption": {
 "description": "If searchable_option is SEARCHABLE_ENABLED, field values are searchable by text queries in SearchService.Search. If SEARCHABLE_ENABLED but field type is numerical, field values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical fields. If searchable_option is unset, the server behavior defaults to SEARCHABLE_DISABLED for fields that support setting searchable options. Only `string` fields that have no key property mapping support setting searchable_option. For those fields that do not support setting searchable options, the server will skip searchable option setting, and setting searchable_option for those fields will throw `INVALID_ARGUMENT` error.",
 "enum": [
@@ -8763,6 +9869,37 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaAlloyDbSource": {
+"description": "AlloyDB source import data from.",
+"id": "GoogleCloudDiscoveryengineV1betaAlloyDbSource",
+"properties": {
+"clusterId": {
+"description": "Required. The AlloyDB cluster to copy the data from with a length limit of 256 characters.",
+"type": "string"
+},
+"databaseId": {
+"description": "Required. The AlloyDB database to copy the data from with a length limit of 256 characters.",
+"type": "string"
+},
+"gcsStagingDir": {
+"description": "Intermediate Cloud Storage directory used for the import with a length limit of 2,000 characters. Can be specified if one wants to have the AlloyDB export to a specific Cloud Storage directory. Ensure that the AlloyDB service account has the necessary Cloud Storage Admin permissions to access the specified Cloud Storage directory.",
+"type": "string"
+},
+"locationId": {
+"description": "Required. The AlloyDB location to copy the data from with a length limit of 256 characters.",
+"type": "string"
+},
+"projectId": {
+"description": "The project ID that the AlloyDB source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.",
+"type": "string"
+},
+"tableId": {
+"description": "Required. The AlloyDB table to copy the data from with a length limit of 256 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaAnswer": {
 "description": "Defines an answer.",
 "id": "GoogleCloudDiscoveryengineV1betaAnswer",
@@ -8930,6 +10067,13 @@
 "description": "The session resource name. Not required. When session field is not set, the API is in sessionless mode. We support auto session mode: users can use the wildcard symbol `-` as session ID. A new ID will be automatically generated and assigned.",
 "type": "string"
 },
+"userLabels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "The user labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. See [Google Cloud Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) for more details.",
+"type": "object"
+},
 "userPseudoId": {
 "description": "A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "type": "string"
@@ -8949,6 +10093,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreLowRelevantContent": {
+"description": "Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.",
+"type": "boolean"
+},
 "ignoreNonAnswerSeekingQuery": {
 "description": "Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.",
 "type": "boolean"
@@ -9090,6 +10238,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec",
 "description": "Boost specification to boost certain documents in search results which may affect the answer query response. For more information on boosting, see [Boosting](https://cloud.google.com/retail/docs/boosting#boost)"
 },
+"dataStoreSpecs": {
+"description": "Specs defining dataStores to filter on in a search call and configurations for those dataStores. This is only considered for engines with multiple dataStores use case. For single dataStore within an engine, they should use the specs at the top level.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec"
+},
+"type": "array"
+},
 "filter": {
 "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. This will be used to filter search results which may affect the Answer response. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customers might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY(\"king kong\")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
 "type": "string"
@@ -9102,6 +10257,20 @@
 "orderBy": {
 "description": "The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering, see [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order) If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.",
 "type": "string"
+},
+"searchResultMode": {
+"description": "Specifies the search result mode. If unspecified, the search result mode is based on DataStore.DocumentProcessingConfig.chunking_config: * If DataStore.DocumentProcessingConfig.chunking_config is specified, it defaults to `CHUNKS`. * Otherwise, it defaults to `DOCUMENTS`. See [parse and chunk documents](https://cloud.google.com/generative-ai-app-builder/docs/parse-chunk-documents)",
+"enum": [
+"SEARCH_RESULT_MODE_UNSPECIFIED",
+"DOCUMENTS",
+"CHUNKS"
+],
+"enumDescriptions": [
+"Default value.",
+"Returns documents in the search result.",
+"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+],
+"type": "string"
 }
 },
 "type": "object"
@@ -9344,6 +10513,14 @@
 "description": "Page identifier.",
 "type": "string"
 },
+"structData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result.",
+"type": "object"
+},
 "title": {
 "description": "Title.",
 "type": "string"
@@ -9370,6 +10547,14 @@
 "description": "Document resource name.",
 "type": "string"
 },
+"structData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result.",
+"type": "object"
+},
 "title": {
 "description": "Title.",
 "type": "string"
@@ -9874,85 +11059,387 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaChunk": {
+"description": "Chunk captures all raw metadata information of items to be recommended or searched in the chunk mode.",
+"id": "GoogleCloudDiscoveryengineV1betaChunk",
+"properties": {
+"chunkMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1betaChunkChunkMetadata",
+"description": "Output only. Metadata of the current chunk.",
+"readOnly": true
+},
+"content": {
+"description": "Content is a string from a document (parsed content).",
+"type": "string"
+},
+"derivedStructData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Output only. This field is OUTPUT_ONLY. It contains derived data that are not in the original input document.",
+"readOnly": true,
+"type": "object"
+},
+"documentMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1betaChunkDocumentMetadata",
+"description": "Metadata of the document from the current chunk."
+},
+"id": {
+"description": "Unique chunk ID of the current chunk.",
+"type": "string"
+},
+"name": {
+"description": "The full resource name of the chunk. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document_id}/chunks/{chunk_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+},
+"pageSpan": {
+"$ref": "GoogleCloudDiscoveryengineV1betaChunkPageSpan",
+"description": "Page span of the chunk."
+},
+"relevanceScore": {
+"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse.",
+"format": "double",
+"readOnly": true,
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaChunkChunkMetadata": {
+"description": "Metadata of the current chunk. This field is only populated on SearchService.Search API.",
+"id": "GoogleCloudDiscoveryengineV1betaChunkChunkMetadata",
+"properties": {
+"nextChunks": {
+"description": "The next chunks of the current chunk. The number is controlled by SearchRequest.ContentSearchSpec.ChunkSpec.num_next_chunks. This field is only populated on SearchService.Search API.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaChunk"
+},
+"type": "array"
+},
+"previousChunks": {
+"description": "The previous chunks of the current chunk. The number is controlled by SearchRequest.ContentSearchSpec.ChunkSpec.num_previous_chunks. This field is only populated on SearchService.Search API.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaChunk"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaChunkDocumentMetadata": {
+"description": "Document metadata contains the information of the document of the current chunk.",
+"id": "GoogleCloudDiscoveryengineV1betaChunkDocumentMetadata",
+"properties": {
+"structData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown.",
+"type": "object"
+},
+"title": {
+"description": "Title of the document.",
+"type": "string"
+},
+"uri": {
+"description": "Uri of the document.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaChunkPageSpan": {
+"description": "Page span of the chunk.",
+"id": "GoogleCloudDiscoveryengineV1betaChunkPageSpan",
+"properties": {
+"pageEnd": {
+"description": "The end page of the chunk.",
+"format": "int32",
+"type": "integer"
+},
+"pageStart": {
+"description": "The start page of the chunk.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaCloudSqlSource": {
 "description": "Cloud SQL source import data from.",
 "id": "GoogleCloudDiscoveryengineV1betaCloudSqlSource",
 "properties": {
-"databaseId": {
-"description": "Required. The Cloud SQL database to copy the data from with a length limit of 256 characters.",
+"databaseId": {
+"description": "Required. The Cloud SQL database to copy the data from with a length limit of 256 characters.",
+"type": "string"
+},
+"gcsStagingDir": {
+"description": "Intermediate Cloud Storage directory used for the import with a length limit of 2,000 characters. Can be specified if one wants to have the Cloud SQL export to a specific Cloud Storage directory. Ensure that the Cloud SQL service account has the necessary Cloud Storage Admin permissions to access the specified Cloud Storage directory.",
+"type": "string"
+},
+"instanceId": {
+"description": "Required. The Cloud SQL instance to copy the data from with a length limit of 256 characters.",
+"type": "string"
+},
+"offload": {
+"description": "Option for serverless export. Enabling this option will incur additional cost. More info can be found [here](https://cloud.google.com/sql/pricing#serverless).",
+"type": "boolean"
+},
+"projectId": {
+"description": "The project ID that the Cloud SQL source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.",
+"type": "string"
+},
+"tableId": {
+"description": "Required. The Cloud SQL table to copy the data from with a length limit of 256 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaCompleteQueryResponse": {
+"description": "Response message for CompletionService.CompleteQuery method.",
+"id": "GoogleCloudDiscoveryengineV1betaCompleteQueryResponse",
+"properties": {
+"querySuggestions": {
+"description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaCompleteQueryResponseQuerySuggestion"
+},
+"type": "array"
+},
+"tailMatchTriggered": {
+"description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaCompleteQueryResponseQuerySuggestion": {
+"description": "Suggestions as search queries.",
+"id": "GoogleCloudDiscoveryengineV1betaCompleteQueryResponseQuerySuggestion",
+"properties": {
+"completableFieldPaths": {
+"description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"suggestion": {
+"description": "The suggestion for the query.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaCompletionInfo": {
+"description": "Detailed completion information including completion attribution token and clicked completion info.",
+"id": "GoogleCloudDiscoveryengineV1betaCompletionInfo",
+"properties": {
+"selectedPosition": {
+"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0.",
+"format": "int32",
+"type": "integer"
+},
+"selectedSuggestion": {
+"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaCondition": {
+"description": "Defines circumstances to be checked before allowing a behavior",
+"id": "GoogleCloudDiscoveryengineV1betaCondition",
+"properties": {
+"activeTimeRange": {
+"description": "Range of time(s) specifying when condition is active. Maximum of 10 time ranges.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConditionTimeRange"
+},
+"type": "array"
+},
+"queryTerms": {
+"description": "Search only A list of terms to match the query on. Maximum of 10 query terms.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaConditionQueryTerm"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaConditionQueryTerm": {
+"description": "Matcher for search request query",
+"id": "GoogleCloudDiscoveryengineV1betaConditionQueryTerm",
+"properties": {
+"fullMatch": {
+"description": "Whether the search query needs to exactly match the query term.",
+"type": "boolean"
+},
+"value": {
+"description": "The specific query value to match against Must be lowercase, must be UTF-8. Can have at most 3 space separated terms if full_match is true. Cannot be an empty string. Maximum length of 5000 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaConditionTimeRange": {
+"description": "Used for time-dependent conditions.",
+"id": "GoogleCloudDiscoveryengineV1betaConditionTimeRange",
+"properties": {
+"endTime": {
+"description": "End of time range. Range is inclusive. Must be in the future.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Start of time range. Range is inclusive.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaControl": {
+"description": "Defines a conditioned behavior to employ during serving. Must be attached to a ServingConfig to be considered at serving time. Permitted actions dependent on `SolutionType`.",
+"id": "GoogleCloudDiscoveryengineV1betaControl",
+"properties": {
+"associatedServingConfigIds": {
+"description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.",
+"items": {
 "type": "string"
 },
-"gcsStagingDir": {
-"description": "Intermediate Cloud Storage directory used for the import with a length limit of 2,000 characters. Can be specified if one wants to have the Cloud SQL export to a specific Cloud Storage directory. Ensure that the Cloud SQL service account has the necessary Cloud Storage Admin permissions to access the specified Cloud Storage directory.",
+"readOnly": true,
+"type": "array"
+},
+"boostAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlBoostAction",
+"description": "Defines a boost-type control"
+},
+"conditions": {
+"description": "Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaCondition"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.",
 "type": "string"
 },
-"instanceId": {
-"description": "Required. The Cloud SQL instance to copy the data from with a length limit of 256 characters.",
+"filterAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlFilterAction",
+"description": "Defines a filter-type control Currently not supported by Recommendation"
+},
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
 "type": "string"
 },
-"offload": {
-"description": "Option for serverless export. Enabling this option will incur additional cost. More info can be found [here](https://cloud.google.com/sql/pricing#serverless).",
-"type": "boolean"
+"redirectAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
+"description": "Defines a redirect-type control."
 },
-"projectId": {
-"description": "The project ID that the Cloud SQL source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.",
+"solutionType": {
+"description": "Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.",
+"enum": [
+"SOLUTION_TYPE_UNSPECIFIED",
+"SOLUTION_TYPE_RECOMMENDATION",
+"SOLUTION_TYPE_SEARCH",
+"SOLUTION_TYPE_CHAT",
+"SOLUTION_TYPE_GENERATIVE_CHAT"
+],
+"enumDescriptions": [
+"Default value.",
+"Used for Recommendations AI.",
+"Used for Discovery Search.",
+"Used for use cases related to the Generative AI agent.",
+"Used for use cases related to the Generative Chat agent. It's used for Generative chat engine only, the associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution."
+],
 "type": "string"
 },
-"tableId": {
-"description": "Required. The Cloud SQL table to copy the data from with a length limit of 256 characters.",
+"synonymsAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlSynonymsAction",
+"description": "Treats a group of terms as synonyms of one another."
+},
+"useCases": {
+"description": "Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.",
+"items": {
+"enum": [
+"SEARCH_USE_CASE_UNSPECIFIED",
+"SEARCH_USE_CASE_SEARCH",
+"SEARCH_USE_CASE_BROWSE"
+],
+"enumDescriptions": [
+"Value used when unset. Will not occur in CSS.",
+"Search use case. Expects the traffic has a non-empty query.",
+"Browse use case. Expects the traffic has an empty query."
+],
 "type": "string"
+},
+"type": "array"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1betaCompleteQueryResponse": {
-"description": "Response message for CompletionService.CompleteQuery method.",
-"id": "GoogleCloudDiscoveryengineV1betaCompleteQueryResponse",
+"GoogleCloudDiscoveryengineV1betaControlBoostAction": {
+"description": "Adjusts order of products in returned list.",
+"id": "GoogleCloudDiscoveryengineV1betaControlBoostAction",
 "properties": {
-"querySuggestions": {
-"description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.",
-"items": {
-"$ref": "GoogleCloudDiscoveryengineV1betaCompleteQueryResponseQuerySuggestion"
+"boost": {
+"description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).",
+"format": "float",
+"type": "number"
 },
-"type": "array"
+"dataStore": {
+"description": "Required. Specifies which data store's documents can be boosted by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store",
+"type": "string"
 },
-"tailMatchTriggered": {
-"description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.",
-"type": "boolean"
+"filter": {
+"description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1betaCompleteQueryResponseQuerySuggestion": {
-"description": "Suggestions as search queries.",
-"id": "GoogleCloudDiscoveryengineV1betaCompleteQueryResponseQuerySuggestion",
+"GoogleCloudDiscoveryengineV1betaControlFilterAction": {
+"description": "Specified which products may be included in results. Uses same filter as boost.",
+"id": "GoogleCloudDiscoveryengineV1betaControlFilterAction",
 "properties": {
-"completableFieldPaths": {
-"description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.",
-"items": {
+"dataStore": {
+"description": "Required. Specifies which data store's documents can be filtered by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store",
 "type": "string"
 },
-"type": "array"
-},
-"suggestion": {
-"description": "The suggestion for the query.",
+"filter": {
+"description": "Required. A filter to apply on the matching condition results. Required Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
 "type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1betaCompletionInfo": {
-"description": "Detailed completion information including completion attribution token and clicked completion info.",
-"id": "GoogleCloudDiscoveryengineV1betaCompletionInfo",
+"GoogleCloudDiscoveryengineV1betaControlRedirectAction": {
+"description": "Redirects a shopper to the provided URI.",
+"id": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
 "properties": {
-"selectedPosition": {
-"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0.",
-"format": "int32",
-"type": "integer"
+"redirectUri": {
+"description": "Required. The URI to which the shopper will be redirected. Required. URI must have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT error is thrown.",
+"type": "string"
+}
 },
-"selectedSuggestion": {
-"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion.",
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaControlSynonymsAction": {
+"description": "Creates a set of terms that will act as synonyms of one another. Example: \"happy\" will also be considered as \"glad\", \"glad\" will also be considered as \"happy\".",
+"id": "GoogleCloudDiscoveryengineV1betaControlSynonymsAction",
+"properties": {
+"synonyms": {
+"description": "Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown.",
+"items": {
 "type": "string"
+},
+"type": "array"
 }
 },
 "type": "object"
@@ -10244,7 +11731,7 @@
 "TRAINING_FAILED"
 ],
 "enumDescriptions": [
-"",
+"Default value.",
 "The model is in a paused training state.",
 "The model is currently training.",
 "The model has successfully completed training.",
@@ -10254,6 +11741,7 @@
 "type": "string"
 },
 "modelVersion": {
+"description": "The version of the model.",
 "format": "int64",
 "type": "string"
 },
@@ -10562,6 +12050,10 @@
 "description": "A singleton resource of DataStore. It's empty when DataStore is created, which defaults to digital parser. The first call to DataStoreService.UpdateDocumentProcessingConfig method will initialize the config.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfig",
 "properties": {
+"chunkingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigChunkingConfig",
+"description": "Whether chunking mode is enabled."
+},
 "defaultParsingConfig": {
 "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig",
 "description": "Configurations for default Document parser. If not specified, we will configure it as default DigitalParsingConfig, and the default parsing config will be applied to all file types for Document parsing."
@@ -10580,6 +12072,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigChunkingConfig": {
+"description": "Configuration for chunking config.",
+"id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigChunkingConfig",
+"properties": {
+"layoutBasedChunkingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigChunkingConfigLayoutBasedChunkingConfig",
+"description": "Configuration for the layout based chunking."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigChunkingConfigLayoutBasedChunkingConfig": {
+"description": "Configuration for the layout based chunking.",
+"id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigChunkingConfigLayoutBasedChunkingConfig",
+"properties": {
+"chunkSize": {
+"description": "The token size limit for each chunk. Supported values: 100-500 (inclusive). Default value: 500.",
+"format": "int32",
+"type": "integer"
+},
+"includeAncestorHeadings": {
+"description": "Whether to include appending different levels of headings to chunks from the middle of the document to prevent context loss. Default value: False.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig": {
 "description": "Related configurations applied to a specific type of document parser.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig",
@@ -10588,6 +12107,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigDigitalParsingConfig",
 "description": "Configurations applied to digital parser."
 },
+"layoutParsingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
+"description": "Configurations applied to layout parser."
+},
 "ocrParsingConfig": {
 "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigOcrParsingConfig",
 "description": "Configurations applied to OCR parser. Currently it only applies to PDFs."
@@ -10601,6 +12124,12 @@
 "properties": {},
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig": {
+"description": "The layout parsing configurations for documents.",
+"id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
+"properties": {},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigOcrParsingConfig": {
 "description": "The OCR parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigOcrParsingConfig",
@@ -10814,7 +12343,7 @@
 "id": "GoogleCloudDiscoveryengineV1betaEngineCommonConfig",
 "properties": {
 "companyName": {
-"description": "Immutable. The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features.",
+"description": "The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features.",
 "type": "string"
 }
 },
@@ -11016,6 +12545,10 @@
 "description": "Request message for Import methods.",
 "id": "GoogleCloudDiscoveryengineV1betaImportDocumentsRequest",
 "properties": {
+"alloyDbSource": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAlloyDbSource",
+"description": "AlloyDB input source."
+},
 "autoGenerateIds": {
 "description": "Whether to automatically generate IDs for the documents if absent. If set to `true`, Document.ids are automatically generated based on the hash of the payload, where IDs may not be consistent during multiple imports. In which case ReconciliationMode.FULL is highly recommended to avoid duplicate contents. If unset or set to `false`, Document.ids have to be specified using id_field, otherwise, documents without IDs fail to be imported. Supported data sources: * GcsSource. GcsSource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * BigQuerySource. BigQuerySource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * SpannerSource. * CloudSqlSource. * FirestoreSource. * BigtableSource.",
 "type": "boolean"
@@ -11314,6 +12847,24 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaListControlsResponse": {
+"description": "Response for ListControls method.",
+"id": "GoogleCloudDiscoveryengineV1betaListControlsResponse",
+"properties": {
+"controls": {
+"description": "All the Controls for a given data store.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControl"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Pagination token, if not returned indicates the last page.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaListConversationsResponse": {
 "description": "Response for ListConversations method.",
 "id": "GoogleCloudDiscoveryengineV1betaListConversationsResponse",
@@ -11548,6 +13099,100 @@
 "properties": {},
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaProject": {
+"description": "Metadata and configurations for a Google Cloud project in the service.",
+"id": "GoogleCloudDiscoveryengineV1betaProject",
+"properties": {
+"createTime": {
+"description": "Output only. The timestamp when this project is created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"readOnly": true,
+"type": "string"
+},
+"provisionCompletionTime": {
+"description": "Output only. The timestamp when this project is successfully provisioned. Empty value means this project is still provisioning and is not ready for use.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"serviceTermsMap": {
+"additionalProperties": {
+"$ref": "GoogleCloudDiscoveryengineV1betaProjectServiceTerms"
+},
+"description": "Output only. A map of terms of services. The key is the `id` of ServiceTerms.",
+"readOnly": true,
+"type": "object"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaProjectServiceTerms": {
+"description": "Metadata about the terms of service.",
+"id": "GoogleCloudDiscoveryengineV1betaProjectServiceTerms",
+"properties": {
+"acceptTime": {
+"description": "The last time when the project agreed to the terms of service.",
+"format": "google-datetime",
+"type": "string"
+},
+"declineTime": {
+"description": "The last time when the project declined or revoked the agreement to terms of service.",
+"format": "google-datetime",
+"type": "string"
+},
+"id": {
+"description": "The unique identifier of this terms of service. Available terms: * `GA_DATA_USE_TERMS`: [Terms for data use](https://cloud.google.com/retail/data-use-terms). When using this as `id`, the acceptable version to provide is `2022-11-23`.",
+"type": "string"
+},
+"state": {
+"description": "Whether the project has accepted/rejected the service terms or it is still pending.",
+"enum": [
+"STATE_UNSPECIFIED",
+"TERMS_ACCEPTED",
+"TERMS_PENDING",
+"TERMS_DECLINED"
+],
+"enumDescriptions": [
+"The default value of the enum. This value is not actually used.",
+"The project has given consent to the terms of service.",
+"The project is pending to review and accept the terms of service.",
+"The project has declined or revoked the agreement to terms of service."
+],
+"type": "string"
+},
+"version": {
+"description": "The version string of the terms of service. For acceptable values, see the comments for id above.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaProvisionProjectMetadata": {
+"description": "Metadata associated with a project provision operation.",
+"id": "GoogleCloudDiscoveryengineV1betaProvisionProjectMetadata",
+"properties": {},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaProvisionProjectRequest": {
+"description": "Request for ProjectService.ProvisionProject method.",
+"id": "GoogleCloudDiscoveryengineV1betaProvisionProjectRequest",
+"properties": {
+"acceptDataUseTerms": {
+"description": "Required. Set to `true` to specify that caller has read and would like to give consent to the [Terms for data use](https://cloud.google.com/retail/data-use-terms).",
+"type": "boolean"
+},
+"dataUseTermsVersion": {
+"description": "Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata": {
 "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata",
@@ -11698,6 +13343,13 @@
 "description": "The number of results to return. If this is unset or no bigger than zero, returns all results.",
 "format": "int32",
 "type": "integer"
+},
+"userLabels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "The user labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. See [Google Cloud Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) for more details.",
+"type": "object"
 }
 },
 "type": "object"
@@ -12149,10 +13801,28 @@
 "description": "A specification for configuring the behavior of content search.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpec",
 "properties": {
+"chunkSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecChunkSpec",
+"description": "Specifies the chunk spec to be returned from the search response. Only available if the SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS"
+},
 "extractiveContentSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecExtractiveContentSpec",
 "description": "If there is no extractive_content_spec provided, there will be no extractive answer in the search response."
 },
+"searchResultMode": {
+"description": "Specifies the search result mode. If unspecified, the search result mode is based on DataStore.DocumentProcessingConfig.chunking_config: * If DataStore.DocumentProcessingConfig.chunking_config is specified, it defaults to `CHUNKS`. * Otherwise, it defaults to `DOCUMENTS`.",
+"enum": [
+"SEARCH_RESULT_MODE_UNSPECIFIED",
+"DOCUMENTS",
+"CHUNKS"
+],
+"enumDescriptions": [
+"Default value.",
+"Returns documents in the search result.",
+"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+],
+"type": "string"
+},
 "snippetSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSnippetSpec",
 "description": "If `snippetSpec` is not specified, snippets are not included in the search response."
@@ -12164,6 +13834,23 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecChunkSpec": {
+"description": "Specifies the chunk spec to be returned from the search response. Only available if the SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS",
+"id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecChunkSpec",
+"properties": {
+"numNextChunks": {
+"description": "The number of next chunks to be returned of the current chunk. The maximum allowed value is 3. If not specified, no next chunks will be returned.",
+"format": "int32",
+"type": "integer"
+},
+"numPreviousChunks": {
+"description": "The number of previous chunks to be returned of the current chunk. The maximum allowed value is 3. If not specified, no previous chunks will be returned.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecExtractiveContentSpec": {
 "description": "A specification for configuring the extractive content in a search response.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecExtractiveContentSpec",
@@ -12634,6 +14321,10 @@
 "description": "Represents the search results.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchResponseSearchResult",
 "properties": {
+"chunk": {
+"$ref": "GoogleCloudDiscoveryengineV1betaChunk",
+"description": "The chunk data in the search response if the SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS."
+},
 "document": {
 "$ref": "GoogleCloudDiscoveryengineV1betaDocument",
 "description": "The document data snippet in the search response. Only fields that are marked as `retrievable` are populated."
@@ -13468,6 +15159,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaCompletionInfo",
 "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
 },
+"dataStore": {
+"description": "The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted.",
+"type": "string"
+},
 "directUserRequest": {
 "description": "Should set to true if the request is made directly from the end user, in which case the UserEvent.user_info.user_agent can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent.",
 "type": "boolean"
@@ -13479,6 +15174,10 @@
 },
 "type": "array"
 },
+"engine": {
+"description": "The Engine resource name, in the form of `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. Optional. Only required for Engine produced user events. For example, user events from blended search.",
+"type": "string"
+},
 "eventTime": {
 "description": "Only required for UserEventService.ImportUserEvents method. Timestamp of when the user event happened.",
 "format": "google-datetime",