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

googleapiclient/discovery_cache/documents/discoveryengine.v1.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": "v1/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": "v1/{+name}:provision",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1ProvisionProjectRequest"
+},
+"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"
 },
@@ -742,6 +772,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": "v1/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}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"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": "v1/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": "v1/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1/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": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1/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}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ListControlsResponse"
+},
+"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": "v1/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": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "conversations": {
 "methods": {
 "converse": {
@@ -2201,6 +2393,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": "v1/{+parent}/userEvents:write",
@@ -2380,77 +2577,54 @@
 }
 },
 "resources": {
-"conversations": {
+"controls": {
 "methods": {
-"converse": {
-"description": "Converses a conversation.",
-"flatPath": "v1/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": "v1/{+name}:converse",
-"request": {
-"$ref": "GoogleCloudDiscoveryengineV1ConverseConversationRequest"
-},
-"response": {
-"$ref": "GoogleCloudDiscoveryengineV1ConverseConversationResponse"
-},
-"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": "v1/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": "v1/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}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1/{+parent}/conversations",
+"path": "v1/{+parent}/controls",
 "request": {
-"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+"$ref": "GoogleCloudDiscoveryengineV1Control"
 },
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+"$ref": "GoogleCloudDiscoveryengineV1Control"
 },
 "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": "v1/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": "v1/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"
 }
@@ -2464,94 +2638,89 @@
 ]
 },
 "get": {
-"description": "Gets a Conversation.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations/{conversationsId}",
+"description": "Gets a Control.",
+"flatPath": "v1/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": "v1/{+name}",
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+"$ref": "GoogleCloudDiscoveryengineV1Control"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
 "list": {
-"description": "Lists all Conversations by their parent DataStore.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/conversations",
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1/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}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1/{+parent}/conversations",
+"path": "v1/{+parent}/controls",
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1ListConversationsResponse"
+"$ref": "GoogleCloudDiscoveryengineV1ListControlsResponse"
 },
 "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": "v1/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": "v1/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"
@@ -2559,10 +2728,10 @@
 },
 "path": "v1/{+name}",
 "request": {
-"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+"$ref": "GoogleCloudDiscoveryengineV1Control"
 },
 "response": {
-"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+"$ref": "GoogleCloudDiscoveryengineV1Control"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
@@ -2570,40 +2739,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": "v1/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": "v1/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": "v1/{+name}",
+"path": "v1/{+name}:converse",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1ConverseConversationRequest"
+},
 "response": {
-"$ref": "GoogleLongrunningOperation"
+"$ref": "GoogleCloudDiscoveryengineV1ConverseConversationResponse"
 },
 "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": "v1/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": "v1/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": "v1/{+parent}/conversations",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+},
+"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": "v1/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": "v1/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Conversation.",
+"flatPath": "v1/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": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Conversations by their parent DataStore.",
+"flatPath": "v1/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": "v1/{+parent}/conversations",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ListConversationsResponse"
+},
+"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": "v1/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": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Conversation"
+},
+"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": "v1/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": "v1/{+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": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.operations.list",
+"parameterOrder": [
+"name"
 ],
 "parameters": {
 "filter": {
@@ -3165,7 +3524,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"
 },
@@ -3552,6 +3911,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": "v1/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}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"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": "v1/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": "v1/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1/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": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1/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}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ListControlsResponse"
+},
+"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": "v1/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": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "conversations": {
 "methods": {
 "converse": {
@@ -4733,6 +5254,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": "v1/{+parent}/userEvents:write",
@@ -4901,6 +5427,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": "v1/{+parent}/userEvents:write",
@@ -5019,7 +5550,7 @@
 }
 }
 },
-"revision": "20240517",
+"revision": "20240526",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -5354,6 +5885,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"
@@ -5490,6 +6025,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpec",
 "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": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec"
+},
+"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"
@@ -5744,6 +6286,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"
@@ -5770,6 +6320,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"
@@ -6357,6 +6915,200 @@
 },
 "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"
+},
+"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": {
+"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"
+},
 "GoogleCloudDiscoveryengineV1Conversation": {
 "description": "External conversation proto definition.",
 "id": "GoogleCloudDiscoveryengineV1Conversation",
@@ -7132,7 +7884,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"
 }
 },
@@ -7624,10 +8376,28 @@
 "format": "double",
 "type": "number"
 },
-"minimum": {
-"description": "Inclusive lower bound.",
-"format": "double",
-"type": "number"
+"minimum": {
+"description": "Inclusive lower bound.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ListControlsResponse": {
+"description": "Response for ListControls method.",
+"id": "GoogleCloudDiscoveryengineV1ListControlsResponse",
+"properties": {
+"controls": {
+"description": "All the Controls for a given data store.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1Control"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Pagination token, if not returned indicates the last page.",
+"type": "string"
 }
 },
 "type": "object"
@@ -7828,6 +8598,100 @@
 },
 "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"
+},
+"GoogleCloudDiscoveryengineV1ProvisionProjectRequest": {
+"description": "Request for ProjectService.ProvisionProject method.",
+"id": "GoogleCloudDiscoveryengineV1ProvisionProjectRequest",
+"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"
+},
 "GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata": {
 "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata",
@@ -7978,6 +8842,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"
@@ -9241,6 +10112,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1CompletionInfo",
 "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"
@@ -9252,6 +10127,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",
@@ -9565,6 +10444,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"
@@ -9591,6 +10478,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"
@@ -9724,69 +10619,263 @@
 "description": "Chunk resource name.",
 "type": "string"
 },
-"content": {
-"description": "Chunk textual content.",
+"content": {
+"description": "Chunk textual content.",
+"type": "string"
+},
+"relevanceScore": {
+"description": "Relevance score.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaAnswerStepActionObservationSearchResultSnippetInfo": {
+"description": "Snippet information.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerStepActionObservationSearchResultSnippetInfo",
+"properties": {
+"snippet": {
+"description": "Snippet content.",
+"type": "string"
+},
+"snippetStatus": {
+"description": "Status of the snippet defined by the search team.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaAnswerStepActionSearchAction": {
+"description": "Search action.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerStepActionSearchAction",
+"properties": {
+"query": {
+"description": "The query to search.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSiteMetadata": {
+"description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
+"id": "GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSiteMetadata",
+"properties": {
+"createTime": {
+"description": "Operation create time.",
+"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",
+"type": "string"
+}
+},
+"type": "object"
+},
+"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"
 },
-"relevanceScore": {
-"description": "Relevance score.",
-"format": "float",
-"type": "number"
+"type": "array"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1alphaAnswerStepActionObservationSearchResultSnippetInfo": {
-"description": "Snippet information.",
-"id": "GoogleCloudDiscoveryengineV1alphaAnswerStepActionObservationSearchResultSnippetInfo",
+"GoogleCloudDiscoveryengineV1alphaControlBoostAction": {
+"description": "Adjusts order of products in returned list.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlBoostAction",
 "properties": {
-"snippet": {
-"description": "Snippet content.",
+"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"
 },
-"snippetStatus": {
-"description": "Status of the snippet defined by the search team.",
+"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"
 },
-"GoogleCloudDiscoveryengineV1alphaAnswerStepActionSearchAction": {
-"description": "Search action.",
-"id": "GoogleCloudDiscoveryengineV1alphaAnswerStepActionSearchAction",
+"GoogleCloudDiscoveryengineV1alphaControlFilterAction": {
+"description": "Specified which products may be included in results. Uses same filter as boost.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlFilterAction",
 "properties": {
-"query": {
-"description": "The query to search.",
+"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"
 },
-"GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSiteMetadata": {
-"description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
-"id": "GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSiteMetadata",
+"GoogleCloudDiscoveryengineV1alphaControlRedirectAction": {
+"description": "Redirects a shopper to the provided URI.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlRedirectAction",
 "properties": {
-"createTime": {
-"description": "Operation create time.",
-"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",
+"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"
 },
-"GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse": {
-"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
-"id": "GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse",
+"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"
 }
@@ -9885,7 +10974,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.",
@@ -9895,6 +10984,7 @@
 "type": "string"
 },
 "modelVersion": {
+"description": "The version of the model.",
 "format": "int64",
 "type": "string"
 },
@@ -10375,7 +11465,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"
 }
 },
@@ -10561,12 +11651,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"
 },
@@ -10676,6 +11768,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": [
@@ -11583,6 +12682,200 @@
 },
 "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"
+},
+"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"
+},
+"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"
+},
+"redirectAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
+"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": "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"
+},
+"GoogleCloudDiscoveryengineV1betaControlBoostAction": {
+"description": "Adjusts order of products in returned list.",
+"id": "GoogleCloudDiscoveryengineV1betaControlBoostAction",
+"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"
+},
+"GoogleCloudDiscoveryengineV1betaControlFilterAction": {
+"description": "Specified which products may be included in results. Uses same filter as boost.",
+"id": "GoogleCloudDiscoveryengineV1betaControlFilterAction",
+"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"
+},
+"GoogleCloudDiscoveryengineV1betaControlRedirectAction": {
+"description": "Redirects a shopper to the provided URI.",
+"id": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
+"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"
+},
+"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"
+},
 "GoogleCloudDiscoveryengineV1betaCreateDataStoreMetadata": {
 "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1betaCreateDataStoreMetadata",
@@ -11675,7 +12968,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.",
@@ -11685,6 +12978,7 @@
 "type": "string"
 },
 "modelVersion": {
+"description": "The version of the model.",
 "format": "int64",
 "type": "string"
 },
@@ -12102,7 +13396,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"
 }
 },
@@ -12315,6 +13609,85 @@
 },
 "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"
+},
 "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata": {
 "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata",