google-cloud-discovery_engine-v1 2.0.0 → 2.1.0

data/lib/google/cloud/discovery_engine/v1/document_service/rest/client.rb

@@ -453,7 +453,7 @@ module Google
               #     Otherwise, an `ALREADY_EXISTS` error is returned.
               #
               #     This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
-              #     standard with a length limit of 63 characters. Otherwise, an
+              #     standard with a length limit of 128 characters. Otherwise, an
               #     `INVALID_ARGUMENT` error is returned.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::Document]
@@ -713,7 +713,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, alloy_db_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil)
+              # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, alloy_db_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil, force_refresh_content: nil)
               #   Pass arguments to `import_documents` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -828,6 +828,12 @@ module Google
               #     * {::Google::Cloud::DiscoveryEngine::V1::CloudSqlSource CloudSqlSource}.
               #     * {::Google::Cloud::DiscoveryEngine::V1::FirestoreSource FirestoreSource}.
               #     * {::Google::Cloud::DiscoveryEngine::V1::BigtableSource BigtableSource}.
+              #   @param force_refresh_content [::Boolean]
+              #     Optional. Whether to force refresh the unstructured content of the
+              #     documents.
+              #
+              #     If set to `true`, the content part of the documents will be refreshed
+              #     regardless of the update status of the referencing content.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]

data/lib/google/cloud/discovery_engine/v1/grounded_generation_service/client.rb

@@ -315,8 +315,6 @@ module Google
             #     For single-turn queries, this is a single instance. For multi-turn queries,
             #     this is a repeated field that contains conversation history + latest
             #     request.
-            #
-            #     Only a single-turn query is supported currently.
             #   @param generation_spec [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GenerationSpec, ::Hash]
             #     Content generation specification.
             #   @param grounding_spec [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GroundingSpec, ::Hash]
@@ -426,7 +424,7 @@ module Google
             #     Required. The resource name of the grounding config, such as
             #     `projects/*/locations/global/groundingConfigs/default_grounding_config`.
             #   @param answer_candidate [::String]
-            #     Answer candidate to check. Can have a maximum length of 1024 characters.
+            #     Answer candidate to check. It can have a maximum length of 4096 tokens.
             #   @param facts [::Array<::Google::Cloud::DiscoveryEngine::V1::GroundingFact, ::Hash>]
             #     List of facts for the grounding check.
             #     We support up to 200 facts.

data/lib/google/cloud/discovery_engine/v1/grounded_generation_service/rest/client.rb

@@ -230,8 +230,6 @@ module Google
               #     For single-turn queries, this is a single instance. For multi-turn queries,
               #     this is a repeated field that contains conversation history + latest
               #     request.
-              #
-              #     Only a single-turn query is supported currently.
               #   @param generation_spec [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GenerationSpec, ::Hash]
               #     Content generation specification.
               #   @param grounding_spec [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GroundingSpec, ::Hash]
@@ -334,7 +332,7 @@ module Google
               #     Required. The resource name of the grounding config, such as
               #     `projects/*/locations/global/groundingConfigs/default_grounding_config`.
               #   @param answer_candidate [::String]
-              #     Answer candidate to check. Can have a maximum length of 1024 characters.
+              #     Answer candidate to check. It can have a maximum length of 4096 tokens.
               #   @param facts [::Array<::Google::Cloud::DiscoveryEngine::V1::GroundingFact, ::Hash>]
               #     List of facts for the grounding check.
               #     We support up to 200 facts.

data/lib/google/cloud/discovery_engine/v1/rank_service/client.rb

@@ -228,7 +228,7 @@ module Google
             #   @param model [::String]
             #     The identifier of the model to use. It is one of:
             #
-            #     * `semantic-ranker-512@latest`: Semantic ranking model with maxiumn input
+            #     * `semantic-ranker-512@latest`: Semantic ranking model with maximum input
             #     token size 512.
             #
             #     It is set to `semantic-ranker-512@latest` by default if unspecified.

data/lib/google/cloud/discovery_engine/v1/rank_service/rest/client.rb

@@ -221,7 +221,7 @@ module Google
               #   @param model [::String]
               #     The identifier of the model to use. It is one of:
               #
-              #     * `semantic-ranker-512@latest`: Semantic ranking model with maxiumn input
+              #     * `semantic-ranker-512@latest`: Semantic ranking model with maximum input
               #     token size 512.
               #
               #     It is set to `semantic-ranker-512@latest` by default if unspecified.

data/lib/google/cloud/discovery_engine/v1/recommendation_service/client.rb

@@ -224,7 +224,7 @@ module Google
             #
             #   @param serving_config [::String]
             #     Required. Full resource name of a
-            #     [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig]:
+            #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig ServingConfig}:
             #     `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or
             #     `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*`
             #
@@ -273,9 +273,9 @@ module Google
             #     attribute-based expressions are expected instead of the above described
             #     tag-based syntax. Examples:
             #
-            #      * (launguage: ANY("en", "es")) AND NOT (categories: ANY("Movie"))
+            #      * (language: ANY("en", "es")) AND NOT (categories: ANY("Movie"))
             #      * (available: true) AND
-            #        (launguage: ANY("en", "es")) OR (categories: ANY("Movie"))
+            #        (language: ANY("en", "es")) OR (categories: ANY("Movie"))
             #
             #     If your filter blocks all results, the API returns generic
             #     (unfiltered) popular Documents. If you only want results strictly matching

data/lib/google/cloud/discovery_engine/v1/recommendation_service/rest/client.rb

@@ -217,7 +217,7 @@ module Google
               #
               #   @param serving_config [::String]
               #     Required. Full resource name of a
-              #     [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig]:
+              #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig ServingConfig}:
               #     `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or
               #     `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*`
               #
@@ -266,9 +266,9 @@ module Google
               #     attribute-based expressions are expected instead of the above described
               #     tag-based syntax. Examples:
               #
-              #      * (launguage: ANY("en", "es")) AND NOT (categories: ANY("Movie"))
+              #      * (language: ANY("en", "es")) AND NOT (categories: ANY("Movie"))
               #      * (available: true) AND
-              #        (launguage: ANY("en", "es")) OR (categories: ANY("Movie"))
+              #        (language: ANY("en", "es")) OR (categories: ANY("Movie"))
               #
               #     If your filter blocks all results, the API returns generic
               #     (unfiltered) popular Documents. If you only want results strictly matching

data/lib/google/cloud/discovery_engine/v1/rest.rb

@@ -29,6 +29,7 @@ require "google/cloud/discovery_engine/v1/rank_service/rest"
 require "google/cloud/discovery_engine/v1/recommendation_service/rest"
 require "google/cloud/discovery_engine/v1/schema_service/rest"
 require "google/cloud/discovery_engine/v1/search_tuning_service/rest"
+require "google/cloud/discovery_engine/v1/serving_config_service/rest"
 require "google/cloud/discovery_engine/v1/site_search_engine_service/rest"
 require "google/cloud/discovery_engine/v1/user_event_service/rest"
 require "google/cloud/discovery_engine/v1/version"

data/lib/google/cloud/discovery_engine/v1/search_service/client.rb

@@ -217,7 +217,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, session: nil, session_spec: nil)
+            # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_spec: nil)
             #   Pass arguments to `search` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -272,10 +272,13 @@ module Google
             #     This applies to each OneBox type individually.
             #     Default number is 10.
             #   @param data_store_specs [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DataStoreSpec, ::Hash>]
-            #     Specs defining dataStores to filter on in a search call and configurations
-            #     for those dataStores. This is only considered for engines with multiple
-            #     dataStores use case. For single dataStore within an engine, they should
-            #     use the specs at the top level.
+            #     Specifications that define the specific
+            #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}s to be searched,
+            #     along with configurations for those data stores. This is only considered
+            #     for {::Google::Cloud::DiscoveryEngine::V1::Engine Engine}s with multiple data
+            #     stores. For engines with a single data store, the specs directly under
+            #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest SearchRequest} should be
+            #     used.
             #   @param filter [::String]
             #     The filter syntax consists of an expression language for constructing a
             #     predicate from one or more fields of the documents being filtered. Filter
@@ -320,7 +323,7 @@ module Google
             #     If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
             #   @param user_info [::Google::Cloud::DiscoveryEngine::V1::UserInfo, ::Hash]
             #     Information about the end user.
-            #     Highly recommended for analytics.
+            #     Highly recommended for analytics and personalization.
             #     {::Google::Cloud::DiscoveryEngine::V1::UserInfo#user_agent UserInfo.user_agent}
             #     is used to deduce `device_type` for analytics.
             #   @param language_code [::String]
@@ -402,6 +405,9 @@ module Google
             #     Search as you type configuration. Only supported for the
             #     {::Google::Cloud::DiscoveryEngine::V1::IndustryVertical::MEDIA IndustryVertical.MEDIA}
             #     vertical.
+            #   @param display_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DisplaySpec, ::Hash]
+            #     Optional. Config for display feature, like match highlighting on search
+            #     results.
             #   @param session [::String]
             #     The session resource name. Optional.
             #
@@ -433,6 +439,16 @@ module Google
             #     Session specification.
             #
             #     Can be used only when `session` is set.
+            #   @param relevance_threshold [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceThreshold]
+            #     The relevance threshold of the search results.
+            #
+            #     Default to Google defined threshold, leveraging a balance of
+            #     precision and recall to deliver both highly accurate results and
+            #     comprehensive coverage of relevant information.
+            #
+            #     This feature is not supported for healthcare search.
+            #   @param relevance_score_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceScoreSpec, ::Hash]
+            #     Optional. The specification for returning the relevance score.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::SearchResponse::SearchResult>]
@@ -529,7 +545,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search_lite(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, session: nil, session_spec: nil)
+            # @overload search_lite(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_spec: nil)
             #   Pass arguments to `search_lite` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -584,10 +600,13 @@ module Google
             #     This applies to each OneBox type individually.
             #     Default number is 10.
             #   @param data_store_specs [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DataStoreSpec, ::Hash>]
-            #     Specs defining dataStores to filter on in a search call and configurations
-            #     for those dataStores. This is only considered for engines with multiple
-            #     dataStores use case. For single dataStore within an engine, they should
-            #     use the specs at the top level.
+            #     Specifications that define the specific
+            #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}s to be searched,
+            #     along with configurations for those data stores. This is only considered
+            #     for {::Google::Cloud::DiscoveryEngine::V1::Engine Engine}s with multiple data
+            #     stores. For engines with a single data store, the specs directly under
+            #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest SearchRequest} should be
+            #     used.
             #   @param filter [::String]
             #     The filter syntax consists of an expression language for constructing a
             #     predicate from one or more fields of the documents being filtered. Filter
@@ -632,7 +651,7 @@ module Google
             #     If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
             #   @param user_info [::Google::Cloud::DiscoveryEngine::V1::UserInfo, ::Hash]
             #     Information about the end user.
-            #     Highly recommended for analytics.
+            #     Highly recommended for analytics and personalization.
             #     {::Google::Cloud::DiscoveryEngine::V1::UserInfo#user_agent UserInfo.user_agent}
             #     is used to deduce `device_type` for analytics.
             #   @param language_code [::String]
@@ -714,6 +733,9 @@ module Google
             #     Search as you type configuration. Only supported for the
             #     {::Google::Cloud::DiscoveryEngine::V1::IndustryVertical::MEDIA IndustryVertical.MEDIA}
             #     vertical.
+            #   @param display_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DisplaySpec, ::Hash]
+            #     Optional. Config for display feature, like match highlighting on search
+            #     results.
             #   @param session [::String]
             #     The session resource name. Optional.
             #
@@ -745,6 +767,16 @@ module Google
             #     Session specification.
             #
             #     Can be used only when `session` is set.
+            #   @param relevance_threshold [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceThreshold]
+            #     The relevance threshold of the search results.
+            #
+            #     Default to Google defined threshold, leveraging a balance of
+            #     precision and recall to deliver both highly accurate results and
+            #     comprehensive coverage of relevant information.
+            #
+            #     This feature is not supported for healthcare search.
+            #   @param relevance_score_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceScoreSpec, ::Hash]
+            #     Optional. The specification for returning the relevance score.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::SearchResponse::SearchResult>]

data/lib/google/cloud/discovery_engine/v1/search_service/rest/client.rb

@@ -210,7 +210,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, session: nil, session_spec: nil)
+              # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_spec: nil)
               #   Pass arguments to `search` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -265,10 +265,13 @@ module Google
               #     This applies to each OneBox type individually.
               #     Default number is 10.
               #   @param data_store_specs [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DataStoreSpec, ::Hash>]
-              #     Specs defining dataStores to filter on in a search call and configurations
-              #     for those dataStores. This is only considered for engines with multiple
-              #     dataStores use case. For single dataStore within an engine, they should
-              #     use the specs at the top level.
+              #     Specifications that define the specific
+              #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}s to be searched,
+              #     along with configurations for those data stores. This is only considered
+              #     for {::Google::Cloud::DiscoveryEngine::V1::Engine Engine}s with multiple data
+              #     stores. For engines with a single data store, the specs directly under
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest SearchRequest} should be
+              #     used.
               #   @param filter [::String]
               #     The filter syntax consists of an expression language for constructing a
               #     predicate from one or more fields of the documents being filtered. Filter
@@ -313,7 +316,7 @@ module Google
               #     If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
               #   @param user_info [::Google::Cloud::DiscoveryEngine::V1::UserInfo, ::Hash]
               #     Information about the end user.
-              #     Highly recommended for analytics.
+              #     Highly recommended for analytics and personalization.
               #     {::Google::Cloud::DiscoveryEngine::V1::UserInfo#user_agent UserInfo.user_agent}
               #     is used to deduce `device_type` for analytics.
               #   @param language_code [::String]
@@ -395,6 +398,9 @@ module Google
               #     Search as you type configuration. Only supported for the
               #     {::Google::Cloud::DiscoveryEngine::V1::IndustryVertical::MEDIA IndustryVertical.MEDIA}
               #     vertical.
+              #   @param display_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DisplaySpec, ::Hash]
+              #     Optional. Config for display feature, like match highlighting on search
+              #     results.
               #   @param session [::String]
               #     The session resource name. Optional.
               #
@@ -426,6 +432,16 @@ module Google
               #     Session specification.
               #
               #     Can be used only when `session` is set.
+              #   @param relevance_threshold [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceThreshold]
+              #     The relevance threshold of the search results.
+              #
+              #     Default to Google defined threshold, leveraging a balance of
+              #     precision and recall to deliver both highly accurate results and
+              #     comprehensive coverage of relevant information.
+              #
+              #     This feature is not supported for healthcare search.
+              #   @param relevance_score_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceScoreSpec, ::Hash]
+              #     Optional. The specification for returning the relevance score.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::SearchResponse::SearchResult>]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -515,7 +531,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload search_lite(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, session: nil, session_spec: nil)
+              # @overload search_lite(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, one_box_page_size: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, safe_search: nil, user_labels: nil, search_as_you_type_spec: nil, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_spec: nil)
               #   Pass arguments to `search_lite` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -570,10 +586,13 @@ module Google
               #     This applies to each OneBox type individually.
               #     Default number is 10.
               #   @param data_store_specs [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DataStoreSpec, ::Hash>]
-              #     Specs defining dataStores to filter on in a search call and configurations
-              #     for those dataStores. This is only considered for engines with multiple
-              #     dataStores use case. For single dataStore within an engine, they should
-              #     use the specs at the top level.
+              #     Specifications that define the specific
+              #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}s to be searched,
+              #     along with configurations for those data stores. This is only considered
+              #     for {::Google::Cloud::DiscoveryEngine::V1::Engine Engine}s with multiple data
+              #     stores. For engines with a single data store, the specs directly under
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest SearchRequest} should be
+              #     used.
               #   @param filter [::String]
               #     The filter syntax consists of an expression language for constructing a
               #     predicate from one or more fields of the documents being filtered. Filter
@@ -618,7 +637,7 @@ module Google
               #     If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
               #   @param user_info [::Google::Cloud::DiscoveryEngine::V1::UserInfo, ::Hash]
               #     Information about the end user.
-              #     Highly recommended for analytics.
+              #     Highly recommended for analytics and personalization.
               #     {::Google::Cloud::DiscoveryEngine::V1::UserInfo#user_agent UserInfo.user_agent}
               #     is used to deduce `device_type` for analytics.
               #   @param language_code [::String]
@@ -700,6 +719,9 @@ module Google
               #     Search as you type configuration. Only supported for the
               #     {::Google::Cloud::DiscoveryEngine::V1::IndustryVertical::MEDIA IndustryVertical.MEDIA}
               #     vertical.
+              #   @param display_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DisplaySpec, ::Hash]
+              #     Optional. Config for display feature, like match highlighting on search
+              #     results.
               #   @param session [::String]
               #     The session resource name. Optional.
               #
@@ -731,6 +753,16 @@ module Google
               #     Session specification.
               #
               #     Can be used only when `session` is set.
+              #   @param relevance_threshold [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceThreshold]
+              #     The relevance threshold of the search results.
+              #
+              #     Default to Google defined threshold, leveraging a balance of
+              #     precision and recall to deliver both highly accurate results and
+              #     comprehensive coverage of relevant information.
+              #
+              #     This feature is not supported for healthcare search.
+              #   @param relevance_score_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceScoreSpec, ::Hash]
+              #     Optional. The specification for returning the relevance score.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::SearchResponse::SearchResult>]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]