@googleapis/discoveryengine 28.1.0 → 28.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/v1beta.d.ts CHANGED
@@ -4093,12 +4093,16 @@ export declare namespace discoveryengine_v1beta {
4093
4093
  * 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.
4094
4094
  */
4095
4095
  regionCode?: string | null;
4096
+ /**
4097
+ * Optional. The granular relevance filtering specification. If not specified, the global `relevance_threshold` will be used for all sub-searches. If specified, this overrides the global `relevance_threshold` to use thresholds on a per sub-search basis. This feature is currently supported only for custom and site search.
4098
+ */
4099
+ relevanceFilterSpec?: Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceFilterSpec;
4096
4100
  /**
4097
4101
  * Optional. The specification for returning the relevance score.
4098
4102
  */
4099
4103
  relevanceScoreSpec?: Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceScoreSpec;
4100
4104
  /**
4101
- * The relevance threshold of the search results. Default to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information. This feature is not supported for healthcare search.
4105
+ * The global relevance threshold of the search results. Defaults to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information. If more granular relevance filtering is required, use the `relevance_filter_spec` instead. This feature is not supported for healthcare search.
4102
4106
  */
4103
4107
  relevanceThreshold?: string | null;
4104
4108
  /**
@@ -4539,6 +4543,32 @@ export declare namespace discoveryengine_v1beta {
4539
4543
  */
4540
4544
  pinUnexpandedResults?: boolean | null;
4541
4545
  }
4546
+ /**
4547
+ * Relevance filtering specification.
4548
+ */
4549
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceFilterSpec {
4550
+ /**
4551
+ * Optional. Relevance filtering threshold specification for keyword search.
4552
+ */
4553
+ keywordSearchThreshold?: Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceFilterSpecRelevanceThresholdSpec;
4554
+ /**
4555
+ * Optional. Relevance filtering threshold specification for semantic search.
4556
+ */
4557
+ semanticSearchThreshold?: Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceFilterSpecRelevanceThresholdSpec;
4558
+ }
4559
+ /**
4560
+ * Specification for relevance filtering on a specific sub-search.
4561
+ */
4562
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceFilterSpecRelevanceThresholdSpec {
4563
+ /**
4564
+ * Pre-defined relevance threshold for the sub-search.
4565
+ */
4566
+ relevanceThreshold?: string | null;
4567
+ /**
4568
+ * Custom relevance threshold for the sub-search. The value must be in [0.0, 1.0].
4569
+ */
4570
+ semanticRelevanceThreshold?: number | null;
4571
+ }
4542
4572
  /**
4543
4573
  * The specification for returning the document relevance score.
4544
4574
  */
@@ -5076,6 +5106,10 @@ export declare namespace discoveryengine_v1beta {
5076
5106
  * Optional. Customer policy for the assistant.
5077
5107
  */
5078
5108
  customerPolicy?: Schema$GoogleCloudDiscoveryengineV1AssistantCustomerPolicy;
5109
+ /**
5110
+ * Optional. This field controls the default web grounding toggle for end users if `web_grounding_type` is set to `WEB_GROUNDING_TYPE_GOOGLE_SEARCH` or `WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH`. By default, this field is set to false. If `web_grounding_type` is `WEB_GROUNDING_TYPE_GOOGLE_SEARCH` or `WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH`, end users will have web grounding enabled by default on UI. If true, grounding toggle will be disabled by default on UI. End users can still enable web grounding in the UI if web grounding is enabled.
5111
+ */
5112
+ defaultWebGroundingToggleOff?: boolean | null;
5079
5113
  /**
5080
5114
  * Optional. Description for additional information. Expected to be shown on the configuration UI, not to the users of the assistant.
5081
5115
  */
@@ -6527,6 +6561,10 @@ export declare namespace discoveryengine_v1beta {
6527
6561
  * Optional. Customer policy for the assistant.
6528
6562
  */
6529
6563
  customerPolicy?: Schema$GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicy;
6564
+ /**
6565
+ * Optional. This field controls the default web grounding toggle for end users if `web_grounding_type` is set to `WEB_GROUNDING_TYPE_GOOGLE_SEARCH` or `WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH`. By default, this field is set to false. If `web_grounding_type` is `WEB_GROUNDING_TYPE_GOOGLE_SEARCH` or `WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH`, end users will have web grounding enabled by default on UI. If true, grounding toggle will be disabled by default on UI. End users can still enable web grounding in the UI if web grounding is enabled.
6566
+ */
6567
+ defaultWebGroundingToggleOff?: boolean | null;
6530
6568
  /**
6531
6569
  * Optional. Description for additional information. Expected to be shown on the configuration UI, not to the users of the assistant.
6532
6570
  */
@@ -10801,12 +10839,16 @@ export declare namespace discoveryengine_v1beta {
10801
10839
  * 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.
10802
10840
  */
10803
10841
  regionCode?: string | null;
10842
+ /**
10843
+ * Optional. The granular relevance filtering specification. If not specified, the global `relevance_threshold` will be used for all sub-searches. If specified, this overrides the global `relevance_threshold` to use thresholds on a per sub-search basis. This feature is currently supported only for custom and site search.
10844
+ */
10845
+ relevanceFilterSpec?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceFilterSpec;
10804
10846
  /**
10805
10847
  * Optional. The specification for returning the relevance score.
10806
10848
  */
10807
10849
  relevanceScoreSpec?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceScoreSpec;
10808
10850
  /**
10809
- * The relevance threshold of the search results. Default to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information. This feature is not supported for healthcare search.
10851
+ * The global relevance threshold of the search results. Defaults to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information. If more granular relevance filtering is required, use the `relevance_filter_spec` instead. This feature is not supported for healthcare search.
10810
10852
  */
10811
10853
  relevanceThreshold?: string | null;
10812
10854
  /**
@@ -11243,6 +11285,32 @@ export declare namespace discoveryengine_v1beta {
11243
11285
  */
11244
11286
  pinUnexpandedResults?: boolean | null;
11245
11287
  }
11288
+ /**
11289
+ * Relevance filtering specification.
11290
+ */
11291
+ export interface Schema$GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceFilterSpec {
11292
+ /**
11293
+ * Optional. Relevance filtering threshold specification for keyword search.
11294
+ */
11295
+ keywordSearchThreshold?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceFilterSpecRelevanceThresholdSpec;
11296
+ /**
11297
+ * Optional. Relevance filtering threshold specification for semantic search.
11298
+ */
11299
+ semanticSearchThreshold?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceFilterSpecRelevanceThresholdSpec;
11300
+ }
11301
+ /**
11302
+ * Specification for relevance filtering on a specific sub-search.
11303
+ */
11304
+ export interface Schema$GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceFilterSpecRelevanceThresholdSpec {
11305
+ /**
11306
+ * Pre-defined relevance threshold for the sub-search.
11307
+ */
11308
+ relevanceThreshold?: string | null;
11309
+ /**
11310
+ * Custom relevance threshold for the sub-search. The value must be in [0.0, 1.0].
11311
+ */
11312
+ semanticRelevanceThreshold?: number | null;
11313
+ }
11246
11314
  /**
11247
11315
  * The specification for returning the document relevance score.
11248
11316
  */
@@ -20733,6 +20801,125 @@ export declare namespace discoveryengine_v1beta {
20733
20801
  answer(params: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Answer, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
20734
20802
  answer(params: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Answer, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
20735
20803
  answer(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
20804
+ /**
20805
+ * Creates a ServingConfig. Note: The Google Cloud console works only with the default serving config. Additional ServingConfigs can be created and managed only via the API. A maximum of 100 ServingConfigs are allowed in an Engine, otherwise a RESOURCE_EXHAUSTED error is returned.
20806
+ * @example
20807
+ * ```js
20808
+ * // Before running the sample:
20809
+ * // - Enable the API at:
20810
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
20811
+ * // - Login into gcloud by running:
20812
+ * // ```sh
20813
+ * // $ gcloud auth application-default login
20814
+ * // ```
20815
+ * // - Install the npm module by running:
20816
+ * // ```sh
20817
+ * // $ npm install googleapis
20818
+ * // ```
20819
+ *
20820
+ * const {google} = require('googleapis');
20821
+ * const discoveryengine = google.discoveryengine('v1beta');
20822
+ *
20823
+ * async function main() {
20824
+ * const auth = new google.auth.GoogleAuth({
20825
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
20826
+ * scopes: [
20827
+ * 'https://www.googleapis.com/auth/cloud-platform',
20828
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
20829
+ * ],
20830
+ * });
20831
+ *
20832
+ * // Acquire an auth client, and bind it to all future calls
20833
+ * const authClient = await auth.getClient();
20834
+ * google.options({auth: authClient});
20835
+ *
20836
+ * // Do the magic
20837
+ * const res =
20838
+ * await discoveryengine.projects.locations.collections.dataStores.servingConfigs.create(
20839
+ * {
20840
+ * // Required. Full resource name of parent. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}`
20841
+ * parent:
20842
+ * 'projects/my-project/locations/my-location/collections/my-collection/dataStores/my-dataStore',
20843
+ * // Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name. This value should be 4-63 characters, and valid characters are /a-zA-Z0-9+/.
20844
+ * servingConfigId: 'placeholder-value',
20845
+ *
20846
+ * // Request body metadata
20847
+ * requestBody: {
20848
+ * // request body parameters
20849
+ * // {
20850
+ * // "answerGenerationSpec": {},
20851
+ * // "boostControlIds": [],
20852
+ * // "createTime": "my_createTime",
20853
+ * // "displayName": "my_displayName",
20854
+ * // "dissociateControlIds": [],
20855
+ * // "diversityLevel": "my_diversityLevel",
20856
+ * // "embeddingConfig": {},
20857
+ * // "filterControlIds": [],
20858
+ * // "genericConfig": {},
20859
+ * // "ignoreControlIds": [],
20860
+ * // "mediaConfig": {},
20861
+ * // "modelId": "my_modelId",
20862
+ * // "name": "my_name",
20863
+ * // "onewaySynonymsControlIds": [],
20864
+ * // "personalizationSpec": {},
20865
+ * // "promoteControlIds": [],
20866
+ * // "rankingExpression": "my_rankingExpression",
20867
+ * // "redirectControlIds": [],
20868
+ * // "replacementControlIds": [],
20869
+ * // "solutionType": "my_solutionType",
20870
+ * // "synonymsControlIds": [],
20871
+ * // "updateTime": "my_updateTime"
20872
+ * // }
20873
+ * },
20874
+ * },
20875
+ * );
20876
+ * console.log(res.data);
20877
+ *
20878
+ * // Example response
20879
+ * // {
20880
+ * // "answerGenerationSpec": {},
20881
+ * // "boostControlIds": [],
20882
+ * // "createTime": "my_createTime",
20883
+ * // "displayName": "my_displayName",
20884
+ * // "dissociateControlIds": [],
20885
+ * // "diversityLevel": "my_diversityLevel",
20886
+ * // "embeddingConfig": {},
20887
+ * // "filterControlIds": [],
20888
+ * // "genericConfig": {},
20889
+ * // "ignoreControlIds": [],
20890
+ * // "mediaConfig": {},
20891
+ * // "modelId": "my_modelId",
20892
+ * // "name": "my_name",
20893
+ * // "onewaySynonymsControlIds": [],
20894
+ * // "personalizationSpec": {},
20895
+ * // "promoteControlIds": [],
20896
+ * // "rankingExpression": "my_rankingExpression",
20897
+ * // "redirectControlIds": [],
20898
+ * // "replacementControlIds": [],
20899
+ * // "solutionType": "my_solutionType",
20900
+ * // "synonymsControlIds": [],
20901
+ * // "updateTime": "my_updateTime"
20902
+ * // }
20903
+ * }
20904
+ *
20905
+ * main().catch(e => {
20906
+ * console.error(e);
20907
+ * throw e;
20908
+ * });
20909
+ *
20910
+ * ```
20911
+ *
20912
+ * @param params - Parameters for request
20913
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
20914
+ * @param callback - Optional callback that handles the response.
20915
+ * @returns A promise if used with async/await, or void if used with a callback.
20916
+ */
20917
+ create(params: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
20918
+ create(params?: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>>;
20919
+ create(params: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
20920
+ create(params: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Create, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
20921
+ create(params: Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Create, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
20922
+ create(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
20736
20923
  /**
20737
20924
  * Deletes a ServingConfig. Returns a NOT_FOUND error if the ServingConfig does not exist.
20738
20925
  * @example
@@ -21228,6 +21415,7 @@ export declare namespace discoveryengine_v1beta {
21228
21415
  * // "rankingExpression": "my_rankingExpression",
21229
21416
  * // "rankingExpressionBackend": "my_rankingExpressionBackend",
21230
21417
  * // "regionCode": "my_regionCode",
21418
+ * // "relevanceFilterSpec": {},
21231
21419
  * // "relevanceScoreSpec": {},
21232
21420
  * // "relevanceThreshold": "my_relevanceThreshold",
21233
21421
  * // "safeSearch": false,
@@ -21358,6 +21546,7 @@ export declare namespace discoveryengine_v1beta {
21358
21546
  * // "rankingExpression": "my_rankingExpression",
21359
21547
  * // "rankingExpressionBackend": "my_rankingExpressionBackend",
21360
21548
  * // "regionCode": "my_regionCode",
21549
+ * // "relevanceFilterSpec": {},
21361
21550
  * // "relevanceScoreSpec": {},
21362
21551
  * // "relevanceThreshold": "my_relevanceThreshold",
21363
21552
  * // "safeSearch": false,
@@ -21516,6 +21705,20 @@ export declare namespace discoveryengine_v1beta {
21516
21705
  */
21517
21706
  requestBody?: Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryRequest;
21518
21707
  }
21708
+ export interface Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Create extends StandardParameters {
21709
+ /**
21710
+ * Required. Full resource name of parent. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}`
21711
+ */
21712
+ parent?: string;
21713
+ /**
21714
+ * Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name. This value should be 4-63 characters, and valid characters are /a-zA-Z0-9+/.
21715
+ */
21716
+ servingConfigId?: string;
21717
+ /**
21718
+ * Request body metadata
21719
+ */
21720
+ requestBody?: Schema$GoogleCloudDiscoveryengineV1betaServingConfig;
21721
+ }
21519
21722
  export interface Params$Resource$Projects$Locations$Collections$Datastores$Servingconfigs$Delete extends StandardParameters {
21520
21723
  /**
21521
21724
  * Required. The resource name of the ServingConfig to delete. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/servingConfigs/{serving_config_id\}`
@@ -25165,6 +25368,7 @@ export declare namespace discoveryengine_v1beta {
25165
25368
  * // request body parameters
25166
25369
  * // {
25167
25370
  * // "customerPolicy": {},
25371
+ * // "defaultWebGroundingToggleOff": false,
25168
25372
  * // "description": "my_description",
25169
25373
  * // "displayName": "my_displayName",
25170
25374
  * // "enabledTools": {},
@@ -25180,6 +25384,7 @@ export declare namespace discoveryengine_v1beta {
25180
25384
  * // Example response
25181
25385
  * // {
25182
25386
  * // "customerPolicy": {},
25387
+ * // "defaultWebGroundingToggleOff": false,
25183
25388
  * // "description": "my_description",
25184
25389
  * // "displayName": "my_displayName",
25185
25390
  * // "enabledTools": {},
@@ -25318,6 +25523,7 @@ export declare namespace discoveryengine_v1beta {
25318
25523
  * // Example response
25319
25524
  * // {
25320
25525
  * // "customerPolicy": {},
25526
+ * // "defaultWebGroundingToggleOff": false,
25321
25527
  * // "description": "my_description",
25322
25528
  * // "displayName": "my_displayName",
25323
25529
  * // "enabledTools": {},
@@ -25465,6 +25671,7 @@ export declare namespace discoveryengine_v1beta {
25465
25671
  * // request body parameters
25466
25672
  * // {
25467
25673
  * // "customerPolicy": {},
25674
+ * // "defaultWebGroundingToggleOff": false,
25468
25675
  * // "description": "my_description",
25469
25676
  * // "displayName": "my_displayName",
25470
25677
  * // "enabledTools": {},
@@ -25480,6 +25687,7 @@ export declare namespace discoveryengine_v1beta {
25480
25687
  * // Example response
25481
25688
  * // {
25482
25689
  * // "customerPolicy": {},
25690
+ * // "defaultWebGroundingToggleOff": false,
25483
25691
  * // "description": "my_description",
25484
25692
  * // "displayName": "my_displayName",
25485
25693
  * // "enabledTools": {},
@@ -27202,6 +27410,125 @@ export declare namespace discoveryengine_v1beta {
27202
27410
  answer(params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Answer, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
27203
27411
  answer(params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Answer, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
27204
27412
  answer(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
27413
+ /**
27414
+ * Creates a ServingConfig. Note: The Google Cloud console works only with the default serving config. Additional ServingConfigs can be created and managed only via the API. A maximum of 100 ServingConfigs are allowed in an Engine, otherwise a RESOURCE_EXHAUSTED error is returned.
27415
+ * @example
27416
+ * ```js
27417
+ * // Before running the sample:
27418
+ * // - Enable the API at:
27419
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
27420
+ * // - Login into gcloud by running:
27421
+ * // ```sh
27422
+ * // $ gcloud auth application-default login
27423
+ * // ```
27424
+ * // - Install the npm module by running:
27425
+ * // ```sh
27426
+ * // $ npm install googleapis
27427
+ * // ```
27428
+ *
27429
+ * const {google} = require('googleapis');
27430
+ * const discoveryengine = google.discoveryengine('v1beta');
27431
+ *
27432
+ * async function main() {
27433
+ * const auth = new google.auth.GoogleAuth({
27434
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
27435
+ * scopes: [
27436
+ * 'https://www.googleapis.com/auth/cloud-platform',
27437
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
27438
+ * ],
27439
+ * });
27440
+ *
27441
+ * // Acquire an auth client, and bind it to all future calls
27442
+ * const authClient = await auth.getClient();
27443
+ * google.options({auth: authClient});
27444
+ *
27445
+ * // Do the magic
27446
+ * const res =
27447
+ * await discoveryengine.projects.locations.collections.engines.servingConfigs.create(
27448
+ * {
27449
+ * // Required. Full resource name of parent. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}`
27450
+ * parent:
27451
+ * 'projects/my-project/locations/my-location/collections/my-collection/engines/my-engine',
27452
+ * // Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name. This value should be 4-63 characters, and valid characters are /a-zA-Z0-9+/.
27453
+ * servingConfigId: 'placeholder-value',
27454
+ *
27455
+ * // Request body metadata
27456
+ * requestBody: {
27457
+ * // request body parameters
27458
+ * // {
27459
+ * // "answerGenerationSpec": {},
27460
+ * // "boostControlIds": [],
27461
+ * // "createTime": "my_createTime",
27462
+ * // "displayName": "my_displayName",
27463
+ * // "dissociateControlIds": [],
27464
+ * // "diversityLevel": "my_diversityLevel",
27465
+ * // "embeddingConfig": {},
27466
+ * // "filterControlIds": [],
27467
+ * // "genericConfig": {},
27468
+ * // "ignoreControlIds": [],
27469
+ * // "mediaConfig": {},
27470
+ * // "modelId": "my_modelId",
27471
+ * // "name": "my_name",
27472
+ * // "onewaySynonymsControlIds": [],
27473
+ * // "personalizationSpec": {},
27474
+ * // "promoteControlIds": [],
27475
+ * // "rankingExpression": "my_rankingExpression",
27476
+ * // "redirectControlIds": [],
27477
+ * // "replacementControlIds": [],
27478
+ * // "solutionType": "my_solutionType",
27479
+ * // "synonymsControlIds": [],
27480
+ * // "updateTime": "my_updateTime"
27481
+ * // }
27482
+ * },
27483
+ * },
27484
+ * );
27485
+ * console.log(res.data);
27486
+ *
27487
+ * // Example response
27488
+ * // {
27489
+ * // "answerGenerationSpec": {},
27490
+ * // "boostControlIds": [],
27491
+ * // "createTime": "my_createTime",
27492
+ * // "displayName": "my_displayName",
27493
+ * // "dissociateControlIds": [],
27494
+ * // "diversityLevel": "my_diversityLevel",
27495
+ * // "embeddingConfig": {},
27496
+ * // "filterControlIds": [],
27497
+ * // "genericConfig": {},
27498
+ * // "ignoreControlIds": [],
27499
+ * // "mediaConfig": {},
27500
+ * // "modelId": "my_modelId",
27501
+ * // "name": "my_name",
27502
+ * // "onewaySynonymsControlIds": [],
27503
+ * // "personalizationSpec": {},
27504
+ * // "promoteControlIds": [],
27505
+ * // "rankingExpression": "my_rankingExpression",
27506
+ * // "redirectControlIds": [],
27507
+ * // "replacementControlIds": [],
27508
+ * // "solutionType": "my_solutionType",
27509
+ * // "synonymsControlIds": [],
27510
+ * // "updateTime": "my_updateTime"
27511
+ * // }
27512
+ * }
27513
+ *
27514
+ * main().catch(e => {
27515
+ * console.error(e);
27516
+ * throw e;
27517
+ * });
27518
+ *
27519
+ * ```
27520
+ *
27521
+ * @param params - Parameters for request
27522
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
27523
+ * @param callback - Optional callback that handles the response.
27524
+ * @returns A promise if used with async/await, or void if used with a callback.
27525
+ */
27526
+ create(params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
27527
+ create(params?: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>>;
27528
+ create(params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
27529
+ create(params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Create, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
27530
+ create(params: Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Create, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
27531
+ create(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
27205
27532
  /**
27206
27533
  * Deletes a ServingConfig. Returns a NOT_FOUND error if the ServingConfig does not exist.
27207
27534
  * @example
@@ -27697,6 +28024,7 @@ export declare namespace discoveryengine_v1beta {
27697
28024
  * // "rankingExpression": "my_rankingExpression",
27698
28025
  * // "rankingExpressionBackend": "my_rankingExpressionBackend",
27699
28026
  * // "regionCode": "my_regionCode",
28027
+ * // "relevanceFilterSpec": {},
27700
28028
  * // "relevanceScoreSpec": {},
27701
28029
  * // "relevanceThreshold": "my_relevanceThreshold",
27702
28030
  * // "safeSearch": false,
@@ -27827,6 +28155,7 @@ export declare namespace discoveryengine_v1beta {
27827
28155
  * // "rankingExpression": "my_rankingExpression",
27828
28156
  * // "rankingExpressionBackend": "my_rankingExpressionBackend",
27829
28157
  * // "regionCode": "my_regionCode",
28158
+ * // "relevanceFilterSpec": {},
27830
28159
  * // "relevanceScoreSpec": {},
27831
28160
  * // "relevanceThreshold": "my_relevanceThreshold",
27832
28161
  * // "safeSearch": false,
@@ -27985,6 +28314,20 @@ export declare namespace discoveryengine_v1beta {
27985
28314
  */
27986
28315
  requestBody?: Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryRequest;
27987
28316
  }
28317
+ export interface Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Create extends StandardParameters {
28318
+ /**
28319
+ * Required. Full resource name of parent. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}`
28320
+ */
28321
+ parent?: string;
28322
+ /**
28323
+ * Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name. This value should be 4-63 characters, and valid characters are /a-zA-Z0-9+/.
28324
+ */
28325
+ servingConfigId?: string;
28326
+ /**
28327
+ * Request body metadata
28328
+ */
28329
+ requestBody?: Schema$GoogleCloudDiscoveryengineV1betaServingConfig;
28330
+ }
27988
28331
  export interface Params$Resource$Projects$Locations$Collections$Engines$Servingconfigs$Delete extends StandardParameters {
27989
28332
  /**
27990
28333
  * Required. The resource name of the ServingConfig to delete. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/servingConfigs/{serving_config_id\}`
@@ -32649,6 +32992,123 @@ export declare namespace discoveryengine_v1beta {
32649
32992
  answer(params: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Answer, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
32650
32993
  answer(params: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Answer, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
32651
32994
  answer(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>): void;
32995
+ /**
32996
+ * Creates a ServingConfig. Note: The Google Cloud console works only with the default serving config. Additional ServingConfigs can be created and managed only via the API. A maximum of 100 ServingConfigs are allowed in an Engine, otherwise a RESOURCE_EXHAUSTED error is returned.
32997
+ * @example
32998
+ * ```js
32999
+ * // Before running the sample:
33000
+ * // - Enable the API at:
33001
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
33002
+ * // - Login into gcloud by running:
33003
+ * // ```sh
33004
+ * // $ gcloud auth application-default login
33005
+ * // ```
33006
+ * // - Install the npm module by running:
33007
+ * // ```sh
33008
+ * // $ npm install googleapis
33009
+ * // ```
33010
+ *
33011
+ * const {google} = require('googleapis');
33012
+ * const discoveryengine = google.discoveryengine('v1beta');
33013
+ *
33014
+ * async function main() {
33015
+ * const auth = new google.auth.GoogleAuth({
33016
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
33017
+ * scopes: [
33018
+ * 'https://www.googleapis.com/auth/cloud-platform',
33019
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
33020
+ * ],
33021
+ * });
33022
+ *
33023
+ * // Acquire an auth client, and bind it to all future calls
33024
+ * const authClient = await auth.getClient();
33025
+ * google.options({auth: authClient});
33026
+ *
33027
+ * // Do the magic
33028
+ * const res =
33029
+ * await discoveryengine.projects.locations.dataStores.servingConfigs.create({
33030
+ * // Required. Full resource name of parent. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}`
33031
+ * parent:
33032
+ * 'projects/my-project/locations/my-location/dataStores/my-dataStore',
33033
+ * // Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name. This value should be 4-63 characters, and valid characters are /a-zA-Z0-9+/.
33034
+ * servingConfigId: 'placeholder-value',
33035
+ *
33036
+ * // Request body metadata
33037
+ * requestBody: {
33038
+ * // request body parameters
33039
+ * // {
33040
+ * // "answerGenerationSpec": {},
33041
+ * // "boostControlIds": [],
33042
+ * // "createTime": "my_createTime",
33043
+ * // "displayName": "my_displayName",
33044
+ * // "dissociateControlIds": [],
33045
+ * // "diversityLevel": "my_diversityLevel",
33046
+ * // "embeddingConfig": {},
33047
+ * // "filterControlIds": [],
33048
+ * // "genericConfig": {},
33049
+ * // "ignoreControlIds": [],
33050
+ * // "mediaConfig": {},
33051
+ * // "modelId": "my_modelId",
33052
+ * // "name": "my_name",
33053
+ * // "onewaySynonymsControlIds": [],
33054
+ * // "personalizationSpec": {},
33055
+ * // "promoteControlIds": [],
33056
+ * // "rankingExpression": "my_rankingExpression",
33057
+ * // "redirectControlIds": [],
33058
+ * // "replacementControlIds": [],
33059
+ * // "solutionType": "my_solutionType",
33060
+ * // "synonymsControlIds": [],
33061
+ * // "updateTime": "my_updateTime"
33062
+ * // }
33063
+ * },
33064
+ * });
33065
+ * console.log(res.data);
33066
+ *
33067
+ * // Example response
33068
+ * // {
33069
+ * // "answerGenerationSpec": {},
33070
+ * // "boostControlIds": [],
33071
+ * // "createTime": "my_createTime",
33072
+ * // "displayName": "my_displayName",
33073
+ * // "dissociateControlIds": [],
33074
+ * // "diversityLevel": "my_diversityLevel",
33075
+ * // "embeddingConfig": {},
33076
+ * // "filterControlIds": [],
33077
+ * // "genericConfig": {},
33078
+ * // "ignoreControlIds": [],
33079
+ * // "mediaConfig": {},
33080
+ * // "modelId": "my_modelId",
33081
+ * // "name": "my_name",
33082
+ * // "onewaySynonymsControlIds": [],
33083
+ * // "personalizationSpec": {},
33084
+ * // "promoteControlIds": [],
33085
+ * // "rankingExpression": "my_rankingExpression",
33086
+ * // "redirectControlIds": [],
33087
+ * // "replacementControlIds": [],
33088
+ * // "solutionType": "my_solutionType",
33089
+ * // "synonymsControlIds": [],
33090
+ * // "updateTime": "my_updateTime"
33091
+ * // }
33092
+ * }
33093
+ *
33094
+ * main().catch(e => {
33095
+ * console.error(e);
33096
+ * throw e;
33097
+ * });
33098
+ *
33099
+ * ```
33100
+ *
33101
+ * @param params - Parameters for request
33102
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
33103
+ * @param callback - Optional callback that handles the response.
33104
+ * @returns A promise if used with async/await, or void if used with a callback.
33105
+ */
33106
+ create(params: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
33107
+ create(params?: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>>;
33108
+ create(params: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
33109
+ create(params: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Create, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
33110
+ create(params: Params$Resource$Projects$Locations$Datastores$Servingconfigs$Create, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
33111
+ create(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaServingConfig>): void;
32652
33112
  /**
32653
33113
  * Deletes a ServingConfig. Returns a NOT_FOUND error if the ServingConfig does not exist.
32654
33114
  * @example
@@ -33135,6 +33595,7 @@ export declare namespace discoveryengine_v1beta {
33135
33595
  * // "rankingExpression": "my_rankingExpression",
33136
33596
  * // "rankingExpressionBackend": "my_rankingExpressionBackend",
33137
33597
  * // "regionCode": "my_regionCode",
33598
+ * // "relevanceFilterSpec": {},
33138
33599
  * // "relevanceScoreSpec": {},
33139
33600
  * // "relevanceThreshold": "my_relevanceThreshold",
33140
33601
  * // "safeSearch": false,
@@ -33264,6 +33725,7 @@ export declare namespace discoveryengine_v1beta {
33264
33725
  * // "rankingExpression": "my_rankingExpression",
33265
33726
  * // "rankingExpressionBackend": "my_rankingExpressionBackend",
33266
33727
  * // "regionCode": "my_regionCode",
33728
+ * // "relevanceFilterSpec": {},
33267
33729
  * // "relevanceScoreSpec": {},
33268
33730
  * // "relevanceThreshold": "my_relevanceThreshold",
33269
33731
  * // "safeSearch": false,
@@ -33422,6 +33884,20 @@ export declare namespace discoveryengine_v1beta {
33422
33884
  */
33423
33885
  requestBody?: Schema$GoogleCloudDiscoveryengineV1betaAnswerQueryRequest;
33424
33886
  }
33887
+ export interface Params$Resource$Projects$Locations$Datastores$Servingconfigs$Create extends StandardParameters {
33888
+ /**
33889
+ * Required. Full resource name of parent. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}`
33890
+ */
33891
+ parent?: string;
33892
+ /**
33893
+ * Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name. This value should be 4-63 characters, and valid characters are /a-zA-Z0-9+/.
33894
+ */
33895
+ servingConfigId?: string;
33896
+ /**
33897
+ * Request body metadata
33898
+ */
33899
+ requestBody?: Schema$GoogleCloudDiscoveryengineV1betaServingConfig;
33900
+ }
33425
33901
  export interface Params$Resource$Projects$Locations$Datastores$Servingconfigs$Delete extends StandardParameters {
33426
33902
  /**
33427
33903
  * Required. The resource name of the ServingConfig to delete. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/servingConfigs/{serving_config_id\}`