@google-cloud/discoveryengine 2.5.2 → 2.6.0

package/build/src/v1/search_service_client.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -373,6 +373,24 @@ class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {string[]} [request.pageCategories]
+     *   Optional. The categories associated with a category page. Must be set for
+     *   category navigation queries to achieve good search quality. The format
+     *   should be the same as
+     *   {@link protos.google.cloud.discoveryengine.v1.PageInfo.page_category|PageInfo.page_category}.
+     *   This field is the equivalent of the query for browse (navigation) queries.
+     *   It's used by the browse model when the query is empty.
+     *
+     *   If the field is empty, it will not be used by the browse model.
+     *   If the field contains more than one element, only the first element will
+     *   be used.
+     *
+     *   To represent full path of a category, use '>' character to separate
+     *   different hierarchies. If '>' is part of the category name, replace it with
+     *   other character(s).
+     *   For example, `Graphics Cards > RTX>4090 > Founders Edition` where "RTX >
+     *   4090" represents one level, can be rewritten as `Graphics Cards > RTX_4090
+     *   > Founders Edition`
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ImageQuery} request.imageQuery
      *   Raw image query.
      * @param {number} request.pageSize
@@ -403,6 +421,8 @@ class SearchServiceClient {
      *   unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   A large offset may be capped to a reasonable threshold.
      * @param {number} request.oneBoxPageSize
      *   The maximum number of results to return for OneBox.
      *   This applies to each OneBox type individually.
@@ -499,11 +519,11 @@ class SearchServiceClient {
      * @param {google.cloud.discoveryengine.v1.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
      *   which spell correction takes effect.
-     * @param {string} request.userPseudoId
-     *   A unique identifier for tracking visitors. For example, this could be
-     *   implemented with an HTTP cookie, which should be able to uniquely identify
-     *   a visitor on a single device. This unique identifier should not change if
-     *   the visitor logs in or out of the website.
+     * @param {string} [request.userPseudoId]
+     *   Optional. A unique identifier for tracking visitors. For example, this
+     *   could be implemented with an HTTP cookie, which should be able to uniquely
+     *   identify a visitor on a single device. This unique identifier should not
+     *   change if the visitor logs in or out of the website.
      *
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
@@ -516,72 +536,9 @@ class SearchServiceClient {
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec} request.contentSearchSpec
      *   A specification for configuring the behavior of content search.
-     * @param {boolean} request.safeSearch
-     *   Whether to turn on safe search. This is only supported for
-     *   website search.
-     * @param {number[]} request.userLabels
-     *   The user labels applied to a resource must meet the following requirements:
-     *
-     *   * Each resource can have multiple labels, up to a maximum of 64.
-     *   * Each label must be a key-value pair.
-     *   * Keys have a minimum length of 1 character and a maximum length of 63
-     *     characters and cannot be empty. Values can be empty and have a maximum
-     *     length of 63 characters.
-     *   * Keys and values can contain only lowercase letters, numeric characters,
-     *     underscores, and dashes. All characters must use UTF-8 encoding, and
-     *     international characters are allowed.
-     *   * The key portion of a label must be unique. However, you can use the same
-     *     key with multiple resources.
-     *   * Keys must start with a lowercase letter or international character.
-     *
-     *   See [Google Cloud
-     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
-     *   for more details.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
-     *   Search as you type configuration. Only supported for the
-     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
-     *   vertical.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
-     *   Optional. Config for display feature, like match highlighting on search
-     *   results.
-     * @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):
-     *     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):
-     *     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.
-     *
-     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
-     *   Session specification.
-     *
-     *   Can be used only when `session` is set.
-     * @param {google.cloud.discoveryengine.v1.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.
-     *
-     *   This feature is not supported for healthcare search.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
-     *   Optional. The specification for returning the relevance score.
-     * @param {string} request.rankingExpression
-     *   The ranking expression controls the customized ranking on retrieval
-     *   documents. This overrides
+     * @param {string} [request.rankingExpression]
+     *   Optional. The ranking expression controls the customized ranking on
+     *   retrieval documents. This overrides
      *   {@link protos.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
@@ -671,7 +628,90 @@ class SearchServiceClient {
      *     the document.
      *     * `base_rank`: the default rank of the result
      * @param {google.cloud.discoveryengine.v1.SearchRequest.RankingExpressionBackend} [request.rankingExpressionBackend]
-     *   The backend to use for the ranking expression evaluation.
+     *   Optional. The backend to use for the ranking expression evaluation.
+     * @param {boolean} request.safeSearch
+     *   Whether to turn on safe search. This is only supported for
+     *   website search.
+     * @param {number[]} request.userLabels
+     *   The user labels applied to a resource must meet the following requirements:
+     *
+     *   * Each resource can have multiple labels, up to a maximum of 64.
+     *   * Each label must be a key-value pair.
+     *   * Keys have a minimum length of 1 character and a maximum length of 63
+     *     characters and cannot be empty. Values can be empty and have a maximum
+     *     length of 63 characters.
+     *   * Keys and values can contain only lowercase letters, numeric characters,
+     *     underscores, and dashes. All characters must use UTF-8 encoding, and
+     *     international characters are allowed.
+     *   * The key portion of a label must be unique. However, you can use the same
+     *     key with multiple resources.
+     *   * Keys must start with a lowercase letter or international character.
+     *
+     *   See [Google Cloud
+     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+     *   for more details.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec} [request.naturalLanguageQueryUnderstandingSpec]
+     *   Optional. Config for natural language query understanding capabilities,
+     *   such as extracting structured field filters from the query. Refer to [this
+     *   documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries)
+     *   for more information.
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
+     *   Optional. Config for display feature, like match highlighting on search
+     *   results.
+     * @param {number[]} [request.crowdingSpecs]
+     *   Optional. Crowding specifications for improving result diversity.
+     *   If multiple CrowdingSpecs are specified, crowding will be evaluated on
+     *   each unique combination of the `field` values, and max_count will be the
+     *   maximum value of `max_count` across all CrowdingSpecs.
+     *   For example, if the first CrowdingSpec has `field` = "color" and
+     *   `max_count` = 3, and the second CrowdingSpec has `field` = "size" and
+     *   `max_count` = 2, then after 3 documents that share the same color AND size
+     *   have been returned, subsequent ones should be
+     *   removed or demoted.
+     * @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):
+     *     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):
+     *     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.
+     *
+     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceThreshold} request.relevanceThreshold
+     *   The global relevance threshold of the search results.
+     *
+     *   Defaults to Google defined threshold, leveraging a balance of
+     *   precision and recall to deliver both highly accurate results and
+     *   comprehensive coverage of relevant information.
+     *
+     *   If more granular relevance filtering is required, use the
+     *   `relevance_filter_spec` instead.
+     *
+     *   This feature is not supported for healthcare search.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
+     *   Optional. The specification for returning the relevance score.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
@@ -718,6 +758,24 @@ class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {string[]} [request.pageCategories]
+     *   Optional. The categories associated with a category page. Must be set for
+     *   category navigation queries to achieve good search quality. The format
+     *   should be the same as
+     *   {@link protos.google.cloud.discoveryengine.v1.PageInfo.page_category|PageInfo.page_category}.
+     *   This field is the equivalent of the query for browse (navigation) queries.
+     *   It's used by the browse model when the query is empty.
+     *
+     *   If the field is empty, it will not be used by the browse model.
+     *   If the field contains more than one element, only the first element will
+     *   be used.
+     *
+     *   To represent full path of a category, use '>' character to separate
+     *   different hierarchies. If '>' is part of the category name, replace it with
+     *   other character(s).
+     *   For example, `Graphics Cards > RTX>4090 > Founders Edition` where "RTX >
+     *   4090" represents one level, can be rewritten as `Graphics Cards > RTX_4090
+     *   > Founders Edition`
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ImageQuery} request.imageQuery
      *   Raw image query.
      * @param {number} request.pageSize
@@ -748,6 +806,8 @@ class SearchServiceClient {
      *   unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   A large offset may be capped to a reasonable threshold.
      * @param {number} request.oneBoxPageSize
      *   The maximum number of results to return for OneBox.
      *   This applies to each OneBox type individually.
@@ -844,11 +904,11 @@ class SearchServiceClient {
      * @param {google.cloud.discoveryengine.v1.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
      *   which spell correction takes effect.
-     * @param {string} request.userPseudoId
-     *   A unique identifier for tracking visitors. For example, this could be
-     *   implemented with an HTTP cookie, which should be able to uniquely identify
-     *   a visitor on a single device. This unique identifier should not change if
-     *   the visitor logs in or out of the website.
+     * @param {string} [request.userPseudoId]
+     *   Optional. A unique identifier for tracking visitors. For example, this
+     *   could be implemented with an HTTP cookie, which should be able to uniquely
+     *   identify a visitor on a single device. This unique identifier should not
+     *   change if the visitor logs in or out of the website.
      *
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
@@ -861,72 +921,9 @@ class SearchServiceClient {
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec} request.contentSearchSpec
      *   A specification for configuring the behavior of content search.
-     * @param {boolean} request.safeSearch
-     *   Whether to turn on safe search. This is only supported for
-     *   website search.
-     * @param {number[]} request.userLabels
-     *   The user labels applied to a resource must meet the following requirements:
-     *
-     *   * Each resource can have multiple labels, up to a maximum of 64.
-     *   * Each label must be a key-value pair.
-     *   * Keys have a minimum length of 1 character and a maximum length of 63
-     *     characters and cannot be empty. Values can be empty and have a maximum
-     *     length of 63 characters.
-     *   * Keys and values can contain only lowercase letters, numeric characters,
-     *     underscores, and dashes. All characters must use UTF-8 encoding, and
-     *     international characters are allowed.
-     *   * The key portion of a label must be unique. However, you can use the same
-     *     key with multiple resources.
-     *   * Keys must start with a lowercase letter or international character.
-     *
-     *   See [Google Cloud
-     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
-     *   for more details.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
-     *   Search as you type configuration. Only supported for the
-     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
-     *   vertical.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
-     *   Optional. Config for display feature, like match highlighting on search
-     *   results.
-     * @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):
-     *     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):
-     *     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.
-     *
-     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
-     *   Session specification.
-     *
-     *   Can be used only when `session` is set.
-     * @param {google.cloud.discoveryengine.v1.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.
-     *
-     *   This feature is not supported for healthcare search.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
-     *   Optional. The specification for returning the relevance score.
-     * @param {string} request.rankingExpression
-     *   The ranking expression controls the customized ranking on retrieval
-     *   documents. This overrides
+     * @param {string} [request.rankingExpression]
+     *   Optional. The ranking expression controls the customized ranking on
+     *   retrieval documents. This overrides
      *   {@link protos.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
@@ -1016,7 +1013,90 @@ class SearchServiceClient {
      *     the document.
      *     * `base_rank`: the default rank of the result
      * @param {google.cloud.discoveryengine.v1.SearchRequest.RankingExpressionBackend} [request.rankingExpressionBackend]
-     *   The backend to use for the ranking expression evaluation.
+     *   Optional. The backend to use for the ranking expression evaluation.
+     * @param {boolean} request.safeSearch
+     *   Whether to turn on safe search. This is only supported for
+     *   website search.
+     * @param {number[]} request.userLabels
+     *   The user labels applied to a resource must meet the following requirements:
+     *
+     *   * Each resource can have multiple labels, up to a maximum of 64.
+     *   * Each label must be a key-value pair.
+     *   * Keys have a minimum length of 1 character and a maximum length of 63
+     *     characters and cannot be empty. Values can be empty and have a maximum
+     *     length of 63 characters.
+     *   * Keys and values can contain only lowercase letters, numeric characters,
+     *     underscores, and dashes. All characters must use UTF-8 encoding, and
+     *     international characters are allowed.
+     *   * The key portion of a label must be unique. However, you can use the same
+     *     key with multiple resources.
+     *   * Keys must start with a lowercase letter or international character.
+     *
+     *   See [Google Cloud
+     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+     *   for more details.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec} [request.naturalLanguageQueryUnderstandingSpec]
+     *   Optional. Config for natural language query understanding capabilities,
+     *   such as extracting structured field filters from the query. Refer to [this
+     *   documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries)
+     *   for more information.
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
+     *   Optional. Config for display feature, like match highlighting on search
+     *   results.
+     * @param {number[]} [request.crowdingSpecs]
+     *   Optional. Crowding specifications for improving result diversity.
+     *   If multiple CrowdingSpecs are specified, crowding will be evaluated on
+     *   each unique combination of the `field` values, and max_count will be the
+     *   maximum value of `max_count` across all CrowdingSpecs.
+     *   For example, if the first CrowdingSpec has `field` = "color" and
+     *   `max_count` = 3, and the second CrowdingSpec has `field` = "size" and
+     *   `max_count` = 2, then after 3 documents that share the same color AND size
+     *   have been returned, subsequent ones should be
+     *   removed or demoted.
+     * @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):
+     *     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):
+     *     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.
+     *
+     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceThreshold} request.relevanceThreshold
+     *   The global relevance threshold of the search results.
+     *
+     *   Defaults to Google defined threshold, leveraging a balance of
+     *   precision and recall to deliver both highly accurate results and
+     *   comprehensive coverage of relevant information.
+     *
+     *   If more granular relevance filtering is required, use the
+     *   `relevance_filter_spec` instead.
+     *
+     *   This feature is not supported for healthcare search.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
+     *   Optional. The specification for returning the relevance score.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}
@@ -1093,6 +1173,24 @@ class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {string[]} [request.pageCategories]
+     *   Optional. The categories associated with a category page. Must be set for
+     *   category navigation queries to achieve good search quality. The format
+     *   should be the same as
+     *   {@link protos.google.cloud.discoveryengine.v1.PageInfo.page_category|PageInfo.page_category}.
+     *   This field is the equivalent of the query for browse (navigation) queries.
+     *   It's used by the browse model when the query is empty.
+     *
+     *   If the field is empty, it will not be used by the browse model.
+     *   If the field contains more than one element, only the first element will
+     *   be used.
+     *
+     *   To represent full path of a category, use '>' character to separate
+     *   different hierarchies. If '>' is part of the category name, replace it with
+     *   other character(s).
+     *   For example, `Graphics Cards > RTX>4090 > Founders Edition` where "RTX >
+     *   4090" represents one level, can be rewritten as `Graphics Cards > RTX_4090
+     *   > Founders Edition`
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ImageQuery} request.imageQuery
      *   Raw image query.
      * @param {number} request.pageSize
@@ -1123,6 +1221,8 @@ class SearchServiceClient {
      *   unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   A large offset may be capped to a reasonable threshold.
      * @param {number} request.oneBoxPageSize
      *   The maximum number of results to return for OneBox.
      *   This applies to each OneBox type individually.
@@ -1219,11 +1319,11 @@ class SearchServiceClient {
      * @param {google.cloud.discoveryengine.v1.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
      *   which spell correction takes effect.
-     * @param {string} request.userPseudoId
-     *   A unique identifier for tracking visitors. For example, this could be
-     *   implemented with an HTTP cookie, which should be able to uniquely identify
-     *   a visitor on a single device. This unique identifier should not change if
-     *   the visitor logs in or out of the website.
+     * @param {string} [request.userPseudoId]
+     *   Optional. A unique identifier for tracking visitors. For example, this
+     *   could be implemented with an HTTP cookie, which should be able to uniquely
+     *   identify a visitor on a single device. This unique identifier should not
+     *   change if the visitor logs in or out of the website.
      *
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
@@ -1236,72 +1336,9 @@ class SearchServiceClient {
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec} request.contentSearchSpec
      *   A specification for configuring the behavior of content search.
-     * @param {boolean} request.safeSearch
-     *   Whether to turn on safe search. This is only supported for
-     *   website search.
-     * @param {number[]} request.userLabels
-     *   The user labels applied to a resource must meet the following requirements:
-     *
-     *   * Each resource can have multiple labels, up to a maximum of 64.
-     *   * Each label must be a key-value pair.
-     *   * Keys have a minimum length of 1 character and a maximum length of 63
-     *     characters and cannot be empty. Values can be empty and have a maximum
-     *     length of 63 characters.
-     *   * Keys and values can contain only lowercase letters, numeric characters,
-     *     underscores, and dashes. All characters must use UTF-8 encoding, and
-     *     international characters are allowed.
-     *   * The key portion of a label must be unique. However, you can use the same
-     *     key with multiple resources.
-     *   * Keys must start with a lowercase letter or international character.
-     *
-     *   See [Google Cloud
-     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
-     *   for more details.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
-     *   Search as you type configuration. Only supported for the
-     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
-     *   vertical.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
-     *   Optional. Config for display feature, like match highlighting on search
-     *   results.
-     * @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):
-     *     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):
-     *     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.
-     *
-     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
-     *   Session specification.
-     *
-     *   Can be used only when `session` is set.
-     * @param {google.cloud.discoveryengine.v1.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.
-     *
-     *   This feature is not supported for healthcare search.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
-     *   Optional. The specification for returning the relevance score.
-     * @param {string} request.rankingExpression
-     *   The ranking expression controls the customized ranking on retrieval
-     *   documents. This overrides
+     * @param {string} [request.rankingExpression]
+     *   Optional. The ranking expression controls the customized ranking on
+     *   retrieval documents. This overrides
      *   {@link protos.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
@@ -1391,7 +1428,90 @@ class SearchServiceClient {
      *     the document.
      *     * `base_rank`: the default rank of the result
      * @param {google.cloud.discoveryengine.v1.SearchRequest.RankingExpressionBackend} [request.rankingExpressionBackend]
-     *   The backend to use for the ranking expression evaluation.
+     *   Optional. The backend to use for the ranking expression evaluation.
+     * @param {boolean} request.safeSearch
+     *   Whether to turn on safe search. This is only supported for
+     *   website search.
+     * @param {number[]} request.userLabels
+     *   The user labels applied to a resource must meet the following requirements:
+     *
+     *   * Each resource can have multiple labels, up to a maximum of 64.
+     *   * Each label must be a key-value pair.
+     *   * Keys have a minimum length of 1 character and a maximum length of 63
+     *     characters and cannot be empty. Values can be empty and have a maximum
+     *     length of 63 characters.
+     *   * Keys and values can contain only lowercase letters, numeric characters,
+     *     underscores, and dashes. All characters must use UTF-8 encoding, and
+     *     international characters are allowed.
+     *   * The key portion of a label must be unique. However, you can use the same
+     *     key with multiple resources.
+     *   * Keys must start with a lowercase letter or international character.
+     *
+     *   See [Google Cloud
+     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+     *   for more details.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec} [request.naturalLanguageQueryUnderstandingSpec]
+     *   Optional. Config for natural language query understanding capabilities,
+     *   such as extracting structured field filters from the query. Refer to [this
+     *   documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries)
+     *   for more information.
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
+     *   Optional. Config for display feature, like match highlighting on search
+     *   results.
+     * @param {number[]} [request.crowdingSpecs]
+     *   Optional. Crowding specifications for improving result diversity.
+     *   If multiple CrowdingSpecs are specified, crowding will be evaluated on
+     *   each unique combination of the `field` values, and max_count will be the
+     *   maximum value of `max_count` across all CrowdingSpecs.
+     *   For example, if the first CrowdingSpec has `field` = "color" and
+     *   `max_count` = 3, and the second CrowdingSpec has `field` = "size" and
+     *   `max_count` = 2, then after 3 documents that share the same color AND size
+     *   have been returned, subsequent ones should be
+     *   removed or demoted.
+     * @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):
+     *     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):
+     *     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.
+     *
+     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceThreshold} request.relevanceThreshold
+     *   The global relevance threshold of the search results.
+     *
+     *   Defaults to Google defined threshold, leveraging a balance of
+     *   precision and recall to deliver both highly accurate results and
+     *   comprehensive coverage of relevant information.
+     *
+     *   If more granular relevance filtering is required, use the
+     *   `relevance_filter_spec` instead.
+     *
+     *   This feature is not supported for healthcare search.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
+     *   Optional. The specification for returning the relevance score.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
@@ -1438,6 +1558,24 @@ class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {string[]} [request.pageCategories]
+     *   Optional. The categories associated with a category page. Must be set for
+     *   category navigation queries to achieve good search quality. The format
+     *   should be the same as
+     *   {@link protos.google.cloud.discoveryengine.v1.PageInfo.page_category|PageInfo.page_category}.
+     *   This field is the equivalent of the query for browse (navigation) queries.
+     *   It's used by the browse model when the query is empty.
+     *
+     *   If the field is empty, it will not be used by the browse model.
+     *   If the field contains more than one element, only the first element will
+     *   be used.
+     *
+     *   To represent full path of a category, use '>' character to separate
+     *   different hierarchies. If '>' is part of the category name, replace it with
+     *   other character(s).
+     *   For example, `Graphics Cards > RTX>4090 > Founders Edition` where "RTX >
+     *   4090" represents one level, can be rewritten as `Graphics Cards > RTX_4090
+     *   > Founders Edition`
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ImageQuery} request.imageQuery
      *   Raw image query.
      * @param {number} request.pageSize
@@ -1468,6 +1606,8 @@ class SearchServiceClient {
      *   unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   A large offset may be capped to a reasonable threshold.
      * @param {number} request.oneBoxPageSize
      *   The maximum number of results to return for OneBox.
      *   This applies to each OneBox type individually.
@@ -1564,11 +1704,11 @@ class SearchServiceClient {
      * @param {google.cloud.discoveryengine.v1.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
      *   which spell correction takes effect.
-     * @param {string} request.userPseudoId
-     *   A unique identifier for tracking visitors. For example, this could be
-     *   implemented with an HTTP cookie, which should be able to uniquely identify
-     *   a visitor on a single device. This unique identifier should not change if
-     *   the visitor logs in or out of the website.
+     * @param {string} [request.userPseudoId]
+     *   Optional. A unique identifier for tracking visitors. For example, this
+     *   could be implemented with an HTTP cookie, which should be able to uniquely
+     *   identify a visitor on a single device. This unique identifier should not
+     *   change if the visitor logs in or out of the website.
      *
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
@@ -1581,72 +1721,9 @@ class SearchServiceClient {
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec} request.contentSearchSpec
      *   A specification for configuring the behavior of content search.
-     * @param {boolean} request.safeSearch
-     *   Whether to turn on safe search. This is only supported for
-     *   website search.
-     * @param {number[]} request.userLabels
-     *   The user labels applied to a resource must meet the following requirements:
-     *
-     *   * Each resource can have multiple labels, up to a maximum of 64.
-     *   * Each label must be a key-value pair.
-     *   * Keys have a minimum length of 1 character and a maximum length of 63
-     *     characters and cannot be empty. Values can be empty and have a maximum
-     *     length of 63 characters.
-     *   * Keys and values can contain only lowercase letters, numeric characters,
-     *     underscores, and dashes. All characters must use UTF-8 encoding, and
-     *     international characters are allowed.
-     *   * The key portion of a label must be unique. However, you can use the same
-     *     key with multiple resources.
-     *   * Keys must start with a lowercase letter or international character.
-     *
-     *   See [Google Cloud
-     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
-     *   for more details.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
-     *   Search as you type configuration. Only supported for the
-     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
-     *   vertical.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
-     *   Optional. Config for display feature, like match highlighting on search
-     *   results.
-     * @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):
-     *     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):
-     *     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.
-     *
-     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
-     *   Session specification.
-     *
-     *   Can be used only when `session` is set.
-     * @param {google.cloud.discoveryengine.v1.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.
-     *
-     *   This feature is not supported for healthcare search.
-     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
-     *   Optional. The specification for returning the relevance score.
-     * @param {string} request.rankingExpression
-     *   The ranking expression controls the customized ranking on retrieval
-     *   documents. This overrides
+     * @param {string} [request.rankingExpression]
+     *   Optional. The ranking expression controls the customized ranking on
+     *   retrieval documents. This overrides
      *   {@link protos.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
@@ -1736,7 +1813,90 @@ class SearchServiceClient {
      *     the document.
      *     * `base_rank`: the default rank of the result
      * @param {google.cloud.discoveryengine.v1.SearchRequest.RankingExpressionBackend} [request.rankingExpressionBackend]
-     *   The backend to use for the ranking expression evaluation.
+     *   Optional. The backend to use for the ranking expression evaluation.
+     * @param {boolean} request.safeSearch
+     *   Whether to turn on safe search. This is only supported for
+     *   website search.
+     * @param {number[]} request.userLabels
+     *   The user labels applied to a resource must meet the following requirements:
+     *
+     *   * Each resource can have multiple labels, up to a maximum of 64.
+     *   * Each label must be a key-value pair.
+     *   * Keys have a minimum length of 1 character and a maximum length of 63
+     *     characters and cannot be empty. Values can be empty and have a maximum
+     *     length of 63 characters.
+     *   * Keys and values can contain only lowercase letters, numeric characters,
+     *     underscores, and dashes. All characters must use UTF-8 encoding, and
+     *     international characters are allowed.
+     *   * The key portion of a label must be unique. However, you can use the same
+     *     key with multiple resources.
+     *   * Keys must start with a lowercase letter or international character.
+     *
+     *   See [Google Cloud
+     *   Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+     *   for more details.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec} [request.naturalLanguageQueryUnderstandingSpec]
+     *   Optional. Config for natural language query understanding capabilities,
+     *   such as extracting structured field filters from the query. Refer to [this
+     *   documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries)
+     *   for more information.
+     *   If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+     *   natural language query understanding will be done.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.SearchAsYouTypeSpec} request.searchAsYouTypeSpec
+     *   Search as you type configuration. Only supported for the
+     *   {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.MEDIA|IndustryVertical.MEDIA}
+     *   vertical.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.DisplaySpec} [request.displaySpec]
+     *   Optional. Config for display feature, like match highlighting on search
+     *   results.
+     * @param {number[]} [request.crowdingSpecs]
+     *   Optional. Crowding specifications for improving result diversity.
+     *   If multiple CrowdingSpecs are specified, crowding will be evaluated on
+     *   each unique combination of the `field` values, and max_count will be the
+     *   maximum value of `max_count` across all CrowdingSpecs.
+     *   For example, if the first CrowdingSpec has `field` = "color" and
+     *   `max_count` = 3, and the second CrowdingSpec has `field` = "size" and
+     *   `max_count` = 2, then after 3 documents that share the same color AND size
+     *   have been returned, subsequent ones should be
+     *   removed or demoted.
+     * @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):
+     *     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):
+     *     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.
+     *
+     *   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.v1.SearchRequest.SessionSpec} request.sessionSpec
+     *   Session specification.
+     *
+     *   Can be used only when `session` is set.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceThreshold} request.relevanceThreshold
+     *   The global relevance threshold of the search results.
+     *
+     *   Defaults to Google defined threshold, leveraging a balance of
+     *   precision and recall to deliver both highly accurate results and
+     *   comprehensive coverage of relevant information.
+     *
+     *   If more granular relevance filtering is required, use the
+     *   `relevance_filter_spec` instead.
+     *
+     *   This feature is not supported for healthcare search.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.RelevanceScoreSpec} [request.relevanceScoreSpec]
+     *   Optional. The specification for returning the relevance score.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}