google-api-python-client 2.153.0__py2.py3-none-any.whl → 2.155.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1.json

@@ -15,6 +15,28 @@
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
 "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
+"endpoints": [
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/",
+"location": "asia-northeast1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/",
+"location": "europe-west2"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.us.rep.googleapis.com/",
+"location": "us"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
+"location": "eu"
+}
+],
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -757,7 +779,7 @@
 "operations": {
 "methods": {
 "cancel": {
-"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}:cancel",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel",
@@ -1697,6 +1719,40 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"patch": {
+"description": "Updates a ServingConfig. Returns a NOT_FOUND error if the ServingConfig does not exist.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}/servingConfigs/{serving_config_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Indicates which fields in the provided ServingConfig to update. The following are NOT supported: * ServingConfig.name If not set, all supported fields are updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfig"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfig"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "recommend": {
 "description": "Makes a recommendation, which requires a contextual user event.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:recommend",
@@ -1780,6 +1836,34 @@
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
+},
+"streamAnswer": {
+"description": "Answer query method (streaming). It takes one AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a stream.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:streamAnswer",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer",
+"parameterOrder": [
+"servingConfig"
+],
+"parameters": {
+"servingConfig": {
+"description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+servingConfig}:streamAnswer",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
 }
 }
 },
@@ -1847,6 +1931,11 @@
 "name"
 ],
 "parameters": {
+"includeAnswerDetails": {
+"description": "Optional. If set to true, the full session including all answer details will be returned.",
+"location": "query",
+"type": "boolean"
+},
 "name": {
 "description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
@@ -1878,7 +1967,7 @@
 "type": "string"
 },
 "orderBy": {
-"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: \"update_time desc\" \"create_time\"",
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * \"update_time desc\" * \"create_time\" * \"is_pinned desc,update_time desc\": list sessions by is_pinned first, then by update_time.",
 "location": "query",
 "type": "string"
 },
@@ -2524,7 +2613,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent DataStore resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.",
+"description": "Required. The parent resource name. If the collect user event action is applied in DataStore level, the format is: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`. If the collect user event action is applied in Location level, for example, the event with Document across multiple DataStore, the format is: `projects/{project}/locations/{location}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -3256,6 +3345,40 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"patch": {
+"description": "Updates a ServingConfig. Returns a NOT_FOUND error if the ServingConfig does not exist.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.servingConfigs.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}/servingConfigs/{serving_config_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Indicates which fields in the provided ServingConfig to update. The following are NOT supported: * ServingConfig.name If not set, all supported fields are updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfig"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfig"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "recommend": {
 "description": "Makes a recommendation, which requires a contextual user event.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:recommend",
@@ -3339,6 +3462,34 @@
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
+},
+"streamAnswer": {
+"description": "Answer query method (streaming). It takes one AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a stream.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:streamAnswer",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.servingConfigs.streamAnswer",
+"parameterOrder": [
+"servingConfig"
+],
+"parameters": {
+"servingConfig": {
+"description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+servingConfig}:streamAnswer",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
 }
 }
 },
@@ -3406,6 +3557,11 @@
 "name"
 ],
 "parameters": {
+"includeAnswerDetails": {
+"description": "Optional. If set to true, the full session including all answer details will be returned.",
+"location": "query",
+"type": "boolean"
+},
 "name": {
 "description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
@@ -3437,7 +3593,7 @@
 "type": "string"
 },
 "orderBy": {
-"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: \"update_time desc\" \"create_time\"",
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * \"update_time desc\" * \"create_time\" * \"is_pinned desc,update_time desc\": list sessions by is_pinned first, then by update_time.",
 "location": "query",
 "type": "string"
 },
@@ -4123,7 +4279,7 @@
 "operations": {
 "methods": {
 "cancel": {
-"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}:cancel",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.dataStores.branches.operations.cancel",
@@ -4962,6 +5118,40 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"patch": {
+"description": "Updates a ServingConfig. Returns a NOT_FOUND error if the ServingConfig does not exist.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.dataStores.servingConfigs.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}/servingConfigs/{serving_config_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Indicates which fields in the provided ServingConfig to update. The following are NOT supported: * ServingConfig.name If not set, all supported fields are updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfig"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfig"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "recommend": {
 "description": "Makes a recommendation, which requires a contextual user event.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:recommend",
@@ -5045,6 +5235,34 @@
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
+},
+"streamAnswer": {
+"description": "Answer query method (streaming). It takes one AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a stream.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:streamAnswer",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.servingConfigs.streamAnswer",
+"parameterOrder": [
+"servingConfig"
+],
+"parameters": {
+"servingConfig": {
+"description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+servingConfig}:streamAnswer",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
 }
 }
 },
@@ -5112,6 +5330,11 @@
 "name"
 ],
 "parameters": {
+"includeAnswerDetails": {
+"description": "Optional. If set to true, the full session including all answer details will be returned.",
+"location": "query",
+"type": "boolean"
+},
 "name": {
 "description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
@@ -5143,7 +5366,7 @@
 "type": "string"
 },
 "orderBy": {
-"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: \"update_time desc\" \"create_time\"",
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * \"update_time desc\" * \"create_time\" * \"is_pinned desc,update_time desc\": list sessions by is_pinned first, then by update_time.",
 "location": "query",
 "type": "string"
 },
@@ -5583,7 +5806,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent DataStore resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.",
+"description": "Required. The parent resource name. If the collect user event action is applied in DataStore level, the format is: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`. If the collect user event action is applied in Location level, for example, the event with Document across multiple DataStore, the format is: `projects/{project}/locations/{location}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5927,7 +6150,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent DataStore resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.",
+"description": "Required. The parent resource name. If the collect user event action is applied in DataStore level, the format is: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`. If the collect user event action is applied in Location level, for example, the event with Document across multiple DataStore, the format is: `projects/{project}/locations/{location}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
@@ -5952,6 +6175,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"import": {
+"description": "Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/userEvents:import",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.userEvents.import",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Parent DataStore resource name, of the form `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/userEvents:import",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1ImportUserEventsRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -5992,7 +6243,7 @@
 "operations": {
 "methods": {
 "cancel": {
-"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
 "flatPath": "v1/projects/{projectsId}/operations/{operationsId}:cancel",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.operations.cancel",
@@ -6090,7 +6341,7 @@
 }
 }
 },
-"revision": "20241031",
+"revision": "20241206",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -6560,6 +6811,18 @@
 "readOnly": true,
 "type": "string"
 },
+"groundingScore": {
+"description": "A score in the range of [0, 1] describing how grounded the answer is by the reference chunks.",
+"format": "double",
+"type": "number"
+},
+"groundingSupports": {
+"description": "Optional. Grounding supports.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerGroundingSupport"
+},
+"type": "array"
+},
 "name": {
 "description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*`",
 "type": "string"
@@ -6588,13 +6851,15 @@
 "STATE_UNSPECIFIED",
 "IN_PROGRESS",
 "FAILED",
-"SUCCEEDED"
+"SUCCEEDED",
+"STREAMING"
 ],
 "enumDescriptions": [
 "Unknown.",
 "Answer generation is currently in progress.",
 "Answer generation currently failed.",
-"Answer generation has succeeded."
+"Answer generation has succeeded.",
+"Answer generation is currently in progress."
 ],
 "type": "string"
 },
@@ -6643,6 +6908,39 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1AnswerGroundingSupport": {
+"description": "Grounding support for a claim in `answer_text`.",
+"id": "GoogleCloudDiscoveryengineV1AnswerGroundingSupport",
+"properties": {
+"endIndex": {
+"description": "Required. End of the claim, exclusive.",
+"format": "int64",
+"type": "string"
+},
+"groundingCheckRequired": {
+"description": "Indicates that this claim required grounding check. When the system decided this claim didn't require attribution/grounding check, this field is set to false. In that case, no grounding check was done for the claim and therefore `grounding_score`, `sources` is not returned.",
+"type": "boolean"
+},
+"groundingScore": {
+"description": "A score in the range of [0, 1] describing how grounded is a specific claim by the references. Higher value means that the claim is better supported by the reference chunks.",
+"format": "double",
+"type": "number"
+},
+"sources": {
+"description": "Optional. Citation sources for the claim.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerCitationSource"
+},
+"type": "array"
+},
+"startIndex": {
+"description": "Required. Index indicates the start of the claim, measured in bytes (UTF-8 unicode).",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1AnswerQueryRequest": {
 "description": "Request message for ConversationalSearchService.AnswerQuery method.",
 "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequest",
@@ -6763,6 +7061,20 @@
 "description": "Grounding specification.",
 "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec",
 "properties": {
+"filteringLevel": {
+"description": "Optional. Specifies whether to enable the filtering based on grounding score and at what level.",
+"enum": [
+"FILTERING_LEVEL_UNSPECIFIED",
+"FILTERING_LEVEL_LOW",
+"FILTERING_LEVEL_HIGH"
+],
+"enumDescriptions": [
+"Default is no filter",
+"Filter answers based on a low threshold.",
+"Filter answers based on a high threshold."
+],
+"type": "string"
+},
 "includeGroundingSupports": {
 "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.",
 "type": "boolean"
@@ -6825,6 +7137,31 @@
 "description": "Max rephrase steps. The max number is 5 steps. If not set or set to < 1, it will be set to 1 by default.",
 "format": "int32",
 "type": "integer"
+},
+"modelSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpecModelSpec",
+"description": "Optional. Query Rephraser Model specification."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpecModelSpec": {
+"description": "Query Rephraser Model specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpecModelSpec",
+"properties": {
+"modelType": {
+"description": "Optional. Enabled query rephraser model type. If not set, it will use LARGE by default.",
+"enum": [
+"MODEL_TYPE_UNSPECIFIED",
+"SMALL",
+"LARGE"
+],
+"enumDescriptions": [
+"Unspecified model type.",
+"Small query rephraser model. Gemini 1.0 XS model.",
+"Large query rephraser model. Gemini 1.0 Pro model."
+],
+"type": "string"
 }
 },
 "type": "object"
@@ -6841,7 +7178,7 @@
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec": {
-"description": "Safety specification.",
+"description": "Safety specification. There are two use cases: 1. when only safety_spec.enable is set, the BLOCK_LOW_AND_ABOVE threshold will be applied for all categories. 2. when safety_spec.enable is set and some safety_settings are set, only specified safety_settings are applied.",
 "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec",
 "properties": {
 "enable": {
@@ -6904,7 +7241,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 }
@@ -7815,7 +8152,7 @@
 "type": "integer"
 },
 "groundingCheckRequired": {
-"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, anti_citation_indices, and score should not be returned.",
+"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices should not be returned.",
 "type": "boolean"
 },
 "startPos": {
@@ -7877,7 +8214,7 @@
 "description": "Page span of the chunk."
 },
 "relevanceScore": {
-"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse.",
+"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 SearchResponse.",
 "format": "double",
 "readOnly": true,
 "type": "number"
@@ -8215,6 +8552,10 @@
 "description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
 "type": "string"
 },
+"promoteAction": {
+"$ref": "GoogleCloudDiscoveryengineV1ControlPromoteAction",
+"description": "Promote certain links based on predefined trigger queries. This now only supports basic site search."
+},
 "redirectAction": {
 "$ref": "GoogleCloudDiscoveryengineV1ControlRedirectAction",
 "description": "Defines a redirect-type control."
@@ -8296,6 +8637,21 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1ControlPromoteAction": {
+"description": "Promote certain links based on some trigger queries. Example: Promote shoe store link when searching for `shoe` keyword. The link can be outside of associated data store.",
+"id": "GoogleCloudDiscoveryengineV1ControlPromoteAction",
+"properties": {
+"dataStore": {
+"description": "Required. Data store with which this promotion is attached to.",
+"type": "string"
+},
+"searchLinkPromotion": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchLinkPromotion",
+"description": "Required. Promotion attached to this action."
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1ControlRedirectAction": {
 "description": "Redirects a shopper to the provided URI.",
 "id": "GoogleCloudDiscoveryengineV1ControlRedirectAction",
@@ -9006,7 +9362,12 @@
 "description": "Detailed document information associated with a user event.",
 "id": "GoogleCloudDiscoveryengineV1DocumentInfo",
 "properties": {
-"id": {
+"conversionValue": {
+"description": "Optional. The conversion value associated with this Document. Must be set if UserEvent.event_type is \"conversion\". For example, a value of 1000 signifies that 1000 seconds were spent viewing a Document for the `watch` conversion type.",
+"format": "float",
+"type": "number"
+},
+"id": {
 "description": "The Document resource ID.",
 "type": "string"
 },
@@ -9382,80 +9743,6 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1Feedback": {
-"description": "Information about the user feedback. This information will be used for logging and metrics purpose.",
-"id": "GoogleCloudDiscoveryengineV1Feedback",
-"properties": {
-"comment": {
-"description": "Optional. The additional user comment of the feedback if user gives a thumb down.",
-"type": "string"
-},
-"conversationInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1FeedbackConversationInfo",
-"description": "The related conversation information when user gives feedback."
-},
-"feedbackType": {
-"description": "Required. Indicate whether the user gives a positive or negative feedback. If the user gives a negative feedback, there might be more feedback details.",
-"enum": [
-"FEEDBACK_TYPE_UNSPECIFIED",
-"LIKE",
-"DISLIKE"
-],
-"enumDescriptions": [
-"Unspecified feedback type.",
-"The user gives a positive feedback.",
-"The user gives a negative feedback."
-],
-"type": "string"
-},
-"llmModelVersion": {
-"description": "The version of the LLM model that was used to generate the response.",
-"type": "string"
-},
-"reasons": {
-"description": "Optional. The reason if user gives a thumb down.",
-"items": {
-"enum": [
-"REASON_UNSPECIFIED",
-"INACCURATE_RESPONSE",
-"NOT_RELEVANT",
-"INCOMPREHENSIVE",
-"OFFENSIVE_OR_UNSAFE",
-"BAD_CIATION",
-"FORMAT_AND_STYLES"
-],
-"enumDescriptions": [
-"Unspecified reason.",
-"The response is inaccurate.",
-"The response is not relevant.",
-"The response is incomprehensive.",
-"The response is offensive or unsafe.",
-"The response is not well-associated with the query.",
-"The response is not well-formatted."
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDiscoveryengineV1FeedbackConversationInfo": {
-"description": "The conversation information such as the question index and session name.",
-"id": "GoogleCloudDiscoveryengineV1FeedbackConversationInfo",
-"properties": {
-"questionIndex": {
-"description": "The index of the user input within the conversation messages.",
-"format": "int32",
-"type": "integer"
-},
-"session": {
-"description": "Name of the newly generated or continued session.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse": {
 "description": "Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.",
 "id": "GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse",
@@ -9497,6 +9784,10 @@
 "type": "string"
 },
 "type": "array"
+},
+"updateFromLatestPredefinedSchema": {
+"description": "Optional. Whether to update the DataStore schema to the latest predefined schema. If true, the DataStore schema will be updated to include any FHIR fields or resource types that have been added since the last import and corresponding FHIR resources will be imported from the FHIR store. Note this field cannot be used in conjunction with `resource_types`. It should be used after initial import.",
+"type": "boolean"
 }
 },
 "type": "object"
@@ -10500,7 +10791,7 @@
 "id": "GoogleCloudDiscoveryengineV1PurgeUserEventsRequest",
 "properties": {
 "filter": {
-"description": "Required. The filter string to specify the events to be deleted with a length limit of 5,000 characters. The eligible fields for filtering are: * `eventType`: Double quoted UserEvent.event_type string. * `eventTime`: in ISO 8601 \"zulu\" format. * `userPseudoId`: Double quoted string. Specifying this will delete all events associated with a visitor. * `userId`: Double quoted string. Specifying this will delete all events associated with a user. Examples: * Deleting all events in a time range: `eventTime > \"2012-04-23T18:25:43.511Z\" eventTime < \"2012-04-23T18:30:43.511Z\"` * Deleting specific eventType: `eventType = \"search\"` * Deleting all events for a specific visitor: `userPseudoId = \"visitor1024\"` * Deleting all events inside a DataStore: `*` The filtering fields are assumed to have an implicit AND.",
+"description": "Required. The filter string to specify the events to be deleted with a length limit of 5,000 characters. The eligible fields for filtering are: * `eventType`: Double quoted UserEvent.event_type string. * `eventTime`: in ISO 8601 \"zulu\" format. * `userPseudoId`: Double quoted string. Specifying this will delete all events associated with a visitor. * `userId`: Double quoted string. Specifying this will delete all events associated with a user. Note: This API only supports purging a max range of 30 days. Examples: * Deleting all events in a time range: `eventTime > \"2012-04-23T18:25:43.511Z\" eventTime < \"2012-04-23T18:30:43.511Z\"` * Deleting specific eventType in a time range: `eventTime > \"2012-04-23T18:25:43.511Z\" eventTime < \"2012-04-23T18:30:43.511Z\" eventType = \"search\"` * Deleting all events for a specific visitor in a time range: `eventTime > \"2012-04-23T18:25:43.511Z\" eventTime < \"2012-04-23T18:30:43.511Z\" userPseudoId = \"visitor1024\"` * Deleting the past 30 days of events inside a DataStore: `*` The filtering fields are assumed to have an implicit AND.",
 "type": "string"
 },
 "force": {
@@ -10590,7 +10881,7 @@
 "type": "string"
 },
 "score": {
-"description": "The score of this record based on the given query and selected model.",
+"description": "The score of this record based on the given query and selected model. The score will be rounded to 2 decimal places. If the score is close to 0, it will be rounded to 0.0001 to avoid returning unset.",
 "format": "float",
 "type": "number"
 },
@@ -10606,7 +10897,7 @@
 "id": "GoogleCloudDiscoveryengineV1RecommendRequest",
 "properties": {
 "filter": {
-"description": "Filter for restricting recommendation results with a length limit of 5,000 characters. Currently, only filter expressions on the `filter_tags` attribute is supported. Examples: * `(filter_tags: ANY(\"Red\", \"Blue\") OR filter_tags: ANY(\"Hot\", \"Cold\"))` * `(filter_tags: ANY(\"Red\", \"Blue\")) AND NOT (filter_tags: ANY(\"Green\"))` If `attributeFilteringSyntax` is set to true under the `params` field, then attribute-based expressions are expected instead of the above described tag-based syntax. Examples: * (launguage: ANY(\"en\", \"es\")) AND NOT (categories: ANY(\"Movie\")) * (available: true) AND (launguage: ANY(\"en\", \"es\")) OR (categories: ANY(\"Movie\")) If your filter blocks all results, the API returns generic (unfiltered) popular Documents. If you only want results strictly matching the filters, set `strictFiltering` to `true` in RecommendRequest.params to receive empty results instead. Note that the API never returns Documents with `storageStatus` as `EXPIRED` or `DELETED` regardless of filter choices.",
+"description": "Filter for restricting recommendation results with a length limit of 5,000 characters. Currently, only filter expressions on the `filter_tags` attribute is supported. Examples: * `(filter_tags: ANY(\"Red\", \"Blue\") OR filter_tags: ANY(\"Hot\", \"Cold\"))` * `(filter_tags: ANY(\"Red\", \"Blue\")) AND NOT (filter_tags: ANY(\"Green\"))` If `attributeFilteringSyntax` is set to true under the `params` field, then attribute-based expressions are expected instead of the above described tag-based syntax. Examples: * (language: ANY(\"en\", \"es\")) AND NOT (categories: ANY(\"Movie\")) * (available: true) AND (language: ANY(\"en\", \"es\")) OR (categories: ANY(\"Movie\")) If your filter blocks all results, the API returns generic (unfiltered) popular Documents. If you only want results strictly matching the filters, set `strictFiltering` to `true` in RecommendRequest.params to receive empty results instead. Note that the API never returns Documents with `storageStatus` as `EXPIRED` or `DELETED` regardless of filter choices.",
 "type": "string"
 },
 "pageSize": {
@@ -10762,6 +11053,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1SearchLinkPromotion": {
+"description": "Promotion proto includes uri and other helping information to display the promotion.",
+"id": "GoogleCloudDiscoveryengineV1SearchLinkPromotion",
+"properties": {
+"description": {
+"description": "Optional. The Promotion description. Maximum length: 200 characters.",
+"type": "string"
+},
+"enabled": {
+"description": "Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.",
+"type": "boolean"
+},
+"imageUri": {
+"description": "Optional. The promotion thumbnail image url.",
+"type": "string"
+},
+"title": {
+"description": "Required. The title of the promotion. Maximum length: 160 characters.",
+"type": "string"
+},
+"uri": {
+"description": "Required. The URL for the page the user wants to promote.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1SearchRequest": {
 "description": "Request message for SearchService.Search method.",
 "id": "GoogleCloudDiscoveryengineV1SearchRequest",
@@ -10783,7 +11101,7 @@
 "description": "A specification for configuring the behavior of content search."
 },
 "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.",
+"description": "Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec"
 },
@@ -11000,7 +11318,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -11159,6 +11477,10 @@
 "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "id": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec",
 "properties": {
+"boostSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpec",
+"description": "Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)"
+},
 "dataStore": {
 "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.",
 "type": "string"
@@ -11376,6 +11698,13 @@
 },
 "type": "array"
 },
+"searchLinkPromotions": {
+"description": "Promotions for site search.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchLinkPromotion"
+},
+"type": "array"
+},
 "sessionInfo": {
 "$ref": "GoogleCloudDiscoveryengineV1SearchResponseSessionInfo",
 "description": "Session information. Only set if SearchRequest.session is provided. See its description for more details."
@@ -11669,16 +11998,194 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1ServingConfig": {
+"description": "Configures metadata that is used to generate serving time results (e.g. search results or recommendation predictions). The ServingConfig is passed in the search and predict request and generates results.",
+"id": "GoogleCloudDiscoveryengineV1ServingConfig",
+"properties": {
+"boostControlIds": {
+"description": "Boost controls to use in serving path. All triggered boost controls will be applied. Boost controls must be in the same data store as the serving config. Maximum of 20 boost controls.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"createTime": {
+"description": "Output only. ServingConfig created timestamp.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"displayName": {
+"description": "Required. The human readable serving config display name. Used in Discovery UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.",
+"type": "string"
+},
+"dissociateControlIds": {
+"description": "Condition do not associate specifications. If multiple do not associate conditions match, all matching do not associate controls in the list will execute. Order does not matter. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"diversityLevel": {
+"description": "How much diversity to use in recommendation model results e.g. `medium-diversity` or `high-diversity`. Currently supported values: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` If not specified, we choose default based on recommendation model type. Default value: `no-diversity`. Can only be set if SolutionType is SOLUTION_TYPE_RECOMMENDATION.",
+"type": "string"
+},
+"filterControlIds": {
+"description": "Filter controls to use in serving path. All triggered filter controls will be applied. Filter controls must be in the same data store as the serving config. Maximum of 20 filter controls.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"genericConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfigGenericConfig",
+"description": "The GenericConfig of the serving configuration."
+},
+"ignoreControlIds": {
+"description": "Condition ignore specifications. If multiple ignore conditions match, all matching ignore controls in the list will execute. Order does not matter. Maximum number of specifications is 100.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"mediaConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfigMediaConfig",
+"description": "The MediaConfig of the serving configuration."
+},
+"modelId": {
+"description": "The id of the model to use at serving time. Currently only RecommendationModels are supported. Can be changed but only to a compatible model (e.g. others-you-may-like CTR to others-you-may-like CVR). Required when SolutionType is SOLUTION_TYPE_RECOMMENDATION.",
+"type": "string"
+},
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}/servingConfigs/{serving_config_id}`",
+"type": "string"
+},
+"onewaySynonymsControlIds": {
+"description": "Condition oneway synonyms specifications. If multiple oneway synonyms conditions match, all matching oneway synonyms controls in the list will execute. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"promoteControlIds": {
+"description": "Condition promote specifications. Maximum number of specifications is 100.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"rankingExpression": {
+"description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.",
+"type": "string"
+},
+"redirectControlIds": {
+"description": "IDs of the redirect controls. Only the first triggered redirect action is applied, even if multiple apply. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"replacementControlIds": {
+"description": "Condition replacement specifications. Applied according to the order in the list. A previously replaced term can not be re-replaced. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"solutionType": {
+"description": "Required. Immutable. Specifies the solution type that a serving config can be associated with.",
+"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"
+},
+"synonymsControlIds": {
+"description": "Condition synonyms specifications. If multiple synonyms conditions match, all matching synonyms controls in the list will execute. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"updateTime": {
+"description": "Output only. ServingConfig updated timestamp.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ServingConfigGenericConfig": {
+"description": "Specifies the configurations needed for Generic Discovery.Currently we support: * `content_search_spec`: configuration for generic content search.",
+"id": "GoogleCloudDiscoveryengineV1ServingConfigGenericConfig",
+"properties": {
+"contentSearchSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec",
+"description": "Specifies the expected behavior of content search. Only valid for content-search enabled data store."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ServingConfigMediaConfig": {
+"description": "Specifies the configurations needed for Media Discovery. Currently we support: * `demote_content_watched`: Threshold for watched content demotion. Customers can specify if using watched content demotion or use viewed detail page. Using the content watched demotion, customers need to specify the watched minutes or percentage exceeds the threshold, the content will be demoted in the recommendation result. * `promote_fresh_content`: cutoff days for fresh content promotion. Customers can specify if using content freshness promotion. If the content was published within the cutoff days, the content will be promoted in the recommendation result. Can only be set if SolutionType is SOLUTION_TYPE_RECOMMENDATION.",
+"id": "GoogleCloudDiscoveryengineV1ServingConfigMediaConfig",
+"properties": {
+"contentFreshnessCutoffDays": {
+"description": "Specifies the content freshness used for recommendation result. Contents will be demoted if contents were published for more than content freshness cutoff days.",
+"format": "int32",
+"type": "integer"
+},
+"contentWatchedPercentageThreshold": {
+"description": "Specifies the content watched percentage threshold for demotion. Threshold value must be between [0, 1.0] inclusive.",
+"format": "float",
+"type": "number"
+},
+"contentWatchedSecondsThreshold": {
+"description": "Specifies the content watched minutes threshold for demotion.",
+"format": "float",
+"type": "number"
+},
+"demoteContentWatchedPastDays": {
+"description": "Optional. Specifies the number of days to look back for demoting watched content. If set to zero or unset, defaults to the maximum of 365 days.",
+"format": "int32",
+"type": "integer"
+},
+"demotionEventType": {
+"description": "Specifies the event type used for demoting recommendation result. Currently supported values: * `view-item`: Item viewed. * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. If unset, watch history demotion will not be applied. Content freshness demotion will still be applied.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1Session": {
 "description": "External session proto definition.",
 "id": "GoogleCloudDiscoveryengineV1Session",
 "properties": {
+"displayName": {
+"description": "Optional. The display name of the session. This field is used to identify the session in the UI. By default, the display name is the first turn query text in the session.",
+"type": "string"
+},
 "endTime": {
 "description": "Output only. The time the session finished.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
+"isPinned": {
+"description": "Optional. Whether the session is pinned, pinned session will be displayed on the top of the session list.",
+"type": "boolean"
+},
 "name": {
 "description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`",
 "type": "string"
@@ -11723,6 +12230,11 @@
 "description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
+"detailedAnswer": {
+"$ref": "GoogleCloudDiscoveryengineV1Answer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1Query",
 "description": "The user query."
@@ -12140,6 +12652,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1CompletionInfo",
 "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
 },
+"conversionType": {
+"description": "Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by \"-\", such as \"watch\", \"good-visit\" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc.",
+"type": "string"
+},
 "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"
@@ -12165,13 +12681,9 @@
 "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 * `add-feedback`: Add a user feedback. 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.",
+"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 * `add-feedback`: Add a user feedback. 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. Custom conversion value: * `conversion`: Customer defined conversion event.",
 "type": "string"
 },
-"feedback": {
-"$ref": "GoogleCloudDiscoveryengineV1Feedback",
-"description": "Optional. This field is optional except for the `add-feedback` event types."
-},
 "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"
@@ -12378,6 +12890,18 @@
 "readOnly": true,
 "type": "string"
 },
+"groundingScore": {
+"description": "A score in the range of [0, 1] describing how grounded the answer is by the reference chunks.",
+"format": "double",
+"type": "number"
+},
+"groundingSupports": {
+"description": "Optional. Grounding supports.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswerGroundingSupport"
+},
+"type": "array"
+},
 "name": {
 "description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*`",
 "type": "string"
@@ -12406,13 +12930,15 @@
 "STATE_UNSPECIFIED",
 "IN_PROGRESS",
 "FAILED",
-"SUCCEEDED"
+"SUCCEEDED",
+"STREAMING"
 ],
 "enumDescriptions": [
 "Unknown.",
 "Answer generation is currently in progress.",
 "Answer generation currently failed.",
-"Answer generation has succeeded."
+"Answer generation has succeeded.",
+"Answer generation is currently in progress."
 ],
 "type": "string"
 },
@@ -12461,6 +12987,39 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaAnswerGroundingSupport": {
+"description": "Grounding support for a claim in `answer_text`.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerGroundingSupport",
+"properties": {
+"endIndex": {
+"description": "Required. End of the claim, exclusive.",
+"format": "int64",
+"type": "string"
+},
+"groundingCheckRequired": {
+"description": "Indicates that this claim required grounding check. When the system decided this claim didn't require attribution/grounding check, this field is set to false. In that case, no grounding check was done for the claim and therefore `grounding_score`, `sources` is not returned.",
+"type": "boolean"
+},
+"groundingScore": {
+"description": "A score in the range of [0, 1] describing how grounded is a specific claim by the references. Higher value means that the claim is better supported by the reference chunks.",
+"format": "double",
+"type": "number"
+},
+"sources": {
+"description": "Optional. Citation sources for the claim.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswerCitationSource"
+},
+"type": "array"
+},
+"startIndex": {
+"description": "Required. Index indicates the start of the claim, measured in bytes (UTF-8 unicode).",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfo": {
 "description": "Query understanding information.",
 "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfo",
@@ -12980,6 +13539,10 @@
 "description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
 "type": "string"
 },
+"promoteAction": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaControlPromoteAction",
+"description": "Promote certain links based on predefined trigger queries. This now only supports basic site search."
+},
 "redirectAction": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaControlRedirectAction",
 "description": "Defines a redirect-type control."
@@ -13061,6 +13624,21 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaControlPromoteAction": {
+"description": "Promote certain links based on some trigger queries. Example: Promote shoe store link when searching for `shoe` keyword. The link can be outside of associated data store.",
+"id": "GoogleCloudDiscoveryengineV1alphaControlPromoteAction",
+"properties": {
+"dataStore": {
+"description": "Required. Data store with which this promotion is attached to.",
+"type": "string"
+},
+"searchLinkPromotion": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion",
+"description": "Required. Promotion attached to this action."
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaControlRedirectAction": {
 "description": "Redirects a shopper to the provided URI.",
 "id": "GoogleCloudDiscoveryengineV1alphaControlRedirectAction",
@@ -13512,6 +14090,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaDeleteSessionRequest": {
+"description": "Request for DeleteSession method.",
+"id": "GoogleCloudDiscoveryengineV1alphaDeleteSessionRequest",
+"properties": {
+"name": {
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaDeleteSitemapMetadata": {
 "description": "Metadata related to the progress of the SiteSearchEngineService.DeleteSitemap operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1alphaDeleteSitemapMetadata",
@@ -14299,6 +14888,21 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaGetSessionRequest": {
+"description": "Request for GetSession method.",
+"id": "GoogleCloudDiscoveryengineV1alphaGetSessionRequest",
+"properties": {
+"includeAnswerDetails": {
+"description": "Optional. If set to true, the full session including all answer details will be returned.",
+"type": "boolean"
+},
+"name": {
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse": {
 "description": "Response message for SiteSearchEngineService.GetUriPatternDocumentData method.",
 "id": "GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse",
@@ -14672,6 +15276,52 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaListSessionsRequest": {
+"description": "Request for ListSessions method.",
+"id": "GoogleCloudDiscoveryengineV1alphaListSessionsRequest",
+"properties": {
+"filter": {
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"type": "string"
+},
+"orderBy": {
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * \"update_time desc\" * \"create_time\" * \"is_pinned desc,update_time desc\": list sessions by is_pinned first, then by update_time.",
+"type": "string"
+},
+"pageSize": {
+"description": "Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaListSessionsResponse": {
+"description": "Response for ListSessions method.",
+"id": "GoogleCloudDiscoveryengineV1alphaListSessionsResponse",
+"properties": {
+"nextPageToken": {
+"description": "Pagination token, if not returned indicates the last page.",
+"type": "string"
+},
+"sessions": {
+"description": "All the Sessions for a given data store.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSession"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig": {
 "description": "Configuration for Natural Language Query Understanding.",
 "id": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
@@ -15207,6 +15857,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion": {
+"description": "Promotion proto includes uri and other helping information to display the promotion.",
+"id": "GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion",
+"properties": {
+"description": {
+"description": "Optional. The Promotion description. Maximum length: 200 characters.",
+"type": "string"
+},
+"enabled": {
+"description": "Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.",
+"type": "boolean"
+},
+"imageUri": {
+"description": "Optional. The promotion thumbnail image url.",
+"type": "string"
+},
+"title": {
+"description": "Required. The title of the promotion. Maximum length: 160 characters.",
+"type": "string"
+},
+"uri": {
+"description": "Required. The URL for the page the user wants to promote.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaSearchRequest": {
 "description": "Request message for SearchService.Search method.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchRequest",
@@ -15232,7 +15909,7 @@
 "description": "Custom fine tuning configs. If set, it has higher priority than the configs set in ServingConfig.custom_fine_tuning_spec."
 },
 "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.",
+"description": "Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
 },
@@ -15491,7 +16168,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -15650,6 +16327,10 @@
 "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec",
 "properties": {
+"boostSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestBoostSpec",
+"description": "Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)"
+},
 "dataStore": {
 "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.",
 "type": "string"
@@ -15915,12 +16596,20 @@
 "description": "External session proto definition.",
 "id": "GoogleCloudDiscoveryengineV1alphaSession",
 "properties": {
+"displayName": {
+"description": "Optional. The display name of the session. This field is used to identify the session in the UI. By default, the display name is the first turn query text in the session.",
+"type": "string"
+},
 "endTime": {
 "description": "Output only. The time the session finished.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
+"isPinned": {
+"description": "Optional. Whether the session is pinned, pinned session will be displayed on the top of the session list.",
+"type": "boolean"
+},
 "name": {
 "description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`",
 "type": "string"
@@ -15965,6 +16654,11 @@
 "description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
+"detailedAnswer": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
 "description": "The user query."
@@ -16249,6 +16943,22 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaUpdateSessionRequest": {
+"description": "Request for UpdateSession method.",
+"id": "GoogleCloudDiscoveryengineV1alphaUpdateSessionRequest",
+"properties": {
+"session": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSession",
+"description": "Required. The Session to update."
+},
+"updateMask": {
+"description": "Indicates which fields in the provided Session to update. The following are NOT supported: * Session.name If not set or empty, all supported fields are updated.",
+"format": "google-fieldmask",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaUpdateTargetSiteMetadata": {
 "description": "Metadata related to the progress of the SiteSearchEngineService.UpdateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1alphaUpdateTargetSiteMetadata",
@@ -16506,6 +17216,10 @@
 "description": "Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`",
 "type": "string"
 },
+"promoteAction": {
+"$ref": "GoogleCloudDiscoveryengineV1betaControlPromoteAction",
+"description": "Promote certain links based on predefined trigger queries. This now only supports basic site search."
+},
 "redirectAction": {
 "$ref": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
 "description": "Defines a redirect-type control."
@@ -16587,6 +17301,21 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaControlPromoteAction": {
+"description": "Promote certain links based on some trigger queries. Example: Promote shoe store link when searching for `shoe` keyword. The link can be outside of associated data store.",
+"id": "GoogleCloudDiscoveryengineV1betaControlPromoteAction",
+"properties": {
+"dataStore": {
+"description": "Required. Data store with which this promotion is attached to.",
+"type": "string"
+},
+"searchLinkPromotion": {
+"$ref": "GoogleCloudDiscoveryengineV1betaSearchLinkPromotion",
+"description": "Required. Promotion attached to this action."
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaControlRedirectAction": {
 "description": "Redirects a shopper to the provided URI.",
 "id": "GoogleCloudDiscoveryengineV1betaControlRedirectAction",
@@ -18058,6 +18787,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaSearchLinkPromotion": {
+"description": "Promotion proto includes uri and other helping information to display the promotion.",
+"id": "GoogleCloudDiscoveryengineV1betaSearchLinkPromotion",
+"properties": {
+"description": {
+"description": "Optional. The Promotion description. Maximum length: 200 characters.",
+"type": "string"
+},
+"enabled": {
+"description": "Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.",
+"type": "boolean"
+},
+"imageUri": {
+"description": "Optional. The promotion thumbnail image url.",
+"type": "string"
+},
+"title": {
+"description": "Required. The title of the promotion. Maximum length: 160 characters.",
+"type": "string"
+},
+"uri": {
+"description": "Required. The URL for the page the user wants to promote.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaSearchRequest": {
 "description": "Request message for SearchService.Search method.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequest",
@@ -18079,7 +18835,7 @@
 "description": "A specification for configuring the behavior of content search."
 },
 "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.",
+"description": "Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec"
 },
@@ -18338,7 +19094,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -18497,6 +19253,10 @@
 "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec",
 "properties": {
+"boostSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec",
+"description": "Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)"
+},
 "dataStore": {
 "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.",
 "type": "string"