@google-cloud/discoveryengine 0.8.0 → 1.1.0

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

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import type * as gax from 'google-gax';
-import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback } from 'google-gax';
+import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback, LocationsClient, LocationProtos } from 'google-gax';
 import { Transform } from 'stream';
 import * as protos from '../../protos/protos';
 /**
@@ -22,6 +22,7 @@ export declare class SearchServiceClient {
     innerApiCalls: {
         [name: string]: Function;
     };
+    locationsClient: LocationsClient;
     pathTemplates: {
         [name: string]: gax.PathTemplate;
     };
@@ -56,8 +57,7 @@ export declare class SearchServiceClient {
      *     API remote host.
      * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
      *     Follows the structure of {@link gapicConfig}.
-     * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
-     *     Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
+     * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
      *     For more information, please check the
      *     {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
      * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
@@ -65,7 +65,7 @@ export declare class SearchServiceClient {
      *     HTTP implementation. Load only fallback version and pass it to the constructor:
      *     ```
      *     const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
-     *     const client = new SearchServiceClient({fallback: 'rest'}, gax);
+     *     const client = new SearchServiceClient({fallback: true}, gax);
      *     ```
      */
     constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
@@ -125,27 +125,29 @@ export declare class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {google.cloud.discoveryengine.v1beta.SearchRequest.ImageQuery} request.imageQuery
+     *   Raw image query.
      * @param {number} request.pageSize
-     *   Maximum number of {@link google.cloud.discoveryengine.v1beta.Document|Document}s
+     *   Maximum number of {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}s
      *   to return. If unspecified, defaults to a reasonable value. The maximum
-     *   allowed value is 100. Values above 100 will be coerced to 100.
+     *   allowed value is 100. Values above 100 are coerced to 100.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.pageToken
      *   A page token received from a previous
-     *   {@link google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
      *   call. Provide this to retrieve the subsequent page.
      *
      *   When paginating, all other parameters provided to
-     *   {@link google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
      *   must match the call that provided the page token. Otherwise, an
      *    `INVALID_ARGUMENT`  error is returned.
      * @param {number} request.offset
      *   A 0-indexed integer that specifies the current offset (that is, starting
      *   result location, amongst the
-     *   {@link google.cloud.discoveryengine.v1beta.Document|Document}s deemed by the API
+     *   {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}s deemed by the API
      *   as relevant) in search results. This field is only considered if
-     *   {@link google.cloud.discoveryengine.v1beta.SearchRequest.page_token|page_token}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchRequest.page_token|page_token}
      *   is unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
@@ -156,16 +158,17 @@ export declare class SearchServiceClient {
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.orderBy
-     *   The order in which documents are returned. Document can be ordered by
-     *   a field in an {@link google.cloud.discoveryengine.v1beta.Document|Document}
-     *   object. Leave it unset if ordered by relevance. OrderBy expression is
+     *   The order in which documents are returned. Documents can be ordered by
+     *   a field in an {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}
+     *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1beta.UserInfo} request.userInfo
      *   Information about the end user.
-     *   Highly recommended for analytics. The user_agent string in UserInfo will
-     *   be used to deduce device_type for analytics.
+     *   Highly recommended for analytics.
+     *   {@link protos.google.cloud.discoveryengine.v1beta.UserInfo.user_agent|UserInfo.user_agent}
+     *   is used to deduce `device_type` for analytics.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -185,10 +188,10 @@ export declare class SearchServiceClient {
      *     which enables image searching.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
-     *   query expansion will occur.
+     *   query expansion occurs.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
-     *   which spell correction will take effect.
+     *   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
@@ -198,18 +201,46 @@ export declare class SearchServiceClient {
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
      *   This should be the same identifier as
-     *   {@link google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
      *   and
-     *   {@link google.cloud.discoveryengine.v1beta.CompleteQueryRequest.user_pseudo_id|CompleteQueryRequest.user_pseudo_id}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.CompleteQueryRequest.user_pseudo_id|CompleteQueryRequest.user_pseudo_id}
      *
      *   The field must be a UTF-8 encoded string with a length limit of 128
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec} request.contentSearchSpec
-     *   The content search spec that configs the desired behavior of content
-     *   search.
+     *   A specification for configuring the behavior of content search.
+     * @param {google.cloud.discoveryengine.v1beta.SearchRequest.EmbeddingSpec} request.embeddingSpec
+     *   Uses the provided embedding to do additional semantic document retrieval.
+     *   The retrieval is based on the dot product of
+     *   {@link protos.|SearchRequest.embedding_spec.embedding_vectors.vector} and the document
+     *   embedding that is provided in
+     *   {@link protos.|SearchRequest.embedding_spec.embedding_vectors.field_path}.
+     *
+     *   If {@link protos.|SearchRequest.embedding_spec.embedding_vectors.field_path} is not
+     *   provided, it will use {@link protos.|ServingConfig.embedding_config.field_paths}.
+     * @param {string} request.rankingExpression
+     *   The ranking expression controls the customized ranking on retrieval
+     *   documents. This overrides {@link protos.|ServingConfig.ranking_expression}.
+     *   The ranking expression is a single function or multiple functions that are
+     *   joint by "+".
+     *     * ranking_expression = function, { " + ", function };
+     *   Supported functions:
+     *     * double * relevance_score
+     *     * double * dotProduct(embedding_field_path)
+     *   Function variables:
+     *     `relevance_score`: pre-defined keywords, used for measure relevance
+     *     between query and document.
+     *     `embedding_field_path`: the document embedding field
+     *     used with query embedding vector.
+     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     embedding vector.
+     *
+     *    Example ranking expression:
+     *      If document has an embedding field doc_embedding, the ranking expression
+     *      could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.
      * @param {boolean} request.safeSearch
      *   Whether to turn on safe search. This is only supported for
-     *   {@link |ContentConfig.PUBLIC_WEBSITE}.
+     *   website search.
      * @param {number[]} request.userLabels
      *   The user labels applied to a resource must meet the following requirements:
      *
@@ -231,14 +262,13 @@ export declare class SearchServiceClient {
      * @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 Array of {@link google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult | SearchResult}.
+     *   The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult|SearchResult}.
      *   The client library will perform auto-pagination by default: it will call the API as many
      *   times as needed and will merge results from all the pages into this array.
      *   Note that it can affect your quota.
      *   We recommend using `searchAsync()`
      *   method described below for async iteration which you can stop as needed.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
      *   for more details and examples.
      */
     search(request?: protos.google.cloud.discoveryengine.v1beta.ISearchRequest, options?: CallOptions): Promise<[
@@ -265,27 +295,29 @@ export declare class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {google.cloud.discoveryengine.v1beta.SearchRequest.ImageQuery} request.imageQuery
+     *   Raw image query.
      * @param {number} request.pageSize
-     *   Maximum number of {@link google.cloud.discoveryengine.v1beta.Document|Document}s
+     *   Maximum number of {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}s
      *   to return. If unspecified, defaults to a reasonable value. The maximum
-     *   allowed value is 100. Values above 100 will be coerced to 100.
+     *   allowed value is 100. Values above 100 are coerced to 100.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.pageToken
      *   A page token received from a previous
-     *   {@link google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
      *   call. Provide this to retrieve the subsequent page.
      *
      *   When paginating, all other parameters provided to
-     *   {@link google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
      *   must match the call that provided the page token. Otherwise, an
      *    `INVALID_ARGUMENT`  error is returned.
      * @param {number} request.offset
      *   A 0-indexed integer that specifies the current offset (that is, starting
      *   result location, amongst the
-     *   {@link google.cloud.discoveryengine.v1beta.Document|Document}s deemed by the API
+     *   {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}s deemed by the API
      *   as relevant) in search results. This field is only considered if
-     *   {@link google.cloud.discoveryengine.v1beta.SearchRequest.page_token|page_token}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchRequest.page_token|page_token}
      *   is unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
@@ -296,16 +328,17 @@ export declare class SearchServiceClient {
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.orderBy
-     *   The order in which documents are returned. Document can be ordered by
-     *   a field in an {@link google.cloud.discoveryengine.v1beta.Document|Document}
-     *   object. Leave it unset if ordered by relevance. OrderBy expression is
+     *   The order in which documents are returned. Documents can be ordered by
+     *   a field in an {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}
+     *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1beta.UserInfo} request.userInfo
      *   Information about the end user.
-     *   Highly recommended for analytics. The user_agent string in UserInfo will
-     *   be used to deduce device_type for analytics.
+     *   Highly recommended for analytics.
+     *   {@link protos.google.cloud.discoveryengine.v1beta.UserInfo.user_agent|UserInfo.user_agent}
+     *   is used to deduce `device_type` for analytics.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -325,10 +358,10 @@ export declare class SearchServiceClient {
      *     which enables image searching.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
-     *   query expansion will occur.
+     *   query expansion occurs.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
-     *   which spell correction will take effect.
+     *   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
@@ -338,18 +371,46 @@ export declare class SearchServiceClient {
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
      *   This should be the same identifier as
-     *   {@link google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
      *   and
-     *   {@link google.cloud.discoveryengine.v1beta.CompleteQueryRequest.user_pseudo_id|CompleteQueryRequest.user_pseudo_id}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.CompleteQueryRequest.user_pseudo_id|CompleteQueryRequest.user_pseudo_id}
      *
      *   The field must be a UTF-8 encoded string with a length limit of 128
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec} request.contentSearchSpec
-     *   The content search spec that configs the desired behavior of content
-     *   search.
+     *   A specification for configuring the behavior of content search.
+     * @param {google.cloud.discoveryengine.v1beta.SearchRequest.EmbeddingSpec} request.embeddingSpec
+     *   Uses the provided embedding to do additional semantic document retrieval.
+     *   The retrieval is based on the dot product of
+     *   {@link protos.|SearchRequest.embedding_spec.embedding_vectors.vector} and the document
+     *   embedding that is provided in
+     *   {@link protos.|SearchRequest.embedding_spec.embedding_vectors.field_path}.
+     *
+     *   If {@link protos.|SearchRequest.embedding_spec.embedding_vectors.field_path} is not
+     *   provided, it will use {@link protos.|ServingConfig.embedding_config.field_paths}.
+     * @param {string} request.rankingExpression
+     *   The ranking expression controls the customized ranking on retrieval
+     *   documents. This overrides {@link protos.|ServingConfig.ranking_expression}.
+     *   The ranking expression is a single function or multiple functions that are
+     *   joint by "+".
+     *     * ranking_expression = function, { " + ", function };
+     *   Supported functions:
+     *     * double * relevance_score
+     *     * double * dotProduct(embedding_field_path)
+     *   Function variables:
+     *     `relevance_score`: pre-defined keywords, used for measure relevance
+     *     between query and document.
+     *     `embedding_field_path`: the document embedding field
+     *     used with query embedding vector.
+     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     embedding vector.
+     *
+     *    Example ranking expression:
+     *      If document has an embedding field doc_embedding, the ranking expression
+     *      could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.
      * @param {boolean} request.safeSearch
      *   Whether to turn on safe search. This is only supported for
-     *   {@link |ContentConfig.PUBLIC_WEBSITE}.
+     *   website search.
      * @param {number[]} request.userLabels
      *   The user labels applied to a resource must meet the following requirements:
      *
@@ -371,13 +432,12 @@ export declare class SearchServiceClient {
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
-     *   An object stream which emits an object representing {@link google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult | SearchResult} on 'data' event.
+     *   An object stream which emits an object representing {@link protos.google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult|SearchResult} on 'data' event.
      *   The client library will perform auto-pagination by default: it will call the API as many
      *   times as needed. Note that it can affect your quota.
      *   We recommend using `searchAsync()`
      *   method described below for async iteration which you can stop as needed.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
      *   for more details and examples.
      */
     searchStream(request?: protos.google.cloud.discoveryengine.v1beta.ISearchRequest, options?: CallOptions): Transform;
@@ -400,27 +460,29 @@ export declare class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {google.cloud.discoveryengine.v1beta.SearchRequest.ImageQuery} request.imageQuery
+     *   Raw image query.
      * @param {number} request.pageSize
-     *   Maximum number of {@link google.cloud.discoveryengine.v1beta.Document|Document}s
+     *   Maximum number of {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}s
      *   to return. If unspecified, defaults to a reasonable value. The maximum
-     *   allowed value is 100. Values above 100 will be coerced to 100.
+     *   allowed value is 100. Values above 100 are coerced to 100.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.pageToken
      *   A page token received from a previous
-     *   {@link google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
      *   call. Provide this to retrieve the subsequent page.
      *
      *   When paginating, all other parameters provided to
-     *   {@link google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchService.Search|SearchService.Search}
      *   must match the call that provided the page token. Otherwise, an
      *    `INVALID_ARGUMENT`  error is returned.
      * @param {number} request.offset
      *   A 0-indexed integer that specifies the current offset (that is, starting
      *   result location, amongst the
-     *   {@link google.cloud.discoveryengine.v1beta.Document|Document}s deemed by the API
+     *   {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}s deemed by the API
      *   as relevant) in search results. This field is only considered if
-     *   {@link google.cloud.discoveryengine.v1beta.SearchRequest.page_token|page_token}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchRequest.page_token|page_token}
      *   is unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
@@ -431,16 +493,17 @@ export declare class SearchServiceClient {
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.orderBy
-     *   The order in which documents are returned. Document can be ordered by
-     *   a field in an {@link google.cloud.discoveryengine.v1beta.Document|Document}
-     *   object. Leave it unset if ordered by relevance. OrderBy expression is
+     *   The order in which documents are returned. Documents can be ordered by
+     *   a field in an {@link protos.google.cloud.discoveryengine.v1beta.Document|Document}
+     *   object. Leave it unset if ordered by relevance. `order_by` expression is
      *   case-sensitive.
      *
-     *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1beta.UserInfo} request.userInfo
      *   Information about the end user.
-     *   Highly recommended for analytics. The user_agent string in UserInfo will
-     *   be used to deduce device_type for analytics.
+     *   Highly recommended for analytics.
+     *   {@link protos.google.cloud.discoveryengine.v1beta.UserInfo.user_agent|UserInfo.user_agent}
+     *   is used to deduce `device_type` for analytics.
      * @param {number[]} request.facetSpecs
      *   Facet specifications for faceted search. If empty, no facets are returned.
      *
@@ -460,10 +523,10 @@ export declare class SearchServiceClient {
      *     which enables image searching.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
-     *   query expansion will occur.
+     *   query expansion occurs.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
-     *   which spell correction will take effect.
+     *   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
@@ -473,18 +536,46 @@ export declare class SearchServiceClient {
      *   This field should NOT have a fixed value such as `unknown_visitor`.
      *
      *   This should be the same identifier as
-     *   {@link google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
      *   and
-     *   {@link google.cloud.discoveryengine.v1beta.CompleteQueryRequest.user_pseudo_id|CompleteQueryRequest.user_pseudo_id}
+     *   {@link protos.google.cloud.discoveryengine.v1beta.CompleteQueryRequest.user_pseudo_id|CompleteQueryRequest.user_pseudo_id}
      *
      *   The field must be a UTF-8 encoded string with a length limit of 128
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec} request.contentSearchSpec
-     *   The content search spec that configs the desired behavior of content
-     *   search.
+     *   A specification for configuring the behavior of content search.
+     * @param {google.cloud.discoveryengine.v1beta.SearchRequest.EmbeddingSpec} request.embeddingSpec
+     *   Uses the provided embedding to do additional semantic document retrieval.
+     *   The retrieval is based on the dot product of
+     *   {@link protos.|SearchRequest.embedding_spec.embedding_vectors.vector} and the document
+     *   embedding that is provided in
+     *   {@link protos.|SearchRequest.embedding_spec.embedding_vectors.field_path}.
+     *
+     *   If {@link protos.|SearchRequest.embedding_spec.embedding_vectors.field_path} is not
+     *   provided, it will use {@link protos.|ServingConfig.embedding_config.field_paths}.
+     * @param {string} request.rankingExpression
+     *   The ranking expression controls the customized ranking on retrieval
+     *   documents. This overrides {@link protos.|ServingConfig.ranking_expression}.
+     *   The ranking expression is a single function or multiple functions that are
+     *   joint by "+".
+     *     * ranking_expression = function, { " + ", function };
+     *   Supported functions:
+     *     * double * relevance_score
+     *     * double * dotProduct(embedding_field_path)
+     *   Function variables:
+     *     `relevance_score`: pre-defined keywords, used for measure relevance
+     *     between query and document.
+     *     `embedding_field_path`: the document embedding field
+     *     used with query embedding vector.
+     *     `dotProduct`: embedding function between embedding_field_path and query
+     *     embedding vector.
+     *
+     *    Example ranking expression:
+     *      If document has an embedding field doc_embedding, the ranking expression
+     *      could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.
      * @param {boolean} request.safeSearch
      *   Whether to turn on safe search. This is only supported for
-     *   {@link |ContentConfig.PUBLIC_WEBSITE}.
+     *   website search.
      * @param {number[]} request.userLabels
      *   The user labels applied to a resource must meet the following requirements:
      *
@@ -506,17 +597,67 @@ export declare class SearchServiceClient {
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}
-     *   An iterable Object that allows [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
      *   When you iterate the returned iterable, each element will be an object representing
-     *   {@link google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult | SearchResult}. The API will be called under the hood as needed, once per the page,
+     *   {@link protos.google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult|SearchResult}. The API will be called under the hood as needed, once per the page,
      *   so you can stop the iteration when you don't need more results.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
      *   for more details and examples.
      * @example <caption>include:samples/generated/v1beta/search_service.search.js</caption>
      * region_tag:discoveryengine_v1beta_generated_SearchService_Search_async
      */
     searchAsync(request?: protos.google.cloud.discoveryengine.v1beta.ISearchRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.discoveryengine.v1beta.SearchResponse.ISearchResult>;
+    /**
+     * Gets information about a location.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Resource name for the location.
+     * @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 google.cloud.location.Location | Location}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example
+     * ```
+     * const [response] = await client.getLocation(request);
+     * ```
+     */
+    getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
+    /**
+     * Lists information about the supported locations for this service. Returns an iterable object.
+     *
+     * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   The resource that owns the locations collection, if applicable.
+     * @param {string} request.filter
+     *   The standard list filter.
+     * @param {number} request.pageSize
+     *   The standard list page size.
+     * @param {string} request.pageToken
+     *   The standard list page token.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Object}
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
+     *   so you can stop the iteration when you don't need more results.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     * @example
+     * ```
+     * const iterable = client.listLocationsAsync(request);
+     * for await (const response of iterable) {
+     *   // process response
+     * }
+     * ```
+     */
+    listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreBranch resource name string.
      *
@@ -628,6 +769,57 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the document.
      */
     matchDocumentFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationCollectionDataStoreConversation resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} data_store
+     * @param {string} conversation
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionDataStoreConversationPath(project: string, location: string, collection: string, dataStore: string, conversation: string): string;
+    /**
+     * Parse the project from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the collection from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the conversation from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the conversation.
+     */
+    matchConversationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreSchema resource name string.
      *
@@ -823,6 +1015,48 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the document.
      */
     matchDocumentFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationDataStoreConversation resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} data_store
+     * @param {string} conversation
+     * @returns {string} Resource name string.
+     */
+    projectLocationDataStoreConversationPath(project: string, location: string, dataStore: string, conversation: string): string;
+    /**
+     * Parse the project from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
+    /**
+     * Parse the conversation from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the conversation.
+     */
+    matchConversationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
     /**
      * Return a fully-qualified projectLocationDataStoreSchema resource name string.
      *