google-cloud-discovery_engine-v1 2.4.0 → 2.6.0

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, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_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, ranking_expression: nil, ranking_expression_backend: 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).
@@ -443,6 +443,99 @@ module Google
             #     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.
+            #   @param ranking_expression [::String]
+            #     The ranking expression controls the customized ranking on retrieval
+            #     documents. This overrides
+            #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig#ranking_expression 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 `RANK_BY_EMBEDDING`.
+            #
+            #     If
+            #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+            #     is not provided or set to `RANK_BY_EMBEDDING`, 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)`.
+            #
+            #     If
+            #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+            #     is set to `RANK_BY_FORMULA`, 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.
+            #
+            #       Here are a few examples of ranking formulas that use the supported
+            #       ranking expression types:
+            #
+            #       - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)`
+            #       -- mostly rank by the logarithm of `keyword_similarity_score` with slight
+            #       `semantic_smilarity_score` adjustment.
+            #       - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 *
+            #       is_nan(keyword_similarity_score)` -- rank by the exponent of
+            #       `semantic_similarity_score` filling the value with 0 if it's NaN, also
+            #       add constant 0.3 adjustment to the final score if
+            #       `semantic_similarity_score` is NaN.
+            #       - `0.2 * rr(semantic_similarity_score, 16) + 0.8 *
+            #       rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank
+            #       of `keyword_similarity_score` with slight adjustment of reciprocal rank
+            #       of `semantic_smilarity_score`.
+            #
+            #     The following signals are supported:
+            #
+            #       * `semantic_similarity_score`: semantic similarity adjustment that is
+            #       calculated using the embeddings generated by a proprietary Google model.
+            #       This score determines how semantically similar a search query is to a
+            #       document.
+            #       * `keyword_similarity_score`: keyword match adjustment uses the Best
+            #       Match 25 (BM25) ranking function. This score is calculated using a
+            #       probabilistic model to estimate the probability that a document is
+            #       relevant to a given query.
+            #       * `relevance_score`: semantic relevance adjustment that uses a
+            #       proprietary Google model to determine the meaning and intent behind a
+            #       user's query in context with the content in the documents.
+            #       * `pctr_rank`: predicted conversion rate adjustment as a rank use
+            #       predicted Click-through rate (pCTR) to gauge the relevance and
+            #       attractiveness of a search result from a user's perspective. A higher
+            #       pCTR suggests that the result is more likely to satisfy the user's query
+            #       and intent, making it a valuable signal for ranking.
+            #       * `freshness_rank`: freshness adjustment as a rank
+            #       * `document_age`: The time in hours elapsed since the document was last
+            #       updated, a floating-point number (e.g., 0.25 means 15 minutes).
+            #       * `topicality_rank`: topicality adjustment as a rank. Uses proprietary
+            #       Google model to determine the keyword-based overlap between the query and
+            #       the document.
+            #       * `base_rank`: the default rank of the result
+            #   @param ranking_expression_backend [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RankingExpressionBackend]
+            #     The backend to use for the ranking expression evaluation.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::SearchResponse::SearchResult>]
@@ -539,7 +632,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, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_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, ranking_expression: nil, ranking_expression_backend: 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).
@@ -765,6 +858,99 @@ module Google
             #     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.
+            #   @param ranking_expression [::String]
+            #     The ranking expression controls the customized ranking on retrieval
+            #     documents. This overrides
+            #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig#ranking_expression 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 `RANK_BY_EMBEDDING`.
+            #
+            #     If
+            #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+            #     is not provided or set to `RANK_BY_EMBEDDING`, 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)`.
+            #
+            #     If
+            #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+            #     is set to `RANK_BY_FORMULA`, 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.
+            #
+            #       Here are a few examples of ranking formulas that use the supported
+            #       ranking expression types:
+            #
+            #       - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)`
+            #       -- mostly rank by the logarithm of `keyword_similarity_score` with slight
+            #       `semantic_smilarity_score` adjustment.
+            #       - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 *
+            #       is_nan(keyword_similarity_score)` -- rank by the exponent of
+            #       `semantic_similarity_score` filling the value with 0 if it's NaN, also
+            #       add constant 0.3 adjustment to the final score if
+            #       `semantic_similarity_score` is NaN.
+            #       - `0.2 * rr(semantic_similarity_score, 16) + 0.8 *
+            #       rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank
+            #       of `keyword_similarity_score` with slight adjustment of reciprocal rank
+            #       of `semantic_smilarity_score`.
+            #
+            #     The following signals are supported:
+            #
+            #       * `semantic_similarity_score`: semantic similarity adjustment that is
+            #       calculated using the embeddings generated by a proprietary Google model.
+            #       This score determines how semantically similar a search query is to a
+            #       document.
+            #       * `keyword_similarity_score`: keyword match adjustment uses the Best
+            #       Match 25 (BM25) ranking function. This score is calculated using a
+            #       probabilistic model to estimate the probability that a document is
+            #       relevant to a given query.
+            #       * `relevance_score`: semantic relevance adjustment that uses a
+            #       proprietary Google model to determine the meaning and intent behind a
+            #       user's query in context with the content in the documents.
+            #       * `pctr_rank`: predicted conversion rate adjustment as a rank use
+            #       predicted Click-through rate (pCTR) to gauge the relevance and
+            #       attractiveness of a search result from a user's perspective. A higher
+            #       pCTR suggests that the result is more likely to satisfy the user's query
+            #       and intent, making it a valuable signal for ranking.
+            #       * `freshness_rank`: freshness adjustment as a rank
+            #       * `document_age`: The time in hours elapsed since the document was last
+            #       updated, a floating-point number (e.g., 0.25 means 15 minutes).
+            #       * `topicality_rank`: topicality adjustment as a rank. Uses proprietary
+            #       Google model to determine the keyword-based overlap between the query and
+            #       the document.
+            #       * `base_rank`: the default rank of the result
+            #   @param ranking_expression_backend [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RankingExpressionBackend]
+            #     The backend to use for the ranking expression evaluation.
             #
             # @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, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_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, ranking_expression: nil, ranking_expression_backend: 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).
@@ -436,6 +436,99 @@ module Google
               #     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.
+              #   @param ranking_expression [::String]
+              #     The ranking expression controls the customized ranking on retrieval
+              #     documents. This overrides
+              #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig#ranking_expression 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 `RANK_BY_EMBEDDING`.
+              #
+              #     If
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+              #     is not provided or set to `RANK_BY_EMBEDDING`, 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)`.
+              #
+              #     If
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+              #     is set to `RANK_BY_FORMULA`, 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.
+              #
+              #       Here are a few examples of ranking formulas that use the supported
+              #       ranking expression types:
+              #
+              #       - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)`
+              #       -- mostly rank by the logarithm of `keyword_similarity_score` with slight
+              #       `semantic_smilarity_score` adjustment.
+              #       - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 *
+              #       is_nan(keyword_similarity_score)` -- rank by the exponent of
+              #       `semantic_similarity_score` filling the value with 0 if it's NaN, also
+              #       add constant 0.3 adjustment to the final score if
+              #       `semantic_similarity_score` is NaN.
+              #       - `0.2 * rr(semantic_similarity_score, 16) + 0.8 *
+              #       rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank
+              #       of `keyword_similarity_score` with slight adjustment of reciprocal rank
+              #       of `semantic_smilarity_score`.
+              #
+              #     The following signals are supported:
+              #
+              #       * `semantic_similarity_score`: semantic similarity adjustment that is
+              #       calculated using the embeddings generated by a proprietary Google model.
+              #       This score determines how semantically similar a search query is to a
+              #       document.
+              #       * `keyword_similarity_score`: keyword match adjustment uses the Best
+              #       Match 25 (BM25) ranking function. This score is calculated using a
+              #       probabilistic model to estimate the probability that a document is
+              #       relevant to a given query.
+              #       * `relevance_score`: semantic relevance adjustment that uses a
+              #       proprietary Google model to determine the meaning and intent behind a
+              #       user's query in context with the content in the documents.
+              #       * `pctr_rank`: predicted conversion rate adjustment as a rank use
+              #       predicted Click-through rate (pCTR) to gauge the relevance and
+              #       attractiveness of a search result from a user's perspective. A higher
+              #       pCTR suggests that the result is more likely to satisfy the user's query
+              #       and intent, making it a valuable signal for ranking.
+              #       * `freshness_rank`: freshness adjustment as a rank
+              #       * `document_age`: The time in hours elapsed since the document was last
+              #       updated, a floating-point number (e.g., 0.25 means 15 minutes).
+              #       * `topicality_rank`: topicality adjustment as a rank. Uses proprietary
+              #       Google model to determine the keyword-based overlap between the query and
+              #       the document.
+              #       * `base_rank`: the default rank of the result
+              #   @param ranking_expression_backend [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RankingExpressionBackend]
+              #     The backend to use for the ranking expression evaluation.
               # @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]
@@ -525,7 +618,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, display_spec: nil, session: nil, session_spec: nil, relevance_threshold: nil, relevance_score_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, ranking_expression: nil, ranking_expression_backend: 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).
@@ -751,6 +844,99 @@ module Google
               #     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.
+              #   @param ranking_expression [::String]
+              #     The ranking expression controls the customized ranking on retrieval
+              #     documents. This overrides
+              #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig#ranking_expression 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 `RANK_BY_EMBEDDING`.
+              #
+              #     If
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+              #     is not provided or set to `RANK_BY_EMBEDDING`, 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)`.
+              #
+              #     If
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#ranking_expression_backend ranking_expression_backend}
+              #     is set to `RANK_BY_FORMULA`, 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.
+              #
+              #       Here are a few examples of ranking formulas that use the supported
+              #       ranking expression types:
+              #
+              #       - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)`
+              #       -- mostly rank by the logarithm of `keyword_similarity_score` with slight
+              #       `semantic_smilarity_score` adjustment.
+              #       - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 *
+              #       is_nan(keyword_similarity_score)` -- rank by the exponent of
+              #       `semantic_similarity_score` filling the value with 0 if it's NaN, also
+              #       add constant 0.3 adjustment to the final score if
+              #       `semantic_similarity_score` is NaN.
+              #       - `0.2 * rr(semantic_similarity_score, 16) + 0.8 *
+              #       rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank
+              #       of `keyword_similarity_score` with slight adjustment of reciprocal rank
+              #       of `semantic_smilarity_score`.
+              #
+              #     The following signals are supported:
+              #
+              #       * `semantic_similarity_score`: semantic similarity adjustment that is
+              #       calculated using the embeddings generated by a proprietary Google model.
+              #       This score determines how semantically similar a search query is to a
+              #       document.
+              #       * `keyword_similarity_score`: keyword match adjustment uses the Best
+              #       Match 25 (BM25) ranking function. This score is calculated using a
+              #       probabilistic model to estimate the probability that a document is
+              #       relevant to a given query.
+              #       * `relevance_score`: semantic relevance adjustment that uses a
+              #       proprietary Google model to determine the meaning and intent behind a
+              #       user's query in context with the content in the documents.
+              #       * `pctr_rank`: predicted conversion rate adjustment as a rank use
+              #       predicted Click-through rate (pCTR) to gauge the relevance and
+              #       attractiveness of a search result from a user's perspective. A higher
+              #       pCTR suggests that the result is more likely to satisfy the user's query
+              #       and intent, making it a valuable signal for ranking.
+              #       * `freshness_rank`: freshness adjustment as a rank
+              #       * `document_age`: The time in hours elapsed since the document was last
+              #       updated, a floating-point number (e.g., 0.25 means 15 minutes).
+              #       * `topicality_rank`: topicality adjustment as a rank. Uses proprietary
+              #       Google model to determine the keyword-based overlap between the query and
+              #       the document.
+              #       * `base_rank`: the default rank of the result
+              #   @param ranking_expression_backend [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RankingExpressionBackend]
+              #     The backend to use for the ranking expression evaluation.
               # @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]

data/lib/google/cloud/discovery_engine/v1/search_tuning_service/operations.rb

@@ -134,7 +134,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
             #   Pass arguments to `list_operations` 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).
@@ -147,6 +147,17 @@ module Google
             #     The standard list page size.
             #   @param page_token [::String]
             #     The standard list page token.
+            #   @param return_partial_success [::Boolean]
+            #     When set to `true`, operations that are reachable are returned as normal,
+            #     and those that are unreachable are returned in the
+            #     [ListOperationsResponse.unreachable] field.
+            #
+            #     This can only be `true` when reading across collections e.g. when `parent`
+            #     is set to `"projects/example/locations/-"`.
+            #
+            #     This field is not by default supported and will result in an
+            #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+            #     service or product specific documentation.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]

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

@@ -125,7 +125,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+              # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
               #   Pass arguments to `list_operations` 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).
@@ -138,6 +138,17 @@ module Google
               #     The standard list page size.
               #   @param page_token [::String]
               #     The standard list page token.
+              #   @param return_partial_success [::Boolean]
+              #     When set to `true`, operations that are reachable are returned as normal,
+              #     and those that are unreachable are returned in the
+              #     [ListOperationsResponse.unreachable] field.
+              #
+              #     This can only be `true` when reading across collections e.g. when `parent`
+              #     is set to `"projects/example/locations/-"`.
+              #
+              #     This field is not by default supported and will result in an
+              #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+              #     service or product specific documentation.
               # @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/site_search_engine_service/operations.rb

@@ -134,7 +134,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
             #   Pass arguments to `list_operations` 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).
@@ -147,6 +147,17 @@ module Google
             #     The standard list page size.
             #   @param page_token [::String]
             #     The standard list page token.
+            #   @param return_partial_success [::Boolean]
+            #     When set to `true`, operations that are reachable are returned as normal,
+            #     and those that are unreachable are returned in the
+            #     [ListOperationsResponse.unreachable] field.
+            #
+            #     This can only be `true` when reading across collections e.g. when `parent`
+            #     is set to `"projects/example/locations/-"`.
+            #
+            #     This field is not by default supported and will result in an
+            #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+            #     service or product specific documentation.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]

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

@@ -125,7 +125,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+              # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
               #   Pass arguments to `list_operations` 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).
@@ -138,6 +138,17 @@ module Google
               #     The standard list page size.
               #   @param page_token [::String]
               #     The standard list page token.
+              #   @param return_partial_success [::Boolean]
+              #     When set to `true`, operations that are reachable are returned as normal,
+              #     and those that are unreachable are returned in the
+              #     [ListOperationsResponse.unreachable] field.
+              #
+              #     This can only be `true` when reading across collections e.g. when `parent`
+              #     is set to `"projects/example/locations/-"`.
+              #
+              #     This field is not by default supported and will result in an
+              #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+              #     service or product specific documentation.
               # @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/user_event_service/client.rb

@@ -248,7 +248,7 @@ module Google
             #     is:
             #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
             #     If the write user event action is applied in
-            #     `::Google::Cloud::Location::Location` level, for example, the event
+            #     [Location][google.cloud.location.Location] level, for example, the event
             #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
             #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
             #     `projects/{project}/locations/{location}`.
@@ -351,7 +351,7 @@ module Google
             #     is:
             #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
             #     If the collect user event action is applied in
-            #     `::Google::Cloud::Location::Location` level, for example, the event
+            #     [Location][google.cloud.location.Location] level, for example, the event
             #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
             #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
             #     `projects/{project}/locations/{location}`.

data/lib/google/cloud/discovery_engine/v1/user_event_service/operations.rb

@@ -134,7 +134,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
             #   Pass arguments to `list_operations` 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).
@@ -147,6 +147,17 @@ module Google
             #     The standard list page size.
             #   @param page_token [::String]
             #     The standard list page token.
+            #   @param return_partial_success [::Boolean]
+            #     When set to `true`, operations that are reachable are returned as normal,
+            #     and those that are unreachable are returned in the
+            #     [ListOperationsResponse.unreachable] field.
+            #
+            #     This can only be `true` when reading across collections e.g. when `parent`
+            #     is set to `"projects/example/locations/-"`.
+            #
+            #     This field is not by default supported and will result in an
+            #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+            #     service or product specific documentation.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]

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

@@ -241,7 +241,7 @@ module Google
               #     is:
               #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
               #     If the write user event action is applied in
-              #     `::Google::Cloud::Location::Location` level, for example, the event
+              #     [Location][google.cloud.location.Location] level, for example, the event
               #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
               #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
               #     `projects/{project}/locations/{location}`.
@@ -337,7 +337,7 @@ module Google
               #     is:
               #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
               #     If the collect user event action is applied in
-              #     `::Google::Cloud::Location::Location` level, for example, the event
+              #     [Location][google.cloud.location.Location] level, for example, the event
               #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
               #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
               #     `projects/{project}/locations/{location}`.