@googleapis/discoveryengine 32.1.0 → 36.0.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
@@ -844,6 +844,10 @@ export declare namespace discoveryengine_v1beta {
844
844
  * Required. Model name (e.g. `gemini-2.5-flash`, `gemini-3.1-pro-preview`). See `model_mixture` for the list of allowed models.
845
845
  */
846
846
  name?: string | null;
847
+ /**
848
+ * Optional. Sent as Vertex `ThinkingConfig.thinking_level`.
849
+ */
850
+ thinkingLevel?: string | null;
847
851
  /**
848
852
  * Optional. Relative weight for this model in the mixture. Must be a finite, strictly positive value. Weights across all entries are normalized server-side, so they need not sum to 1.0. Defaults to 1.0 when unset, which is convenient when configuring a single model or an even mixture. Some Pro-tier models are capped at most 50% of the total weight; requests violating that cap are rejected with INVALID_ARGUMENT.
849
853
  */
@@ -1594,6 +1598,12 @@ export declare namespace discoveryengine_v1beta {
1594
1598
  * Referenced content and related document metadata.
1595
1599
  */
1596
1600
  export interface Schema$GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReference {
1601
+ /**
1602
+ * Output only. Generic structured chunk metadata from upstream data source connectors.
1603
+ */
1604
+ chunkMetadata?: {
1605
+ [key: string]: any;
1606
+ } | null;
1597
1607
  /**
1598
1608
  * Chunk of code snippet from the referenced document.
1599
1609
  */
@@ -3317,7 +3327,7 @@ export declare namespace discoveryengine_v1beta {
3317
3327
  */
3318
3328
  displayName?: string | null;
3319
3329
  /**
3320
- * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
3330
+ * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
3321
3331
  */
3322
3332
  features?: {
3323
3333
  [key: string]: string;
@@ -3364,6 +3374,10 @@ export declare namespace discoveryengine_v1beta {
3364
3374
  * Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
3365
3375
  */
3366
3376
  searchEngineConfig?: Schema$GoogleCloudDiscoveryengineV1alphaEngineSearchEngineConfig;
3377
+ /**
3378
+ * Optional. Non-empty default. Session config for the engine.
3379
+ */
3380
+ sessionConfig?: Schema$GoogleCloudDiscoveryengineV1alphaSessionConfig;
3367
3381
  /**
3368
3382
  * Additional config specs for a `similar-items` engine.
3369
3383
  */
@@ -5714,6 +5728,28 @@ export declare namespace discoveryengine_v1beta {
5714
5728
  */
5715
5729
  userPseudoId?: string | null;
5716
5730
  }
5731
+ /**
5732
+ * Configuration for the session.
5733
+ */
5734
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaSessionConfig {
5735
+ /**
5736
+ * Optional. Session management policy that defines who will manage the session.
5737
+ */
5738
+ sessionManagementPolicy?: string | null;
5739
+ /**
5740
+ * Optional. The TTL for the session. If unset, the default value is 60 days.
5741
+ */
5742
+ sessionTtl?: Schema$GoogleCloudDiscoveryengineV1alphaSessionConfigSessionTtl;
5743
+ }
5744
+ /**
5745
+ * Defines the TTL for sessions.
5746
+ */
5747
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaSessionConfigSessionTtl {
5748
+ /**
5749
+ * Defines the number of days for session TTL.
5750
+ */
5751
+ days?: number | null;
5752
+ }
5717
5753
  /**
5718
5754
  * Represents a turn, including a query from the user and a answer from service.
5719
5755
  */
@@ -6243,6 +6279,10 @@ export declare namespace discoveryengine_v1beta {
6243
6279
  * Optional. List of banned phrases.
6244
6280
  */
6245
6281
  bannedPhrases?: Schema$GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase[];
6282
+ /**
6283
+ * Optional. Data protection policy to be used for sanitizing file uploads.
6284
+ */
6285
+ dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1DataProtectionPolicy;
6246
6286
  /**
6247
6287
  * Optional. Model Armor configuration to be used for sanitizing user prompts and assistant responses.
6248
6288
  */
@@ -7832,6 +7872,10 @@ export declare namespace discoveryengine_v1beta {
7832
7872
  * Optional. List of banned phrases.
7833
7873
  */
7834
7874
  bannedPhrases?: Schema$GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicyBannedPhrase[];
7875
+ /**
7876
+ * Optional. Data protection policy to be used for sanitizing file uploads.
7877
+ */
7878
+ dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1betaDataProtectionPolicy;
7835
7879
  /**
7836
7880
  * Optional. Model Armor configuration to be used for sanitizing user prompts and assistant responses.
7837
7881
  */
@@ -7939,6 +7983,12 @@ export declare namespace discoveryengine_v1beta {
7939
7983
  * Referenced content and related document metadata.
7940
7984
  */
7941
7985
  export interface Schema$GoogleCloudDiscoveryengineV1betaAssistantGroundedContentTextGroundingMetadataReference {
7986
+ /**
7987
+ * Output only. Generic structured chunk metadata from upstream data source connectors.
7988
+ */
7989
+ chunkMetadata?: {
7990
+ [key: string]: any;
7991
+ } | null;
7942
7992
  /**
7943
7993
  * Chunk of code snippet from the referenced document.
7944
7994
  */
@@ -9156,6 +9206,24 @@ export declare namespace discoveryengine_v1beta {
9156
9206
  */
9157
9207
  trainingStartTime?: string | null;
9158
9208
  }
9209
+ /**
9210
+ * Contains the data protection policy config for a DataStore or a connector.
9211
+ */
9212
+ export interface Schema$GoogleCloudDiscoveryengineV1betaDataProtectionPolicy {
9213
+ /**
9214
+ * Optional. Specifies the sensitive data protection policy for the connector source.
9215
+ */
9216
+ sensitiveDataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1betaDataProtectionPolicySensitiveDataProtectionPolicy;
9217
+ }
9218
+ /**
9219
+ * Specifies a Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview) policy.
9220
+ */
9221
+ export interface Schema$GoogleCloudDiscoveryengineV1betaDataProtectionPolicySensitiveDataProtectionPolicy {
9222
+ /**
9223
+ * Optional. Specifies the resource name of the Sensitive Data Protection content policy.
9224
+ */
9225
+ policy?: string | null;
9226
+ }
9159
9227
  /**
9160
9228
  * DataStore captures global settings and configs at the DataStore level.
9161
9229
  */
@@ -9192,6 +9260,10 @@ export declare namespace discoveryengine_v1beta {
9192
9260
  * Output only. Timestamp the DataStore was created at.
9193
9261
  */
9194
9262
  createTime?: string | null;
9263
+ /**
9264
+ * Optional. Specifies the data protection policy for the data store.
9265
+ */
9266
+ dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1betaDataProtectionPolicy;
9195
9267
  /**
9196
9268
  * Output only. The id of the default Schema associated to this data store.
9197
9269
  */
@@ -9900,7 +9972,7 @@ export declare namespace discoveryengine_v1beta {
9900
9972
  */
9901
9973
  displayName?: string | null;
9902
9974
  /**
9903
- * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
9975
+ * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
9904
9976
  */
9905
9977
  features?: {
9906
9978
  [key: string]: string;
@@ -9943,6 +10015,10 @@ export declare namespace discoveryengine_v1beta {
9943
10015
  * Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
9944
10016
  */
9945
10017
  searchEngineConfig?: Schema$GoogleCloudDiscoveryengineV1betaEngineSearchEngineConfig;
10018
+ /**
10019
+ * Optional. Non-empty default. Session config for the engine.
10020
+ */
10021
+ sessionConfig?: Schema$GoogleCloudDiscoveryengineV1betaSessionConfig;
9946
10022
  /**
9947
10023
  * Required. The solutions of the engine.
9948
10024
  */
@@ -13725,6 +13801,28 @@ export declare namespace discoveryengine_v1beta {
13725
13801
  */
13726
13802
  userPseudoId?: string | null;
13727
13803
  }
13804
+ /**
13805
+ * Configuration for the session.
13806
+ */
13807
+ export interface Schema$GoogleCloudDiscoveryengineV1betaSessionConfig {
13808
+ /**
13809
+ * Optional. Session management policy that defines who will manage the session.
13810
+ */
13811
+ sessionManagementPolicy?: string | null;
13812
+ /**
13813
+ * Optional. The TTL for the session. If unset, the default value is 60 days.
13814
+ */
13815
+ sessionTtl?: Schema$GoogleCloudDiscoveryengineV1betaSessionConfigSessionTtl;
13816
+ }
13817
+ /**
13818
+ * Defines the TTL for sessions.
13819
+ */
13820
+ export interface Schema$GoogleCloudDiscoveryengineV1betaSessionConfigSessionTtl {
13821
+ /**
13822
+ * Defines the number of days for session TTL.
13823
+ */
13824
+ days?: number | null;
13825
+ }
13728
13826
  /**
13729
13827
  * Represents a turn, including a query from the user and a answer from service.
13730
13828
  */
@@ -13880,6 +13978,10 @@ export declare namespace discoveryengine_v1beta {
13880
13978
  * Request for the AssistantService.StreamAssist method.
13881
13979
  */
13882
13980
  export interface Schema$GoogleCloudDiscoveryengineV1betaStreamAssistRequest {
13981
+ /**
13982
+ * Optional. Specification of agents that are used to serve the request.
13983
+ */
13984
+ agentsSpec?: Schema$GoogleCloudDiscoveryengineV1betaStreamAssistRequestAgentsSpec;
13883
13985
  /**
13884
13986
  * Optional. Specification of the generation configuration for the request.
13885
13987
  */
@@ -13901,6 +14003,24 @@ export declare namespace discoveryengine_v1beta {
13901
14003
  */
13902
14004
  userMetadata?: Schema$GoogleCloudDiscoveryengineV1betaAssistUserMetadata;
13903
14005
  }
14006
+ /**
14007
+ * Specification of agents that are used to serve the request.
14008
+ */
14009
+ export interface Schema$GoogleCloudDiscoveryengineV1betaStreamAssistRequestAgentsSpec {
14010
+ /**
14011
+ * Optional. Specification of agents that are used to serve the request.
14012
+ */
14013
+ agentSpecs?: Schema$GoogleCloudDiscoveryengineV1betaStreamAssistRequestAgentsSpecAgentSpec[];
14014
+ }
14015
+ /**
14016
+ * Specification of an agent.
14017
+ */
14018
+ export interface Schema$GoogleCloudDiscoveryengineV1betaStreamAssistRequestAgentsSpecAgentSpec {
14019
+ /**
14020
+ * Required. ID to identify the agent resource serving the request. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with a length limit of 63 characters.
14021
+ */
14022
+ agentId?: string | null;
14023
+ }
13904
14024
  /**
13905
14025
  * Assistant generation specification for the request. This allows to override the default generation configuration at the engine level.
13906
14026
  */
@@ -14863,6 +14983,10 @@ export declare namespace discoveryengine_v1beta {
14863
14983
  * Output only. Timestamp the DataConnector was created at.
14864
14984
  */
14865
14985
  createTime?: string | null;
14986
+ /**
14987
+ * Optional. Specifies the data protection policy for the connector.
14988
+ */
14989
+ dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1DataProtectionPolicy;
14866
14990
  /**
14867
14991
  * Required. The identifier for the data source. For the full, up-to-date list of supported connectors and their values, see [Connect a third-party data source](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/connect-third-party-data-source#sources-by-launch-stage).
14868
14992
  */
@@ -15140,6 +15264,24 @@ export declare namespace discoveryengine_v1beta {
15140
15264
  */
15141
15265
  startingSchema?: Schema$GoogleCloudDiscoveryengineV1Schema;
15142
15266
  }
15267
+ /**
15268
+ * Contains the data protection policy config for a DataStore or a connector.
15269
+ */
15270
+ export interface Schema$GoogleCloudDiscoveryengineV1DataProtectionPolicy {
15271
+ /**
15272
+ * Optional. Specifies the sensitive data protection policy for the connector source.
15273
+ */
15274
+ sensitiveDataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1DataProtectionPolicySensitiveDataProtectionPolicy;
15275
+ }
15276
+ /**
15277
+ * Specifies a Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview) policy.
15278
+ */
15279
+ export interface Schema$GoogleCloudDiscoveryengineV1DataProtectionPolicySensitiveDataProtectionPolicy {
15280
+ /**
15281
+ * Optional. Specifies the resource name of the Sensitive Data Protection content policy.
15282
+ */
15283
+ policy?: string | null;
15284
+ }
15143
15285
  /**
15144
15286
  * DataStore captures global settings and configs at the DataStore level.
15145
15287
  */
@@ -15176,6 +15318,10 @@ export declare namespace discoveryengine_v1beta {
15176
15318
  * Output only. Timestamp the DataStore was created at.
15177
15319
  */
15178
15320
  createTime?: string | null;
15321
+ /**
15322
+ * Optional. Specifies the data protection policy for the data store.
15323
+ */
15324
+ dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1DataProtectionPolicy;
15179
15325
  /**
15180
15326
  * Output only. The id of the default Schema associated to this data store.
15181
15327
  */
@@ -15742,7 +15888,7 @@ export declare namespace discoveryengine_v1beta {
15742
15888
  */
15743
15889
  displayName?: string | null;
15744
15890
  /**
15745
- * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
15891
+ * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
15746
15892
  */
15747
15893
  features?: {
15748
15894
  [key: string]: string;
@@ -15785,6 +15931,10 @@ export declare namespace discoveryengine_v1beta {
15785
15931
  * Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
15786
15932
  */
15787
15933
  searchEngineConfig?: Schema$GoogleCloudDiscoveryengineV1EngineSearchEngineConfig;
15934
+ /**
15935
+ * Optional. Non-empty default. Session config for the engine.
15936
+ */
15937
+ sessionConfig?: Schema$GoogleCloudDiscoveryengineV1SessionConfig;
15788
15938
  /**
15789
15939
  * Required. The solutions of the engine.
15790
15940
  */
@@ -16880,6 +17030,28 @@ export declare namespace discoveryengine_v1beta {
16880
17030
  */
16881
17031
  demotionEventType?: string | null;
16882
17032
  }
17033
+ /**
17034
+ * Configuration for the session.
17035
+ */
17036
+ export interface Schema$GoogleCloudDiscoveryengineV1SessionConfig {
17037
+ /**
17038
+ * Optional. Session management policy that defines who will manage the session.
17039
+ */
17040
+ sessionManagementPolicy?: string | null;
17041
+ /**
17042
+ * Optional. The TTL for the session. If unset, the default value is 60 days.
17043
+ */
17044
+ sessionTtl?: Schema$GoogleCloudDiscoveryengineV1SessionConfigSessionTtl;
17045
+ }
17046
+ /**
17047
+ * Defines the TTL for sessions.
17048
+ */
17049
+ export interface Schema$GoogleCloudDiscoveryengineV1SessionConfigSessionTtl {
17050
+ /**
17051
+ * Defines the number of days for session TTL.
17052
+ */
17053
+ days?: number | null;
17054
+ }
16883
17055
  /**
16884
17056
  * Metadata for DataConnectorService.SetUpDataConnector method.
16885
17057
  */
@@ -19125,6 +19297,7 @@ export declare namespace discoveryengine_v1beta {
19125
19297
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
19126
19298
  * // "contentConfig": "my_contentConfig",
19127
19299
  * // "createTime": "my_createTime",
19300
+ * // "dataProtectionPolicy": {},
19128
19301
  * // "defaultSchemaId": "my_defaultSchemaId",
19129
19302
  * // "displayName": "my_displayName",
19130
19303
  * // "documentProcessingConfig": {},
@@ -19294,6 +19467,7 @@ export declare namespace discoveryengine_v1beta {
19294
19467
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
19295
19468
  * // "contentConfig": "my_contentConfig",
19296
19469
  * // "createTime": "my_createTime",
19470
+ * // "dataProtectionPolicy": {},
19297
19471
  * // "defaultSchemaId": "my_defaultSchemaId",
19298
19472
  * // "displayName": "my_displayName",
19299
19473
  * // "documentProcessingConfig": {},
@@ -19331,6 +19505,78 @@ export declare namespace discoveryengine_v1beta {
19331
19505
  get(params: Params$Resource$Projects$Locations$Collections$Datastores$Get, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
19332
19506
  get(params: Params$Resource$Projects$Locations$Collections$Datastores$Get, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
19333
19507
  get(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
19508
+ /**
19509
+ * Gets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it.
19510
+ * @example
19511
+ * ```js
19512
+ * // Before running the sample:
19513
+ * // - Enable the API at:
19514
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
19515
+ * // - Login into gcloud by running:
19516
+ * // ```sh
19517
+ * // $ gcloud auth application-default login
19518
+ * // ```
19519
+ * // - Install the npm module by running:
19520
+ * // ```sh
19521
+ * // $ npm install googleapis
19522
+ * // ```
19523
+ *
19524
+ * const {google} = require('googleapis');
19525
+ * const discoveryengine = google.discoveryengine('v1beta');
19526
+ *
19527
+ * async function main() {
19528
+ * const auth = new google.auth.GoogleAuth({
19529
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
19530
+ * scopes: [
19531
+ * 'https://www.googleapis.com/auth/cloud-platform',
19532
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
19533
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
19534
+ * ],
19535
+ * });
19536
+ *
19537
+ * // Acquire an auth client, and bind it to all future calls
19538
+ * const authClient = await auth.getClient();
19539
+ * google.options({auth: authClient});
19540
+ *
19541
+ * // Do the magic
19542
+ * const res =
19543
+ * await discoveryengine.projects.locations.collections.dataStores.getIamPolicy(
19544
+ * {
19545
+ * // Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
19546
+ * 'options.requestedPolicyVersion': 'placeholder-value',
19547
+ * // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
19548
+ * resource:
19549
+ * 'projects/my-project/locations/my-location/collections/my-collection/dataStores/my-dataStore',
19550
+ * },
19551
+ * );
19552
+ * console.log(res.data);
19553
+ *
19554
+ * // Example response
19555
+ * // {
19556
+ * // "bindings": [],
19557
+ * // "etag": "my_etag",
19558
+ * // "version": 0
19559
+ * // }
19560
+ * }
19561
+ *
19562
+ * main().catch(e => {
19563
+ * console.error(e);
19564
+ * throw e;
19565
+ * });
19566
+ *
19567
+ * ```
19568
+ *
19569
+ * @param params - Parameters for request
19570
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
19571
+ * @param callback - Optional callback that handles the response.
19572
+ * @returns A promise if used with async/await, or void if used with a callback.
19573
+ */
19574
+ getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
19575
+ getIamPolicy(params?: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
19576
+ getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
19577
+ getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
19578
+ getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
19579
+ getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
19334
19580
  /**
19335
19581
  * Gets the SiteSearchEngine.
19336
19582
  * @example
@@ -19524,6 +19770,7 @@ export declare namespace discoveryengine_v1beta {
19524
19770
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
19525
19771
  * // "contentConfig": "my_contentConfig",
19526
19772
  * // "createTime": "my_createTime",
19773
+ * // "dataProtectionPolicy": {},
19527
19774
  * // "defaultSchemaId": "my_defaultSchemaId",
19528
19775
  * // "displayName": "my_displayName",
19529
19776
  * // "documentProcessingConfig": {},
@@ -19555,6 +19802,7 @@ export declare namespace discoveryengine_v1beta {
19555
19802
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
19556
19803
  * // "contentConfig": "my_contentConfig",
19557
19804
  * // "createTime": "my_createTime",
19805
+ * // "dataProtectionPolicy": {},
19558
19806
  * // "defaultSchemaId": "my_defaultSchemaId",
19559
19807
  * // "displayName": "my_displayName",
19560
19808
  * // "documentProcessingConfig": {},
@@ -19592,6 +19840,84 @@ export declare namespace discoveryengine_v1beta {
19592
19840
  patch(params: Params$Resource$Projects$Locations$Collections$Datastores$Patch, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
19593
19841
  patch(params: Params$Resource$Projects$Locations$Collections$Datastores$Patch, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
19594
19842
  patch(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
19843
+ /**
19844
+ * Sets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on a DataStore resource, the only recommended roles in the bindings are: `roles/discoveryengine.admin` `roles/discoveryengine.agentspaceAdmin` `roles/discoveryengine.viewer` `roles/discoveryengine.agentspaceViewer` `roles/discoveryengine.user` `roles/discoveryengine.agentspaceUser` Attempting to grant any other role will result in a warning in logging.
19845
+ * @example
19846
+ * ```js
19847
+ * // Before running the sample:
19848
+ * // - Enable the API at:
19849
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
19850
+ * // - Login into gcloud by running:
19851
+ * // ```sh
19852
+ * // $ gcloud auth application-default login
19853
+ * // ```
19854
+ * // - Install the npm module by running:
19855
+ * // ```sh
19856
+ * // $ npm install googleapis
19857
+ * // ```
19858
+ *
19859
+ * const {google} = require('googleapis');
19860
+ * const discoveryengine = google.discoveryengine('v1beta');
19861
+ *
19862
+ * async function main() {
19863
+ * const auth = new google.auth.GoogleAuth({
19864
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
19865
+ * scopes: [
19866
+ * 'https://www.googleapis.com/auth/cloud-platform',
19867
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
19868
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
19869
+ * ],
19870
+ * });
19871
+ *
19872
+ * // Acquire an auth client, and bind it to all future calls
19873
+ * const authClient = await auth.getClient();
19874
+ * google.options({auth: authClient});
19875
+ *
19876
+ * // Do the magic
19877
+ * const res =
19878
+ * await discoveryengine.projects.locations.collections.dataStores.setIamPolicy(
19879
+ * {
19880
+ * // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
19881
+ * resource:
19882
+ * 'projects/my-project/locations/my-location/collections/my-collection/dataStores/my-dataStore',
19883
+ *
19884
+ * // Request body metadata
19885
+ * requestBody: {
19886
+ * // request body parameters
19887
+ * // {
19888
+ * // "policy": {}
19889
+ * // }
19890
+ * },
19891
+ * },
19892
+ * );
19893
+ * console.log(res.data);
19894
+ *
19895
+ * // Example response
19896
+ * // {
19897
+ * // "bindings": [],
19898
+ * // "etag": "my_etag",
19899
+ * // "version": 0
19900
+ * // }
19901
+ * }
19902
+ *
19903
+ * main().catch(e => {
19904
+ * console.error(e);
19905
+ * throw e;
19906
+ * });
19907
+ *
19908
+ * ```
19909
+ *
19910
+ * @param params - Parameters for request
19911
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
19912
+ * @param callback - Optional callback that handles the response.
19913
+ * @returns A promise if used with async/await, or void if used with a callback.
19914
+ */
19915
+ setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
19916
+ setIamPolicy(params?: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
19917
+ setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
19918
+ setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
19919
+ setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
19920
+ setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
19595
19921
  /**
19596
19922
  * Trains a custom model.
19597
19923
  * @example
@@ -19740,6 +20066,16 @@ export declare namespace discoveryengine_v1beta {
19740
20066
  */
19741
20067
  name?: string;
19742
20068
  }
20069
+ export interface Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy extends StandardParameters {
20070
+ /**
20071
+ * Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
20072
+ */
20073
+ 'options.requestedPolicyVersion'?: number;
20074
+ /**
20075
+ * REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
20076
+ */
20077
+ resource?: string;
20078
+ }
19743
20079
  export interface Params$Resource$Projects$Locations$Collections$Datastores$Getsitesearchengine extends StandardParameters {
19744
20080
  /**
19745
20081
  * Required. Resource name of SiteSearchEngine, such as `projects/{project\}/locations/{location\}/collections/{collection\}/dataStores/{data_store\}/siteSearchEngine`. If the caller does not have permission to access the [SiteSearchEngine], regardless of whether or not it exists, a PERMISSION_DENIED error is returned.
@@ -19778,6 +20114,16 @@ export declare namespace discoveryengine_v1beta {
19778
20114
  */
19779
20115
  requestBody?: Schema$GoogleCloudDiscoveryengineV1betaDataStore;
19780
20116
  }
20117
+ export interface Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy extends StandardParameters {
20118
+ /**
20119
+ * REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
20120
+ */
20121
+ resource?: string;
20122
+ /**
20123
+ * Request body metadata
20124
+ */
20125
+ requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
20126
+ }
19781
20127
  export interface Params$Resource$Projects$Locations$Collections$Datastores$Traincustommodel extends StandardParameters {
19782
20128
  /**
19783
20129
  * Required. The resource name of the Data Store, such as `projects/x/locations/global/collections/default_collection/dataStores/default_data_store`. This field is used to identify the data store where to train the models.
@@ -27157,6 +27503,7 @@ export declare namespace discoveryengine_v1beta {
27157
27503
  * // "observabilityConfig": {},
27158
27504
  * // "procurementContactEmails": [],
27159
27505
  * // "searchEngineConfig": {},
27506
+ * // "sessionConfig": {},
27160
27507
  * // "solutionType": "my_solutionType",
27161
27508
  * // "updateTime": "my_updateTime"
27162
27509
  * // }
@@ -27326,6 +27673,7 @@ export declare namespace discoveryengine_v1beta {
27326
27673
  * // "observabilityConfig": {},
27327
27674
  * // "procurementContactEmails": [],
27328
27675
  * // "searchEngineConfig": {},
27676
+ * // "sessionConfig": {},
27329
27677
  * // "solutionType": "my_solutionType",
27330
27678
  * // "updateTime": "my_updateTime"
27331
27679
  * // }
@@ -27561,6 +27909,7 @@ export declare namespace discoveryengine_v1beta {
27561
27909
  * // "observabilityConfig": {},
27562
27910
  * // "procurementContactEmails": [],
27563
27911
  * // "searchEngineConfig": {},
27912
+ * // "sessionConfig": {},
27564
27913
  * // "solutionType": "my_solutionType",
27565
27914
  * // "updateTime": "my_updateTime"
27566
27915
  * // }
@@ -27593,6 +27942,7 @@ export declare namespace discoveryengine_v1beta {
27593
27942
  * // "observabilityConfig": {},
27594
27943
  * // "procurementContactEmails": [],
27595
27944
  * // "searchEngineConfig": {},
27945
+ * // "sessionConfig": {},
27596
27946
  * // "solutionType": "my_solutionType",
27597
27947
  * // "updateTime": "my_updateTime"
27598
27948
  * // }
@@ -27688,6 +28038,7 @@ export declare namespace discoveryengine_v1beta {
27688
28038
  * // "observabilityConfig": {},
27689
28039
  * // "procurementContactEmails": [],
27690
28040
  * // "searchEngineConfig": {},
28041
+ * // "sessionConfig": {},
27691
28042
  * // "solutionType": "my_solutionType",
27692
28043
  * // "updateTime": "my_updateTime"
27693
28044
  * // }
@@ -27783,6 +28134,7 @@ export declare namespace discoveryengine_v1beta {
27783
28134
  * // "observabilityConfig": {},
27784
28135
  * // "procurementContactEmails": [],
27785
28136
  * // "searchEngineConfig": {},
28137
+ * // "sessionConfig": {},
27786
28138
  * // "solutionType": "my_solutionType",
27787
28139
  * // "updateTime": "my_updateTime"
27788
28140
  * // }
@@ -28526,6 +28878,7 @@ export declare namespace discoveryengine_v1beta {
28526
28878
  * requestBody: {
28527
28879
  * // request body parameters
28528
28880
  * // {
28881
+ * // "agentsSpec": {},
28529
28882
  * // "generationSpec": {},
28530
28883
  * // "query": {},
28531
28884
  * // "session": "my_session",
@@ -32112,6 +32465,7 @@ export declare namespace discoveryengine_v1beta {
32112
32465
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
32113
32466
  * // "contentConfig": "my_contentConfig",
32114
32467
  * // "createTime": "my_createTime",
32468
+ * // "dataProtectionPolicy": {},
32115
32469
  * // "defaultSchemaId": "my_defaultSchemaId",
32116
32470
  * // "displayName": "my_displayName",
32117
32471
  * // "documentProcessingConfig": {},
@@ -32279,6 +32633,7 @@ export declare namespace discoveryengine_v1beta {
32279
32633
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
32280
32634
  * // "contentConfig": "my_contentConfig",
32281
32635
  * // "createTime": "my_createTime",
32636
+ * // "dataProtectionPolicy": {},
32282
32637
  * // "defaultSchemaId": "my_defaultSchemaId",
32283
32638
  * // "displayName": "my_displayName",
32284
32639
  * // "documentProcessingConfig": {},
@@ -32316,6 +32671,75 @@ export declare namespace discoveryengine_v1beta {
32316
32671
  get(params: Params$Resource$Projects$Locations$Datastores$Get, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
32317
32672
  get(params: Params$Resource$Projects$Locations$Datastores$Get, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
32318
32673
  get(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
32674
+ /**
32675
+ * Gets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it.
32676
+ * @example
32677
+ * ```js
32678
+ * // Before running the sample:
32679
+ * // - Enable the API at:
32680
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
32681
+ * // - Login into gcloud by running:
32682
+ * // ```sh
32683
+ * // $ gcloud auth application-default login
32684
+ * // ```
32685
+ * // - Install the npm module by running:
32686
+ * // ```sh
32687
+ * // $ npm install googleapis
32688
+ * // ```
32689
+ *
32690
+ * const {google} = require('googleapis');
32691
+ * const discoveryengine = google.discoveryengine('v1beta');
32692
+ *
32693
+ * async function main() {
32694
+ * const auth = new google.auth.GoogleAuth({
32695
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
32696
+ * scopes: [
32697
+ * 'https://www.googleapis.com/auth/cloud-platform',
32698
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
32699
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
32700
+ * ],
32701
+ * });
32702
+ *
32703
+ * // Acquire an auth client, and bind it to all future calls
32704
+ * const authClient = await auth.getClient();
32705
+ * google.options({auth: authClient});
32706
+ *
32707
+ * // Do the magic
32708
+ * const res = await discoveryengine.projects.locations.dataStores.getIamPolicy({
32709
+ * // Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
32710
+ * 'options.requestedPolicyVersion': 'placeholder-value',
32711
+ * // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
32712
+ * resource:
32713
+ * 'projects/my-project/locations/my-location/dataStores/my-dataStore',
32714
+ * });
32715
+ * console.log(res.data);
32716
+ *
32717
+ * // Example response
32718
+ * // {
32719
+ * // "bindings": [],
32720
+ * // "etag": "my_etag",
32721
+ * // "version": 0
32722
+ * // }
32723
+ * }
32724
+ *
32725
+ * main().catch(e => {
32726
+ * console.error(e);
32727
+ * throw e;
32728
+ * });
32729
+ *
32730
+ * ```
32731
+ *
32732
+ * @param params - Parameters for request
32733
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
32734
+ * @param callback - Optional callback that handles the response.
32735
+ * @returns A promise if used with async/await, or void if used with a callback.
32736
+ */
32737
+ getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
32738
+ getIamPolicy(params?: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
32739
+ getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
32740
+ getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
32741
+ getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
32742
+ getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
32319
32743
  /**
32320
32744
  * Gets the SiteSearchEngine.
32321
32745
  * @example
@@ -32504,6 +32928,7 @@ export declare namespace discoveryengine_v1beta {
32504
32928
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
32505
32929
  * // "contentConfig": "my_contentConfig",
32506
32930
  * // "createTime": "my_createTime",
32931
+ * // "dataProtectionPolicy": {},
32507
32932
  * // "defaultSchemaId": "my_defaultSchemaId",
32508
32933
  * // "displayName": "my_displayName",
32509
32934
  * // "documentProcessingConfig": {},
@@ -32535,6 +32960,7 @@ export declare namespace discoveryengine_v1beta {
32535
32960
  * // "configurableBillingApproachUpdateTime": "my_configurableBillingApproachUpdateTime",
32536
32961
  * // "contentConfig": "my_contentConfig",
32537
32962
  * // "createTime": "my_createTime",
32963
+ * // "dataProtectionPolicy": {},
32538
32964
  * // "defaultSchemaId": "my_defaultSchemaId",
32539
32965
  * // "displayName": "my_displayName",
32540
32966
  * // "documentProcessingConfig": {},
@@ -32572,6 +32998,81 @@ export declare namespace discoveryengine_v1beta {
32572
32998
  patch(params: Params$Resource$Projects$Locations$Datastores$Patch, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
32573
32999
  patch(params: Params$Resource$Projects$Locations$Datastores$Patch, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
32574
33000
  patch(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1betaDataStore>): void;
33001
+ /**
33002
+ * Sets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on a DataStore resource, the only recommended roles in the bindings are: `roles/discoveryengine.admin` `roles/discoveryengine.agentspaceAdmin` `roles/discoveryengine.viewer` `roles/discoveryengine.agentspaceViewer` `roles/discoveryengine.user` `roles/discoveryengine.agentspaceUser` Attempting to grant any other role will result in a warning in logging.
33003
+ * @example
33004
+ * ```js
33005
+ * // Before running the sample:
33006
+ * // - Enable the API at:
33007
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
33008
+ * // - Login into gcloud by running:
33009
+ * // ```sh
33010
+ * // $ gcloud auth application-default login
33011
+ * // ```
33012
+ * // - Install the npm module by running:
33013
+ * // ```sh
33014
+ * // $ npm install googleapis
33015
+ * // ```
33016
+ *
33017
+ * const {google} = require('googleapis');
33018
+ * const discoveryengine = google.discoveryengine('v1beta');
33019
+ *
33020
+ * async function main() {
33021
+ * const auth = new google.auth.GoogleAuth({
33022
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
33023
+ * scopes: [
33024
+ * 'https://www.googleapis.com/auth/cloud-platform',
33025
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
33026
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
33027
+ * ],
33028
+ * });
33029
+ *
33030
+ * // Acquire an auth client, and bind it to all future calls
33031
+ * const authClient = await auth.getClient();
33032
+ * google.options({auth: authClient});
33033
+ *
33034
+ * // Do the magic
33035
+ * const res = await discoveryengine.projects.locations.dataStores.setIamPolicy({
33036
+ * // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
33037
+ * resource:
33038
+ * 'projects/my-project/locations/my-location/dataStores/my-dataStore',
33039
+ *
33040
+ * // Request body metadata
33041
+ * requestBody: {
33042
+ * // request body parameters
33043
+ * // {
33044
+ * // "policy": {}
33045
+ * // }
33046
+ * },
33047
+ * });
33048
+ * console.log(res.data);
33049
+ *
33050
+ * // Example response
33051
+ * // {
33052
+ * // "bindings": [],
33053
+ * // "etag": "my_etag",
33054
+ * // "version": 0
33055
+ * // }
33056
+ * }
33057
+ *
33058
+ * main().catch(e => {
33059
+ * console.error(e);
33060
+ * throw e;
33061
+ * });
33062
+ *
33063
+ * ```
33064
+ *
33065
+ * @param params - Parameters for request
33066
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
33067
+ * @param callback - Optional callback that handles the response.
33068
+ * @returns A promise if used with async/await, or void if used with a callback.
33069
+ */
33070
+ setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
33071
+ setIamPolicy(params?: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
33072
+ setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
33073
+ setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
33074
+ setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
33075
+ setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
32575
33076
  }
32576
33077
  export interface Params$Resource$Projects$Locations$Datastores$Completequery extends StandardParameters {
32577
33078
  /**
@@ -32637,6 +33138,16 @@ export declare namespace discoveryengine_v1beta {
32637
33138
  */
32638
33139
  name?: string;
32639
33140
  }
33141
+ export interface Params$Resource$Projects$Locations$Datastores$Getiampolicy extends StandardParameters {
33142
+ /**
33143
+ * Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
33144
+ */
33145
+ 'options.requestedPolicyVersion'?: number;
33146
+ /**
33147
+ * REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
33148
+ */
33149
+ resource?: string;
33150
+ }
32640
33151
  export interface Params$Resource$Projects$Locations$Datastores$Getsitesearchengine extends StandardParameters {
32641
33152
  /**
32642
33153
  * Required. Resource name of SiteSearchEngine, such as `projects/{project\}/locations/{location\}/collections/{collection\}/dataStores/{data_store\}/siteSearchEngine`. If the caller does not have permission to access the [SiteSearchEngine], regardless of whether or not it exists, a PERMISSION_DENIED error is returned.
@@ -32675,6 +33186,16 @@ export declare namespace discoveryengine_v1beta {
32675
33186
  */
32676
33187
  requestBody?: Schema$GoogleCloudDiscoveryengineV1betaDataStore;
32677
33188
  }
33189
+ export interface Params$Resource$Projects$Locations$Datastores$Setiampolicy extends StandardParameters {
33190
+ /**
33191
+ * REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
33192
+ */
33193
+ resource?: string;
33194
+ /**
33195
+ * Request body metadata
33196
+ */
33197
+ requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
33198
+ }
32678
33199
  export class Resource$Projects$Locations$Datastores$Branches {
32679
33200
  context: APIRequestContext;
32680
33201
  documents: Resource$Projects$Locations$Datastores$Branches$Documents;