google-api-python-client 2.165.0__py2.py3-none-any.whl → 2.166.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json

@@ -8291,6 +8291,39 @@
 }
 }
 },
+"podcasts": {
+"resources": {
+"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": "v1alpha/projects/{projectsId}/locations/{locationsId}/podcasts/{podcastsId}/operations/{operationsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.podcasts.operations.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/podcasts/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+}
+}
+},
 "rankingConfigs": {
 "methods": {
 "rank": {
@@ -8983,7 +9016,7 @@
 }
 }
 },
-"revision": "20250312",
+"revision": "20250320",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "ApiservingMediaRequestInfo": {
@@ -10054,6 +10087,23 @@
 "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.",
 "type": "string"
 },
+"notebooklmState": {
+"description": "Output only. Whether the NotebookLM Corpus is ready to be used.",
+"enum": [
+"NOTEBOOK_LM_STATE_UNSPECIFIED",
+"NOTEBOOK_LM_NOT_READY",
+"NOTEBOOK_LM_READY",
+"NOTEBOOK_LM_NOT_ENABLED"
+],
+"enumDescriptions": [
+"The NotebookLM state is unknown.",
+"The NotebookLM is not ready.",
+"The NotebookLM is ready to be used.",
+"The NotebookLM is not enabled."
+],
+"readOnly": true,
+"type": "string"
+},
 "singleRegionKeys": {
 "description": "Optional. Single-regional CMEKs that are required for some VAIS features.",
 "items": {
@@ -10465,6 +10515,10 @@
 "description": "DataStore captures global settings and configs at the DataStore level.",
 "id": "GoogleCloudDiscoveryengineV1DataStore",
 "properties": {
+"aclEnabled": {
+"description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.",
+"type": "boolean"
+},
 "advancedSiteSearchConfig": {
 "$ref": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig",
 "description": "Optional. Configuration for advanced site search."
@@ -12285,6 +12339,10 @@
 "description": "Output only. The connector contains the necessary parameters and is configured to support actions.",
 "readOnly": true,
 "type": "boolean"
+},
+"serviceName": {
+"description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.",
+"type": "string"
 }
 },
 "type": "object"
@@ -12355,7 +12413,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec",
 "properties": {
 "conditionBoostSpecs": {
-"description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.",
+"description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifications, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec"
 },
@@ -12722,6 +12780,13 @@
 "description": "The textual answer.",
 "type": "string"
 },
+"blobAttachments": {
+"description": "List of blob attachments in the answer.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment"
+},
+"type": "array"
+},
 "citations": {
 "description": "Citations.",
 "items": {
@@ -12810,6 +12875,51 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment": {
+"description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment",
+"properties": {
+"attributionType": {
+"description": "Output only. The attribution type of the blob.",
+"enum": [
+"ATTRIBUTION_TYPE_UNSPECIFIED",
+"CORPUS",
+"GENERATED"
+],
+"enumDescriptions": [
+"Unspecified attribution type.",
+"The attachment data is from the corpus.",
+"The attachment data is generated by the model through code generation."
+],
+"readOnly": true,
+"type": "string"
+},
+"data": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob",
+"description": "Output only. The mime type and data of the blob.",
+"readOnly": true
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob": {
+"description": "The media type and data of the blob.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob",
+"properties": {
+"data": {
+"description": "Output only. Raw bytes.",
+"format": "byte",
+"readOnly": true,
+"type": "string"
+},
+"mimeType": {
+"description": "Output only. The media type (MIME type) of the generated or retrieved data.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaAnswerCitation": {
 "description": "Citation info for a segment.",
 "id": "GoogleCloudDiscoveryengineV1alphaAnswerCitation",
@@ -12969,6 +13079,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecModelSpec",
 "description": "Answer generation model specification."
 },
+"multimodalSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec",
+"description": "Optional. Multimodal specification."
+},
 "promptSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec",
 "description": "Answer generation prompt specification."
@@ -12987,6 +13101,29 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec": {
+"description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec",
+"properties": {
+"imageSource": {
+"description": "Optional. Source of image returned in the answer.",
+"enum": [
+"IMAGE_SOURCE_UNSPECIFIED",
+"ALL_AVAILABLE_SOURCES",
+"CORPUS_IMAGE_ONLY",
+"FIGURE_GENERATION_ONLY"
+],
+"enumDescriptions": [
+"Unspecified image source (multimodal feature is disabled by default).",
+"Behavior when service determines the pick from all available sources.",
+"Includes image from corpus in the answer.",
+"Triggers figure generation in the answer."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec": {
 "description": "Answer generation prompt specification.",
 "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec",
@@ -13540,6 +13677,15 @@
 "description": "Chunk information.",
 "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo",
 "properties": {
+"blobAttachmentIndexes": {
+"description": "Output only. Stores indexes of blobattachments linked to this chunk.",
+"items": {
+"format": "int64",
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
 "chunk": {
 "description": "Chunk resource name.",
 "type": "string"
@@ -13658,6 +13804,15 @@
 "description": "Chunk content.",
 "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent",
 "properties": {
+"blobAttachmentIndexes": {
+"description": "Output only. Stores indexes of blobattachments linked to this chunk.",
+"items": {
+"format": "int64",
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
 "content": {
 "description": "Chunk textual content.",
 "type": "string"
@@ -14510,6 +14665,23 @@
 "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.",
 "type": "string"
 },
+"notebooklmState": {
+"description": "Output only. Whether the NotebookLM Corpus is ready to be used.",
+"enum": [
+"NOTEBOOK_LM_STATE_UNSPECIFIED",
+"NOTEBOOK_LM_NOT_READY",
+"NOTEBOOK_LM_READY",
+"NOTEBOOK_LM_NOT_ENABLED"
+],
+"enumDescriptions": [
+"The NotebookLM state is unknown.",
+"The NotebookLM is not ready.",
+"The NotebookLM is ready to be used.",
+"The NotebookLM is not enabled."
+],
+"readOnly": true,
+"type": "string"
+},
 "singleRegionKeys": {
 "description": "Optional. Single-regional CMEKs that are required for some VAIS features.",
 "items": {
@@ -20083,7 +20255,7 @@
 "description": "Custom fine tuning configs. If set, it has higher priority than the configs set in ServingConfig.custom_fine_tuning_spec."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific [DataStore]s to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
 },
@@ -20163,13 +20335,13 @@
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the ranking_expression_backend value. If ranking_expression_backend is not provided, it defaults to BYOE. === BYOE === If ranking expression is not provided or set to BYOE, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. === CLEARBOX === If ranking expression is set to CLEARBOX, the following expression types (and combinations of those chained using + or * operators) are supported: * double * signal * log(signal) * exp(signal) * rr(signal, double > 0) -- reciprocal rank transformation with second argument being a denominator constant. * is_nan(signal) -- returns 0 if signal is NaN, 1 otherwise. * fill_nan(signal1, signal2 | double) -- if signal1 is NaN, returns signal2 | double, else returns signal1. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: * gecko_score -- semantic similarity adjustment * bm25_score -- keyword match adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank -- predicted conversion rate adjustment as a rank * freshness_rank -- freshness adjustment as a rank * base_rank -- the default rank of the result",
+"description": "The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the ranking_expression_backend value. If ranking_expression_backend is not provided, it defaults to BYOE. === BYOE === If ranking_expression_backend is not provided or set to `BYOE`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. === CLEARBOX === If ranking_expression_backend is set to `CLEARBOX`, the following expression types (and combinations of those chained using + or * operators) are supported: * double * signal * log(signal) * exp(signal) * rr(signal, double > 0) -- reciprocal rank transformation with second argument being a denominator constant. * is_nan(signal) -- returns 0 if signal is NaN, 1 otherwise. * fill_nan(signal1, signal2 | double) -- if signal1 is NaN, returns signal2 | double, else returns signal1. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: * gecko_score -- semantic similarity adjustment * bm25_score -- keyword match adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank -- predicted conversion rate adjustment as a rank * freshness_rank -- freshness adjustment as a rank * base_rank -- the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
 "description": "Optional. The backend to use for the ranking expression evaluation.",
 "enum": [
-"UNKNOWN",
+"RANKING_EXPRESSION_BACKEND_UNSPECIFIED",
 "BYOE",
 "CLEARBOX"
 ],
@@ -20253,7 +20425,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestBoostSpec",
 "properties": {
 "conditionBoostSpecs": {
-"description": "Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
+"description": "Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestBoostSpecConditionBoostSpec"
 },
@@ -20485,6 +20657,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec",
 "description": "If specified, the spec will be used to modify the model specification provided to the LLM."
 },
+"multimodalSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec",
+"description": "Optional. Multimodal specification."
+},
 "summaryResultCount": {
 "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.",
 "format": "int32",
@@ -20519,6 +20695,29 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": {
+"description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.",
+"id": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec",
+"properties": {
+"imageSource": {
+"description": "Optional. Source of image returned in the answer.",
+"enum": [
+"IMAGE_SOURCE_UNSPECIFIED",
+"ALL_AVAILABLE_SOURCES",
+"CORPUS_IMAGE_ONLY",
+"FIGURE_GENERATION_ONLY"
+],
+"enumDescriptions": [
+"Unspecified image source (multimodal feature is disabled by default).",
+"Behavior when service determines the pick from all available sources.",
+"Includes image from corpus in the answer.",
+"Triggers figure generation in the answer."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec": {
 "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec",
@@ -21349,6 +21548,51 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment": {
+"description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.",
+"id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment",
+"properties": {
+"attributionType": {
+"description": "Output only. The attribution type of the blob.",
+"enum": [
+"ATTRIBUTION_TYPE_UNSPECIFIED",
+"CORPUS",
+"GENERATED"
+],
+"enumDescriptions": [
+"Unspecified attribution type.",
+"The attachment data is from the corpus.",
+"The attachment data is generated by the model through code generation."
+],
+"readOnly": true,
+"type": "string"
+},
+"data": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob",
+"description": "Output only. The blob data.",
+"readOnly": true
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob": {
+"description": "Stores type and data of the blob.",
+"id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob",
+"properties": {
+"data": {
+"description": "Output only. Raw bytes.",
+"format": "byte",
+"readOnly": true,
+"type": "string"
+},
+"mimeType": {
+"description": "Output only. The media type (MIME type) of the generated data.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitation": {
 "description": "Citation info for a segment.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitation",
@@ -21429,6 +21673,15 @@
 "description": "Chunk content.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryReferenceChunkContent",
 "properties": {
+"blobAttachmentIndexes": {
+"description": "Output only. Stores indexes of blobattachments linked to this chunk.",
+"items": {
+"format": "int64",
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
 "content": {
 "description": "Chunk textual content.",
 "type": "string"
@@ -21466,6 +21719,14 @@
 "description": "Summary with metadata information.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummarySummaryWithMetadata",
 "properties": {
+"blobAttachments": {
+"description": "Output only. Store multimodal data for answer enhancement.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment"
+},
+"readOnly": true,
+"type": "array"
+},
 "citationMetadata": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitationMetadata",
 "description": "Citation metadata for given summary."
@@ -23345,6 +23606,23 @@
 "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.",
 "type": "string"
 },
+"notebooklmState": {
+"description": "Output only. Whether the NotebookLM Corpus is ready to be used.",
+"enum": [
+"NOTEBOOK_LM_STATE_UNSPECIFIED",
+"NOTEBOOK_LM_NOT_READY",
+"NOTEBOOK_LM_READY",
+"NOTEBOOK_LM_NOT_ENABLED"
+],
+"enumDescriptions": [
+"The NotebookLM state is unknown.",
+"The NotebookLM is not ready.",
+"The NotebookLM is ready to be used.",
+"The NotebookLM is not enabled."
+],
+"readOnly": true,
+"type": "string"
+},
 "singleRegionKeys": {
 "description": "Optional. Single-regional CMEKs that are required for some VAIS features.",
 "items": {
@@ -23773,6 +24051,10 @@
 "description": "DataStore captures global settings and configs at the DataStore level.",
 "id": "GoogleCloudDiscoveryengineV1betaDataStore",
 "properties": {
+"aclEnabled": {
+"description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.",
+"type": "boolean"
+},
 "advancedSiteSearchConfig": {
 "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig",
 "description": "Optional. Configuration for advanced site search."
@@ -25265,7 +25547,7 @@
 "description": "A specification for configuring the behavior of content search."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific [DataStore]s to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec"
 },
@@ -25345,13 +25627,13 @@
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the ranking_expression_backend value. If ranking_expression_backend is not provided, it defaults to BYOE. === BYOE === If ranking expression is not provided or set to BYOE, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. === CLEARBOX === If ranking expression is set to CLEARBOX, the following expression types (and combinations of those chained using + or * operators) are supported: * double * signal * log(signal) * exp(signal) * rr(signal, double > 0) -- reciprocal rank transformation with second argument being a denominator constant. * is_nan(signal) -- returns 0 if signal is NaN, 1 otherwise. * fill_nan(signal1, signal2 | double) -- if signal1 is NaN, returns signal2 | double, else returns signal1. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: * gecko_score -- semantic similarity adjustment * bm25_score -- keyword match adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank -- predicted conversion rate adjustment as a rank * freshness_rank -- freshness adjustment as a rank * base_rank -- the default rank of the result",
+"description": "The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the ranking_expression_backend value. If ranking_expression_backend is not provided, it defaults to BYOE. === BYOE === If ranking_expression_backend is not provided or set to `BYOE`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. === CLEARBOX === If ranking_expression_backend is set to `CLEARBOX`, the following expression types (and combinations of those chained using + or * operators) are supported: * double * signal * log(signal) * exp(signal) * rr(signal, double > 0) -- reciprocal rank transformation with second argument being a denominator constant. * is_nan(signal) -- returns 0 if signal is NaN, 1 otherwise. * fill_nan(signal1, signal2 | double) -- if signal1 is NaN, returns signal2 | double, else returns signal1. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: * gecko_score -- semantic similarity adjustment * bm25_score -- keyword match adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank -- predicted conversion rate adjustment as a rank * freshness_rank -- freshness adjustment as a rank * base_rank -- the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
 "description": "Optional. The backend to use for the ranking expression evaluation.",
 "enum": [
-"UNKNOWN",
+"RANKING_EXPRESSION_BACKEND_UNSPECIFIED",
 "BYOE",
 "CLEARBOX"
 ],
@@ -25435,7 +25717,7 @@
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec",
 "properties": {
 "conditionBoostSpecs": {
-"description": "Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
+"description": "Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpecConditionBoostSpec"
 },
@@ -25667,6 +25949,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec",
 "description": "If specified, the spec will be used to modify the model specification provided to the LLM."
 },
+"multimodalSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec",
+"description": "Optional. Multimodal specification."
+},
 "summaryResultCount": {
 "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.",
 "format": "int32",
@@ -25701,6 +25987,29 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": {
+"description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.",
+"id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec",
+"properties": {
+"imageSource": {
+"description": "Optional. Source of image returned in the answer.",
+"enum": [
+"IMAGE_SOURCE_UNSPECIFIED",
+"ALL_AVAILABLE_SOURCES",
+"CORPUS_IMAGE_ONLY",
+"FIGURE_GENERATION_ONLY"
+],
+"enumDescriptions": [
+"Unspecified image source (multimodal feature is disabled by default).",
+"Behavior when service determines the pick from all available sources.",
+"Includes image from corpus in the answer.",
+"Triggers figure generation in the answer."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec": {
 "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec",