@googleapis/discoveryengine 31.0.0 → 32.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@googleapis/discoveryengine",
3
- "version": "31.0.0",
3
+ "version": "32.0.0",
4
4
  "description": "discoveryengine",
5
5
  "main": "build/index.js",
6
6
  "types": "build/index.d.ts",
package/v1.ts CHANGED
@@ -3364,13 +3364,9 @@ export namespace discoveryengine_v1 {
3364
3364
  vpcscEnabled?: boolean | null;
3365
3365
  }
3366
3366
  /**
3367
- * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
3367
+ * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).
3368
3368
  */
3369
3369
  export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata {
3370
- /**
3371
- * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.
3372
- */
3373
- authenticatedAccount?: string | null;
3374
3370
  /**
3375
3371
  * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).
3376
3372
  */
@@ -4193,7 +4189,7 @@ export namespace discoveryengine_v1 {
4193
4189
  */
4194
4190
  displayName?: string | null;
4195
4191
  /**
4196
- * 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` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
4192
+ * 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` * `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`
4197
4193
  */
4198
4194
  features?: {[key: string]: string} | null;
4199
4195
  /**
@@ -8416,7 +8412,7 @@ export namespace discoveryengine_v1 {
8416
8412
  */
8417
8413
  deleteUnassignedUserLicenses?: boolean | null;
8418
8414
  /**
8419
- * The inline source for the input content for document embeddings.
8415
+ * The inline source for the input content for license assignment.
8420
8416
  */
8421
8417
  inlineSource?: Schema$GoogleCloudDiscoveryengineV1BatchUpdateUserLicensesRequestInlineSource;
8422
8418
  }
@@ -9401,7 +9397,7 @@ export namespace discoveryengine_v1 {
9401
9397
  */
9402
9398
  displayName?: string | null;
9403
9399
  /**
9404
- * 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` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
9400
+ * 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` * `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`
9405
9401
  */
9406
9402
  features?: {[key: string]: string} | null;
9407
9403
  /**
@@ -12610,13 +12606,9 @@ export namespace discoveryengine_v1 {
12610
12606
  vpcscEnabled?: boolean | null;
12611
12607
  }
12612
12608
  /**
12613
- * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
12609
+ * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).
12614
12610
  */
12615
12611
  export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata {
12616
- /**
12617
- * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.
12618
- */
12619
- authenticatedAccount?: string | null;
12620
12612
  /**
12621
12613
  * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).
12622
12614
  */
@@ -13521,7 +13513,7 @@ export namespace discoveryengine_v1 {
13521
13513
  */
13522
13514
  displayName?: string | null;
13523
13515
  /**
13524
- * 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` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
13516
+ * 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` * `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`
13525
13517
  */
13526
13518
  features?: {[key: string]: string} | null;
13527
13519
  /**
@@ -17607,6 +17599,14 @@ export namespace discoveryengine_v1 {
17607
17599
  * Output only. The display name of the data source.
17608
17600
  */
17609
17601
  dataSourceDisplayName?: string | null;
17602
+ /**
17603
+ * Output only. The end-user-facing display name of the data source, sourced from `ConnectorSource.end_user_display_name`. When unset, clients fall back to `data_source_display_name`.
17604
+ */
17605
+ dataSourceEndUserDisplayName?: string | null;
17606
+ /**
17607
+ * Output only. The version of the connector definition backing this collection, mirroring `DataConnector.data_source_version`.
17608
+ */
17609
+ dataSourceVersion?: number | null;
17610
17610
  /**
17611
17611
  * For the data store collection, list of the children data stores.
17612
17612
  */
@@ -17619,6 +17619,14 @@ export namespace discoveryengine_v1 {
17619
17619
  * Output only. the identifier of the collection, used for widget service. For now it refers to collection_id, in the future we will migrate the field to encrypted collection name UUID. For synthetic placeholder entries (see message-level comment) this is a synthetic placeholder id, not a real collection_id.
17620
17620
  */
17621
17621
  id?: string | null;
17622
+ /**
17623
+ * Output only. Whether this is a first-party (Google-owned) connector, as opposed to a third-party connector. Used by the frontend to group 1P vs 3P connectors. Sourced from `ConnectorSource.is_first_party` once that field is universally populated (b/534727761); until then derived from `ConnectorSource.connector_type == FIRST_PARTY`.
17624
+ */
17625
+ isFirstParty?: boolean | null;
17626
+ /**
17627
+ * Output only. User-facing connector metadata (`title`, `description`, `short_description`, `author`, `note`), retrieved from the registry `ConnectorSource.metadata` (joined by data source). Shown on the connector detail page.
17628
+ */
17629
+ metadata?: Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata;
17622
17630
  /**
17623
17631
  * The name of the collection. It should be collection resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector.
17624
17632
  */
@@ -17848,7 +17856,7 @@ export namespace discoveryengine_v1 {
17848
17856
  */
17849
17857
  enableVisualContentSummary?: boolean | null;
17850
17858
  /**
17851
- * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
17859
+ * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `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`
17852
17860
  */
17853
17861
  features?: {[key: string]: string} | null;
17854
17862
  /**
@@ -19223,6 +19231,165 @@ export namespace discoveryengine_v1 {
19223
19231
  }
19224
19232
  }
19225
19233
 
19234
+ /**
19235
+ * Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.
19236
+ * @example
19237
+ * ```js
19238
+ * // Before running the sample:
19239
+ * // - Enable the API at:
19240
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
19241
+ * // - Login into gcloud by running:
19242
+ * // ```sh
19243
+ * // $ gcloud auth application-default login
19244
+ * // ```
19245
+ * // - Install the npm module by running:
19246
+ * // ```sh
19247
+ * // $ npm install googleapis
19248
+ * // ```
19249
+ *
19250
+ * const {google} = require('googleapis');
19251
+ * const discoveryengine = google.discoveryengine('v1');
19252
+ *
19253
+ * async function main() {
19254
+ * const auth = new google.auth.GoogleAuth({
19255
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
19256
+ * scopes: [
19257
+ * 'https://www.googleapis.com/auth/cloud-platform',
19258
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
19259
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
19260
+ * ],
19261
+ * });
19262
+ *
19263
+ * // Acquire an auth client, and bind it to all future calls
19264
+ * const authClient = await auth.getClient();
19265
+ * google.options({auth: authClient});
19266
+ *
19267
+ * // Do the magic
19268
+ * const res = await discoveryengine.projects.locations.provision({
19269
+ * // Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`.
19270
+ * name: 'projects/my-project/locations/my-location',
19271
+ *
19272
+ * // Request body metadata
19273
+ * requestBody: {
19274
+ * // request body parameters
19275
+ * // {
19276
+ * // "acceptDataUseTerms": false,
19277
+ * // "dataUseTermsVersion": "my_dataUseTermsVersion",
19278
+ * // "saasParams": {}
19279
+ * // }
19280
+ * },
19281
+ * });
19282
+ * console.log(res.data);
19283
+ *
19284
+ * // Example response
19285
+ * // {
19286
+ * // "done": false,
19287
+ * // "error": {},
19288
+ * // "metadata": {},
19289
+ * // "name": "my_name",
19290
+ * // "response": {}
19291
+ * // }
19292
+ * }
19293
+ *
19294
+ * main().catch(e => {
19295
+ * console.error(e);
19296
+ * throw e;
19297
+ * });
19298
+ *
19299
+ * ```
19300
+ *
19301
+ * @param params - Parameters for request
19302
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
19303
+ * @param callback - Optional callback that handles the response.
19304
+ * @returns A promise if used with async/await, or void if used with a callback.
19305
+ */
19306
+ provision(
19307
+ params: Params$Resource$Projects$Locations$Provision,
19308
+ options: StreamMethodOptions
19309
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
19310
+ provision(
19311
+ params?: Params$Resource$Projects$Locations$Provision,
19312
+ options?: MethodOptions
19313
+ ): Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>;
19314
+ provision(
19315
+ params: Params$Resource$Projects$Locations$Provision,
19316
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
19317
+ callback: BodyResponseCallback<Readable>
19318
+ ): void;
19319
+ provision(
19320
+ params: Params$Resource$Projects$Locations$Provision,
19321
+ options:
19322
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
19323
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
19324
+ ): void;
19325
+ provision(
19326
+ params: Params$Resource$Projects$Locations$Provision,
19327
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
19328
+ ): void;
19329
+ provision(
19330
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
19331
+ ): void;
19332
+ provision(
19333
+ paramsOrCallback?:
19334
+ | Params$Resource$Projects$Locations$Provision
19335
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
19336
+ | BodyResponseCallback<Readable>,
19337
+ optionsOrCallback?:
19338
+ | MethodOptions
19339
+ | StreamMethodOptions
19340
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
19341
+ | BodyResponseCallback<Readable>,
19342
+ callback?:
19343
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
19344
+ | BodyResponseCallback<Readable>
19345
+ ):
19346
+ | void
19347
+ | Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>
19348
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
19349
+ let params = (paramsOrCallback ||
19350
+ {}) as Params$Resource$Projects$Locations$Provision;
19351
+ let options = (optionsOrCallback || {}) as MethodOptions;
19352
+
19353
+ if (typeof paramsOrCallback === 'function') {
19354
+ callback = paramsOrCallback;
19355
+ params = {} as Params$Resource$Projects$Locations$Provision;
19356
+ options = {};
19357
+ }
19358
+
19359
+ if (typeof optionsOrCallback === 'function') {
19360
+ callback = optionsOrCallback;
19361
+ options = {};
19362
+ }
19363
+
19364
+ const rootUrl =
19365
+ options.rootUrl || 'https://discoveryengine.googleapis.com/';
19366
+ const parameters = {
19367
+ options: Object.assign(
19368
+ {
19369
+ url: (rootUrl + '/v1/{+name}:provision').replace(
19370
+ /([^:]\/)\/+/g,
19371
+ '$1'
19372
+ ),
19373
+ method: 'POST',
19374
+ apiVersion: '',
19375
+ },
19376
+ options
19377
+ ),
19378
+ params,
19379
+ requiredParams: ['name'],
19380
+ pathParams: ['name'],
19381
+ context: this.context,
19382
+ };
19383
+ if (callback) {
19384
+ createAPIRequest<Schema$GoogleLongrunningOperation>(
19385
+ parameters,
19386
+ callback as BodyResponseCallback<unknown>
19387
+ );
19388
+ } else {
19389
+ return createAPIRequest<Schema$GoogleLongrunningOperation>(parameters);
19390
+ }
19391
+ }
19392
+
19226
19393
  /**
19227
19394
  * Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method.
19228
19395
  * @example
@@ -19926,6 +20093,17 @@ export namespace discoveryengine_v1 {
19926
20093
  */
19927
20094
  name?: string;
19928
20095
  }
20096
+ export interface Params$Resource$Projects$Locations$Provision extends StandardParameters {
20097
+ /**
20098
+ * Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`.
20099
+ */
20100
+ name?: string;
20101
+
20102
+ /**
20103
+ * Request body metadata
20104
+ */
20105
+ requestBody?: Schema$GoogleCloudDiscoveryengineV1ProvisionProjectRequest;
20106
+ }
19929
20107
  export interface Params$Resource$Projects$Locations$Setupdataconnector extends StandardParameters {
19930
20108
  /**
19931
20109
  * Required. The parent of Collection, in the format of `projects/{project\}/locations/{location\}`.
package/v1alpha.ts CHANGED
@@ -3041,7 +3041,7 @@ export namespace discoveryengine_v1alpha {
3041
3041
  */
3042
3042
  deleteUnassignedUserLicenses?: boolean | null;
3043
3043
  /**
3044
- * The inline source for the input content for document embeddings.
3044
+ * The inline source for the input content for license assignment.
3045
3045
  */
3046
3046
  inlineSource?: Schema$GoogleCloudDiscoveryengineV1alphaBatchUpdateUserLicensesRequestInlineSource;
3047
3047
  }
@@ -4699,13 +4699,9 @@ export namespace discoveryengine_v1alpha {
4699
4699
  vpcscEnabled?: boolean | null;
4700
4700
  }
4701
4701
  /**
4702
- * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
4702
+ * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).
4703
4703
  */
4704
4704
  export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata {
4705
- /**
4706
- * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.
4707
- */
4708
- authenticatedAccount?: string | null;
4709
4705
  /**
4710
4706
  * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).
4711
4707
  */
@@ -5731,7 +5727,7 @@ export namespace discoveryengine_v1alpha {
5731
5727
  */
5732
5728
  displayName?: string | null;
5733
5729
  /**
5734
- * 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` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
5730
+ * 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` * `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`
5735
5731
  */
5736
5732
  features?: {[key: string]: string} | null;
5737
5733
  /**
@@ -11938,6 +11934,14 @@ export namespace discoveryengine_v1alpha {
11938
11934
  * Output only. The display name of the data source.
11939
11935
  */
11940
11936
  dataSourceDisplayName?: string | null;
11937
+ /**
11938
+ * Output only. The end-user-facing display name of the data source, sourced from `ConnectorSource.end_user_display_name`. When unset, clients fall back to `data_source_display_name`.
11939
+ */
11940
+ dataSourceEndUserDisplayName?: string | null;
11941
+ /**
11942
+ * Output only. The version of the connector definition backing this collection, mirroring `DataConnector.data_source_version`.
11943
+ */
11944
+ dataSourceVersion?: number | null;
11941
11945
  /**
11942
11946
  * For the data store collection, list of the children data stores.
11943
11947
  */
@@ -11950,6 +11954,14 @@ export namespace discoveryengine_v1alpha {
11950
11954
  * Output only. the identifier of the collection, used for widget service. For now it refers to collection_id, in the future we will migrate the field to encrypted collection name UUID. For synthetic placeholder entries (see message-level comment) this is a synthetic placeholder id, not a real collection_id.
11951
11955
  */
11952
11956
  id?: string | null;
11957
+ /**
11958
+ * Output only. Whether this is a first-party (Google-owned) connector, as opposed to a third-party connector. Used by the frontend to group 1P vs 3P connectors. Sourced from `ConnectorSource.is_first_party` once that field is universally populated (b/534727761); until then derived from `ConnectorSource.connector_type == FIRST_PARTY`.
11959
+ */
11960
+ isFirstParty?: boolean | null;
11961
+ /**
11962
+ * Output only. User-facing connector metadata (`title`, `description`, `short_description`, `author`, `note`), retrieved from the registry `ConnectorSource.metadata` (joined by data source). Shown on the connector detail page.
11963
+ */
11964
+ metadata?: Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata;
11953
11965
  /**
11954
11966
  * The name of the collection. It should be collection resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector.
11955
11967
  */
@@ -12187,7 +12199,7 @@ export namespace discoveryengine_v1alpha {
12187
12199
  */
12188
12200
  enableVisualContentSummary?: boolean | null;
12189
12201
  /**
12190
- * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
12202
+ * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `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`
12191
12203
  */
12192
12204
  features?: {[key: string]: string} | null;
12193
12205
  /**
@@ -13611,7 +13623,7 @@ export namespace discoveryengine_v1alpha {
13611
13623
  */
13612
13624
  displayName?: string | null;
13613
13625
  /**
13614
- * 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` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
13626
+ * 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` * `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`
13615
13627
  */
13616
13628
  features?: {[key: string]: string} | null;
13617
13629
  /**
@@ -16181,13 +16193,9 @@ export namespace discoveryengine_v1alpha {
16181
16193
  vpcscEnabled?: boolean | null;
16182
16194
  }
16183
16195
  /**
16184
- * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
16196
+ * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).
16185
16197
  */
16186
16198
  export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata {
16187
- /**
16188
- * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.
16189
- */
16190
- authenticatedAccount?: string | null;
16191
16199
  /**
16192
16200
  * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).
16193
16201
  */
@@ -16907,7 +16915,7 @@ export namespace discoveryengine_v1alpha {
16907
16915
  */
16908
16916
  displayName?: string | null;
16909
16917
  /**
16910
- * 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` * `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` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
16918
+ * 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` * `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`
16911
16919
  */
16912
16920
  features?: {[key: string]: string} | null;
16913
16921
  /**
@@ -21476,6 +21484,165 @@ export namespace discoveryengine_v1alpha {
21476
21484
  }
21477
21485
  }
21478
21486
 
21487
+ /**
21488
+ * Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.
21489
+ * @example
21490
+ * ```js
21491
+ * // Before running the sample:
21492
+ * // - Enable the API at:
21493
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
21494
+ * // - Login into gcloud by running:
21495
+ * // ```sh
21496
+ * // $ gcloud auth application-default login
21497
+ * // ```
21498
+ * // - Install the npm module by running:
21499
+ * // ```sh
21500
+ * // $ npm install googleapis
21501
+ * // ```
21502
+ *
21503
+ * const {google} = require('googleapis');
21504
+ * const discoveryengine = google.discoveryengine('v1alpha');
21505
+ *
21506
+ * async function main() {
21507
+ * const auth = new google.auth.GoogleAuth({
21508
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
21509
+ * scopes: [
21510
+ * 'https://www.googleapis.com/auth/cloud-platform',
21511
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
21512
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
21513
+ * ],
21514
+ * });
21515
+ *
21516
+ * // Acquire an auth client, and bind it to all future calls
21517
+ * const authClient = await auth.getClient();
21518
+ * google.options({auth: authClient});
21519
+ *
21520
+ * // Do the magic
21521
+ * const res = await discoveryengine.projects.locations.provision({
21522
+ * // Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`.
21523
+ * name: 'projects/my-project/locations/my-location',
21524
+ *
21525
+ * // Request body metadata
21526
+ * requestBody: {
21527
+ * // request body parameters
21528
+ * // {
21529
+ * // "acceptDataUseTerms": false,
21530
+ * // "dataUseTermsVersion": "my_dataUseTermsVersion",
21531
+ * // "saasParams": {}
21532
+ * // }
21533
+ * },
21534
+ * });
21535
+ * console.log(res.data);
21536
+ *
21537
+ * // Example response
21538
+ * // {
21539
+ * // "done": false,
21540
+ * // "error": {},
21541
+ * // "metadata": {},
21542
+ * // "name": "my_name",
21543
+ * // "response": {}
21544
+ * // }
21545
+ * }
21546
+ *
21547
+ * main().catch(e => {
21548
+ * console.error(e);
21549
+ * throw e;
21550
+ * });
21551
+ *
21552
+ * ```
21553
+ *
21554
+ * @param params - Parameters for request
21555
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
21556
+ * @param callback - Optional callback that handles the response.
21557
+ * @returns A promise if used with async/await, or void if used with a callback.
21558
+ */
21559
+ provision(
21560
+ params: Params$Resource$Projects$Locations$Provision,
21561
+ options: StreamMethodOptions
21562
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
21563
+ provision(
21564
+ params?: Params$Resource$Projects$Locations$Provision,
21565
+ options?: MethodOptions
21566
+ ): Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>;
21567
+ provision(
21568
+ params: Params$Resource$Projects$Locations$Provision,
21569
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
21570
+ callback: BodyResponseCallback<Readable>
21571
+ ): void;
21572
+ provision(
21573
+ params: Params$Resource$Projects$Locations$Provision,
21574
+ options:
21575
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
21576
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
21577
+ ): void;
21578
+ provision(
21579
+ params: Params$Resource$Projects$Locations$Provision,
21580
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
21581
+ ): void;
21582
+ provision(
21583
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
21584
+ ): void;
21585
+ provision(
21586
+ paramsOrCallback?:
21587
+ | Params$Resource$Projects$Locations$Provision
21588
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
21589
+ | BodyResponseCallback<Readable>,
21590
+ optionsOrCallback?:
21591
+ | MethodOptions
21592
+ | StreamMethodOptions
21593
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
21594
+ | BodyResponseCallback<Readable>,
21595
+ callback?:
21596
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
21597
+ | BodyResponseCallback<Readable>
21598
+ ):
21599
+ | void
21600
+ | Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>
21601
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
21602
+ let params = (paramsOrCallback ||
21603
+ {}) as Params$Resource$Projects$Locations$Provision;
21604
+ let options = (optionsOrCallback || {}) as MethodOptions;
21605
+
21606
+ if (typeof paramsOrCallback === 'function') {
21607
+ callback = paramsOrCallback;
21608
+ params = {} as Params$Resource$Projects$Locations$Provision;
21609
+ options = {};
21610
+ }
21611
+
21612
+ if (typeof optionsOrCallback === 'function') {
21613
+ callback = optionsOrCallback;
21614
+ options = {};
21615
+ }
21616
+
21617
+ const rootUrl =
21618
+ options.rootUrl || 'https://discoveryengine.googleapis.com/';
21619
+ const parameters = {
21620
+ options: Object.assign(
21621
+ {
21622
+ url: (rootUrl + '/v1alpha/{+name}:provision').replace(
21623
+ /([^:]\/)\/+/g,
21624
+ '$1'
21625
+ ),
21626
+ method: 'POST',
21627
+ apiVersion: '',
21628
+ },
21629
+ options
21630
+ ),
21631
+ params,
21632
+ requiredParams: ['name'],
21633
+ pathParams: ['name'],
21634
+ context: this.context,
21635
+ };
21636
+ if (callback) {
21637
+ createAPIRequest<Schema$GoogleLongrunningOperation>(
21638
+ parameters,
21639
+ callback as BodyResponseCallback<unknown>
21640
+ );
21641
+ } else {
21642
+ return createAPIRequest<Schema$GoogleLongrunningOperation>(parameters);
21643
+ }
21644
+ }
21645
+
21479
21646
  /**
21480
21647
  * Queries configurable pricing usage stats for a project.
21481
21648
  * @example
@@ -22714,6 +22881,17 @@ export namespace discoveryengine_v1alpha {
22714
22881
  */
22715
22882
  requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest;
22716
22883
  }
22884
+ export interface Params$Resource$Projects$Locations$Provision extends StandardParameters {
22885
+ /**
22886
+ * Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`.
22887
+ */
22888
+ name?: string;
22889
+
22890
+ /**
22891
+ * Request body metadata
22892
+ */
22893
+ requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaProvisionProjectRequest;
22894
+ }
22717
22895
  export interface Params$Resource$Projects$Locations$Queryconfigurablepricingusagestats extends StandardParameters {
22718
22896
  /**
22719
22897
  * Required. The location to query usage stats for.