google-apis-discoveryengine_v1 0.29.0 → 0.31.0

data/lib/google/apis/discoveryengine_v1/classes.rb

@@ -1406,6 +1406,12 @@ module Google
       class GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec
         include Google::Apis::Core::Hashable
       
+        # Optional. Whether to disable spell correction. The default value is `false`.
+        # Corresponds to the JSON property `disableSpellCorrection`
+        # @return [Boolean]
+        attr_accessor :disable_spell_correction
+        alias_method :disable_spell_correction?, :disable_spell_correction
+      
         # Query classification specification.
         # Corresponds to the JSON property `queryClassificationSpec`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec]
@@ -1422,6 +1428,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @disable_spell_correction = args[:disable_spell_correction] if args.key?(:disable_spell_correction)
           @query_classification_spec = args[:query_classification_spec] if args.key?(:query_classification_spec)
           @query_rephraser_spec = args[:query_rephraser_spec] if args.key?(:query_rephraser_spec)
         end
@@ -3254,6 +3261,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Output only. Whether the NotebookLM Corpus is ready to be used.
+        # Corresponds to the JSON property `notebooklmState`
+        # @return [String]
+        attr_accessor :notebooklm_state
+      
         # Optional. Single-regional CMEKs that are required for some VAIS features.
         # Corresponds to the JSON property `singleRegionKeys`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SingleRegionKey>]
@@ -3275,6 +3287,7 @@ module Google
           @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
           @last_rotation_timestamp_micros = args[:last_rotation_timestamp_micros] if args.key?(:last_rotation_timestamp_micros)
           @name = args[:name] if args.key?(:name)
+          @notebooklm_state = args[:notebooklm_state] if args.key?(:notebooklm_state)
           @single_region_keys = args[:single_region_keys] if args.key?(:single_region_keys)
           @state = args[:state] if args.key?(:state)
         end
@@ -4326,6 +4339,17 @@ module Google
       class GoogleCloudDiscoveryengineV1DataStore
         include Google::Apis::Core::Hashable
       
+        # 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.
+        # Corresponds to the JSON property `aclEnabled`
+        # @return [Boolean]
+        attr_accessor :acl_enabled
+        alias_method :acl_enabled?, :acl_enabled
+      
         # Configuration data for advance site search.
         # Corresponds to the JSON property `advancedSiteSearchConfig`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig]
@@ -4440,6 +4464,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @acl_enabled = args[:acl_enabled] if args.key?(:acl_enabled)
           @advanced_site_search_config = args[:advanced_site_search_config] if args.key?(:advanced_site_search_config)
           @billing_estimation = args[:billing_estimation] if args.key?(:billing_estimation)
           @cmek_config = args[:cmek_config] if args.key?(:cmek_config)
@@ -6628,6 +6653,25 @@ module Google
         end
       end
       
+      # Response message for CmekConfigService.ListCmekConfigs method.
+      class GoogleCloudDiscoveryengineV1ListCmekConfigsResponse
+        include Google::Apis::Core::Hashable
+      
+        # All the customer's CmekConfigs.
+        # Corresponds to the JSON property `cmekConfigs`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig>]
+        attr_accessor :cmek_configs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cmek_configs = args[:cmek_configs] if args.key?(:cmek_configs)
+        end
+      end
+      
       # Response for ListControls method.
       class GoogleCloudDiscoveryengineV1ListControlsResponse
         include Google::Apis::Core::Hashable
@@ -8093,7 +8137,8 @@ module Google
         # @return [String]
         attr_accessor :title
       
-        # Required. The URL for the page the user wants to promote.
+        # Optional. The URL for the page the user wants to promote. Must be set for site
+        # search. For other verticals, this is optional.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -8146,14 +8191,19 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec]
         attr_accessor :content_search_spec
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `dataStoreSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
       
+        # Specifies features for display, like match highlighting.
+        # Corresponds to the JSON property `displaySpec`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec]
+        attr_accessor :display_spec
+      
         # Facet specifications for faceted search. If empty, no facets are returned. A
         # maximum of 100 values are allowed. Otherwise, an `INVALID_ARGUMENT` error is
         # returned.
@@ -8354,6 +8404,7 @@ module Google
           @canonical_filter = args[:canonical_filter] if args.key?(:canonical_filter)
           @content_search_spec = args[:content_search_spec] if args.key?(:content_search_spec)
           @data_store_specs = args[:data_store_specs] if args.key?(:data_store_specs)
+          @display_spec = args[:display_spec] if args.key?(:display_spec)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
           @filter = args[:filter] if args.key?(:filter)
           @image_query = args[:image_query] if args.key?(:image_query)
@@ -8384,7 +8435,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Condition boost specifications. If a document matches multiple conditions in
-        # the specifictions, boost scores from these specifications are all applied and
+        # the specifications, boost scores from these specifications are all applied and
         # combined in a non-linear way. Maximum number of specifications is 20.
         # Corresponds to the JSON property `conditionBoostSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpec>]
@@ -8903,6 +8954,25 @@ module Google
         end
       end
       
+      # Specifies features for display, like match highlighting.
+      class GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec
+        include Google::Apis::Core::Hashable
+      
+        # The condition under which match highlighting should occur.
+        # Corresponds to the JSON property `matchHighlightingCondition`
+        # @return [String]
+        attr_accessor :match_highlighting_condition
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @match_highlighting_condition = args[:match_highlighting_condition] if args.key?(:match_highlighting_condition)
+        end
+      end
+      
       # A facet specification to perform faceted search.
       class GoogleCloudDiscoveryengineV1SearchRequestFacetSpec
         include Google::Apis::Core::Hashable
@@ -11028,6 +11098,14 @@ module Google
         attr_accessor :is_action_configured
         alias_method :is_action_configured?, :is_action_configured
       
+        # 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.
+        # Corresponds to the JSON property `serviceName`
+        # @return [String]
+        attr_accessor :service_name
+      
         def initialize(**args)
            update!(**args)
         end
@@ -11036,6 +11114,7 @@ module Google
         def update!(**args)
           @action_params = args[:action_params] if args.key?(:action_params)
           @is_action_configured = args[:is_action_configured] if args.key?(:is_action_configured)
+          @service_name = args[:service_name] if args.key?(:service_name)
         end
       end
       
@@ -11066,6 +11145,56 @@ module Google
         end
       end
       
+      # The connector level alert config.
+      class GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The enrollment states of each alert.
+        # Corresponds to the JSON property `alertEnrollments`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment>]
+        attr_accessor :alert_enrollments
+      
+        # Immutable. The fully qualified resource name of the AlertPolicy.
+        # Corresponds to the JSON property `alertPolicyName`
+        # @return [String]
+        attr_accessor :alert_policy_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @alert_enrollments = args[:alert_enrollments] if args.key?(:alert_enrollments)
+          @alert_policy_name = args[:alert_policy_name] if args.key?(:alert_policy_name)
+        end
+      end
+      
+      # The alert enrollment status.
+      class GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. The id of an alert.
+        # Corresponds to the JSON property `alertId`
+        # @return [String]
+        attr_accessor :alert_id
+      
+        # Required. The enrollment status of a customer.
+        # Corresponds to the JSON property `enrollState`
+        # @return [String]
+        attr_accessor :enroll_state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @alert_id = args[:alert_id] if args.key?(:alert_id)
+          @enroll_state = args[:enroll_state] if args.key?(:enroll_state)
+        end
+      end
+      
       # Defines an answer.
       class GoogleCloudDiscoveryengineV1alphaAnswer
         include Google::Apis::Core::Hashable
@@ -11081,6 +11210,11 @@ module Google
         # @return [String]
         attr_accessor :answer_text
       
+        # List of blob attachments in the answer.
+        # Corresponds to the JSON property `blobAttachments`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment>]
+        attr_accessor :blob_attachments
+      
         # Citations.
         # Corresponds to the JSON property `citations`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerCitation>]
@@ -11151,6 +11285,7 @@ module Google
         def update!(**args)
           @answer_skipped_reasons = args[:answer_skipped_reasons] if args.key?(:answer_skipped_reasons)
           @answer_text = args[:answer_text] if args.key?(:answer_text)
+          @blob_attachments = args[:blob_attachments] if args.key?(:blob_attachments)
           @citations = args[:citations] if args.key?(:citations)
           @complete_time = args[:complete_time] if args.key?(:complete_time)
           @create_time = args[:create_time] if args.key?(:create_time)
@@ -11166,6 +11301,57 @@ module Google
         end
       end
       
+      # Stores binarydata attached to text answer, e.g. image, video, audio, etc.
+      class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The attribution type of the blob.
+        # Corresponds to the JSON property `attributionType`
+        # @return [String]
+        attr_accessor :attribution_type
+      
+        # The media type and data of the blob.
+        # Corresponds to the JSON property `data`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob]
+        attr_accessor :data
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attribution_type = args[:attribution_type] if args.key?(:attribution_type)
+          @data = args[:data] if args.key?(:data)
+        end
+      end
+      
+      # The media type and data of the blob.
+      class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Raw bytes.
+        # Corresponds to the JSON property `data`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :data
+      
+        # Output only. The media type (MIME type) of the generated or retrieved data.
+        # Corresponds to the JSON property `mimeType`
+        # @return [String]
+        attr_accessor :mime_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @mime_type = args[:mime_type] if args.key?(:mime_type)
+        end
+      end
+      
       # Citation info for a segment.
       class GoogleCloudDiscoveryengineV1alphaAnswerCitation
         include Google::Apis::Core::Hashable
@@ -11350,6 +11536,11 @@ module Google
       class GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo
         include Google::Apis::Core::Hashable
       
+        # Output only. Stores indexes of blobattachments linked to this chunk.
+        # Corresponds to the JSON property `blobAttachmentIndexes`
+        # @return [Array<Fixnum>]
+        attr_accessor :blob_attachment_indexes
+      
         # Chunk resource name.
         # Corresponds to the JSON property `chunk`
         # @return [String]
@@ -11379,6 +11570,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @blob_attachment_indexes = args[:blob_attachment_indexes] if args.key?(:blob_attachment_indexes)
           @chunk = args[:chunk] if args.key?(:chunk)
           @content = args[:content] if args.key?(:content)
           @document_metadata = args[:document_metadata] if args.key?(:document_metadata)
@@ -11515,6 +11707,11 @@ module Google
       class GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent
         include Google::Apis::Core::Hashable
       
+        # Output only. Stores indexes of blobattachments linked to this chunk.
+        # Corresponds to the JSON property `blobAttachmentIndexes`
+        # @return [Array<Fixnum>]
+        attr_accessor :blob_attachment_indexes
+      
         # Chunk textual content.
         # Corresponds to the JSON property `content`
         # @return [String]
@@ -11539,6 +11736,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @blob_attachment_indexes = args[:blob_attachment_indexes] if args.key?(:blob_attachment_indexes)
           @content = args[:content] if args.key?(:content)
           @page_identifier = args[:page_identifier] if args.key?(:page_identifier)
           @relevance_score = args[:relevance_score] if args.key?(:relevance_score)
@@ -11856,6 +12054,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Output only. Whether the NotebookLM Corpus is ready to be used.
+        # Corresponds to the JSON property `notebooklmState`
+        # @return [String]
+        attr_accessor :notebooklm_state
+      
         # Optional. Single-regional CMEKs that are required for some VAIS features.
         # Corresponds to the JSON property `singleRegionKeys`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSingleRegionKey>]
@@ -11877,6 +12080,7 @@ module Google
           @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
           @last_rotation_timestamp_micros = args[:last_rotation_timestamp_micros] if args.key?(:last_rotation_timestamp_micros)
           @name = args[:name] if args.key?(:name)
+          @notebooklm_state = args[:notebooklm_state] if args.key?(:notebooklm_state)
           @single_region_keys = args[:single_region_keys] if args.key?(:single_region_keys)
           @state = args[:state] if args.key?(:state)
         end
@@ -12741,6 +12945,11 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaActionConfig]
         attr_accessor :action_config
       
+        # Optional. The connector level alert config.
+        # Corresponds to the JSON property `alertPolicyConfigs`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig>]
+        attr_accessor :alert_policy_configs
+      
         # Indicates whether the connector is disabled for auto run. It can be used to
         # pause periodical and real time sync.
         # Corresponds to the JSON property `autoRunDisabled`
@@ -12930,6 +13139,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @action_config = args[:action_config] if args.key?(:action_config)
+          @alert_policy_configs = args[:alert_policy_configs] if args.key?(:alert_policy_configs)
           @auto_run_disabled = args[:auto_run_disabled] if args.key?(:auto_run_disabled)
           @bap_config = args[:bap_config] if args.key?(:bap_config)
           @blocking_reasons = args[:blocking_reasons] if args.key?(:blocking_reasons)
@@ -16210,7 +16420,8 @@ module Google
         # @return [String]
         attr_accessor :title
       
-        # Required. The URL for the page the user wants to promote.
+        # Optional. The URL for the page the user wants to promote. Must be set for site
+        # search. For other verticals, this is optional.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -16268,10 +16479,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaCustomFineTuningSpec]
         attr_accessor :custom_fine_tuning_spec
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `dataStoreSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
@@ -16402,29 +16613,30 @@ module Google
         # 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
+        # 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
         # Corresponds to the JSON property `rankingExpression`
         # @return [String]
         attr_accessor :ranking_expression
@@ -16591,7 +16803,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Condition boost specifications. If a document matches multiple conditions in
-        # the specifictions, boost scores from these specifications are all applied and
+        # the specifications, boost scores from these specifications are all applied and
         # combined in a non-linear way. Maximum number of specifications is 20.
         # Corresponds to the JSON property `conditionBoostSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestBoostSpecConditionBoostSpec>]
@@ -16990,6 +17202,12 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec]
         attr_accessor :model_spec
       
+        # Multimodal specification: Will return an image from specified source. If
+        # multiple sources are specified, the pick is a quality based decision.
+        # Corresponds to the JSON property `multimodalSpec`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec]
+        attr_accessor :multimodal_spec
+      
         # 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
@@ -17023,6 +17241,7 @@ module Google
           @language_code = args[:language_code] if args.key?(:language_code)
           @model_prompt_spec = args[:model_prompt_spec] if args.key?(:model_prompt_spec)
           @model_spec = args[:model_spec] if args.key?(:model_spec)
+          @multimodal_spec = args[:multimodal_spec] if args.key?(:multimodal_spec)
           @summary_result_count = args[:summary_result_count] if args.key?(:summary_result_count)
           @use_semantic_chunks = args[:use_semantic_chunks] if args.key?(:use_semantic_chunks)
         end
@@ -17074,6 +17293,26 @@ module Google
         end
       end
       
+      # Multimodal specification: Will return an image from specified source. If
+      # multiple sources are specified, the pick is a quality based decision.
+      class GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Source of image returned in the answer.
+        # Corresponds to the JSON property `imageSource`
+        # @return [String]
+        attr_accessor :image_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @image_source = args[:image_source] if args.key?(:image_source)
+        end
+      end
+      
       # 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.
@@ -18367,6 +18606,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Output only. Whether the NotebookLM Corpus is ready to be used.
+        # Corresponds to the JSON property `notebooklmState`
+        # @return [String]
+        attr_accessor :notebooklm_state
+      
         # Optional. Single-regional CMEKs that are required for some VAIS features.
         # Corresponds to the JSON property `singleRegionKeys`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSingleRegionKey>]
@@ -18388,6 +18632,7 @@ module Google
           @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
           @last_rotation_timestamp_micros = args[:last_rotation_timestamp_micros] if args.key?(:last_rotation_timestamp_micros)
           @name = args[:name] if args.key?(:name)
+          @notebooklm_state = args[:notebooklm_state] if args.key?(:notebooklm_state)
           @single_region_keys = args[:single_region_keys] if args.key?(:single_region_keys)
           @state = args[:state] if args.key?(:state)
         end
@@ -18981,6 +19226,17 @@ module Google
       class GoogleCloudDiscoveryengineV1betaDataStore
         include Google::Apis::Core::Hashable
       
+        # 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.
+        # Corresponds to the JSON property `aclEnabled`
+        # @return [Boolean]
+        attr_accessor :acl_enabled
+        alias_method :acl_enabled?, :acl_enabled
+      
         # Configuration data for advance site search.
         # Corresponds to the JSON property `advancedSiteSearchConfig`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig]
@@ -19105,6 +19361,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @acl_enabled = args[:acl_enabled] if args.key?(:acl_enabled)
           @advanced_site_search_config = args[:advanced_site_search_config] if args.key?(:advanced_site_search_config)
           @billing_estimation = args[:billing_estimation] if args.key?(:billing_estimation)
           @cmek_config = args[:cmek_config] if args.key?(:cmek_config)
@@ -21095,7 +21352,8 @@ module Google
         # @return [String]
         attr_accessor :title
       
-        # Required. The URL for the page the user wants to promote.
+        # Optional. The URL for the page the user wants to promote. Must be set for site
+        # search. For other verticals, this is optional.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -21148,14 +21406,19 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpec]
         attr_accessor :content_search_spec
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `dataStoreSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
       
+        # Specifies features for display, like match highlighting.
+        # Corresponds to the JSON property `displaySpec`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec]
+        attr_accessor :display_spec
+      
         # The specification that uses customized query embedding vector to do semantic
         # document retrieval.
         # Corresponds to the JSON property `embeddingSpec`
@@ -21277,29 +21540,30 @@ module Google
         # 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
+        # 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
         # Corresponds to the JSON property `rankingExpression`
         # @return [String]
         attr_accessor :ranking_expression
@@ -21427,6 +21691,7 @@ module Google
           @canonical_filter = args[:canonical_filter] if args.key?(:canonical_filter)
           @content_search_spec = args[:content_search_spec] if args.key?(:content_search_spec)
           @data_store_specs = args[:data_store_specs] if args.key?(:data_store_specs)
+          @display_spec = args[:display_spec] if args.key?(:display_spec)
           @embedding_spec = args[:embedding_spec] if args.key?(:embedding_spec)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
           @filter = args[:filter] if args.key?(:filter)
@@ -21464,7 +21729,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Condition boost specifications. If a document matches multiple conditions in
-        # the specifictions, boost scores from these specifications are all applied and
+        # the specifications, boost scores from these specifications are all applied and
         # combined in a non-linear way. Maximum number of specifications is 20.
         # Corresponds to the JSON property `conditionBoostSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpecConditionBoostSpec>]
@@ -21863,6 +22128,12 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec]
         attr_accessor :model_spec
       
+        # Multimodal specification: Will return an image from specified source. If
+        # multiple sources are specified, the pick is a quality based decision.
+        # Corresponds to the JSON property `multimodalSpec`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec]
+        attr_accessor :multimodal_spec
+      
         # 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
@@ -21896,6 +22167,7 @@ module Google
           @language_code = args[:language_code] if args.key?(:language_code)
           @model_prompt_spec = args[:model_prompt_spec] if args.key?(:model_prompt_spec)
           @model_spec = args[:model_spec] if args.key?(:model_spec)
+          @multimodal_spec = args[:multimodal_spec] if args.key?(:multimodal_spec)
           @summary_result_count = args[:summary_result_count] if args.key?(:summary_result_count)
           @use_semantic_chunks = args[:use_semantic_chunks] if args.key?(:use_semantic_chunks)
         end
@@ -21947,6 +22219,26 @@ module Google
         end
       end
       
+      # Multimodal specification: Will return an image from specified source. If
+      # multiple sources are specified, the pick is a quality based decision.
+      class GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Source of image returned in the answer.
+        # Corresponds to the JSON property `imageSource`
+        # @return [String]
+        attr_accessor :image_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @image_source = args[:image_source] if args.key?(:image_source)
+        end
+      end
+      
       # 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.
@@ -21983,6 +22275,25 @@ module Google
         end
       end
       
+      # Specifies features for display, like match highlighting.
+      class GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec
+        include Google::Apis::Core::Hashable
+      
+        # The condition under which match highlighting should occur.
+        # Corresponds to the JSON property `matchHighlightingCondition`
+        # @return [String]
+        attr_accessor :match_highlighting_condition
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @match_highlighting_condition = args[:match_highlighting_condition] if args.key?(:match_highlighting_condition)
+        end
+      end
+      
       # The specification that uses customized query embedding vector to do semantic
       # document retrieval.
       class GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec