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

googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json

@@ -795,7 +795,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Indicates which fields in the provided DataConnector to update. Supported field paths include: - refresh_interval - params - auto_run_disabled - action_config - destination_configs - blocking_reasons Note: Support for these fields may vary depending on the connector type. For example, not all connectors support `destination_configs`. If an unsupported or unknown field path is provided, the request will return an INVALID_ARGUMENT error.",
+"description": "Indicates which fields in the provided DataConnector to update. Supported field paths include: - refresh_interval - params - auto_run_disabled - action_config - destination_configs - blocking_reasons - sync_mode Note: Support for these fields may vary depending on the connector type. For example, not all connectors support `destination_configs`. If an unsupported or unknown field path is provided, the request will return an INVALID_ARGUMENT error.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -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": "20250331",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "ApiservingMediaRequestInfo": {
@@ -9060,6 +9093,11 @@
 "format": "byte",
 "type": "string"
 },
+"destinationBlobMintIndex": {
+"description": "For the first notification of a |diff_encoded| HttpRequestInfo, this is the index of the blob mint that Scotty should use when writing the resulting blob. This field is optional. It's not required ever, even if `original_object_blob_mint_index` is set. In situations like that, we will use the destination blob's mint for the destination blob and regular blob ACL checks for the original object. Note: This field is only for use by Drive API for diff uploads.",
+"format": "int32",
+"type": "integer"
+},
 "dynamicDropTarget": {
 "description": "Specifies the Scotty Drop Target to use for uploads. If present in a media response, Scotty does not upload to a standard drop zone. Instead, Scotty saves the upload directly to the location specified in this drop target. Unlike drop zones, the drop target is the final storage location for an upload. So, the agent does not need to clone the blob at the end of the upload. The agent is responsible for garbage collecting any orphaned blobs that may occur due to aborted uploads. For more information, see the drop target design doc here: http://goto/ScottyDropTarget This field will be preferred to dynamicDropzone. If provided, the identified field in the response must be of the type uploader.agent.DropTarget.",
 "format": "byte",
@@ -9073,6 +9111,11 @@
 "$ref": "GdataMedia",
 "description": "Diff Updates must respond to a START notification with this Media proto to tell Scotty to decode the diff encoded payload and apply the diff against this field. If the request was diff encoded, but this field is not set, Scotty will treat the encoding as identity. This is corresponding to Apiary's DiffUploadResponse.original_object (//depot/google3/gdata/rosy/proto/data.proto?l=413). See go/esf-scotty-diff-upload for more information."
 },
+"originalObjectBlobMintIndex": {
+"description": "For the first notification of a |diff_encoded| HttpRequestInfo, this is the index of the blob mint that Scotty should use when reading the original blob. This field is optional. It's not required ever, even if `destination_blob_mint_index` is set. In situations like that, we will use the destination blob's mint for the destination blob and regular blob ACL checks for the original object. Note: This field is only for use by Drive API for diff uploads.",
+"format": "int32",
+"type": "integer"
+},
 "requestClass": {
 "description": "Request class to use for all Blobstore operations for this request.",
 "enum": [
@@ -10054,6 +10097,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 +10525,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."
@@ -10859,7 +10923,16 @@
 "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig": {
 "description": "The layout parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig",
-"properties": {},
+"properties": {
+"enableImageAnnotation": {
+"description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
+"type": "boolean"
+},
+"enableTableAnnotation": {
+"description": "Optional. If true, the LLM based annotation is added to the table during parsing.",
+"type": "boolean"
+}
+},
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigOcrParsingConfig": {
@@ -12285,6 +12358,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 +12432,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 +12799,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 +12894,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 +13098,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 +13120,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 +13696,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 +13823,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 +14684,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": {
@@ -15716,6 +15907,10 @@
 "readOnly": true,
 "type": "string"
 },
+"realtimeSyncConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfig",
+"description": "Optional. The configuration for realtime sync."
+},
 "refreshInterval": {
 "description": "Required. The refresh interval for data sync. If duration is set to 0, the data will be synced in real time. The streaming feature is not supported yet. The minimum is 30 minutes and maximum is 7 days.",
 "format": "google-duration",
@@ -15779,6 +15974,21 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfig": {
+"description": "The configuration for realtime sync to store additional params for realtime sync.",
+"id": "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfig",
+"properties": {
+"realtimeSyncSecret": {
+"description": "Optional. The ID of the Secret Manager secret used for webhook secret.",
+"type": "string"
+},
+"webhookUri": {
+"description": "Optional. Webhook url for the connector to specify additional params for realtime sync.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity": {
 "description": "Represents an entity in the data source. For example, the `Account` object in Salesforce.",
 "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity",
@@ -16511,7 +16721,16 @@
 "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfigLayoutParsingConfig": {
 "description": "The layout parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
-"properties": {},
+"properties": {
+"enableImageAnnotation": {
+"description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
+"type": "boolean"
+},
+"enableTableAnnotation": {
+"description": "Optional. If true, the LLM based annotation is added to the table during parsing.",
+"type": "boolean"
+}
+},
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfigOcrParsingConfig": {
@@ -20083,7 +20302,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 +20382,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 +20472,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 +20704,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 +20742,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 +21595,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 +21720,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 +21766,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."
@@ -22538,6 +22846,10 @@
 "description": "Information of an end user.",
 "id": "GoogleCloudDiscoveryengineV1alphaUserInfo",
 "properties": {
+"timeZone": {
+"description": "Optional. IANA time zone, e.g. Europe/Budapest.",
+"type": "string"
+},
 "userAgent": {
 "description": "User agent as included in the HTTP header. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.",
 "type": "string"
@@ -23345,6 +23657,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 +24102,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."
@@ -24181,7 +24514,16 @@
 "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig": {
 "description": "The layout parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
-"properties": {},
+"properties": {
+"enableImageAnnotation": {
+"description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
+"type": "boolean"
+},
+"enableTableAnnotation": {
+"description": "Optional. If true, the LLM based annotation is added to the table during parsing.",
+"type": "boolean"
+}
+},
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigOcrParsingConfig": {
@@ -25265,7 +25607,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 +25687,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 +25777,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 +26009,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 +26047,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",
@@ -26316,6 +26685,10 @@
 "description": "Information of an end user.",
 "id": "GoogleCloudDiscoveryengineV1betaUserInfo",
 "properties": {
+"timeZone": {
+"description": "Optional. IANA time zone, e.g. Europe/Budapest.",
+"type": "string"
+},
 "userAgent": {
 "description": "User agent as included in the HTTP header. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.",
 "type": "string"