@googleapis/discoveryengine 1.2.0 → 3.0.0

package/v1beta.ts

@@ -239,15 +239,6 @@ export namespace discoveryengine_v1beta {
      */
     functionName?: string | null;
   }
-  /**
-   * Response message for SiteSearchEngineService.BatchCreateTargetSites method.
-   */
-  export interface Schema$GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse {
-    /**
-     * TargetSites created.
-     */
-    targetSites?: Schema$GoogleCloudDiscoveryengineV1alphaTargetSite[];
-  }
   /**
    * Metadata for Create Schema LRO.
    */
@@ -464,6 +455,78 @@ export namespace discoveryengine_v1beta {
      */
     purgeCount?: string | null;
   }
+  /**
+   * Metadata related to the progress of the SiteSearchEngineService.RecrawlUris operation. This will be returned by the google.longrunning.Operation.metadata field.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaRecrawlUrisMetadata {
+    /**
+     * Operation create time.
+     */
+    createTime?: string | null;
+    /**
+     * Unique URIs in the request that don't match any TargetSite in the DataStore, only match TargetSites that haven't been fully indexed, or match a TargetSite with type EXCLUDE.
+     */
+    invalidUris?: string[] | null;
+    /**
+     * Total number of URIs that have yet to be crawled.
+     */
+    pendingCount?: number | null;
+    /**
+     * Total number of URIs that were rejected due to insufficient indexing resources.
+     */
+    quotaExceededCount?: number | null;
+    /**
+     * Total number of URIs that have been crawled so far.
+     */
+    successCount?: number | null;
+    /**
+     * Operation last update time. If the operation is done, this is also the finish time.
+     */
+    updateTime?: string | null;
+    /**
+     * Total number of unique URIs in the request that are not in invalid_uris.
+     */
+    validUrisCount?: number | null;
+  }
+  /**
+   * Response message for SiteSearchEngineService.RecrawlUris method.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponse {
+    /**
+     * URIs that were not crawled before the LRO terminated.
+     */
+    failedUris?: string[] | null;
+    /**
+     * Details for a sample of up to 10 `failed_uris`.
+     */
+    failureSamples?: Schema$GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfo[];
+  }
+  /**
+   * Details about why a particular URI failed to be crawled. Each FailureInfo contains one FailureReason per CorpusType.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfo {
+    /**
+     * List of failure reasons by corpus type (e.g. desktop, mobile).
+     */
+    failureReasons?: Schema$GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfoFailureReason[];
+    /**
+     * URI that failed to be crawled.
+     */
+    uri?: string | null;
+  }
+  /**
+   * Details about why crawling failed for a particular CorpusType, e.g. DESKTOP and MOBILE crawling may fail for different reasons.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfoFailureReason {
+    /**
+     * DESKTOP, MOBILE, or CORPUS_TYPE_UNSPECIFIED.
+     */
+    corpusType?: string | null;
+    /**
+     * Reason why the URI was not crawled.
+     */
+    errorMessage?: string | null;
+  }
   /**
    * Defines the structure and layout of a type of document data.
    */
@@ -548,12 +611,7 @@ export namespace discoveryengine_v1beta {
      */
     quotaFailure?: Schema$GoogleCloudDiscoveryengineV1alphaTargetSiteFailureReasonQuotaFailure;
   }
-  export interface Schema$GoogleCloudDiscoveryengineV1alphaTargetSiteFailureReasonQuotaFailure {
-    /**
-     * This number is an estimation on how much total quota this project needs to successfully complete indexing.
-     */
-    totalRequiredQuota?: string | null;
-  }
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaTargetSiteFailureReasonQuotaFailure {}
   /**
    * Metadata for UpdateSchema LRO.
    */
@@ -616,7 +674,7 @@ export namespace discoveryengine_v1beta {
     /**
      * The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.
      */
-    completableFieldPath?: string[] | null;
+    completableFieldPaths?: string[] | null;
     /**
      * The suggestion for the query.
      */
@@ -714,6 +772,10 @@ export namespace discoveryengine_v1beta {
      * The resource name of the Serving Config to use. Format: `projects/{project_number\}/locations/{location_id\}/collections/{collection\}/dataStores/{data_store_id\}/servingConfigs/{serving_config_id\}` If this is not set, the default serving config will be used.
      */
     servingConfig?: string | null;
+    /**
+     * A specification for configuring the summary returned in the response.
+     */
+    summarySpec?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec;
     /**
      * 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.
      */
@@ -1204,7 +1266,7 @@ export namespace discoveryengine_v1beta {
    */
   export interface Schema$GoogleCloudDiscoveryengineV1betaRecommendRequest {
     /**
-     * Filter for restricting recommendation results with a length limit of 5,000 characters. Currently, only filter expressions on the `filter_tags` attribute is supported. Examples: * `(filter_tags: ANY("Red", "Blue") OR filter_tags: ANY("Hot", "Cold"))` * `(filter_tags: ANY("Red", "Blue")) AND NOT (filter_tags: ANY("Green"))` If your filter blocks all results, the API will return generic (unfiltered) popular Documents. If you only want results strictly matching the filters, set `strictFiltering` to True in RecommendRequest.params to receive empty results instead. Note that the API will never return Documents with `storageStatus` of `EXPIRED` or `DELETED` regardless of filter choices.
+     * Filter for restricting recommendation results with a length limit of 5,000 characters. Currently, only filter expressions on the `filter_tags` attribute is supported. Examples: * `(filter_tags: ANY("Red", "Blue") OR filter_tags: ANY("Hot", "Cold"))` * `(filter_tags: ANY("Red", "Blue")) AND NOT (filter_tags: ANY("Green"))` If `attributeFilteringSyntax` is set to true under the `params` field, then attribute-based expressions are expected instead of the above described tag-based syntax. Examples: * (launguage: ANY("en", "es")) AND NOT (categories: ANY("Movie")) * (available: true) AND (launguage: ANY("en", "es")) OR (categories: ANY("Movie")) If your filter blocks all results, the API will return generic (unfiltered) popular Documents. If you only want results strictly matching the filters, set `strictFiltering` to True in RecommendRequest.params to receive empty results instead. Note that the API will never return Documents with `storageStatus` of `EXPIRED` or `DELETED` regardless of filter choices.
      */
     filter?: string | null;
     /**
@@ -1212,7 +1274,7 @@ export namespace discoveryengine_v1beta {
      */
     pageSize?: number | null;
     /**
-     * Additional domain specific parameters for the recommendations. Allowed values: * `returnDocument`: Boolean. If set to true, the associated Document object will be returned in RecommendResponse.RecommendationResult.document. * `returnScore`: Boolean. If set to true, the recommendation 'score' corresponding to each returned Document will be set in RecommendResponse.RecommendationResult.metadata. The given 'score' indicates the probability of a Document conversion given the user's context and history. * `strictFiltering`: Boolean. True by default. If set to false, the service will return generic (unfiltered) popular Documents instead of empty if your filter blocks all recommendation results. * `diversityLevel`: String. Default empty. If set to be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-level control and adjusts recommendation results based on Document category.
+     * Additional domain specific parameters for the recommendations. Allowed values: * `returnDocument`: Boolean. If set to true, the associated Document object will be returned in RecommendResponse.RecommendationResult.document. * `returnScore`: Boolean. If set to true, the recommendation 'score' corresponding to each returned Document will be set in RecommendResponse.RecommendationResult.metadata. The given 'score' indicates the probability of a Document conversion given the user's context and history. * `strictFiltering`: Boolean. True by default. If set to false, the service will return generic (unfiltered) popular Documents instead of empty if your filter blocks all recommendation results. * `diversityLevel`: String. Default empty. If set to be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-level control and adjusts recommendation results based on Document category. * `attributeFilteringSyntax`: Boolean. False by default. If set to true, the `filter` field is interpreted according to the new, attribute-based syntax.
      */
     params?: {[key: string]: any} | null;
     /**
@@ -1343,7 +1405,7 @@ export namespace discoveryengine_v1beta {
    */
   export interface Schema$GoogleCloudDiscoveryengineV1betaSearchRequest {
     /**
-     * Boost specification to boost certain documents.
+     * Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/retail/docs/boosting#boost)
      */
     boostSpec?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec;
     /**
@@ -1363,7 +1425,7 @@ export namespace discoveryengine_v1beta {
      */
     facetSpecs?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestFacetSpec[];
     /**
-     * The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
+     * The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --\> name:'ANY("king kong")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
      */
     filter?: string | null;
     /**
@@ -1375,7 +1437,7 @@ export namespace discoveryengine_v1beta {
      */
     offset?: number | null;
     /**
-     * The order in which documents are returned. Documents can be ordered by a field in an 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.
+     * The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering, see [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order) If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      */
     orderBy?: string | null;
     /**
@@ -1475,9 +1537,13 @@ export namespace discoveryengine_v1beta {
      */
     maxExtractiveSegmentCount?: number | null;
     /**
-     * Specifies whether to return the confidence score from the extractive segments in each search result. The default value is `false`.
+     * Return at most `num_next_segments` segments after each selected segments.
      */
-    returnExtractiveSegmentScore?: boolean | null;
+    numNextSegments?: number | null;
+    /**
+     * Specifies whether to also include the adjacent from each selected segments. Return at most `num_previous_segments` segments before each selected segments.
+     */
+    numPreviousSegments?: number | null;
   }
   /**
    * A specification for configuring snippets in a search response.
@@ -1513,7 +1579,7 @@ export namespace discoveryengine_v1beta {
      */
     includeCitations?: boolean | null;
     /**
-     * Language code for Summary. Use language tags defined by BCP47.
+     * Language code for Summary. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
      */
     languageCode?: string | null;
     /**
@@ -1648,6 +1714,7 @@ export namespace discoveryengine_v1beta {
      * Results of facets requested by user.
      */
     facets?: Schema$GoogleCloudDiscoveryengineV1betaSearchResponseFacet[];
+    geoSearchDebugInfo?: Schema$GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo[];
     /**
      * Guided search result.
      */
@@ -1711,6 +1778,19 @@ export namespace discoveryengine_v1beta {
      */
     value?: string | null;
   }
+  /**
+   * Debug information specifically related to forward geocoding issues arising from Geolocation Search.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo {
+    /**
+     * The error produced.
+     */
+    errorMessage?: string | null;
+    /**
+     * The address from which forward geocoding ingestion produced issues.
+     */
+    originalAddressQuery?: string | null;
+  }
   /**
    * Guided search result. The guided search helps user to refine the search results and narrow down to the real needs from a broaded search results.
    */
@@ -1773,6 +1853,10 @@ export namespace discoveryengine_v1beta {
    * Summary of the top N search result specified by the summary spec.
    */
   export interface Schema$GoogleCloudDiscoveryengineV1betaSearchResponseSummary {
+    /**
+     * A collection of Safety Attribute categories and their associated confidence scores.
+     */
+    safetyAttributes?: Schema$GoogleCloudDiscoveryengineV1betaSearchResponseSummarySafetyAttributes;
     /**
      * Additional summary-skipped reasons. This provides the reason for ignored cases. If nothing is skipped, this field is not set.
      */
@@ -1782,6 +1866,19 @@ export namespace discoveryengine_v1beta {
      */
     summaryText?: string | null;
   }
+  /**
+   * Safety Attribute categories and their associated confidence scores.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1betaSearchResponseSummarySafetyAttributes {
+    /**
+     * The display names of Safety Attribute categories associated with the generated content. Order matches the Scores.
+     */
+    categories?: string[] | null;
+    /**
+     * The confidence scores of the each category, higher value means higher confidence. Order matches the Categories.
+     */
+    scores?: number[] | null;
+  }
   /**
    * Defines text input.
    */
@@ -2390,7 +2487,7 @@ export namespace discoveryengine_v1beta {
      */
     query?: string;
     /**
-     * Selects data model of query suggestions for serving. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for IndustryVertical.SITE_SEARCH dataStores.
+     * Selects data model of query suggestions for serving. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.
      */
     queryModel?: string;
     /**
@@ -6342,12 +6439,17 @@ export namespace discoveryengine_v1beta {
   export class Resource$Projects$Locations$Collections$Engines {
     context: APIRequestContext;
     operations: Resource$Projects$Locations$Collections$Engines$Operations;
+    servingConfigs: Resource$Projects$Locations$Collections$Engines$Servingconfigs;
     constructor(context: APIRequestContext) {
       this.context = context;
       this.operations =
         new Resource$Projects$Locations$Collections$Engines$Operations(
           this.context
         );
+      this.servingConfigs =
+        new Resource$Projects$Locations$Collections$Engines$Servingconfigs(
+          this.context
+        );
     }
   }
 
@@ -6576,6 +6678,234 @@ export namespace discoveryengine_v1beta {
     pageToken?: string;
   }
 
+  export class Resource$Projects$Locations$Collections$Engines$Servingconfigs {
+    context: APIRequestContext;
+    constructor(context: APIRequestContext) {
+      this.context = context;
+    }
+
+    /**
+     * Makes a recommendation, which requires a contextual user event.
+     *
+     * @param params - Parameters for request
+     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+     * @param callback - Optional callback that handles the response.
+     * @returns A promise if used with async/await, or void if used with a callback.
+     */
+    recommend(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend,
+      options: StreamMethodOptions
+    ): GaxiosPromise<Readable>;
+    recommend(
+      params?: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend,
+      options?: MethodOptions
+    ): GaxiosPromise<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>;
+    recommend(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    recommend(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend,
+      options:
+        | MethodOptions
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>,
+      callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+    ): void;
+    recommend(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend,
+      callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+    ): void;
+    recommend(
+      callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+    ): void;
+    recommend(
+      paramsOrCallback?:
+        | Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+        | BodyResponseCallback<Readable>
+    ):
+      | void
+      | GaxiosPromise<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>
+      | GaxiosPromise<Readable> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params =
+          {} as Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend;
+        options = {};
+      }
+
+      if (typeof optionsOrCallback === 'function') {
+        callback = optionsOrCallback;
+        options = {};
+      }
+
+      const rootUrl =
+        options.rootUrl || 'https://discoveryengine.googleapis.com/';
+      const parameters = {
+        options: Object.assign(
+          {
+            url: (rootUrl + '/v1beta/{+servingConfig}:recommend').replace(
+              /([^:]\/)\/+/g,
+              '$1'
+            ),
+            method: 'POST',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['servingConfig'],
+        pathParams: ['servingConfig'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$GoogleCloudDiscoveryengineV1betaRecommendResponse>(
+          parameters
+        );
+      }
+    }
+
+    /**
+     * Performs a search.
+     *
+     * @param params - Parameters for request
+     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+     * @param callback - Optional callback that handles the response.
+     * @returns A promise if used with async/await, or void if used with a callback.
+     */
+    search(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search,
+      options: StreamMethodOptions
+    ): GaxiosPromise<Readable>;
+    search(
+      params?: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search,
+      options?: MethodOptions
+    ): GaxiosPromise<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>;
+    search(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    search(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search,
+      options:
+        | MethodOptions
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>,
+      callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+    ): void;
+    search(
+      params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search,
+      callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+    ): void;
+    search(
+      callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+    ): void;
+    search(
+      paramsOrCallback?:
+        | Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+        | BodyResponseCallback<Readable>
+    ):
+      | void
+      | GaxiosPromise<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>
+      | GaxiosPromise<Readable> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params =
+          {} as Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search;
+        options = {};
+      }
+
+      if (typeof optionsOrCallback === 'function') {
+        callback = optionsOrCallback;
+        options = {};
+      }
+
+      const rootUrl =
+        options.rootUrl || 'https://discoveryengine.googleapis.com/';
+      const parameters = {
+        options: Object.assign(
+          {
+            url: (rootUrl + '/v1beta/{+servingConfig}:search').replace(
+              /([^:]\/)\/+/g,
+              '$1'
+            ),
+            method: 'POST',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['servingConfig'],
+        pathParams: ['servingConfig'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$GoogleCloudDiscoveryengineV1betaSearchResponse>(
+          parameters
+        );
+      }
+    }
+  }
+
+  export interface Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Recommend
+    extends StandardParameters {
+    /**
+     * Required. Full resource name of the format: `projects/x/locations/global/collections/x/dataStores/x/servingConfigs/x` Before you can request recommendations from your model, you must create at least one serving config for it.
+     */
+    servingConfig?: string;
+
+    /**
+     * Request body metadata
+     */
+    requestBody?: Schema$GoogleCloudDiscoveryengineV1betaRecommendRequest;
+  }
+  export interface Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Search
+    extends StandardParameters {
+    /**
+     * Required. The resource name of the Search serving config, such as `projects/x/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.
+     */
+    servingConfig?: string;
+
+    /**
+     * Request body metadata
+     */
+    requestBody?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequest;
+  }
+
   export class Resource$Projects$Locations$Collections$Operations {
     context: APIRequestContext;
     constructor(context: APIRequestContext) {
@@ -6947,7 +7277,7 @@ export namespace discoveryengine_v1beta {
      */
     query?: string;
     /**
-     * Selects data model of query suggestions for serving. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for IndustryVertical.SITE_SEARCH dataStores.
+     * Selects data model of query suggestions for serving. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.
      */
     queryModel?: string;
     /**