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.v1alpha.json

@@ -546,7 +546,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"
 },
@@ -1117,6 +1117,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": "v1alpha/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": "v1alpha/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"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": "v1alpha/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": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1alpha/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": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1alpha/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": "v1alpha/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaListControlsResponse"
+},
+"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": "v1alpha/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": "v1alpha/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "conversations": {
 "methods": {
 "converse": {
@@ -2728,6 +2890,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": "v1alpha/{+parent}/userEvents:write",
@@ -2991,6 +3158,168 @@
 }
 },
 "resources": {
+"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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls",
+"httpMethod": "POST",
+"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_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": "v1alpha/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls/{controlsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/engines/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls/{controlsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/engines/[^/]+/controls/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/engines/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaListControlsResponse"
+},
+"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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/controls/{controlsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.controls.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/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": "v1alpha/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "conversations": {
 "methods": {
 "converse": {
@@ -3896,7 +4225,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"
 },
@@ -4439,11 +4768,173 @@
 }
 }
 },
-"conversations": {
+"controls": {
 "methods": {
-"converse": {
-"description": "Converses a conversation.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/conversations/{conversationsId}:converse",
+"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": "v1alpha/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": "v1alpha/{+parent}/controls",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"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": "v1alpha/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": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Control.",
+"flatPath": "v1alpha/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": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Controls by their parent DataStore.",
+"flatPath": "v1alpha/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": "v1alpha/{+parent}/controls",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaListControlsResponse"
+},
+"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": "v1alpha/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": "v1alpha/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
+"conversations": {
+"methods": {
+"converse": {
+"description": "Converses a conversation.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/conversations/{conversationsId}:converse",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.dataStores.conversations.converse",
 "parameterOrder": [
@@ -5743,6 +6234,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": "v1alpha/{+parent}/userEvents:write",
@@ -5927,6 +6423,38 @@
 }
 }
 },
+"requirements": {
+"methods": {
+"checkRequirement": {
+"description": "Check a particular requirement.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/requirements:checkRequirement",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.requirements.checkRequirement",
+"parameterOrder": [
+"location"
+],
+"parameters": {
+"location": {
+"description": "Required. Full resource name of the location. Format `projects/{project_number_or_id}/locations/{location}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+location}/requirements:checkRequirement",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaCheckRequirementRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaCheckRequirementResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "sampleQuerySets": {
 "resources": {
 "operations": {
@@ -5962,6 +6490,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": "v1alpha/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": "v1alpha/{+parent}/userEvents:collect",
+"response": {
+"$ref": "GoogleApiHttpBody"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -5977,6 +6546,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": "v1alpha/{+parent}/userEvents:write",
@@ -6067,71 +6641,257 @@
 }
 }
 },
-"revision": "20240517",
+"revision": "20240607",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
-"GoogleApiHttpBody": {
-"description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.",
-"id": "GoogleApiHttpBody",
+"GoogleApiDistribution": {
+"description": "`Distribution` contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets. The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` fields meaningless.",
+"id": "GoogleApiDistribution",
 "properties": {
-"contentType": {
-"description": "The HTTP Content-Type header value specifying the content type of the body.",
+"bucketCounts": {
+"description": "The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1).",
+"items": {
+"format": "int64",
 "type": "string"
 },
-"data": {
-"description": "The HTTP request/response body as raw binary.",
-"format": "byte",
+"type": "array"
+},
+"bucketOptions": {
+"$ref": "GoogleApiDistributionBucketOptions",
+"description": "Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field."
+},
+"count": {
+"description": "The number of values in the population. Must be non-negative. This value must equal the sum of the values in `bucket_counts` if a histogram is provided.",
+"format": "int64",
 "type": "string"
 },
-"extensions": {
-"description": "Application specific response metadata. Must be set in the first response for streaming APIs.",
+"exemplars": {
+"description": "Must be in increasing order of `value` field.",
 "items": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"type": "object"
+"$ref": "GoogleApiDistributionExemplar"
 },
 "type": "array"
+},
+"mean": {
+"description": "The arithmetic mean of the values in the population. If `count` is zero then this field must be zero.",
+"format": "double",
+"type": "number"
+},
+"range": {
+"$ref": "GoogleApiDistributionRange",
+"description": "If specified, contains the range of the population values. The field must not be present if the `count` is zero."
+},
+"sumOfSquaredDeviation": {
+"description": "The sum of squared deviations from the mean of the values in the population. For values x_i this is: Sum[i=1..n]((x_i - mean)^2) Knuth, \"The Art of Computer Programming\", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be zero.",
+"format": "double",
+"type": "number"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineLoggingErrorContext": {
-"description": "A description of the context in which an error occurred.",
-"id": "GoogleCloudDiscoveryengineLoggingErrorContext",
+"GoogleApiDistributionBucketOptions": {
+"description": "`BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.",
+"id": "GoogleApiDistributionBucketOptions",
 "properties": {
-"httpRequest": {
-"$ref": "GoogleCloudDiscoveryengineLoggingHttpRequestContext",
-"description": "The HTTP request which was processed when the error was triggered."
+"explicitBuckets": {
+"$ref": "GoogleApiDistributionBucketOptionsExplicit",
+"description": "The explicit buckets."
 },
-"reportLocation": {
-"$ref": "GoogleCloudDiscoveryengineLoggingSourceLocation",
-"description": "The location in the source code where the decision was made to report the error, usually the place where it was logged."
+"exponentialBuckets": {
+"$ref": "GoogleApiDistributionBucketOptionsExponential",
+"description": "The exponential buckets."
+},
+"linearBuckets": {
+"$ref": "GoogleApiDistributionBucketOptionsLinear",
+"description": "The linear bucket."
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineLoggingErrorLog": {
-"description": "An error log which is reported to the Error Reporting system.",
-"id": "GoogleCloudDiscoveryengineLoggingErrorLog",
+"GoogleApiDistributionBucketOptionsExplicit": {
+"description": "Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): bounds[i] Lower bound (1 <= i < N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets.",
+"id": "GoogleApiDistributionBucketOptionsExplicit",
 "properties": {
-"context": {
-"$ref": "GoogleCloudDiscoveryengineLoggingErrorContext",
-"description": "A description of the context in which the error occurred."
+"bounds": {
+"description": "The values must be monotonically increasing.",
+"items": {
+"format": "double",
+"type": "number"
 },
-"importPayload": {
-"$ref": "GoogleCloudDiscoveryengineLoggingImportErrorContext",
-"description": "The error payload that is populated on LRO import APIs."
+"type": "array"
+}
 },
-"message": {
-"description": "A message describing the error.",
-"type": "string"
+"type": "object"
 },
-"requestPayload": {
-"additionalProperties": {
-"description": "Properties of the object.",
-"type": "any"
+"GoogleApiDistributionBucketOptionsExponential": {
+"description": "Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).",
+"id": "GoogleApiDistributionBucketOptionsExponential",
+"properties": {
+"growthFactor": {
+"description": "Must be greater than 1.",
+"format": "double",
+"type": "number"
+},
+"numFiniteBuckets": {
+"description": "Must be greater than 0.",
+"format": "int32",
+"type": "integer"
+},
+"scale": {
+"description": "Must be greater than 0.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleApiDistributionBucketOptionsLinear": {
+"description": "Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)).",
+"id": "GoogleApiDistributionBucketOptionsLinear",
+"properties": {
+"numFiniteBuckets": {
+"description": "Must be greater than 0.",
+"format": "int32",
+"type": "integer"
+},
+"offset": {
+"description": "Lower bound of the first bucket.",
+"format": "double",
+"type": "number"
+},
+"width": {
+"description": "Must be greater than 0.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleApiDistributionExemplar": {
+"description": "Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that gives information about a particular value added to a Distribution bucket, such as a trace ID that was active when a value was added. They may contain further information, such as a example values and timestamps, origin, etc.",
+"id": "GoogleApiDistributionExemplar",
+"properties": {
+"attachments": {
+"description": "Contextual information about the example value. Examples are: Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given message type in a single exemplar, and this is enforced by the system.",
+"items": {
+"additionalProperties": {
+"description": "Properties of the object. Contains field @type with type URL.",
+"type": "any"
+},
+"type": "object"
+},
+"type": "array"
+},
+"timestamp": {
+"description": "The observation (sampling) time of the above value.",
+"format": "google-datetime",
+"type": "string"
+},
+"value": {
+"description": "Value of the exemplar point. This value determines to which bucket the exemplar belongs.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleApiDistributionRange": {
+"description": "The range of the population values.",
+"id": "GoogleApiDistributionRange",
+"properties": {
+"max": {
+"description": "The maximum of the population values.",
+"format": "double",
+"type": "number"
+},
+"min": {
+"description": "The minimum of the population values.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleApiHttpBody": {
+"description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.",
+"id": "GoogleApiHttpBody",
+"properties": {
+"contentType": {
+"description": "The HTTP Content-Type header value specifying the content type of the body.",
+"type": "string"
+},
+"data": {
+"description": "The HTTP request/response body as raw binary.",
+"format": "byte",
+"type": "string"
+},
+"extensions": {
+"description": "Application specific response metadata. Must be set in the first response for streaming APIs.",
+"items": {
+"additionalProperties": {
+"description": "Properties of the object. Contains field @type with type URL.",
+"type": "any"
+},
+"type": "object"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleApiMonitoredResource": {
+"description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}",
+"id": "GoogleApiMonitoredResource",
+"properties": {
+"labels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels `\"project_id\"`, `\"instance_id\"`, and `\"zone\"`.",
+"type": "object"
+},
+"type": {
+"description": "Required. The monitored resource type. This field must match the `type` field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. Some descriptors include the service name in the type; for example, the type of a Datastream stream is `datastream.googleapis.com/Stream`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineLoggingErrorContext": {
+"description": "A description of the context in which an error occurred.",
+"id": "GoogleCloudDiscoveryengineLoggingErrorContext",
+"properties": {
+"httpRequest": {
+"$ref": "GoogleCloudDiscoveryengineLoggingHttpRequestContext",
+"description": "The HTTP request which was processed when the error was triggered."
+},
+"reportLocation": {
+"$ref": "GoogleCloudDiscoveryengineLoggingSourceLocation",
+"description": "The location in the source code where the decision was made to report the error, usually the place where it was logged."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineLoggingErrorLog": {
+"description": "An error log which is reported to the Error Reporting system.",
+"id": "GoogleCloudDiscoveryengineLoggingErrorLog",
+"properties": {
+"context": {
+"$ref": "GoogleCloudDiscoveryengineLoggingErrorContext",
+"description": "A description of the context in which the error occurred."
+},
+"importPayload": {
+"$ref": "GoogleCloudDiscoveryengineLoggingImportErrorContext",
+"description": "The error payload that is populated on LRO import APIs."
+},
+"message": {
+"description": "A message describing the error.",
+"type": "string"
+},
+"requestPayload": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
 },
 "description": "The API request payload, represented as a protocol buffer. Most API request types are supported\u2014for example: * `type.googleapis.com/google.cloud.discoveryengine.v1alpha.DocumentService.CreateDocumentRequest` * `type.googleapis.com/google.cloud.discoveryengine.v1alpha.UserEventService.WriteUserEventRequest`",
 "type": "object"
@@ -6247,6 +7007,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"
+},
 "GoogleCloudDiscoveryengineV1CreateDataStoreMetadata": {
 "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1CreateDataStoreMetadata",
@@ -6497,6 +7451,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."
@@ -6515,6 +7473,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",
@@ -6523,6 +7508,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."
@@ -6536,6 +7525,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",
@@ -6717,7 +7712,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"
 }
 },
@@ -6896,26 +7891,105 @@
 "$ref": "GoogleCloudDiscoveryengineV1ImportErrorConfig",
 "description": "Echoes the destination for the complete errors if this field was set in the request."
 },
-"errorSamples": {
-"description": "A sample of errors encountered while processing the request.",
-"items": {
-"$ref": "GoogleRpcStatus"
+"errorSamples": {
+"description": "A sample of errors encountered while processing the request.",
+"items": {
+"$ref": "GoogleRpcStatus"
+},
+"type": "array"
+},
+"joinedEventsCount": {
+"description": "Count of user events imported with complete existing Documents.",
+"format": "int64",
+"type": "string"
+},
+"unjoinedEventsCount": {
+"description": "Count of user events imported, but with Document information not found in the existing Branch.",
+"format": "int64",
+"type": "string"
+}
+},
+"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"
 },
-"type": "array"
+"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"
 },
-"joinedEventsCount": {
-"description": "Count of user events imported with complete existing Documents.",
-"format": "int64",
+"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"
 },
-"unjoinedEventsCount": {
-"description": "Count of user events imported, but with Document information not found in the existing Branch.",
-"format": "int64",
+"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",
@@ -7205,6 +8279,37 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaAlloyDbSource": {
+"description": "AlloyDB source import data from.",
+"id": "GoogleCloudDiscoveryengineV1alphaAlloyDbSource",
+"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"
+},
 "GoogleCloudDiscoveryengineV1alphaAnswer": {
 "description": "Defines an answer.",
 "id": "GoogleCloudDiscoveryengineV1alphaAnswer",
@@ -7372,6 +8477,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"
@@ -7391,6 +8503,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"
@@ -7536,6 +8652,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaCustomFineTuningSpec",
 "description": "Custom fine tuning configs."
 },
+"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": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
+},
+"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"
@@ -7804,6 +8927,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"
@@ -7830,6 +8961,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"
@@ -8334,6 +9473,95 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaCheckRequirementRequest": {
+"description": "Request for CheckRequirement method.",
+"id": "GoogleCloudDiscoveryengineV1alphaCheckRequirementRequest",
+"properties": {
+"requirementType": {
+"description": "A Requirement.type specifying the requirement to check.",
+"type": "string"
+},
+"resources": {
+"description": "The resources to be checked for this requirement.",
+"items": {
+"$ref": "GoogleApiMonitoredResource"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaCheckRequirementResponse": {
+"description": "Response for CheckRequirement method.",
+"id": "GoogleCloudDiscoveryengineV1alphaCheckRequirementResponse",
+"properties": {
+"metricResults": {
+"description": "Metric results.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaCheckRequirementResponseMetricQueryResult"
+},
+"type": "array"
+},
+"oldestMetricTimestamp": {
+"description": "Timestamp of the oldest calculated metric (i.e. the most stale metric). Indicates that the `requirement_result` may not accurately reflect any Event and Product Catalog updates performed after this time.",
+"format": "google-datetime",
+"type": "string"
+},
+"requirement": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaRequirement",
+"description": "Requirement definition."
+},
+"requirementCondition": {
+"$ref": "GoogleTypeExpr",
+"description": "The condition for evaluating the requirement result."
+},
+"requirementResult": {
+"description": "Requirement result, e.g. pass or fail.",
+"enum": [
+"UNKNOWN",
+"SUCCESS",
+"FAILURE",
+"WARNING"
+],
+"enumDescriptions": [
+"The requirement is unknown.",
+"The requirement check is passed.",
+"The requirement check fails to meet at least one blocking threshold.",
+"The requirement check fails at least one warning threshold, but passes all blocking thresholds."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaCheckRequirementResponseMetricQueryResult": {
+"description": "Metric result. The metric are in the requirement_condition.",
+"id": "GoogleCloudDiscoveryengineV1alphaCheckRequirementResponseMetricQueryResult",
+"properties": {
+"metricType": {
+"description": "Type identifier of the metric corresponding to this query result.",
+"type": "string"
+},
+"name": {
+"description": "This metric query name is mapping to variables in the requirement_condition.",
+"type": "string"
+},
+"timestamp": {
+"description": "Time corresponding to when this metric value was calculated.",
+"format": "google-datetime",
+"type": "string"
+},
+"unit": {
+"description": "The unit in which this metric is reported. Follows [The Unified Code for Units of Measure](https://unitsofmeasure.org/ucum.html) standard.",
+"type": "string"
+},
+"value": {
+"$ref": "GoogleMonitoringV3TypedValue",
+"description": "Value of the metric query."
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaChunk": {
 "description": "Chunk captures all raw metadata information of items to be recommended or searched in the chunk mode.",
 "id": "GoogleCloudDiscoveryengineV1alphaChunk",
@@ -8373,8 +9601,9 @@
 "description": "Page span of the chunk."
 },
 "relevanceScore": {
-"description": "Represents the relevance score based on similarity. Higher score represents the chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse",
+"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"
 }
 },
@@ -8524,6 +9753,200 @@
 },
 "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": {
+"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"
+},
 "GoogleCloudDiscoveryengineV1alphaConversation": {
 "description": "External conversation proto definition.",
 "id": "GoogleCloudDiscoveryengineV1alphaConversation",
@@ -8822,7 +10245,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.",
@@ -8832,6 +10255,7 @@
 "type": "string"
 },
 "modelVersion": {
+"description": "The version of the model.",
 "format": "int64",
 "type": "string"
 },
@@ -9487,7 +10911,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"
 }
 },
@@ -9801,12 +11225,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"
 },
@@ -9916,6 +11342,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": [
@@ -10084,6 +11517,10 @@
 "description": "Request message for Import methods.",
 "id": "GoogleCloudDiscoveryengineV1alphaImportDocumentsRequest",
 "properties": {
+"alloyDbSource": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAlloyDbSource",
+"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"
@@ -10400,6 +11837,24 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaListControlsResponse": {
+"description": "Response for ListControls method.",
+"id": "GoogleCloudDiscoveryengineV1alphaListControlsResponse",
+"properties": {
+"controls": {
+"description": "All the Controls for a given data store.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControl"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Pagination token, if not returned indicates the last page.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaListConversationsResponse": {
 "description": "Response for ListConversations method.",
 "id": "GoogleCloudDiscoveryengineV1alphaListConversationsResponse",
@@ -10981,6 +12436,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"
@@ -11311,6 +12773,121 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaRequirement": {
+"description": "A data requirement.",
+"id": "GoogleCloudDiscoveryengineV1alphaRequirement",
+"properties": {
+"condition": {
+"$ref": "GoogleTypeExpr",
+"description": "The condition for evaluating the requirement result. Variables in the expression should be provided by `metrics_bindings` or `threshold_bindings`. Where `metrics_bindings` are used for computed metrics and `threshold_bindings` are used to define thresholds for corresponding `metric_bindings`."
+},
+"description": {
+"description": "The description of the requirement.",
+"type": "string"
+},
+"displayName": {
+"description": "The name of the requirement.",
+"type": "string"
+},
+"metricBindings": {
+"description": "A list of the metric bindings to be used in `condition`.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaRequirementMetricBinding"
+},
+"type": "array"
+},
+"thresholdBindings": {
+"description": "A list of threshold bindings to be used in `condition`.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBinding"
+},
+"type": "array"
+},
+"type": {
+"description": "The requirement type, used as an identifier. Must be unique. The type should prefix with service name to avoid possible collision. It's encoraged to use natural hierarchical grouping for similar requirements. Examples: * `library.googleapis.com/books/min_available_books` * `discoveryengine.googleapis.com/media_rec/recommended_for_you/conversion_rate`",
+"type": "string"
+},
+"violationSamplesBindings": {
+"description": "A list of the metric bindings to be used in `condition`.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaRequirementViolationSamplesBinding"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaRequirementMetricBinding": {
+"description": "Specifies a metrics query and bind its result to a variable which will be used in the `condition`.",
+"id": "GoogleCloudDiscoveryengineV1alphaRequirementMetricBinding",
+"properties": {
+"category": {
+"description": "The category of the metric's target resource. Example: \"Events\"",
+"type": "string"
+},
+"description": {
+"description": "Human readable description of the corresponding metric filter.",
+"type": "string"
+},
+"metricFilter": {
+"description": "The filter string used for metrics query. Example: \"metric.type = \\\"discoveryengine.googleapis.com/events/day_count\\\" AND \" \"metric.conditions.time_range = \\\"NINETY_DAYS\\\"\"",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource being monitored for the metric.",
+"type": "string"
+},
+"variableId": {
+"description": "The variable id to be referenced in `condition`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaRequirementThresholdBinding": {
+"description": "Specifies a multi-level threshold to apply to apply to a `metric_bindings` in the `condition` CEL expression.",
+"id": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBinding",
+"properties": {
+"blockingThreshold": {
+"description": "Threshold to trigger a blocking failure. If not met, the requirement will evaluate as a `FAILURE`.",
+"format": "double",
+"type": "number"
+},
+"description": {
+"description": "Human readable description of the corresponding threshold and sub-requirement.",
+"type": "string"
+},
+"variableId": {
+"description": "The variable id to be referenced in `condition`. Must be unique across all `metric_bindings` and `threshold_bindings`.",
+"type": "string"
+},
+"warningThreshold": {
+"description": "Threshold to trigger a warning. If not met, the requirement will evaluate as a `WARNING`.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaRequirementViolationSamplesBinding": {
+"description": "Specifies a samples query and bind its result to a variable which will be used in the `condition`.",
+"id": "GoogleCloudDiscoveryengineV1alphaRequirementViolationSamplesBinding",
+"properties": {
+"description": {
+"description": "Description of this sample binding. Used by the UI to render user friendly descriptions for each requirement condition. Should be less than 128 characters long.",
+"type": "string"
+},
+"sampleFilter": {
+"description": "The filter string used for samples query. Example: \"sample.type = \\\"retail.googleapis.com/user_event\\\" AND \" \"sample.labels.event_type = \\\"PURCHASE\\\" \"",
+"type": "string"
+},
+"variableId": {
+"description": "The variable id to be referenced in `condition`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaResumeEngineRequest": {
 "description": "Request for resuming training of an engine.",
 "id": "GoogleCloudDiscoveryengineV1alphaResumeEngineRequest",
@@ -12934,130 +14511,332 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaCustomAttribute"
 },
-"description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.",
+"description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.",
+"type": "object"
+},
+"attributionToken": {
+"description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field.",
+"type": "string"
+},
+"completionInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaCompletionInfo",
+"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"
+},
+"documents": {
+"description": "List of Documents associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different UserEvent.documents is desired.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaDocumentInfo"
+},
+"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",
+"type": "string"
+},
+"eventType": {
+"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.",
+"type": "string"
+},
+"filter": {
+"description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendRequest, this field may be populated directly from RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
+"type": "string"
+},
+"mediaInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaMediaInfo",
+"description": "Media-specific info."
+},
+"pageInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaPageInfo",
+"description": "Page metadata such as categories and other critical information for certain event types such as `view-category-page`."
+},
+"panel": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaPanelInfo",
+"description": "Panel metadata associated with this user event."
+},
+"promotionIds": {
+"description": "The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"searchInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchInfo",
+"description": "SearchService.Search details related to the event. This field should be set for `search` event."
+},
+"sessionId": {
+"description": "A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix.",
+"type": "string"
+},
+"tagIds": {
+"description": "A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"transactionInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaTransactionInfo",
+"description": "The transaction metadata (if any) associated with this user event."
+},
+"userInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaUserInfo",
+"description": "Information about the end user."
+},
+"userPseudoId": {
+"description": "Required. 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 log in/out of the website. Do not set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. The field should not contain PII or user-data. We recommend to use Google Analytics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaUserInfo": {
+"description": "Information of an end user.",
+"id": "GoogleCloudDiscoveryengineV1alphaUserInfo",
+"properties": {
+"userAgent": {
+"description": "User agent as included in the HTTP header. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.",
+"type": "string"
+},
+"userId": {
+"description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users. Always use a hashed value for this ID. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. 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"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": {
+"description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
+"id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata",
+"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"
+},
+"GoogleCloudDiscoveryengineV1betaBatchCreateTargetSitesResponse": {
+"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
+"id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSitesResponse",
+"properties": {
+"targetSites": {
+"description": "TargetSites created.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaTargetSite"
+},
+"type": "array"
+}
+},
+"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"
 },
-"attributionToken": {
-"description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field.",
+"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"
 },
-"completionInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaCompletionInfo",
-"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."
+"readOnly": true,
+"type": "array"
 },
-"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"
+"boostAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlBoostAction",
+"description": "Defines a boost-type control"
 },
-"documents": {
-"description": "List of Documents associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different UserEvent.documents is desired.",
+"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": "GoogleCloudDiscoveryengineV1alphaDocumentInfo"
+"$ref": "GoogleCloudDiscoveryengineV1betaCondition"
 },
 "type": "array"
 },
-"eventTime": {
-"description": "Only required for UserEventService.ImportUserEvents method. Timestamp of when the user event happened.",
-"format": "google-datetime",
+"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"
 },
-"eventType": {
-"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.",
-"type": "string"
+"filterAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlFilterAction",
+"description": "Defines a filter-type control Currently not supported by Recommendation"
 },
-"filter": {
-"description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendRequest, this field may be populated directly from RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
+"name": {
+"description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
 "type": "string"
 },
-"mediaInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaMediaInfo",
-"description": "Media-specific info."
+"redirectAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
+"description": "Defines a redirect-type control."
 },
-"pageInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaPageInfo",
-"description": "Page metadata such as categories and other critical information for certain event types such as `view-category-page`."
+"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"
 },
-"panel": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaPanelInfo",
-"description": "Panel metadata associated with this user event."
+"synonymsAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlSynonymsAction",
+"description": "Treats a group of terms as synonyms of one another."
 },
-"promotionIds": {
-"description": "The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.",
+"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"
+}
 },
-"searchInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaSearchInfo",
-"description": "SearchService.Search details related to the event. This field should be set for `search` event."
+"type": "object"
 },
-"sessionId": {
-"description": "A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix.",
-"type": "string"
+"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"
 },
-"tagIds": {
-"description": "A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups.",
-"items": {
+"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"
 },
-"type": "array"
-},
-"transactionInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaTransactionInfo",
-"description": "The transaction metadata (if any) associated with this user event."
-},
-"userInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaUserInfo",
-"description": "Information about the end user."
-},
-"userPseudoId": {
-"description": "Required. 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 log in/out of the website. Do not set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. The field should not contain PII or user-data. We recommend to use Google Analytics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.",
+"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"
 },
-"GoogleCloudDiscoveryengineV1alphaUserInfo": {
-"description": "Information of an end user.",
-"id": "GoogleCloudDiscoveryengineV1alphaUserInfo",
+"GoogleCloudDiscoveryengineV1betaControlFilterAction": {
+"description": "Specified which products may be included in results. Uses same filter as boost.",
+"id": "GoogleCloudDiscoveryengineV1betaControlFilterAction",
 "properties": {
-"userAgent": {
-"description": "User agent as included in the HTTP header. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.",
+"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"
 },
-"userId": {
-"description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users. Always use a hashed value for this ID. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
+"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"
 },
-"GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": {
-"description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
-"id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata",
+"GoogleCloudDiscoveryengineV1betaControlRedirectAction": {
+"description": "Redirects a shopper to the provided URI.",
+"id": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
 "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"
 },
-"GoogleCloudDiscoveryengineV1betaBatchCreateTargetSitesResponse": {
-"description": "Response message for SiteSearchEngineService.BatchCreateTargetSites method.",
-"id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSitesResponse",
+"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": {
-"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": "GoogleCloudDiscoveryengineV1betaTargetSite"
+"type": "string"
 },
 "type": "array"
 }
@@ -13156,7 +14935,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.",
@@ -13166,6 +14945,7 @@
 "type": "string"
 },
 "modelVersion": {
+"description": "The version of the model.",
 "format": "int64",
 "type": "string"
 },
@@ -13363,6 +15143,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."
@@ -13381,6 +15165,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",
@@ -13389,6 +15200,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."
@@ -13402,6 +15217,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",
@@ -13583,7 +15404,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"
 }
 },
@@ -13796,6 +15617,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",
@@ -14197,6 +16097,35 @@
 },
 "type": "object"
 },
+"GoogleMonitoringV3TypedValue": {
+"description": "A single strongly-typed value.",
+"id": "GoogleMonitoringV3TypedValue",
+"properties": {
+"boolValue": {
+"description": "A Boolean value: `true` or `false`.",
+"type": "boolean"
+},
+"distributionValue": {
+"$ref": "GoogleApiDistribution",
+"description": "A distribution value."
+},
+"doubleValue": {
+"description": "A 64-bit double-precision floating-point number. Its magnitude is approximately \u00b110\u00b1300 and it has 16 significant digits of precision.",
+"format": "double",
+"type": "number"
+},
+"int64Value": {
+"description": "A 64-bit integer. Its range is approximately \u00b19.2x1018.",
+"format": "int64",
+"type": "string"
+},
+"stringValue": {
+"description": "A variable-length string value.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleProtobufEmpty": {
 "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
 "id": "GoogleProtobufEmpty",
@@ -14251,6 +16180,29 @@
 }
 },
 "type": "object"
+},
+"GoogleTypeExpr": {
+"description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() < 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.",
+"id": "GoogleTypeExpr",
+"properties": {
+"description": {
+"description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.",
+"type": "string"
+},
+"expression": {
+"description": "Textual representation of an expression in Common Expression Language syntax.",
+"type": "string"
+},
+"location": {
+"description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.",
+"type": "string"
+},
+"title": {
+"description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.",
+"type": "string"
+}
+},
+"type": "object"
 }
 },
 "servicePath": "",