@google-cloud/discoveryengine 1.11.0 → 1.13.0

package/build/src/v1alpha/search_service_client.d.ts

@@ -206,15 +206,29 @@ export declare class SearchServiceClient {
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   For more information on ordering for retail search, see
-     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
-     *
+     *   For more information on ordering the website search results, see
+     *   [Order web search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results).
+     *   For more information on ordering the healthcare search results, see
+     *   [Order healthcare search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results).
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
      *   Information about the end user.
      *   Highly recommended for analytics.
      *   {@link protos.google.cloud.discoveryengine.v1alpha.UserInfo.user_agent|UserInfo.user_agent}
      *   is used to deduce `device_type` for analytics.
+     * @param {string} request.languageCode
+     *   The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+     *   information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). This field
+     *   helps to better interpret the query. If a value isn't specified, the query
+     *   language code is automatically detected, which may not be accurate.
+     * @param {string} request.regionCode
+     *   The Unicode country/region code (CLDR) of a location, such as "US" and
+     *   "419". For more information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). If set,
+     *   then results will be boosted based on the region_code provided.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -279,20 +293,26 @@ export declare class SearchServiceClient {
      *   documents. This overrides
      *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.ranking_expression|ServingConfig.ranking_expression}.
      *   The ranking expression is a single function or multiple functions that are
-     *   joint by "+".
+     *   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
+     *
+     *     * `relevance_score`: pre-defined keywords, used for measure relevance
      *     between query and document.
-     *     `embedding_field_path`: the document embedding field
+     *     * `embedding_field_path`: the document embedding field
      *     used with query embedding vector.
-     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     * `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)`.
      * @param {boolean} request.safeSearch
@@ -316,8 +336,54 @@ export declare class SearchServiceClient {
      *   See [Google Cloud
      *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
      *   for more details.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.NaturalLanguageQueryUnderstandingSpec} request.naturalLanguageQueryUnderstandingSpec
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
      * @param {google.cloud.discoveryengine.v1alpha.CustomFineTuningSpec} request.customFineTuningSpec
      *   Custom fine tuning configs.
+     *   If set, it has higher priority than the configs set in
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.custom_fine_tuning_spec|ServingConfig.custom_fine_tuning_spec}.
+     * @param {string} request.session
+     *   The session resource name. Optional.
+     *
+     *   Session allows users to do multi-turn /search API calls or coordination
+     *   between /search API calls and /answer API calls.
+     *
+     *   Example #1 (multi-turn /search API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /search API with the session ID generated in the first call.
+     *        Here, the previous search query gets considered in query
+     *        standing. I.e., if the first query is "How did Alphabet do in 2022?"
+     *        and the current query is "How about 2023?", the current query will
+     *        be interpreted as "How did Alphabet do in 2023?".
+     *
+     *   Example #2 (coordination between /search API calls and /answer API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /answer API with the session ID generated in the first call.
+     *        Here, the answer generation happens in the context of the search
+     *        results from the first search call.
+     *
+     *   Auto-session mode: when `projects/.../sessions/-` is used, a new session
+     *   gets automatically created. Otherwise, users can use the create-session API
+     *   to create a session manually.
+     *
+     *   Multi-turn Search feature is currently at private GA stage. Please use
+     *   v1alpha or v1beta version instead before we launch this feature to public
+     *   GA. Or ask for allowlisting through Google Support team.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.RelevanceThreshold} request.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.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Promise} - The promise which resolves to an array.
@@ -427,15 +493,29 @@ export declare class SearchServiceClient {
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   For more information on ordering for retail search, see
-     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
-     *
+     *   For more information on ordering the website search results, see
+     *   [Order web search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results).
+     *   For more information on ordering the healthcare search results, see
+     *   [Order healthcare search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results).
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
      *   Information about the end user.
      *   Highly recommended for analytics.
      *   {@link protos.google.cloud.discoveryengine.v1alpha.UserInfo.user_agent|UserInfo.user_agent}
      *   is used to deduce `device_type` for analytics.
+     * @param {string} request.languageCode
+     *   The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+     *   information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). This field
+     *   helps to better interpret the query. If a value isn't specified, the query
+     *   language code is automatically detected, which may not be accurate.
+     * @param {string} request.regionCode
+     *   The Unicode country/region code (CLDR) of a location, such as "US" and
+     *   "419". For more information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). If set,
+     *   then results will be boosted based on the region_code provided.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -500,20 +580,26 @@ export declare class SearchServiceClient {
      *   documents. This overrides
      *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.ranking_expression|ServingConfig.ranking_expression}.
      *   The ranking expression is a single function or multiple functions that are
-     *   joint by "+".
+     *   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
+     *
+     *     * `relevance_score`: pre-defined keywords, used for measure relevance
      *     between query and document.
-     *     `embedding_field_path`: the document embedding field
+     *     * `embedding_field_path`: the document embedding field
      *     used with query embedding vector.
-     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     * `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)`.
      * @param {boolean} request.safeSearch
@@ -537,8 +623,54 @@ export declare class SearchServiceClient {
      *   See [Google Cloud
      *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
      *   for more details.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.NaturalLanguageQueryUnderstandingSpec} request.naturalLanguageQueryUnderstandingSpec
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
      * @param {google.cloud.discoveryengine.v1alpha.CustomFineTuningSpec} request.customFineTuningSpec
      *   Custom fine tuning configs.
+     *   If set, it has higher priority than the configs set in
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.custom_fine_tuning_spec|ServingConfig.custom_fine_tuning_spec}.
+     * @param {string} request.session
+     *   The session resource name. Optional.
+     *
+     *   Session allows users to do multi-turn /search API calls or coordination
+     *   between /search API calls and /answer API calls.
+     *
+     *   Example #1 (multi-turn /search API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /search API with the session ID generated in the first call.
+     *        Here, the previous search query gets considered in query
+     *        standing. I.e., if the first query is "How did Alphabet do in 2022?"
+     *        and the current query is "How about 2023?", the current query will
+     *        be interpreted as "How did Alphabet do in 2023?".
+     *
+     *   Example #2 (coordination between /search API calls and /answer API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /answer API with the session ID generated in the first call.
+     *        Here, the answer generation happens in the context of the search
+     *        results from the first search call.
+     *
+     *   Auto-session mode: when `projects/.../sessions/-` is used, a new session
+     *   gets automatically created. Otherwise, users can use the create-session API
+     *   to create a session manually.
+     *
+     *   Multi-turn Search feature is currently at private GA stage. Please use
+     *   v1alpha or v1beta version instead before we launch this feature to public
+     *   GA. Or ask for allowlisting through Google Support team.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.RelevanceThreshold} request.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.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
@@ -643,15 +775,29 @@ export declare class SearchServiceClient {
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   For more information on ordering for retail search, see
-     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
-     *
+     *   For more information on ordering the website search results, see
+     *   [Order web search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results).
+     *   For more information on ordering the healthcare search results, see
+     *   [Order healthcare search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results).
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
      *   Information about the end user.
      *   Highly recommended for analytics.
      *   {@link protos.google.cloud.discoveryengine.v1alpha.UserInfo.user_agent|UserInfo.user_agent}
      *   is used to deduce `device_type` for analytics.
+     * @param {string} request.languageCode
+     *   The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+     *   information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). This field
+     *   helps to better interpret the query. If a value isn't specified, the query
+     *   language code is automatically detected, which may not be accurate.
+     * @param {string} request.regionCode
+     *   The Unicode country/region code (CLDR) of a location, such as "US" and
+     *   "419". For more information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). If set,
+     *   then results will be boosted based on the region_code provided.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -716,20 +862,26 @@ export declare class SearchServiceClient {
      *   documents. This overrides
      *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.ranking_expression|ServingConfig.ranking_expression}.
      *   The ranking expression is a single function or multiple functions that are
-     *   joint by "+".
+     *   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
+     *
+     *     * `relevance_score`: pre-defined keywords, used for measure relevance
      *     between query and document.
-     *     `embedding_field_path`: the document embedding field
+     *     * `embedding_field_path`: the document embedding field
      *     used with query embedding vector.
-     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     * `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)`.
      * @param {boolean} request.safeSearch
@@ -753,8 +905,54 @@ export declare class SearchServiceClient {
      *   See [Google Cloud
      *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
      *   for more details.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.NaturalLanguageQueryUnderstandingSpec} request.naturalLanguageQueryUnderstandingSpec
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
      * @param {google.cloud.discoveryengine.v1alpha.CustomFineTuningSpec} request.customFineTuningSpec
      *   Custom fine tuning configs.
+     *   If set, it has higher priority than the configs set in
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.custom_fine_tuning_spec|ServingConfig.custom_fine_tuning_spec}.
+     * @param {string} request.session
+     *   The session resource name. Optional.
+     *
+     *   Session allows users to do multi-turn /search API calls or coordination
+     *   between /search API calls and /answer API calls.
+     *
+     *   Example #1 (multi-turn /search API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /search API with the session ID generated in the first call.
+     *        Here, the previous search query gets considered in query
+     *        standing. I.e., if the first query is "How did Alphabet do in 2022?"
+     *        and the current query is "How about 2023?", the current query will
+     *        be interpreted as "How did Alphabet do in 2023?".
+     *
+     *   Example #2 (coordination between /search API calls and /answer API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /answer API with the session ID generated in the first call.
+     *        Here, the answer generation happens in the context of the search
+     *        results from the first search call.
+     *
+     *   Auto-session mode: when `projects/.../sessions/-` is used, a new session
+     *   gets automatically created. Otherwise, users can use the create-session API
+     *   to create a session manually.
+     *
+     *   Multi-turn Search feature is currently at private GA stage. Please use
+     *   v1alpha or v1beta version instead before we launch this feature to public
+     *   GA. Or ask for allowlisting through Google Support team.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.RelevanceThreshold} request.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.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}

package/build/src/v1alpha/search_service_client.js

@@ -417,15 +417,29 @@ class SearchServiceClient {
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   For more information on ordering for retail search, see
-     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
-     *
+     *   For more information on ordering the website search results, see
+     *   [Order web search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results).
+     *   For more information on ordering the healthcare search results, see
+     *   [Order healthcare search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results).
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
      *   Information about the end user.
      *   Highly recommended for analytics.
      *   {@link protos.google.cloud.discoveryengine.v1alpha.UserInfo.user_agent|UserInfo.user_agent}
      *   is used to deduce `device_type` for analytics.
+     * @param {string} request.languageCode
+     *   The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+     *   information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). This field
+     *   helps to better interpret the query. If a value isn't specified, the query
+     *   language code is automatically detected, which may not be accurate.
+     * @param {string} request.regionCode
+     *   The Unicode country/region code (CLDR) of a location, such as "US" and
+     *   "419". For more information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). If set,
+     *   then results will be boosted based on the region_code provided.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -490,20 +504,26 @@ class SearchServiceClient {
      *   documents. This overrides
      *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.ranking_expression|ServingConfig.ranking_expression}.
      *   The ranking expression is a single function or multiple functions that are
-     *   joint by "+".
+     *   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
+     *
+     *     * `relevance_score`: pre-defined keywords, used for measure relevance
      *     between query and document.
-     *     `embedding_field_path`: the document embedding field
+     *     * `embedding_field_path`: the document embedding field
      *     used with query embedding vector.
-     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     * `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)`.
      * @param {boolean} request.safeSearch
@@ -527,8 +547,54 @@ class SearchServiceClient {
      *   See [Google Cloud
      *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
      *   for more details.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.NaturalLanguageQueryUnderstandingSpec} request.naturalLanguageQueryUnderstandingSpec
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
      * @param {google.cloud.discoveryengine.v1alpha.CustomFineTuningSpec} request.customFineTuningSpec
      *   Custom fine tuning configs.
+     *   If set, it has higher priority than the configs set in
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.custom_fine_tuning_spec|ServingConfig.custom_fine_tuning_spec}.
+     * @param {string} request.session
+     *   The session resource name. Optional.
+     *
+     *   Session allows users to do multi-turn /search API calls or coordination
+     *   between /search API calls and /answer API calls.
+     *
+     *   Example #1 (multi-turn /search API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /search API with the session ID generated in the first call.
+     *        Here, the previous search query gets considered in query
+     *        standing. I.e., if the first query is "How did Alphabet do in 2022?"
+     *        and the current query is "How about 2023?", the current query will
+     *        be interpreted as "How did Alphabet do in 2023?".
+     *
+     *   Example #2 (coordination between /search API calls and /answer API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /answer API with the session ID generated in the first call.
+     *        Here, the answer generation happens in the context of the search
+     *        results from the first search call.
+     *
+     *   Auto-session mode: when `projects/.../sessions/-` is used, a new session
+     *   gets automatically created. Otherwise, users can use the create-session API
+     *   to create a session manually.
+     *
+     *   Multi-turn Search feature is currently at private GA stage. Please use
+     *   v1alpha or v1beta version instead before we launch this feature to public
+     *   GA. Or ask for allowlisting through Google Support team.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.RelevanceThreshold} request.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.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
@@ -647,15 +713,29 @@ class SearchServiceClient {
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   For more information on ordering for retail search, see
-     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
-     *
+     *   For more information on ordering the website search results, see
+     *   [Order web search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results).
+     *   For more information on ordering the healthcare search results, see
+     *   [Order healthcare search
+     *   results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results).
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
      *   Information about the end user.
      *   Highly recommended for analytics.
      *   {@link protos.google.cloud.discoveryengine.v1alpha.UserInfo.user_agent|UserInfo.user_agent}
      *   is used to deduce `device_type` for analytics.
+     * @param {string} request.languageCode
+     *   The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+     *   information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). This field
+     *   helps to better interpret the query. If a value isn't specified, the query
+     *   language code is automatically detected, which may not be accurate.
+     * @param {string} request.regionCode
+     *   The Unicode country/region code (CLDR) of a location, such as "US" and
+     *   "419". For more information, see [Standard
+     *   fields](https://cloud.google.com/apis/design/standard_fields). If set,
+     *   then results will be boosted based on the region_code provided.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -720,20 +800,26 @@ class SearchServiceClient {
      *   documents. This overrides
      *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.ranking_expression|ServingConfig.ranking_expression}.
      *   The ranking expression is a single function or multiple functions that are
-     *   joint by "+".
+     *   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
+     *
+     *     * `relevance_score`: pre-defined keywords, used for measure relevance
      *     between query and document.
-     *     `embedding_field_path`: the document embedding field
+     *     * `embedding_field_path`: the document embedding field
      *     used with query embedding vector.
-     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     * `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)`.
      * @param {boolean} request.safeSearch
@@ -757,8 +843,54 @@ class SearchServiceClient {
      *   See [Google Cloud
      *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
      *   for more details.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.NaturalLanguageQueryUnderstandingSpec} request.naturalLanguageQueryUnderstandingSpec
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
      * @param {google.cloud.discoveryengine.v1alpha.CustomFineTuningSpec} request.customFineTuningSpec
      *   Custom fine tuning configs.
+     *   If set, it has higher priority than the configs set in
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.ServingConfig.custom_fine_tuning_spec|ServingConfig.custom_fine_tuning_spec}.
+     * @param {string} request.session
+     *   The session resource name. Optional.
+     *
+     *   Session allows users to do multi-turn /search API calls or coordination
+     *   between /search API calls and /answer API calls.
+     *
+     *   Example #1 (multi-turn /search API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /search API with the session ID generated in the first call.
+     *        Here, the previous search query gets considered in query
+     *        standing. I.e., if the first query is "How did Alphabet do in 2022?"
+     *        and the current query is "How about 2023?", the current query will
+     *        be interpreted as "How did Alphabet do in 2023?".
+     *
+     *   Example #2 (coordination between /search API calls and /answer API calls):
+     *     1. Call /search API with the auto-session mode (see below).
+     *     2. Call /answer API with the session ID generated in the first call.
+     *        Here, the answer generation happens in the context of the search
+     *        results from the first search call.
+     *
+     *   Auto-session mode: when `projects/.../sessions/-` is used, a new session
+     *   gets automatically created. Otherwise, users can use the create-session API
+     *   to create a session manually.
+     *
+     *   Multi-turn Search feature is currently at private GA stage. Please use
+     *   v1alpha or v1beta version instead before we launch this feature to public
+     *   GA. Or ask for allowlisting through Google Support team.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.RelevanceThreshold} request.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.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}

package/build/src/v1alpha/search_tuning_service_client.js

@@ -249,6 +249,9 @@ class SearchTuningServiceClient {
                         {
                             get: '/v1alpha/{name=projects/*/locations/*/evaluations/*/operations/*}',
                         },
+                        {
+                            get: '/v1alpha/{name=projects/*/locations/*/identity_mapping_stores/*/operations/*}',
+                        },
                         { get: '/v1alpha/{name=projects/*/locations/*/operations/*}' },
                         {
                             get: '/v1alpha/{name=projects/*/locations/*/sampleQuerySets/*/operations/*}',
@@ -293,6 +296,9 @@ class SearchTuningServiceClient {
                         {
                             get: '/v1alpha/{name=projects/*/locations/*/dataStores/*}/operations',
                         },
+                        {
+                            get: '/v1alpha/{name=projects/*/locations/*/identity_mapping_stores/*}/operations',
+                        },
                         { get: '/v1alpha/{name=projects/*/locations/*}/operations' },
                         { get: '/v1alpha/{name=projects/*}/operations' },
                     ],