@googleapis/discoveryengine 32.1.0 → 33.0.0

package/build/v1alpha.d.ts

@@ -2711,6 +2711,12 @@ export declare namespace discoveryengine_v1alpha {
      * Referenced content and related document metadata.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReference {
+        /**
+         * Output only. Generic structured chunk metadata from upstream data source connectors.
+         */
+        chunkMetadata?: {
+            [key: string]: any;
+        } | null;
         /**
          * Chunk of code snippet from the referenced document.
          */
@@ -3845,7 +3851,7 @@ export declare namespace discoveryengine_v1alpha {
          */
         numUniqueUsersThreshold?: number | null;
         /**
-         * This field is only meaningful for suggestions generated from user events or search history. If a query shows up less than this threshold, it may indicate that the query is rarely searched and thus will not be generated as a suggestion. This is field can be helpful for preventing PII queries becoming suggestions, as those queries are usually uniquely searched. If not set, the default value is 3 used in the generation pipeline.
+         * This field is only meaningful for suggestions generated from user events or search history. If a query shows up less than this threshold, it may indicate that the query is rarely searched and thus will not be generated as a suggestion. This is field can be helpful for preventing PII queries becoming suggestions, as those queries are usually uniquely searched. If not set, the default value is 8 used in the generation pipeline.
          */
         queryFrequencyThreshold?: number | null;
         /**
@@ -7259,6 +7265,42 @@ export declare namespace discoveryengine_v1alpha {
          */
         minimum?: number | null;
     }
+    /**
+     * Request message for making a call to an MCP connector. It carries the connector name, the method to invoke, and optional parameters.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpRequest {
+        /**
+         * Optional. The engine resource name (e.g. "projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}"). Used as the search engine id when invoking tool registry tools that issue Discovery Search Service requests.
+         */
+        engine?: string | null;
+        /**
+         * Required. The method to invoke (e.g. "tools/list", "tools/call", "resources/read", "prompts/get", etc.).
+         */
+        method?: string | null;
+        /**
+         * Optional. Arbitrary structured parameters for the method. Using google.protobuf.Struct keeps the payload schema-flexible, matching JSON-RPC's free-form `params` field.
+         */
+        params?: {
+            [key: string]: any;
+        } | null;
+        /**
+         * Optional. The tool spec version to resolve the connector's tool surface against. This corresponds to the connector's BAP tool spec file name (e.g. "v2", "v5.2"). When unset, the server uses its default (latest) tool spec for the connector. Applies to all methods (e.g. "tools/list" and "tools/call").
+         */
+        toolSpecVersion?: string | null;
+    }
+    /**
+     * Response message returning the result of an MCP connector invocation. It contains either a successful result payload or error details.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpResponse {
+        /**
+         * Error details when the call fails.
+         */
+        error?: Schema$GoogleCloudDiscoveryengineV1alphaMcpError;
+        /**
+         * Successful result — arbitrary structured data.
+         */
+        result?: any | null;
+    }
     /**
      * Language info for DataStore.
      */
@@ -7801,6 +7843,23 @@ export declare namespace discoveryengine_v1alpha {
      */
     export interface Schema$GoogleCloudDiscoveryengineV1alphaManagedAgentDefinition {
     }
+    /**
+     * McpError represents error details when an MCP call fails. This structure follows the JSON-RPC 2.0 error object shape.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaMcpError {
+        /**
+         * Numeric error code.
+         */
+        code?: number | null;
+        /**
+         * Optional structured data with additional error context.
+         */
+        data?: any | null;
+        /**
+         * Short, human-readable description of the error.
+         */
+        message?: string | null;
+    }
     /**
      * Media-specific user event information.
      */
@@ -11067,6 +11126,10 @@ export declare namespace discoveryengine_v1alpha {
          * Optional. Specification of actions for the request.
          */
         actionSpec?: Schema$GoogleCloudDiscoveryengineV1alphaStreamAssistRequestActionSpec;
+        /**
+         * Optional. Specification of agents that are used to serve the request.
+         */
+        agentsSpec?: Schema$GoogleCloudDiscoveryengineV1alphaStreamAssistRequestAgentsSpec;
         /**
          * Optional. Specification of the generation configuration for the request.
          */
@@ -11097,6 +11160,24 @@ export declare namespace discoveryengine_v1alpha {
          */
         actionDisabled?: boolean | null;
     }
+    /**
+     * Specification of agents that are used to serve the request.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaStreamAssistRequestAgentsSpec {
+        /**
+         * Optional. Specification of agents that are used to serve the request.
+         */
+        agentSpecs?: Schema$GoogleCloudDiscoveryengineV1alphaStreamAssistRequestAgentsSpecAgentSpec[];
+    }
+    /**
+     * Specification of an agent.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaStreamAssistRequestAgentsSpecAgentSpec {
+        /**
+         * 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.
+         */
+        agentId?: string | null;
+    }
     /**
      * Assistant generation specification for the request. This allows to override the default generation configuration at the engine level.
      */
@@ -12029,7 +12110,7 @@ export declare namespace discoveryengine_v1alpha {
          */
         id?: string | null;
         /**
-         * 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`.
+         * 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.
          */
         isFirstParty?: boolean | null;
         /**
@@ -12409,6 +12490,10 @@ export declare namespace discoveryengine_v1alpha {
          * Output only. Unique identifier of the model (e.g. `gemini-2.5-flash`, `gemini-3.1-pro-preview`). This is the same identifier that clients pass back to the assistant service to select this model. Virtual / "pseudo" models (e.g. `gemini-fast`) are also valid values here; they are resolved to the underlying concrete model on the backend.
          */
         modelId?: string | null;
+        /**
+         * Output only. Whether this model should be promoted in the GE chat homepage banner.
+         */
+        promoted?: boolean | null;
     }
     /**
      * Admin-surface metadata. Populated only when the request originates from the Cloud Console admin "Feature Control" page; left unset for end-user surfaces (Web, Mobile). Lets the admin page render its toggle table directly from the backend instead of a hardcoded client-side registry.
@@ -22305,6 +22390,77 @@ export declare namespace discoveryengine_v1alpha {
         getDataConnector(params: Params$Resource$Projects$Locations$Collections$Getdataconnector, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDataConnector>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDataConnector>): void;
         getDataConnector(params: Params$Resource$Projects$Locations$Collections$Getdataconnector, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDataConnector>): void;
         getDataConnector(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDataConnector>): void;
+        /**
+         * Gets the IAM access control policy for a Collection. 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.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await discoveryengine.projects.locations.collections.getIamPolicy(
+         *     {
+         *       // 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).
+         *       'options.requestedPolicyVersion': 'placeholder-value',
+         *       // 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.
+         *       resource:
+         *         'projects/my-project/locations/my-location/collections/my-collection',
+         *     },
+         *   );
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        getIamPolicy(params?: Params$Resource$Projects$Locations$Collections$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
         /**
          * Gets a list of Collections.
          * @example
@@ -22457,6 +22613,83 @@ export declare namespace discoveryengine_v1alpha {
         patch(params: Params$Resource$Projects$Locations$Collections$Patch, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         patch(params: Params$Resource$Projects$Locations$Collections$Patch, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         patch(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        /**
+         * Sets the IAM access control policy for a Collection. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on a Collection 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.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await discoveryengine.projects.locations.collections.setIamPolicy(
+         *     {
+         *       // 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.
+         *       resource:
+         *         'projects/my-project/locations/my-location/collections/my-collection',
+         *
+         *       // Request body metadata
+         *       requestBody: {
+         *         // request body parameters
+         *         // {
+         *         //   "policy": {}
+         *         // }
+         *       },
+         *     },
+         *   );
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        setIamPolicy(params?: Params$Resource$Projects$Locations$Collections$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
         /**
          * Updates a DataConnector.
          * @example
@@ -22646,6 +22879,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         name?: string;
     }
+    export interface Params$Resource$Projects$Locations$Collections$Getiampolicy extends StandardParameters {
+        /**
+         * 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).
+         */
+        'options.requestedPolicyVersion'?: number;
+        /**
+         * 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.
+         */
+        resource?: string;
+    }
     export interface Params$Resource$Projects$Locations$Collections$List extends StandardParameters {
         /**
          * Filter returned collections by associated data connector data sources. For example: `filter = 'data_source:jira confluence'`. If the filter is empty, we return all collections under a project and location.
@@ -22678,6 +22921,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaCollection;
     }
+    export interface Params$Resource$Projects$Locations$Collections$Setiampolicy extends StandardParameters {
+        /**
+         * 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.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
+    }
     export interface Params$Resource$Projects$Locations$Collections$Updatedataconnector extends StandardParameters {
         /**
          * Identifier. The full resource name of the Data Connector. Format: `projects/x/locations/x/collections/x/dataConnector`.
@@ -22916,6 +23169,86 @@ export declare namespace discoveryengine_v1alpha {
         getConnectorSecret(params: Params$Resource$Projects$Locations$Collections$Dataconnector$Getconnectorsecret, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaGetConnectorSecretResponse>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaGetConnectorSecretResponse>): void;
         getConnectorSecret(params: Params$Resource$Projects$Locations$Collections$Dataconnector$Getconnectorsecret, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaGetConnectorSecretResponse>): void;
         getConnectorSecret(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaGetConnectorSecretResponse>): void;
+        /**
+         * Makes a call to an MCP connector.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.assist.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res =
+         *     await discoveryengine.projects.locations.collections.dataConnector.invokeConnectorMcp(
+         *       {
+         *         // Required. DataConnector resource. The data connector used for making the MCP call.
+         *         name: 'projects/my-project/locations/my-location/collections/my-collection/dataConnector',
+         *
+         *         // Request body metadata
+         *         requestBody: {
+         *           // request body parameters
+         *           // {
+         *           //   "engine": "my_engine",
+         *           //   "method": "my_method",
+         *           //   "params": {},
+         *           //   "toolSpecVersion": "my_toolSpecVersion"
+         *           // }
+         *         },
+         *       },
+         *     );
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "error": {},
+         *   //   "result": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        invokeConnectorMcp(params: Params$Resource$Projects$Locations$Collections$Dataconnector$Invokeconnectormcp, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        invokeConnectorMcp(params?: Params$Resource$Projects$Locations$Collections$Dataconnector$Invokeconnectormcp, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpResponse>>;
+        invokeConnectorMcp(params: Params$Resource$Projects$Locations$Collections$Dataconnector$Invokeconnectormcp, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        invokeConnectorMcp(params: Params$Resource$Projects$Locations$Collections$Dataconnector$Invokeconnectormcp, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpResponse>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpResponse>): void;
+        invokeConnectorMcp(params: Params$Resource$Projects$Locations$Collections$Dataconnector$Invokeconnectormcp, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpResponse>): void;
+        invokeConnectorMcp(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpResponse>): void;
         /**
          * ServeMcpDeleteRequest serves a MCP DELETE request.
          * @example
@@ -23104,6 +23437,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         name?: string;
     }
+    export interface Params$Resource$Projects$Locations$Collections$Dataconnector$Invokeconnectormcp extends StandardParameters {
+        /**
+         * Required. DataConnector resource. The data connector used for making the MCP call.
+         */
+        name?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaInvokeConnectorMcpRequest;
+    }
     export interface Params$Resource$Projects$Locations$Collections$Dataconnector$Mcp extends StandardParameters {
         /**
          *
@@ -24096,6 +24439,78 @@ export declare namespace discoveryengine_v1alpha {
         getDocumentProcessingConfig(params: Params$Resource$Projects$Locations$Collections$Datastores$Getdocumentprocessingconfig, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>): void;
         getDocumentProcessingConfig(params: Params$Resource$Projects$Locations$Collections$Datastores$Getdocumentprocessingconfig, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>): void;
         getDocumentProcessingConfig(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>): void;
+        /**
+         * 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.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res =
+         *     await discoveryengine.projects.locations.collections.dataStores.getIamPolicy(
+         *       {
+         *         // 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).
+         *         'options.requestedPolicyVersion': 'placeholder-value',
+         *         // 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.
+         *         resource:
+         *           'projects/my-project/locations/my-location/collections/my-collection/dataStores/my-dataStore',
+         *       },
+         *     );
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        getIamPolicy(params?: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
         /**
          * Gets the SiteSearchEngine.
          * @example
@@ -24527,6 +24942,84 @@ export declare namespace discoveryengine_v1alpha {
         replacePatientFilter(params: Params$Resource$Projects$Locations$Collections$Datastores$Replacepatientfilter, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         replacePatientFilter(params: Params$Resource$Projects$Locations$Collections$Datastores$Replacepatientfilter, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         replacePatientFilter(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        /**
+         * 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.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res =
+         *     await discoveryengine.projects.locations.collections.dataStores.setIamPolicy(
+         *       {
+         *         // 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.
+         *         resource:
+         *           'projects/my-project/locations/my-location/collections/my-collection/dataStores/my-dataStore',
+         *
+         *         // Request body metadata
+         *         requestBody: {
+         *           // request body parameters
+         *           // {
+         *           //   "policy": {}
+         *           // }
+         *         },
+         *       },
+         *     );
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        setIamPolicy(params?: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
         /**
          * Trains a custom model.
          * @example
@@ -24889,6 +25382,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         name?: string;
     }
+    export interface Params$Resource$Projects$Locations$Collections$Datastores$Getiampolicy extends StandardParameters {
+        /**
+         * 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).
+         */
+        'options.requestedPolicyVersion'?: number;
+        /**
+         * 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.
+         */
+        resource?: string;
+    }
     export interface Params$Resource$Projects$Locations$Collections$Datastores$Getsitesearchengine extends StandardParameters {
         /**
          * 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.
@@ -24951,6 +25454,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaReplacePatientFilterRequest;
     }
+    export interface Params$Resource$Projects$Locations$Collections$Datastores$Setiampolicy extends StandardParameters {
+        /**
+         * 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.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
+    }
     export interface Params$Resource$Projects$Locations$Collections$Datastores$Traincustommodel extends StandardParameters {
         /**
          * 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.
@@ -35195,6 +35708,7 @@ export declare namespace discoveryengine_v1alpha {
          *           // request body parameters
          *           // {
          *           //   "actionSpec": {},
+         *           //   "agentsSpec": {},
          *           //   "generationSpec": {},
          *           //   "query": {},
          *           //   "session": "my_session",
@@ -41936,6 +42450,75 @@ export declare namespace discoveryengine_v1alpha {
         getDocumentProcessingConfig(params: Params$Resource$Projects$Locations$Datastores$Getdocumentprocessingconfig, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>): void;
         getDocumentProcessingConfig(params: Params$Resource$Projects$Locations$Datastores$Getdocumentprocessingconfig, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>): void;
         getDocumentProcessingConfig(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig>): void;
+        /**
+         * 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.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await discoveryengine.projects.locations.dataStores.getIamPolicy({
+         *     // 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).
+         *     'options.requestedPolicyVersion': 'placeholder-value',
+         *     // 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.
+         *     resource:
+         *       'projects/my-project/locations/my-location/dataStores/my-dataStore',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        getIamPolicy(params?: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        getIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
         /**
          * Gets the SiteSearchEngine.
          * @example
@@ -42358,6 +42941,81 @@ export declare namespace discoveryengine_v1alpha {
         replacePatientFilter(params: Params$Resource$Projects$Locations$Datastores$Replacepatientfilter, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         replacePatientFilter(params: Params$Resource$Projects$Locations$Datastores$Replacepatientfilter, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         replacePatientFilter(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        /**
+         * 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.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const discoveryengine = google.discoveryengine('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/discoveryengine.readwrite',
+         *       'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await discoveryengine.projects.locations.dataStores.setIamPolicy({
+         *     // 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.
+         *     resource:
+         *       'projects/my-project/locations/my-location/dataStores/my-dataStore',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "policy": {}
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        setIamPolicy(params?: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        setIamPolicy(params: Params$Resource$Projects$Locations$Datastores$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
+        setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
         /**
          * Updates the CompletionConfigs.
          * @example
@@ -42635,6 +43293,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         name?: string;
     }
+    export interface Params$Resource$Projects$Locations$Datastores$Getiampolicy extends StandardParameters {
+        /**
+         * 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).
+         */
+        'options.requestedPolicyVersion'?: number;
+        /**
+         * 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.
+         */
+        resource?: string;
+    }
     export interface Params$Resource$Projects$Locations$Datastores$Getsitesearchengine extends StandardParameters {
         /**
          * 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.
@@ -42697,6 +43365,16 @@ export declare namespace discoveryengine_v1alpha {
          */
         requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaReplacePatientFilterRequest;
     }
+    export interface Params$Resource$Projects$Locations$Datastores$Setiampolicy extends StandardParameters {
+        /**
+         * 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.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
+    }
     export interface Params$Resource$Projects$Locations$Datastores$Updatecompletionconfig extends StandardParameters {
         /**
          * Required. Immutable. Fully qualified name `projects/x/locations/x/dataStores/x/completionConfig` `projects/x/locations/x/collections/x/dataStores/x/completionConfig` `projects/x/locations/x/collections/x/engines/x/completionConfig`