@google-cloud/discoveryengine 1.12.0 → 1.14.0

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

@@ -304,6 +304,35 @@ export declare class DocumentServiceClient {
     ]>;
     getProcessedDocument(request: protos.google.cloud.discoveryengine.v1alpha.IGetProcessedDocumentRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1alpha.IProcessedDocument, protos.google.cloud.discoveryengine.v1alpha.IGetProcessedDocumentRequest | null | undefined, {} | null | undefined>): void;
     getProcessedDocument(request: protos.google.cloud.discoveryengine.v1alpha.IGetProcessedDocumentRequest, callback: Callback<protos.google.cloud.discoveryengine.v1alpha.IProcessedDocument, protos.google.cloud.discoveryengine.v1alpha.IGetProcessedDocumentRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Gets index freshness metadata for
+     * {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}s. Supported for
+     * website search only.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. The parent branch resource name, such as
+     *   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
+     * @param {google.cloud.discoveryengine.v1alpha.BatchGetDocumentsMetadataRequest.Matcher} request.matcher
+     *   Required. Matcher for the
+     *   {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}s.
+     * @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.
+     *   The first element of the array is an object representing {@link protos.google.cloud.discoveryengine.v1alpha.BatchGetDocumentsMetadataResponse|BatchGetDocumentsMetadataResponse}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1alpha/document_service.batch_get_documents_metadata.js</caption>
+     * region_tag:discoveryengine_v1alpha_generated_DocumentService_BatchGetDocumentsMetadata_async
+     */
+    batchGetDocumentsMetadata(request?: protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataRequest, options?: CallOptions): Promise<[
+        protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataResponse,
+        (protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataRequest | undefined),
+        {} | undefined
+    ]>;
+    batchGetDocumentsMetadata(request: protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataResponse, protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataRequest | null | undefined, {} | null | undefined>): void;
+    batchGetDocumentsMetadata(request: protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataRequest, callback: Callback<protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataResponse, protos.google.cloud.discoveryengine.v1alpha.IBatchGetDocumentsMetadataRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Bulk import of multiple
      * {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}s. Request
@@ -329,6 +358,8 @@ export declare class DocumentServiceClient {
      *   Cloud SQL input source.
      * @param {google.cloud.discoveryengine.v1alpha.FirestoreSource} request.firestoreSource
      *   Firestore input source.
+     * @param {google.cloud.discoveryengine.v1alpha.AlloyDbSource} request.alloyDbSource
+     *   AlloyDB input source.
      * @param {google.cloud.discoveryengine.v1alpha.BigtableSource} request.bigtableSource
      *   Cloud Bigtable input source.
      * @param {string} request.parent
@@ -461,6 +492,8 @@ export declare class DocumentServiceClient {
      *   Supported `data_schema`:
      *   * `document_id`: One valid
      *   {@link protos.google.cloud.discoveryengine.v1alpha.Document.id|Document.id} per line.
+     * @param {google.cloud.discoveryengine.v1alpha.PurgeDocumentsRequest.InlineSource} request.inlineSource
+     *   Inline source for the input content for purge.
      * @param {string} request.parent
      *   Required. The parent resource name, such as
      *   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.

package/build/src/v1alpha/document_service_client.js

@@ -259,6 +259,9 @@ class DocumentServiceClient {
                         {
                             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/*}',
@@ -303,6 +306,9 @@ class DocumentServiceClient {
                         {
                             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' },
                     ],
@@ -363,6 +369,7 @@ class DocumentServiceClient {
             'importDocuments',
             'purgeDocuments',
             'getProcessedDocument',
+            'batchGetDocumentsMetadata',
         ];
         for (const methodName of documentServiceStubMethods) {
             const callPromise = this.documentServiceStub.then(stub => (...args) => {
@@ -547,6 +554,27 @@ class DocumentServiceClient {
         this.initialize();
         return this.innerApiCalls.getProcessedDocument(request, options, callback);
     }
+    batchGetDocumentsMetadata(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.batchGetDocumentsMetadata(request, options, callback);
+    }
     importDocuments(request, optionsOrCallback, callback) {
         var _a;
         request = request || {};

package/build/src/v1alpha/document_service_client_config.json

@@ -80,6 +80,11 @@
                     "timeout_millis": 30000,
                     "retry_codes_name": "unavailable",
                     "retry_params_name": "ce5b960a6ed052e690863808e4f0deff3dc7d49f"
+                },
+                "BatchGetDocumentsMetadata": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "unavailable",
+                    "retry_params_name": "ce5b960a6ed052e690863808e4f0deff3dc7d49f"
                 }
             }
         }

package/build/src/v1alpha/engine_service_client.js

@@ -257,6 +257,9 @@ class EngineServiceClient {
                         {
                             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/*}',
@@ -301,6 +304,9 @@ class EngineServiceClient {
                         {
                             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' },
                     ],

package/build/src/v1alpha/estimate_billing_service_client.js

@@ -251,6 +251,9 @@ class EstimateBillingServiceClient {
                         {
                             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/*}',
@@ -295,6 +298,9 @@ class EstimateBillingServiceClient {
                         {
                             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' },
                     ],

package/build/src/v1alpha/evaluation_service_client.js

@@ -258,6 +258,9 @@ class EvaluationServiceClient {
                         {
                             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/*}',
@@ -302,6 +305,9 @@ class EvaluationServiceClient {
                         {
                             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' },
                     ],

package/build/src/v1alpha/project_service_client.js

@@ -250,6 +250,9 @@ class ProjectServiceClient {
                         {
                             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/*}',
@@ -294,6 +297,9 @@ class ProjectServiceClient {
                         {
                             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' },
                     ],

package/build/src/v1alpha/sample_query_service_client.js

@@ -256,6 +256,9 @@ class SampleQueryServiceClient {
                         {
                             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/*}',
@@ -300,6 +303,9 @@ class SampleQueryServiceClient {
                         {
                             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' },
                     ],

package/build/src/v1alpha/schema_service_client.js

@@ -255,6 +255,9 @@ class SchemaServiceClient {
                         {
                             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/*}',
@@ -299,6 +302,9 @@ class SchemaServiceClient {
                         {
                             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' },
                     ],

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}