google-api-python-client 2.129.0__py2.py3-none-any.whl → 2.130.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1.json

@@ -436,7 +436,7 @@
 ],
 "parameters": {
 "documentId": {
-"description": "Required. The ID to use for the Document, which will become the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
+"description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "location": "query",
 "type": "string"
 },
@@ -510,7 +510,7 @@
 ]
 },
 "import": {
-"description": "Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items will be created. Note: It is possible for a subset of the Documents to be successfully updated.",
+"description": "Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items are created. Note: It is possible for a subset of the Documents to be successfully updated.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:import",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.collections.dataStores.branches.documents.import",
@@ -547,7 +547,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.",
+"description": "Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 are set to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -583,7 +583,7 @@
 ],
 "parameters": {
 "allowMissing": {
-"description": "If set to true, and the Document is not found, a new Document will be created.",
+"description": "If set to `true` and the Document is not found, a new Document is be created.",
 "location": "query",
 "type": "boolean"
 },
@@ -595,7 +595,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Indicates which fields in the provided imported 'document' to update. If not set, will by default update all fields.",
+"description": "Indicates which fields in the provided imported 'document' to update. If not set, by default updates all fields.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -644,6 +644,34 @@
 },
 "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`.",
+"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",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource to be cancelled.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:cancel",
+"request": {
+"$ref": "GoogleLongrunningCancelOperationRequest"
+},
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}",
@@ -1067,7 +1095,7 @@
 "type": "string"
 },
 "schemaId": {
-"description": "Required. The ID to use for the Schema, which will become the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.",
+"description": "Required. The ID to use for the Schema, which becomes the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.",
 "location": "query",
 "type": "string"
 }
@@ -1143,7 +1171,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+"description": "The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas are returned. The maximum value is 1000; values above 1000 are set to 1000.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -1179,7 +1207,7 @@
 ],
 "parameters": {
 "allowMissing": {
-"description": "If set to true, and the Schema is not found, a new Schema will be created. In this situation, `update_mask` is ignored.",
+"description": "If set to true, and the Schema is not found, a new Schema is created. In this situation, `update_mask` is ignored.",
 "location": "query",
 "type": "boolean"
 },
@@ -1278,6 +1306,34 @@
 },
 "servingConfigs": {
 "methods": {
+"answer": {
+"description": "Answer query method.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:answer",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer",
+"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}:answer",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryResponse"
+},
+"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",
@@ -1288,7 +1344,7 @@
 ],
 "parameters": {
 "servingConfig": {
-"description": "Required. Full resource name of a ServingConfig: `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*/locations/global/collections/*/engines/my-engine`, you can use `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests.",
+"description": "Required. Full resource name of a ServingConfig: `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*/locations/global/collections/*/engines/my-engine`, you can use `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -1336,6 +1392,199 @@
 }
 }
 },
+"sessions": {
+"methods": {
+"create": {
+"description": "Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/sessions",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.dataStores.sessions.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/sessions",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/sessions/{sessionsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.collections.dataStores.sessions.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Session.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/sessions/{sessionsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.dataStores.sessions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Sessions by their parent DataStore.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/sessions",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.dataStores.sessions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: \"update_time desc\" \"create_time\"",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/sessions",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ListSessionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates a Session. Session action type cannot be changed. If the Session to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/sessions/{sessionsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.dataStores.sessions.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"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",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+},
+"resources": {
+"answers": {
+"methods": {
+"get": {
+"description": "Gets a Answer.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/sessions/{sessionsId}/answers/{answersId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Answer"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+}
+}
+},
 "siteSearchEngine": {
 "methods": {
 "batchVerifyTargetSites": {
@@ -1910,7 +2159,7 @@
 ]
 },
 "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.",
+"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}/collections/{collectionsId}/dataStores/{dataStoresId}/userEvents:import",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.collections.dataStores.userEvents.import",
@@ -2393,6 +2642,34 @@
 },
 "servingConfigs": {
 "methods": {
+"answer": {
+"description": "Answer query method.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:answer",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.servingConfigs.answer",
+"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}:answer",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryResponse"
+},
+"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",
@@ -2403,7 +2680,7 @@
 ],
 "parameters": {
 "servingConfig": {
-"description": "Required. Full resource name of a ServingConfig: `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*/locations/global/collections/*/engines/my-engine`, you can use `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests.",
+"description": "Required. Full resource name of a ServingConfig: `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*/locations/global/collections/*/engines/my-engine`, you can use `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -2450,59 +2727,252 @@
 ]
 }
 }
-}
-}
 },
-"operations": {
+"sessions": {
 "methods": {
-"get": {
-"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/operations/{operationsId}",
-"httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.operations.get",
+"create": {
+"description": "Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.create",
 "parameterOrder": [
-"name"
+"parent"
 ],
 "parameters": {
-"name": {
-"description": "The name of the operation resource.",
+"parent": {
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/operations/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1/{+name}",
+"path": "v1/{+parent}/sessions",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
 "response": {
-"$ref": "GoogleLongrunningOperation"
+"$ref": "GoogleCloudDiscoveryengineV1Session"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
-"list": {
-"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/operations",
-"httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.operations.list",
+"delete": {
+"description": "Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.delete",
 "parameterOrder": [
 "name"
 ],
 "parameters": {
-"filter": {
-"description": "The standard list filter.",
-"location": "query",
-"type": "string"
-},
 "name": {
-"description": "The name of the operation's parent resource.",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
 "type": "string"
+}
 },
-"pageSize": {
-"description": "The standard list page size.",
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets a Session.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Sessions by their parent DataStore.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: \"update_time desc\" \"create_time\"",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/sessions",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ListSessionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates a Session. Session action type cannot be changed. If the Session to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"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",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+},
+"resources": {
+"answers": {
+"methods": {
+"get": {
+"description": "Gets a Answer.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}/answers/{answersId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.answers.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+/answers/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Answer"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+}
+}
+}
+}
+},
+"operations": {
+"methods": {
+"get": {
+"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/operations/{operationsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.operations.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/operations",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.operations.list",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"filter": {
+"description": "The standard list filter.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "The name of the operation's parent resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+$",
+"required": true,
+"type": "string"
+},
+"pageSize": {
+"description": "The standard list page size.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -2776,7 +3246,7 @@
 ],
 "parameters": {
 "documentId": {
-"description": "Required. The ID to use for the Document, which will become the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
+"description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "location": "query",
 "type": "string"
 },
@@ -2850,7 +3320,7 @@
 ]
 },
 "import": {
-"description": "Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items will be created. Note: It is possible for a subset of the Documents to be successfully updated.",
+"description": "Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items are created. Note: It is possible for a subset of the Documents to be successfully updated.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:import",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.dataStores.branches.documents.import",
@@ -2887,7 +3357,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.",
+"description": "Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 are set to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -2923,7 +3393,7 @@
 ],
 "parameters": {
 "allowMissing": {
-"description": "If set to true, and the Document is not found, a new Document will be created.",
+"description": "If set to `true` and the Document is not found, a new Document is be created.",
 "location": "query",
 "type": "boolean"
 },
@@ -2935,7 +3405,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Indicates which fields in the provided imported 'document' to update. If not set, will by default update all fields.",
+"description": "Indicates which fields in the provided imported 'document' to update. If not set, by default updates all fields.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -2984,6 +3454,34 @@
 },
 "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`.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}:cancel",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.branches.operations.cancel",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource to be cancelled.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:cancel",
+"request": {
+"$ref": "GoogleLongrunningCancelOperationRequest"
+},
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}",
@@ -3407,7 +3905,7 @@
 "type": "string"
 },
 "schemaId": {
-"description": "Required. The ID to use for the Schema, which will become the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.",
+"description": "Required. The ID to use for the Schema, which becomes the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.",
 "location": "query",
 "type": "string"
 }
@@ -3483,7 +3981,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+"description": "The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas are returned. The maximum value is 1000; values above 1000 are set to 1000.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -3519,7 +4017,7 @@
 ],
 "parameters": {
 "allowMissing": {
-"description": "If set to true, and the Schema is not found, a new Schema will be created. In this situation, `update_mask` is ignored.",
+"description": "If set to true, and the Schema is not found, a new Schema is created. In this situation, `update_mask` is ignored.",
 "location": "query",
 "type": "boolean"
 },
@@ -3546,6 +4044,34 @@
 },
 "servingConfigs": {
 "methods": {
+"answer": {
+"description": "Answer query method.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:answer",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.servingConfigs.answer",
+"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}:answer",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryResponse"
+},
+"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",
@@ -3556,7 +4082,7 @@
 ],
 "parameters": {
 "servingConfig": {
-"description": "Required. Full resource name of a ServingConfig: `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*/locations/global/collections/*/engines/my-engine`, you can use `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests.",
+"description": "Required. Full resource name of a ServingConfig: `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*/locations/global/collections/*/engines/my-engine`, you can use `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -3604,70 +4130,263 @@
 }
 }
 },
-"siteSearchEngine": {
+"sessions": {
 "methods": {
-"disableAdvancedSiteSearch": {
-"description": "Downgrade from advanced site search to basic site search.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/siteSearchEngine:disableAdvancedSiteSearch",
+"create": {
+"description": "Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/sessions",
 "httpMethod": "POST",
-"id": "discoveryengine.projects.locations.dataStores.siteSearchEngine.disableAdvancedSiteSearch",
+"id": "discoveryengine.projects.locations.dataStores.sessions.create",
 "parameterOrder": [
-"siteSearchEngine"
+"parent"
 ],
 "parameters": {
-"siteSearchEngine": {
-"description": "Required. Full resource name of the SiteSearchEngine, such as `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSearchEngine`.",
+"parent": {
+"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine$",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1/{+siteSearchEngine}:disableAdvancedSiteSearch",
+"path": "v1/{+parent}/sessions",
 "request": {
-"$ref": "GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchRequest"
+"$ref": "GoogleCloudDiscoveryengineV1Session"
 },
 "response": {
-"$ref": "GoogleLongrunningOperation"
+"$ref": "GoogleCloudDiscoveryengineV1Session"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
-"enableAdvancedSiteSearch": {
-"description": "Upgrade from basic site search to advanced site search.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/siteSearchEngine:enableAdvancedSiteSearch",
-"httpMethod": "POST",
-"id": "discoveryengine.projects.locations.dataStores.siteSearchEngine.enableAdvancedSiteSearch",
+"delete": {
+"description": "Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/sessions/{sessionsId}",
+"httpMethod": "DELETE",
+"id": "discoveryengine.projects.locations.dataStores.sessions.delete",
 "parameterOrder": [
-"siteSearchEngine"
+"name"
 ],
 "parameters": {
-"siteSearchEngine": {
-"description": "Required. Full resource name of the SiteSearchEngine, such as `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSearchEngine`.",
+"name": {
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine$",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1/{+siteSearchEngine}:enableAdvancedSiteSearch",
-"request": {
-"$ref": "GoogleCloudDiscoveryengineV1EnableAdvancedSiteSearchRequest"
-},
+"path": "v1/{+name}",
 "response": {
-"$ref": "GoogleLongrunningOperation"
+"$ref": "GoogleProtobufEmpty"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
-"recrawlUris": {
-"description": "Request on-demand recrawl for a list of URIs.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/siteSearchEngine:recrawlUris",
-"httpMethod": "POST",
-"id": "discoveryengine.projects.locations.dataStores.siteSearchEngine.recrawlUris",
-"parameterOrder": [
+"get": {
+"description": "Gets a Session.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/sessions/{sessionsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.dataStores.sessions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all Sessions by their parent DataStore.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/sessions",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.dataStores.sessions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: \"update_time desc\" \"create_time\"",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/sessions",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1ListSessionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates a Session. Session action type cannot be changed. If the Session to update does not exist, a NOT_FOUND error is returned.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/sessions/{sessionsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.dataStores.sessions.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"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",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Session"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+},
+"resources": {
+"answers": {
+"methods": {
+"get": {
+"description": "Gets a Answer.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/sessions/{sessionsId}/answers/{answersId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.dataStores.sessions.answers.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Answer"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+}
+}
+},
+"siteSearchEngine": {
+"methods": {
+"disableAdvancedSiteSearch": {
+"description": "Downgrade from advanced site search to basic site search.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/siteSearchEngine:disableAdvancedSiteSearch",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.siteSearchEngine.disableAdvancedSiteSearch",
+"parameterOrder": [
+"siteSearchEngine"
+],
+"parameters": {
+"siteSearchEngine": {
+"description": "Required. Full resource name of the SiteSearchEngine, such as `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSearchEngine`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+siteSearchEngine}:disableAdvancedSiteSearch",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"enableAdvancedSiteSearch": {
+"description": "Upgrade from basic site search to advanced site search.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/siteSearchEngine:enableAdvancedSiteSearch",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.siteSearchEngine.enableAdvancedSiteSearch",
+"parameterOrder": [
+"siteSearchEngine"
+],
+"parameters": {
+"siteSearchEngine": {
+"description": "Required. Full resource name of the SiteSearchEngine, such as `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSearchEngine`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+siteSearchEngine}:enableAdvancedSiteSearch",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1EnableAdvancedSiteSearchRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"recrawlUris": {
+"description": "Request on-demand recrawl for a list of URIs.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/siteSearchEngine:recrawlUris",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.siteSearchEngine.recrawlUris",
+"parameterOrder": [
 "siteSearchEngine"
 ],
 "parameters": {
@@ -3972,7 +4691,7 @@
 ]
 },
 "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.",
+"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}/dataStores/{dataStoresId}/userEvents:import",
 "httpMethod": "POST",
 "id": "discoveryengine.projects.locations.dataStores.userEvents.import",
@@ -4031,6 +4750,38 @@
 }
 }
 },
+"groundingConfigs": {
+"methods": {
+"check": {
+"description": "Performs a grounding check.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/groundingConfigs/{groundingConfigsId}:check",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.groundingConfigs.check",
+"parameterOrder": [
+"groundingConfig"
+],
+"parameters": {
+"groundingConfig": {
+"description": "Required. The resource name of the grounding config, such as `projects/*/locations/global/groundingConfigs/default_grounding_config`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/groundingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+groundingConfig}:check",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1CheckGroundingRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1CheckGroundingResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "operations": {
 "methods": {
 "get": {
@@ -4101,6 +4852,38 @@
 }
 }
 },
+"rankingConfigs": {
+"methods": {
+"rank": {
+"description": "Ranks a list of text records based on the given input query.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/rankingConfigs/{rankingConfigsId}:rank",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.rankingConfigs.rank",
+"parameterOrder": [
+"rankingConfig"
+],
+"parameters": {
+"rankingConfig": {
+"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/rankingConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+rankingConfig}:rank",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1RankRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1RankResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "userEvents": {
 "methods": {
 "write": {
@@ -4137,6 +4920,34 @@
 },
 "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`.",
+"flatPath": "v1/projects/{projectsId}/operations/{operationsId}:cancel",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.operations.cancel",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource to be cancelled.",
+"location": "path",
+"pattern": "^projects/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:cancel",
+"request": {
+"$ref": "GoogleLongrunningCancelOperationRequest"
+},
+"response": {
+"$ref": "GoogleProtobufEmpty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
 "flatPath": "v1/projects/{projectsId}/operations/{operationsId}",
@@ -4208,7 +5019,7 @@
 }
 }
 },
-"revision": "20240509",
+"revision": "20240517",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -4316,42 +5127,815 @@
 "description": "The detailed content which caused the error on importing a document.",
 "type": "string"
 },
-"gcsPath": {
-"description": "Google Cloud Storage file path of the import source. Can be set for batch operation error.",
+"gcsPath": {
+"description": "Google Cloud Storage file path of the import source. Can be set for batch operation error.",
+"type": "string"
+},
+"lineNumber": {
+"description": "Line number of the content in file. Should be empty for permission or batch operation error.",
+"type": "string"
+},
+"operation": {
+"description": "The operation resource name of the LRO.",
+"type": "string"
+},
+"userEvent": {
+"description": "The detailed content which caused the error on importing a user event.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineLoggingServiceContext": {
+"description": "Describes a running service that sends errors.",
+"id": "GoogleCloudDiscoveryengineLoggingServiceContext",
+"properties": {
+"service": {
+"description": "An identifier of the service\u2014for example, `discoveryengine.googleapis.com`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineLoggingSourceLocation": {
+"description": "Indicates a location in the source code of the service for which errors are reported.",
+"id": "GoogleCloudDiscoveryengineLoggingSourceLocation",
+"properties": {
+"functionName": {
+"description": "Human-readable name of a function or method\u2014for example, `google.cloud.discoveryengine.v1alpha.RecommendationService.Recommend`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1Answer": {
+"description": "Defines an answer.",
+"id": "GoogleCloudDiscoveryengineV1Answer",
+"properties": {
+"answerSkippedReasons": {
+"description": "Additional answer-skipped reasons. This provides the reason for ignored cases. If nothing is skipped, this field is not set.",
+"items": {
+"enum": [
+"ANSWER_SKIPPED_REASON_UNSPECIFIED",
+"ADVERSARIAL_QUERY_IGNORED",
+"NON_ANSWER_SEEKING_QUERY_IGNORED",
+"OUT_OF_DOMAIN_QUERY_IGNORED",
+"POTENTIAL_POLICY_VIOLATION"
+],
+"enumDescriptions": [
+"Default value. The answer skipped reason is not specified.",
+"The adversarial query ignored case.",
+"The non-answer seeking query ignored case.",
+"The out-of-domain query ignored case. Google skips the answer if there are no high-relevance search results.",
+"The potential policy violation case. Google skips the answer if there is a potential policy violation detected. This includes content that may be violent or toxic."
+],
+"type": "string"
+},
+"type": "array"
+},
+"answerText": {
+"description": "The textual answer.",
+"type": "string"
+},
+"citations": {
+"description": "Citations.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerCitation"
+},
+"type": "array"
+},
+"completeTime": {
+"description": "Output only. Answer completed timestamp.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"createTime": {
+"description": "Output only. Answer creation timestamp.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*`",
+"type": "string"
+},
+"queryUnderstandingInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfo",
+"description": "Query understanding information."
+},
+"references": {
+"description": "References.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerReference"
+},
+"type": "array"
+},
+"relatedQuestions": {
+"description": "Suggested related questions.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"state": {
+"description": "The state of the answer generation.",
+"enum": [
+"STATE_UNSPECIFIED",
+"IN_PROGRESS",
+"FAILED",
+"SUCCEEDED"
+],
+"enumDescriptions": [
+"Unknown.",
+"Answer generation is currently in progress.",
+"Answer generation currently failed.",
+"Answer generation has succeeded."
+],
+"type": "string"
+},
+"steps": {
+"description": "Answer generation steps.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStep"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerCitation": {
+"description": "Citation info for a segment.",
+"id": "GoogleCloudDiscoveryengineV1AnswerCitation",
+"properties": {
+"endIndex": {
+"description": "End of the attributed segment, exclusive.",
+"format": "int64",
+"type": "string"
+},
+"sources": {
+"description": "Citation sources for the attributed segment.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerCitationSource"
+},
+"type": "array"
+},
+"startIndex": {
+"description": "Index indicates the start of the segment, measured in bytes (UTF-8 unicode).",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerCitationSource": {
+"description": "Citation source.",
+"id": "GoogleCloudDiscoveryengineV1AnswerCitationSource",
+"properties": {
+"referenceId": {
+"description": "ID of the citation source.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequest": {
+"description": "Request message for ConversationalSearchService.AnswerQuery method.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequest",
+"properties": {
+"answerGenerationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpec",
+"description": "Answer generation specification."
+},
+"asynchronousMode": {
+"description": "Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
+"type": "boolean"
+},
+"query": {
+"$ref": "GoogleCloudDiscoveryengineV1Query",
+"description": "Required. Current user query."
+},
+"queryUnderstandingSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec",
+"description": "Query understanding specification."
+},
+"relatedQuestionsSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestRelatedQuestionsSpec",
+"description": "Related questions specification."
+},
+"safetySpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec",
+"description": "Model specification."
+},
+"searchSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpec",
+"description": "Search specification."
+},
+"session": {
+"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"
+},
+"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"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpec": {
+"description": "Answer generation specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpec",
+"properties": {
+"answerLanguageCode": {
+"description": "Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.",
+"type": "string"
+},
+"ignoreAdversarialQuery": {
+"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"
+},
+"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"
+},
+"includeCitations": {
+"description": "Specifies whether to include citation metadata in the answer. The default value is `false`.",
+"type": "boolean"
+},
+"modelSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecModelSpec",
+"description": "Answer generation model specification."
+},
+"promptSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecPromptSpec",
+"description": "Answer generation prompt specification."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecModelSpec": {
+"description": "Answer Generation Model specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecModelSpec",
+"properties": {
+"modelVersion": {
+"description": "Model version. If not set, it will use the default stable model. Allowed values are: stable, preview.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecPromptSpec": {
+"description": "Answer generation prompt specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecPromptSpec",
+"properties": {
+"preamble": {
+"description": "Customized preamble.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec": {
+"description": "Query understanding specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec",
+"properties": {
+"queryClassificationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec",
+"description": "Query classification specification."
+},
+"queryRephraserSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpec",
+"description": "Query rephraser specification."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec": {
+"description": "Query classification specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec",
+"properties": {
+"types": {
+"description": "Enabled query classification types.",
+"items": {
+"enum": [
+"TYPE_UNSPECIFIED",
+"ADVERSARIAL_QUERY",
+"NON_ANSWER_SEEKING_QUERY"
+],
+"enumDescriptions": [
+"Unspecified query classification type.",
+"Adversarial query classification type.",
+"Non-answer-seeking query classification type."
+],
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpec": {
+"description": "Query rephraser specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpec",
+"properties": {
+"disable": {
+"description": "Disable query rephraser.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestRelatedQuestionsSpec": {
+"description": "Related questions specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestRelatedQuestionsSpec",
+"properties": {
+"enable": {
+"description": "Enable related questions feature if true.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec": {
+"description": "Safety specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec",
+"properties": {
+"enable": {
+"description": "Enable the safety filtering on the answer response. It is false by default.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpec": {
+"description": "Search specification.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpec",
+"properties": {
+"searchParams": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchParams",
+"description": "Search parameters."
+},
+"searchResultList": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultList",
+"description": "Search result list."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchParams": {
+"description": "Search parameters.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchParams",
+"properties": {
+"boostSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpec",
+"description": "Boost specification to boost certain documents in search results which may affect the answer query response. For more information on boosting, see [Boosting](https://cloud.google.com/retail/docs/boosting#boost)"
+},
+"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"
+},
+"maxReturnResults": {
+"description": "Number of search results to return. The default value is 10.",
+"format": "int32",
+"type": "integer"
+},
+"orderBy": {
+"description": "The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering, see [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order) If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultList": {
+"description": "Search result list.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultList",
+"properties": {
+"searchResults": {
+"description": "Search results.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResult"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResult": {
+"description": "Search result.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResult",
+"properties": {
+"chunkInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfo",
+"description": "Chunk information."
+},
+"unstructuredDocumentInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo",
+"description": "Unstructured document information."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfo": {
+"description": "Chunk information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfo",
+"properties": {
+"chunk": {
+"description": "Chunk resource name.",
+"type": "string"
+},
+"content": {
+"description": "Chunk textual content.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo": {
+"description": "Unstructured document information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo",
+"properties": {
+"document": {
+"description": "Document resource name.",
+"type": "string"
+},
+"documentContexts": {
+"description": "List of document contexts.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext"
+},
+"type": "array"
+},
+"extractiveAnswers": {
+"description": "List of extractive answers.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer"
+},
+"type": "array"
+},
+"extractiveSegments": {
+"description": "List of extractive segments.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveSegment"
+},
+"type": "array"
+},
+"title": {
+"description": "Title.",
+"type": "string"
+},
+"uri": {
+"description": "URI for the document.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext": {
+"description": "Document context.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext",
+"properties": {
+"content": {
+"description": "Document content.",
+"type": "string"
+},
+"pageIdentifier": {
+"description": "Page identifier.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer": {
+"description": "Extractive answer. [Guide](https://cloud.google.com/generative-ai-app-builder/docs/snippets#get-answers)",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer",
+"properties": {
+"content": {
+"description": "Extractive answer content.",
+"type": "string"
+},
+"pageIdentifier": {
+"description": "Page identifier.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveSegment": {
+"description": "Extractive segment. [Guide](https://cloud.google.com/generative-ai-app-builder/docs/snippets#extractive-segments)",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveSegment",
+"properties": {
+"content": {
+"description": "Extractive segment content.",
+"type": "string"
+},
+"pageIdentifier": {
+"description": "Page identifier.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryResponse": {
+"description": "Response message for ConversationalSearchService.AnswerQuery method.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryResponse",
+"properties": {
+"answer": {
+"$ref": "GoogleCloudDiscoveryengineV1Answer",
+"description": "Answer resource object. If AnswerQueryRequest.StepSpec.max_step_count is greater than 1, use Answer.name to fetch answer information using ConversationalSearchService.GetAnswer API."
+},
+"answerQueryToken": {
+"description": "A global unique ID used for logging.",
+"type": "string"
+},
+"session": {
+"$ref": "GoogleCloudDiscoveryengineV1Session",
+"description": "Session resource object. It will be only available when session field is set and valid in the AnswerQueryRequest request."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfo": {
+"description": "Query understanding information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfo",
+"properties": {
+"queryClassificationInfo": {
+"description": "Query classification information.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfoQueryClassificationInfo"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfoQueryClassificationInfo": {
+"description": "Query classification information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfoQueryClassificationInfo",
+"properties": {
+"positive": {
+"description": "Classification output.",
+"type": "boolean"
+},
+"type": {
+"description": "Query classification type.",
+"enum": [
+"TYPE_UNSPECIFIED",
+"ADVERSARIAL_QUERY",
+"NON_ANSWER_SEEKING_QUERY"
+],
+"enumDescriptions": [
+"Unspecified query classification type.",
+"Adversarial query classification type.",
+"Non-answer-seeking query classification type."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerReference": {
+"description": "Reference.",
+"id": "GoogleCloudDiscoveryengineV1AnswerReference",
+"properties": {
+"chunkInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerReferenceChunkInfo",
+"description": "Chunk information."
+},
+"unstructuredDocumentInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerReferenceUnstructuredDocumentInfo",
+"description": "Unstructured document information."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerReferenceChunkInfo": {
+"description": "Chunk information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerReferenceChunkInfo",
+"properties": {
+"chunk": {
+"description": "Chunk resource name.",
+"type": "string"
+},
+"content": {
+"description": "Chunk textual content.",
+"type": "string"
+},
+"documentMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerReferenceChunkInfoDocumentMetadata",
+"description": "Document metadata."
+},
+"relevanceScore": {
+"description": "Relevance score.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerReferenceChunkInfoDocumentMetadata": {
+"description": "Document metadata.",
+"id": "GoogleCloudDiscoveryengineV1AnswerReferenceChunkInfoDocumentMetadata",
+"properties": {
+"document": {
+"description": "Document resource name.",
+"type": "string"
+},
+"pageIdentifier": {
+"description": "Page identifier.",
+"type": "string"
+},
+"title": {
+"description": "Title.",
+"type": "string"
+},
+"uri": {
+"description": "URI for the document.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerReferenceUnstructuredDocumentInfo": {
+"description": "Unstructured document information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerReferenceUnstructuredDocumentInfo",
+"properties": {
+"chunkContents": {
+"description": "List of cited chunk contents derived from document content.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerReferenceUnstructuredDocumentInfoChunkContent"
+},
+"type": "array"
+},
+"document": {
+"description": "Document resource name.",
+"type": "string"
+},
+"title": {
+"description": "Title.",
+"type": "string"
+},
+"uri": {
+"description": "URI for the document.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerReferenceUnstructuredDocumentInfoChunkContent": {
+"description": "Chunk content.",
+"id": "GoogleCloudDiscoveryengineV1AnswerReferenceUnstructuredDocumentInfoChunkContent",
+"properties": {
+"content": {
+"description": "Chunk textual content.",
+"type": "string"
+},
+"pageIdentifier": {
+"description": "Page identifier.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStep": {
+"description": "Step information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStep",
+"properties": {
+"actions": {
+"description": "Actions.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepAction"
+},
+"type": "array"
+},
+"description": {
+"description": "The description of the step.",
+"type": "string"
+},
+"state": {
+"description": "The state of the step.",
+"enum": [
+"STATE_UNSPECIFIED",
+"IN_PROGRESS",
+"FAILED",
+"SUCCEEDED"
+],
+"enumDescriptions": [
+"Unknown.",
+"Step is currently in progress.",
+"Step currently failed.",
+"Step has succeeded."
+],
+"type": "string"
+},
+"thought": {
+"description": "The thought of the step.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepAction": {
+"description": "Action.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepAction",
+"properties": {
+"observation": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservation",
+"description": "Observation."
+},
+"searchAction": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction",
+"description": "Search action."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservation": {
+"description": "Observation.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservation",
+"properties": {
+"searchResults": {
+"description": "Search results observed by the search action, it can be snippets info or chunk info, depending on the citation type set by the user.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult": {
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult",
+"properties": {
+"chunkInfo": {
+"description": "If citation_type is CHUNK_LEVEL_CITATION and chunk mode is on, populate chunk info.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo"
+},
+"type": "array"
+},
+"document": {
+"description": "Document resource name.",
+"type": "string"
+},
+"snippetInfo": {
+"description": "If citation_type is DOCUMENT_LEVEL_CITATION, populate document level snippets.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo"
+},
+"type": "array"
+},
+"title": {
+"description": "Title.",
+"type": "string"
+},
+"uri": {
+"description": "URI for the document.",
 "type": "string"
+}
 },
-"lineNumber": {
-"description": "Line number of the content in file. Should be empty for permission or batch operation error.",
-"type": "string"
+"type": "object"
 },
-"operation": {
-"description": "The operation resource name of the LRO.",
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo": {
+"description": "Chunk information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo",
+"properties": {
+"chunk": {
+"description": "Chunk resource name.",
 "type": "string"
 },
-"userEvent": {
-"description": "The detailed content which caused the error on importing a user event.",
+"content": {
+"description": "Chunk textual content.",
 "type": "string"
+},
+"relevanceScore": {
+"description": "Relevance score.",
+"format": "float",
+"type": "number"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineLoggingServiceContext": {
-"description": "Describes a running service that sends errors.",
-"id": "GoogleCloudDiscoveryengineLoggingServiceContext",
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo": {
+"description": "Snippet information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo",
 "properties": {
-"service": {
-"description": "An identifier of the service\u2014for example, `discoveryengine.googleapis.com`.",
+"snippet": {
+"description": "Snippet content.",
+"type": "string"
+},
+"snippetStatus": {
+"description": "Status of the snippet defined by the search team.",
 "type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineLoggingSourceLocation": {
-"description": "Indicates a location in the source code of the service for which errors are reported.",
-"id": "GoogleCloudDiscoveryengineLoggingSourceLocation",
+"GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction": {
+"description": "Search action.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction",
 "properties": {
-"functionName": {
-"description": "Human-readable name of a function or method\u2014for example, `google.cloud.discoveryengine.v1alpha.RecommendationService.Recommend`.",
+"query": {
+"description": "The query to search.",
 "type": "string"
 }
 },
@@ -4590,6 +6174,106 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1CheckGroundingRequest": {
+"description": "Request message for GroundedGenerationService.CheckGrounding method.",
+"id": "GoogleCloudDiscoveryengineV1CheckGroundingRequest",
+"properties": {
+"answerCandidate": {
+"description": "Answer candidate to check. Can have a maximum length of 1024 characters.",
+"type": "string"
+},
+"facts": {
+"description": "List of facts for the grounding check. We support up to 200 facts.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1GroundingFact"
+},
+"type": "array"
+},
+"groundingSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1CheckGroundingSpec",
+"description": "Configuration of the grounding check."
+},
+"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"
+},
+"GoogleCloudDiscoveryengineV1CheckGroundingResponse": {
+"description": "Response message for the GroundedGenerationService.CheckGrounding method.",
+"id": "GoogleCloudDiscoveryengineV1CheckGroundingResponse",
+"properties": {
+"citedChunks": {
+"description": "List of facts cited across all claims in the answer candidate. These are derived from the facts supplied in the request.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1FactChunk"
+},
+"type": "array"
+},
+"claims": {
+"description": "Claim texts and citation info across all claims in the answer candidate.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim"
+},
+"type": "array"
+},
+"supportScore": {
+"description": "The support score for the input answer candidate. Higher the score, higher is the fraction of claims that are supported by the provided facts. This is always set when a response is returned.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim": {
+"description": "Text and citation info for a claim in the answer candidate.",
+"id": "GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim",
+"properties": {
+"citationIndices": {
+"description": "A list of indices (into 'cited_chunks') specifying the citations associated with the claim. For instance [1,3,4] means that cited_chunks[1], cited_chunks[3], cited_chunks[4] are the facts cited supporting for the claim. A citation to a fact indicates that the claim is supported by the fact.",
+"items": {
+"format": "int32",
+"type": "integer"
+},
+"type": "array"
+},
+"claimText": {
+"description": "Text for the claim in the answer candidate. Always provided regardless of whether citations or anti-citations are found.",
+"type": "string"
+},
+"endPos": {
+"description": "Position indicating the end of the claim in the answer candidate, exclusive.",
+"format": "int32",
+"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, and anti_citation_indices should not be returned.",
+"type": "boolean"
+},
+"startPos": {
+"description": "Position indicating the start of the claim in the answer candidate, measured in bytes.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1CheckGroundingSpec": {
+"description": "Specification for the grounding check.",
+"id": "GoogleCloudDiscoveryengineV1CheckGroundingSpec",
+"properties": {
+"citationThreshold": {
+"description": "The threshold (in [0,1]) used for determining whether a fact must be cited for a claim in the answer candidate. Choosing a higher threshold will lead to fewer but very strong citations, while choosing a lower threshold may lead to more but somewhat weaker citations. If unset, the threshold will default to 0.6.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1CloudSqlSource": {
 "description": "Cloud SQL source import data from.",
 "id": "GoogleCloudDiscoveryengineV1CloudSqlSource",
@@ -5207,7 +6891,7 @@
 "type": "array"
 },
 "quantity": {
-"description": "Quantity of the Document associated with the user event. Defaults to 1. For example, this field will be 2 if two quantities of the same Document are involved in a `add-to-cart` event. Required for events of the following event types: * `add-to-cart` * `purchase`",
+"description": "Quantity of the Document associated with the user event. Defaults to 1. For example, this field is 2 if two quantities of the same Document are involved in a `add-to-cart` event. Required for events of the following event types: * `add-to-cart` * `purchase`",
 "format": "int32",
 "type": "integer"
 },
@@ -5344,7 +7028,7 @@
 "type": "string"
 },
 "industryVertical": {
-"description": "The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore liniked to the engine.",
+"description": "The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.",
 "enum": [
 "INDUSTRY_VERTICAL_UNSPECIFIED",
 "GENERIC",
@@ -5490,6 +7174,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1FactChunk": {
+"description": "Fact Chunk.",
+"id": "GoogleCloudDiscoveryengineV1FactChunk",
+"properties": {
+"chunkText": {
+"description": "Text content of the fact chunk. Can be at most 10K characters long.",
+"type": "string"
+},
+"index": {
+"description": "The index of this chunk. Currently, only used for the streaming mode.",
+"format": "int32",
+"type": "integer"
+},
+"source": {
+"description": "Source from which this fact chunk was retrieved. If it was retrieved from the GroundingFacts provided in the request then this field will contain the index of the specific fact from which this chunk was retrieved.",
+"type": "string"
+},
+"sourceMetadata": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "More fine-grained information for the source reference.",
+"type": "object"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse": {
 "description": "Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.",
 "id": "GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse",
@@ -5533,7 +7244,7 @@
 "id": "GoogleCloudDiscoveryengineV1FirestoreSource",
 "properties": {
 "collectionId": {
-"description": "Required. The Firestore collection to copy the data from with a length limit of 1,500 characters.",
+"description": "Required. The Firestore collection (or entity) to copy the data from with a length limit of 1,500 characters.",
 "type": "string"
 },
 "databaseId": {
@@ -5556,11 +7267,11 @@
 "id": "GoogleCloudDiscoveryengineV1GcsSource",
 "properties": {
 "dataSchema": {
-"description": "The schema to use when parsing the data from the source. Supported values for document imports: * `document` (default): One JSON Document per line. Each document must have a valid Document.id. * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by `input_uris` becomes a document, with the ID set to the first 128 bits of SHA256(URI) encoded as a hex string. * `custom`: One custom data JSON per row in arbitrary format that conforms to the defined Schema of the data store. This can only be used by the GENERIC Data Store vertical. * `csv`: A CSV file with header conforming to the defined Schema of the data store. Each entry after the header is imported as a Document. This can only be used by the GENERIC Data Store vertical. Supported values for user even imports: * `user_event` (default): One JSON UserEvent per line.",
+"description": "The schema to use when parsing the data from the source. Supported values for document imports: * `document` (default): One JSON Document per line. Each document must have a valid Document.id. * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by `input_uris` becomes a document, with the ID set to the first 128 bits of SHA256(URI) encoded as a hex string. * `custom`: One custom data JSON per row in arbitrary format that conforms to the defined Schema of the data store. This can only be used by the GENERIC Data Store vertical. * `csv`: A CSV file with header conforming to the defined Schema of the data store. Each entry after the header is imported as a Document. This can only be used by the GENERIC Data Store vertical. Supported values for user event imports: * `user_event` (default): One JSON UserEvent per line.",
 "type": "string"
 },
 "inputUris": {
-"description": "Required. Cloud Storage URIs to input files. URI can be up to 2000 characters long. URIs can match the full object path (for example, `gs://bucket/directory/object.json`) or a pattern matching one or more files, such as `gs://bucket/directory/*.json`. A request can contain at most 100 files (or 100,000 files if `data_schema` is `content`). Each file can be up to 2 GB (or 100 MB if `data_schema` is `content`).",
+"description": "Required. Cloud Storage URIs to input files. Each URI can be up to 2000 characters long. URIs can match the full object path (for example, `gs://bucket/directory/object.json`) or a pattern matching one or more files, such as `gs://bucket/directory/*.json`. A request can contain at most 100 files (or 100,000 files if `data_schema` is `content`). Each file can be up to 2 GB (or 100 MB if `data_schema` is `content`).",
 "items": {
 "type": "string"
 },
@@ -5569,6 +7280,24 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1GroundingFact": {
+"description": "Grounding Fact.",
+"id": "GoogleCloudDiscoveryengineV1GroundingFact",
+"properties": {
+"attributes": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Attributes associated with the fact. Common attributes include `source` (indicating where the fact was sourced from), `author` (indicating the author of the fact), and so on.",
+"type": "object"
+},
+"factText": {
+"description": "Text content of the fact. Can be at most 10K characters long.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1ImportDocumentsMetadata": {
 "description": "Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1ImportDocumentsMetadata",
@@ -5993,6 +7722,24 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1ListSessionsResponse": {
+"description": "Response for ListSessions method.",
+"id": "GoogleCloudDiscoveryengineV1ListSessionsResponse",
+"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": "GoogleCloudDiscoveryengineV1Session"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1ListTargetSitesResponse": {
 "description": "Response message for SiteSearchEngineService.ListTargetSites method.",
 "id": "GoogleCloudDiscoveryengineV1ListTargetSitesResponse",
@@ -6189,16 +7936,100 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1Query": {
+"description": "Defines a user inputed query.",
+"id": "GoogleCloudDiscoveryengineV1Query",
+"properties": {
+"queryId": {
+"description": "Unique Id for the query.",
+"type": "string"
+},
+"text": {
+"description": "Plain text.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1RankRequest": {
+"description": "Request message for RankService.Rank method.",
+"id": "GoogleCloudDiscoveryengineV1RankRequest",
+"properties": {
+"ignoreRecordDetailsInResponse": {
+"description": "If true, the response will contain only record ID and score. By default, it is false, the response will contain record details.",
+"type": "boolean"
+},
+"model": {
+"description": "The identifier of the model to use. It is one of: * `semantic-ranker-512@latest`: Semantic ranking model with maxiumn input token size 512. It is set to `semantic-ranker-512@latest` by default if unspecified.",
+"type": "string"
+},
+"query": {
+"description": "The query to use.",
+"type": "string"
+},
+"records": {
+"description": "Required. A list of records to rank. At most 200 records to rank.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1RankingRecord"
+},
+"type": "array"
+},
+"topN": {
+"description": "The number of results to return. If this is unset or no bigger than zero, returns all results.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1RankResponse": {
+"description": "Response message for RankService.Rank method.",
+"id": "GoogleCloudDiscoveryengineV1RankResponse",
+"properties": {
+"records": {
+"description": "A list of records sorted by descending score.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1RankingRecord"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1RankingRecord": {
+"description": "Record message for RankService.Rank method.",
+"id": "GoogleCloudDiscoveryengineV1RankingRecord",
+"properties": {
+"content": {
+"description": "The content of the record. Empty by default. At least one of title or content should be set otherwise an INVALID_ARGUMENT error is thrown.",
+"type": "string"
+},
+"id": {
+"description": "The unique ID to represent the record.",
+"type": "string"
+},
+"score": {
+"description": "The score of this record based on the given query and selected model.",
+"format": "float",
+"type": "number"
+},
+"title": {
+"description": "The title of the record. Empty by default. At least one of title or content should be set otherwise an INVALID_ARGUMENT error is thrown.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1RecommendRequest": {
 "description": "Request message for Recommend method.",
 "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 will return 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 will never return Documents with `storageStatus` of `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: * (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.",
 "type": "string"
 },
 "pageSize": {
-"description": "Maximum number of results to return. Set this property to the number of recommendation results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
+"description": "Maximum number of results to return. Set this property to the number of recommendation results needed. If zero, the service chooses a reasonable default. The maximum allowed value is 100. Values above 100 are set to 100.",
 "format": "int32",
 "type": "integer"
 },
@@ -6206,7 +8037,7 @@
 "additionalProperties": {
 "type": "any"
 },
-"description": "Additional domain specific parameters for the recommendations. Allowed values: * `returnDocument`: Boolean. If set to true, the associated Document object will be returned in RecommendResponse.RecommendationResult.document. * `returnScore`: Boolean. If set to true, the recommendation 'score' corresponding to each returned Document will be set in RecommendResponse.RecommendationResult.metadata. The given 'score' indicates the probability of a Document conversion given the user's context and history. * `strictFiltering`: Boolean. True by default. If set to false, the service will return generic (unfiltered) popular Documents instead of empty if your filter blocks all recommendation results. * `diversityLevel`: String. Default empty. If set to be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-level control and adjusts recommendation results based on Document category. * `attributeFilteringSyntax`: Boolean. False by default. If set to true, the `filter` field is interpreted according to the new, attribute-based syntax.",
+"description": "Additional domain specific parameters for the recommendations. Allowed values: * `returnDocument`: Boolean. If set to `true`, the associated Document object is returned in RecommendResponse.RecommendationResult.document. * `returnScore`: Boolean. If set to true, the recommendation score corresponding to each returned Document is set in RecommendResponse.RecommendationResult.metadata. The given score indicates the probability of a Document conversion given the user's context and history. * `strictFiltering`: Boolean. True by default. If set to `false`, the service returns generic (unfiltered) popular Documents instead of empty if your filter blocks all recommendation results. * `diversityLevel`: String. Default empty. If set to be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-level control and adjusts recommendation results based on Document category. * `attributeFilteringSyntax`: Boolean. False by default. If set to true, the `filter` field is interpreted according to the new, attribute-based syntax.",
 "type": "object"
 },
 "userEvent": {
@@ -6221,7 +8052,7 @@
 "type": "object"
 },
 "validateOnly": {
-"description": "Use validate only mode for this recommendation query. If set to true, a fake model will be used that returns arbitrary Document IDs. Note that the validate only mode should only be used for testing the API, or if the model is not ready.",
+"description": "Use validate only mode for this recommendation query. If set to `true`, a fake model is used that returns arbitrary Document IDs. Note that the validate only mode should only be used for testing the API, or if the model is not ready.",
 "type": "boolean"
 }
 },
@@ -6272,7 +8103,7 @@
 "additionalProperties": {
 "type": "any"
 },
-"description": "Additional Document metadata / annotations. Possible values: * `score`: Recommendation score in double value. Is set if `returnScore` is set to true in RecommendRequest.params.",
+"description": "Additional Document metadata or annotations. Possible values: * `score`: Recommendation score in double value. Is set if `returnScore` is set to true in RecommendRequest.params.",
 "type": "object"
 }
 },
@@ -6352,7 +8183,7 @@
 "properties": {
 "boostSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpec",
-"description": "Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/retail/docs/boosting#boost)"
+"description": "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)"
 },
 "branch": {
 "description": "The branch resource name, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/branches/0`. Use `default_branch` as the branch ID or leave this field empty, to search documents under the default branch.",
@@ -6367,7 +8198,7 @@
 "description": "A specification for configuring the behavior of content search."
 },
 "dataStoreSpecs": {
-"description": "A list of data store specs to apply on a search call.",
+"description": "Specs defining dataStores to filter on in a search call and configurations for those dataStores. This is only considered for engines with multiple dataStores use case. For single dataStore within an engine, they should use the specs at the top level.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec"
 },
@@ -6410,7 +8241,7 @@
 "additionalProperties": {
 "type": "any"
 },
-"description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. Example: user_country_code: \"au\" For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. Example: search_type: 1",
+"description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`",
 "type": "object"
 },
 "query": {
@@ -6612,7 +8443,7 @@
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec": {
-"description": "A struct to define data stores to filter on in a search call.",
+"description": "A struct to define data stores to filter on in a search call and configurations for those data stores. A maximum of 1 DataStoreSpec per data_store is allowed. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "id": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec",
 "properties": {
 "dataStore": {
@@ -6642,7 +8473,7 @@
 "description": "Required. The facet key specification."
 },
 "limit": {
-"description": "Maximum of facet values that should be returned for this facet. If unspecified, defaults to 20. The maximum allowed value is 300. Values above 300 are coerced to 300. If this field is negative, an `INVALID_ARGUMENT` is returned.",
+"description": "Maximum facet values that are returned for this facet. If unspecified, defaults to 20. The maximum allowed value is 300. Values above 300 are coerced to 300. If this field is negative, an `INVALID_ARGUMENT` is returned.",
 "format": "int32",
 "type": "integer"
 }
@@ -6658,7 +8489,7 @@
 "type": "boolean"
 },
 "contains": {
-"description": "Only get facet values that contains the given strings. For example, suppose \"category\" has three values \"Action > 2022\", \"Action > 2021\" and \"Sci-Fi > 2022\". If set \"contains\" to \"2022\", the \"category\" facet only contains \"Action > 2022\" and \"Sci-Fi > 2022\". Only supported on textual fields. Maximum is 10.",
+"description": "Only get facet values that contain the given strings. For example, suppose \"category\" has three values \"Action > 2022\", \"Action > 2021\" and \"Sci-Fi > 2022\". If set \"contains\" to \"2022\", the \"category\" facet only contains \"Action > 2022\" and \"Sci-Fi > 2022\". Only supported on textual fields. Maximum is 10.",
 "items": {
 "type": "string"
 },
@@ -6737,7 +8568,7 @@
 "id": "GoogleCloudDiscoveryengineV1SearchRequestSpellCorrectionSpec",
 "properties": {
 "mode": {
-"description": "The mode under which spell correction should take effect to replace the original search query. Default to Mode.AUTO.",
+"description": "The mode under which spell correction replaces the original search query. Defaults to Mode.AUTO.",
 "enum": [
 "MODE_UNSPECIFIED",
 "SUGGESTION_ONLY",
@@ -6745,7 +8576,7 @@
 ],
 "enumDescriptions": [
 "Unspecified spell correction mode. In this case, server behavior defaults to Mode.AUTO.",
-"Search API will try to find a spell suggestion if there is any and put in the SearchResponse.corrected_query. The spell suggestion will not be used as the search query.",
+"Search API tries to find a spelling suggestion. If a suggestion is found, it is put in the SearchResponse.corrected_query. The spelling suggestion won't be used as the search query.",
 "Automatic spell correction built by the Search API. Search will be based on the corrected query if found."
 ],
 "type": "string"
@@ -6812,7 +8643,7 @@
 "type": "boolean"
 },
 "key": {
-"description": "The key for this facet. E.g., \"colors\" or \"price\". It matches SearchRequest.FacetSpec.FacetKey.key.",
+"description": "The key for this facet. For example, `\"colors\"` or `\"price\"`. It matches SearchRequest.FacetSpec.FacetKey.key.",
 "type": "string"
 },
 "values": {
@@ -6867,7 +8698,7 @@
 "properties": {
 "document": {
 "$ref": "GoogleCloudDiscoveryengineV1Document",
-"description": "The document data snippet in the search response. Only fields that are marked as retrievable are populated."
+"description": "The document data snippet in the search response. Only fields that are marked as `retrievable` are populated."
 },
 "id": {
 "description": "Document.id of the searched Document.",
@@ -6877,7 +8708,7 @@
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1SearchResponseSummary": {
-"description": "Summary of the top N search result specified by the summary spec.",
+"description": "Summary of the top N search results specified by the summary spec.",
 "id": "GoogleCloudDiscoveryengineV1SearchResponseSummary",
 "properties": {
 "safetyAttributes": {
@@ -7053,6 +8884,67 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1Session": {
+"description": "External session proto definition.",
+"id": "GoogleCloudDiscoveryengineV1Session",
+"properties": {
+"endTime": {
+"description": "Output only. The time the session finished.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`",
+"type": "string"
+},
+"startTime": {
+"description": "Output only. The time the session started.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"state": {
+"description": "The state of the session.",
+"enum": [
+"STATE_UNSPECIFIED",
+"IN_PROGRESS"
+],
+"enumDescriptions": [
+"State is unspecified.",
+"The session is currently open."
+],
+"type": "string"
+},
+"turns": {
+"description": "Turns.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1SessionTurn"
+},
+"type": "array"
+},
+"userPseudoId": {
+"description": "A unique identifier for tracking users.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1SessionTurn": {
+"description": "Represents a turn, including a query from the user and a answer from service.",
+"id": "GoogleCloudDiscoveryengineV1SessionTurn",
+"properties": {
+"answer": {
+"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"
+},
+"query": {
+"$ref": "GoogleCloudDiscoveryengineV1Query",
+"description": "The user query."
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1SiteSearchEngine": {
 "description": "SiteSearchEngine captures DataStore level site search persisting configurations. It is a singleton value per data store.",
 "id": "GoogleCloudDiscoveryengineV1SiteSearchEngine",
@@ -7331,7 +9223,7 @@
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1UserEvent": {
-"description": "UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with customers' website.",
+"description": "UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website.",
 "id": "GoogleCloudDiscoveryengineV1UserEvent",
 "properties": {
 "attributes": {
@@ -7401,7 +9293,7 @@
 "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 on the customer end.",
+"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"
 },
@@ -8366,7 +10258,7 @@
 "type": "string"
 },
 "industryVertical": {
-"description": "The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore liniked to the engine.",
+"description": "The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.",
 "enum": [
 "INDUSTRY_VERTICAL_UNSPECIFIED",
 "GENERIC",
@@ -9418,7 +11310,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaSessionTurn",
 "properties": {
 "answer": {
-"description": "The resource name of the answer to the user query.",
+"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"
 },
 "query": {
@@ -10106,7 +11998,7 @@
 "type": "string"
 },
 "industryVertical": {
-"description": "The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore liniked to the engine.",
+"description": "The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.",
 "enum": [
 "INDUSTRY_VERTICAL_UNSPECIFIED",
 "GENERIC",
@@ -10765,6 +12657,12 @@
 },
 "type": "object"
 },
+"GoogleLongrunningCancelOperationRequest": {
+"description": "The request message for Operations.CancelOperation.",
+"id": "GoogleLongrunningCancelOperationRequest",
+"properties": {},
+"type": "object"
+},
 "GoogleLongrunningListOperationsResponse": {
 "description": "The response message for Operations.ListOperations.",
 "id": "GoogleLongrunningListOperationsResponse",