google-api-python-client 2.152.0__py2.py3-none-any.whl → 2.154.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json

@@ -15,6 +15,28 @@
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
 "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
+"endpoints": [
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/",
+"location": "asia-northeast1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/",
+"location": "europe-west2"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.us.rep.googleapis.com/",
+"location": "us"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
+"location": "eu"
+}
+],
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -7823,6 +7845,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"import": {
+"description": "Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userEvents:import",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.userEvents.import",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Parent DataStore resource name, of the form `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/userEvents:import",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaImportUserEventsRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -8007,7 +8057,7 @@
 }
 }
 },
-"revision": "20241030",
+"revision": "20241110",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -10719,7 +10769,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 }
@@ -11571,7 +11621,14 @@
 "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": "GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseFactChunk"
+"$ref": "GoogleCloudDiscoveryengineV1alphaFactChunk"
+},
+"type": "array"
+},
+"citedFacts": {
+"description": "List of facts cited across all claims in the answer candidate. These are derived from the facts supplied in the request.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseCheckGroundingFactChunk"
 },
 "type": "array"
 },
@@ -11590,6 +11647,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseCheckGroundingFactChunk": {
+"description": "Fact chunk for grounding check.",
+"id": "GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseCheckGroundingFactChunk",
+"properties": {
+"chunkText": {
+"description": "Text content of the fact chunk. Can be at most 10K characters long.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseClaim": {
 "description": "Text and citation info for a claim in the answer candidate.",
 "id": "GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseClaim",
@@ -11612,7 +11680,7 @@
 "type": "integer"
 },
 "groundingCheckRequired": {
-"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, anti_citation_indices, and score should not be returned.",
+"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices should not be returned.",
 "type": "boolean"
 },
 "startPos": {
@@ -11623,21 +11691,6 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseFactChunk": {
-"description": "Fact chunk for grounding check.",
-"id": "GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseFactChunk",
-"properties": {
-"chunkText": {
-"description": "Text content of the fact chunk. Can be at most 10K characters long.",
-"type": "string"
-},
-"source": {
-"description": "Source from which this fact chunk was retrieved. For a fact chunk retrieved from inline facts, this field will contain the index of the specific fact from which this chunk was retrieved.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudDiscoveryengineV1alphaCheckGroundingSpec": {
 "description": "Specification for the grounding check.",
 "id": "GoogleCloudDiscoveryengineV1alphaCheckGroundingSpec",
@@ -11692,20 +11745,8 @@
 "$ref": "GoogleTypeExpr",
 "description": "The condition for evaluating the requirement result."
 },
-"requirementResult": {
-"description": "Requirement result, e.g. pass or fail.",
-"enum": [
-"UNKNOWN",
-"SUCCESS",
-"FAILURE",
-"WARNING"
-],
-"enumDescriptions": [
-"The requirement is unknown.",
-"The requirement check is passed.",
-"The requirement check fails to meet at least one blocking threshold.",
-"The requirement check fails at least one warning threshold, but passes all blocking thresholds."
-],
+"result": {
+"description": "The result of the requirement. It should be one of the `severity` fields in the requirement definition. If any error happens during the evaluation, it will be `UNKNOWN`.",
 "type": "string"
 }
 },
@@ -11778,7 +11819,7 @@
 "description": "Page span of the chunk."
 },
 "relevanceScore": {
-"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse.",
+"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchResponse.",
 "format": "double",
 "readOnly": true,
 "type": "number"
@@ -13044,6 +13085,11 @@
 "description": "Detailed document information associated with a user event.",
 "id": "GoogleCloudDiscoveryengineV1alphaDocumentInfo",
 "properties": {
+"conversionValue": {
+"description": "Optional. The conversion value associated with this Document. Must be set if UserEvent.event_type is \"conversion\". For example, a value of 1000 signifies that 1000 seconds were spent viewing a Document for the `watch` conversion type.",
+"format": "float",
+"type": "number"
+},
 "id": {
 "description": "The Document resource ID.",
 "type": "string"
@@ -13719,6 +13765,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaFactChunk": {
+"description": "Fact Chunk.",
+"id": "GoogleCloudDiscoveryengineV1alphaFactChunk",
+"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"
+},
 "GoogleCloudDiscoveryengineV1alphaFetchDomainVerificationStatusResponse": {
 "description": "Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.",
 "id": "GoogleCloudDiscoveryengineV1alphaFetchDomainVerificationStatusResponse",
@@ -15032,6 +15105,13 @@
 "description": "The display name of the panel.",
 "type": "string"
 },
+"documents": {
+"description": "Optional. The document IDs associated with this panel.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaDocumentInfo"
+},
+"type": "array"
+},
 "panelId": {
 "description": "Required. The panel ID.",
 "type": "string"
@@ -15553,7 +15633,7 @@
 "type": "string"
 },
 "score": {
-"description": "The score of this record based on the given query and selected model.",
+"description": "The score of this record based on the given query and selected model. The score will be rounded to 2 decimal places. If the score is close to 0, it will be rounded to 0.0001 to avoid returning unset.",
 "format": "float",
 "type": "number"
 },
@@ -15896,6 +15976,13 @@
 },
 "type": "array"
 },
+"severity": {
+"description": "The severity of errors if the requirement is not met. It must be ordered from the most strict to the least strict. Examples: * `BLOCKING` * `CRITICAL` * `WARNING` All thresholds in the requirement must have all the severity here.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "thresholdBindings": {
 "description": "A list of threshold bindings to be used in `condition`.",
 "items": {
@@ -15948,21 +16035,34 @@
 "description": "Specifies a multi-level threshold to apply to apply to a `metric_bindings` in the `condition` CEL expression.",
 "id": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBinding",
 "properties": {
-"blockingThreshold": {
-"description": "Threshold to trigger a blocking failure. If not met, the requirement will evaluate as a `FAILURE`.",
-"format": "double",
-"type": "number"
-},
 "description": {
 "description": "Human readable description of the corresponding threshold and sub-requirement.",
 "type": "string"
 },
+"thresholdValues": {
+"description": "The values of the threshold. The values should be ordered from the most strict to the least strict.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBindingThresholdValue"
+},
+"type": "array"
+},
 "variableId": {
 "description": "The variable id to be referenced in `condition`. Must be unique across all `metric_bindings` and `threshold_bindings`.",
 "type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaRequirementThresholdBindingThresholdValue": {
+"description": "Specifies a threshold value for a given severity.",
+"id": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBindingThresholdValue",
+"properties": {
+"severity": {
+"description": "The severity of errors if the threshold is not met. It should be one of the `severity` fields in the requirement.",
+"type": "string"
 },
-"warningThreshold": {
-"description": "Threshold to trigger a warning. If not met, the requirement will evaluate as a `WARNING`.",
+"value": {
+"description": "The value of the threshold.",
 "format": "double",
 "type": "number"
 }
@@ -16417,7 +16517,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -17696,6 +17796,11 @@
 "description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
+"detailedAnswer": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
 "description": "The user query."
@@ -18211,6 +18316,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaCompletionInfo",
 "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
 },
+"conversionType": {
+"description": "Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by \"-\", such as \"watch\", \"good-visit\" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc.",
+"type": "string"
+},
 "dataStore": {
 "description": "The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted.",
 "type": "string"
@@ -18236,7 +18345,7 @@
 "type": "string"
 },
 "eventType": {
-"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.",
+"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. Custom conversion value: * `conversion`: Customer defined conversion event.",
 "type": "string"
 },
 "filter": {
@@ -18255,6 +18364,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaPanelInfo",
 "description": "Panel metadata associated with this user event."
 },
+"panels": {
+"description": "Optional. List of panels associated with this event. Used for page-level impression data.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaPanelInfo"
+},
+"type": "array"
+},
 "promotionIds": {
 "description": "The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.",
 "items": {
@@ -20364,7 +20480,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },

googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json

@@ -15,6 +15,28 @@
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
 "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
+"endpoints": [
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/",
+"location": "asia-northeast1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/",
+"location": "europe-west2"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.us.rep.googleapis.com/",
+"location": "us"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
+"location": "eu"
+}
+],
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -7095,6 +7117,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"import": {
+"description": "Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/userEvents:import",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.userEvents.import",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Parent DataStore resource name, of the form `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/userEvents:import",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaImportUserEventsRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -7205,7 +7255,7 @@
 }
 }
 },
-"revision": "20241030",
+"revision": "20241110",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -12403,7 +12453,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -12877,6 +12927,11 @@
 "description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
+"detailedAnswer": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
 "description": "The user query."
@@ -13923,7 +13978,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 }
@@ -14775,7 +14830,14 @@
 "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": "GoogleCloudDiscoveryengineV1betaCheckGroundingResponseFactChunk"
+"$ref": "GoogleCloudDiscoveryengineV1betaFactChunk"
+},
+"type": "array"
+},
+"citedFacts": {
+"description": "List of facts cited across all claims in the answer candidate. These are derived from the facts supplied in the request.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaCheckGroundingResponseCheckGroundingFactChunk"
 },
 "type": "array"
 },
@@ -14794,6 +14856,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaCheckGroundingResponseCheckGroundingFactChunk": {
+"description": "Fact chunk for grounding check.",
+"id": "GoogleCloudDiscoveryengineV1betaCheckGroundingResponseCheckGroundingFactChunk",
+"properties": {
+"chunkText": {
+"description": "Text content of the fact chunk. Can be at most 10K characters long.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaCheckGroundingResponseClaim": {
 "description": "Text and citation info for a claim in the answer candidate.",
 "id": "GoogleCloudDiscoveryengineV1betaCheckGroundingResponseClaim",
@@ -14816,7 +14889,7 @@
 "type": "integer"
 },
 "groundingCheckRequired": {
-"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, anti_citation_indices, and score should not be returned.",
+"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices should not be returned.",
 "type": "boolean"
 },
 "startPos": {
@@ -14827,21 +14900,6 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1betaCheckGroundingResponseFactChunk": {
-"description": "Fact chunk for grounding check.",
-"id": "GoogleCloudDiscoveryengineV1betaCheckGroundingResponseFactChunk",
-"properties": {
-"chunkText": {
-"description": "Text content of the fact chunk. Can be at most 10K characters long.",
-"type": "string"
-},
-"source": {
-"description": "Source from which this fact chunk was retrieved. For a fact chunk retrieved from inline facts, this field will contain the index of the specific fact from which this chunk was retrieved.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudDiscoveryengineV1betaCheckGroundingSpec": {
 "description": "Specification for the grounding check.",
 "id": "GoogleCloudDiscoveryengineV1betaCheckGroundingSpec",
@@ -14893,7 +14951,7 @@
 "description": "Page span of the chunk."
 },
 "relevanceScore": {
-"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse.",
+"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchResponse.",
 "format": "double",
 "readOnly": true,
 "type": "number"
@@ -16077,6 +16135,11 @@
 "description": "Detailed document information associated with a user event.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentInfo",
 "properties": {
+"conversionValue": {
+"description": "Optional. The conversion value associated with this Document. Must be set if UserEvent.event_type is \"conversion\". For example, a value of 1000 signifies that 1000 seconds were spent viewing a Document for the `watch` conversion type.",
+"format": "float",
+"type": "number"
+},
 "id": {
 "description": "The Document resource ID.",
 "type": "string"
@@ -16542,6 +16605,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaFactChunk": {
+"description": "Fact Chunk.",
+"id": "GoogleCloudDiscoveryengineV1betaFactChunk",
+"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"
+},
 "GoogleCloudDiscoveryengineV1betaFetchDomainVerificationStatusResponse": {
 "description": "Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.",
 "id": "GoogleCloudDiscoveryengineV1betaFetchDomainVerificationStatusResponse",
@@ -17543,6 +17633,13 @@
 "description": "The display name of the panel.",
 "type": "string"
 },
+"documents": {
+"description": "Optional. The document IDs associated with this panel.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaDocumentInfo"
+},
+"type": "array"
+},
 "panelId": {
 "description": "Required. The panel ID.",
 "type": "string"
@@ -17960,7 +18057,7 @@
 "type": "string"
 },
 "score": {
-"description": "The score of this record based on the given query and selected model.",
+"description": "The score of this record based on the given query and selected model. The score will be rounded to 2 decimal places. If the score is close to 0, it will be rounded to 0.0001 to avoid returning unset.",
 "format": "float",
 "type": "number"
 },
@@ -18545,7 +18642,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -19816,6 +19913,11 @@
 "description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
+"detailedAnswer": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1betaQuery",
 "description": "The user query."
@@ -20261,6 +20363,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaCompletionInfo",
 "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
 },
+"conversionType": {
+"description": "Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by \"-\", such as \"watch\", \"good-visit\" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc.",
+"type": "string"
+},
 "dataStore": {
 "description": "The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted.",
 "type": "string"
@@ -20286,7 +20392,7 @@
 "type": "string"
 },
 "eventType": {
-"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.",
+"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. Custom conversion value: * `conversion`: Customer defined conversion event.",
 "type": "string"
 },
 "filter": {
@@ -20305,6 +20411,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaPanelInfo",
 "description": "Panel metadata associated with this user event."
 },
+"panels": {
+"description": "Optional. List of panels associated with this event. Used for page-level impression data.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1betaPanelInfo"
+},
+"type": "array"
+},
 "promotionIds": {
 "description": "The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.",
 "items": {