@googleapis/discoveryengine 37.0.0 → 37.2.0

package/v1beta.ts

@@ -1420,6 +1420,10 @@ export namespace discoveryengine_v1beta {
      * Reasons for not answering the assist call.
      */
     assistSkippedReasons?: string[] | null;
+    /**
+     * Output only. Maps an internal connector agent name (the machine identifier embedded in tool names, e.g. `custom_mcp__agent`) to the connector's human-readable display name. Populated at serving time for custom MCP / agent gateway connectors so user-facing surfaces (e.g. the tool-call chip) can show the connector name instead of its internal identifier. Empty when there are no such connectors.
+     */
+    connectorDisplayNames?: {[key: string]: string} | null;
     /**
      * Optional. The field contains information about the various policy checks' results like the banned phrases or the Model Armor checks. This field is populated only if the assist call was skipped due to a policy violation.
      */
@@ -2492,7 +2496,7 @@ export namespace discoveryengine_v1beta {
      */
     syncMode?: string | null;
     /**
-     * Optional. Immutable. User-facing, version-independent label for this connector. May be shared by multiple connectors under the same (project, location, collection, data_source); tag-based lookup returns the one with the greatest create_time. Optional at Create time. Agent Designer resolves connectors via (data_source, tag) when set, falling back to the legacy resource-name lookup when unset, so connectors created before the tag-write launch continue to work without a backfill.
+     * Optional. Immutable. User-facing, version-independent label for this connector. May be shared by multiple connectors under the same (project, location, collection, data_source); tag-based lookup returns the one with the greatest create_time. Optional at Create time. If the caller omits `tag`, the server auto-derives one from the collection_id (falling back to data_source, else a time-based `t-` sentinel). The auto-derived tag is subject to the same immutability guarantee as a caller-supplied one, so callers who care about the exact tag value should provide it explicitly rather than relying on the server default. Agent Designer resolves connectors via (data_source, tag) when set, falling back to the legacy resource-name lookup when unset, so connectors created before the tag-write launch continue to work without a backfill.
      */
     tag?: string | null;
     /**
@@ -4107,6 +4111,10 @@ export namespace discoveryengine_v1beta {
      * Optional. Whether the license config should be auto renewed when it reaches the end date.
      */
     autoRenew?: boolean | null;
+    /**
+     * Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set.
+     */
+    billingAccountLicenseConfig?: string | null;
     /**
      * Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3.
      */
@@ -4378,6 +4386,10 @@ export namespace discoveryengine_v1beta {
      * Optional. Configuration for NotebookLM settings.
      */
     notebooklmConfig?: Schema$GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig;
+    /**
+     * Optional. Resource-level access control config for Gemini Enterprise users.
+     */
+    resourceAccessControlConfig?: Schema$GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigResourceAccessControlConfig;
   }
   /**
    * Configuration for NotebookLM.
@@ -4431,6 +4443,15 @@ export namespace discoveryengine_v1beta {
      */
     userPromptTemplate?: string | null;
   }
+  /**
+   * Controls resource-level access control for Gemini Enterprise users.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigResourceAccessControlConfig {
+    /**
+     * Optional. If `true`, the data stores and data connectors shown to Gemini Enterprise users are filtered to those the user has the required resource-level `.get` IAM permission on.
+     */
+    dataStoreAccessControlEnabled?: boolean | null;
+  }
   /**
    * Metadata about the terms of service.
    */
@@ -4675,6 +4696,10 @@ export namespace discoveryengine_v1beta {
      * This field is expected to be a ui message in JSON format. As of Q1 2026, ui_json_payload is only supported for A2UI messages.
      */
     uiJsonPayload?: string | null;
+    /**
+     * Reference to a user-supplied file attached to a long-running-agent (Sobi) task. See `UserSuppliedSobiArtifactReference` above.
+     */
+    userSuppliedSobiArtifactReference?: Schema$GoogleCloudDiscoveryengineV1alphaQueryPartUserSuppliedSobiArtifactReference;
   }
   /**
    * Represents a document reference.
@@ -4767,6 +4792,19 @@ export namespace discoveryengine_v1beta {
      */
     personId?: string | null;
   }
+  /**
+   * Reference to a user-supplied file attached to a long-running-agent (Sobi) task. Rendered by the client as an attachment chip on the user turn's bubble. The file itself is stored on the task's `AgentArtifact` list; the client resolves full metadata (source URI, size, ...) for download or preview by calling `GetTask` on the Sobi Task API and matching `AgentArtifact.name` against `file_name`. Only `file_name` and `mime_type` appear on this wire deliberately: the backing `gs://` or Drive URI is not exposed to conversation-history readers. Same variant is used for both byte-uploaded and Drive-picked files -- "user attached a file" is one concept regardless of source.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaQueryPartUserSuppliedSobiArtifactReference {
+    /**
+     * Required. Client-supplied filename. Unique per task within the user-supplied artifact set (UI dedupes before upload). Doubles as the artifact identifier used to look up the artifact on `Task.artifacts`. The `_name` suffix is deliberate and the AIP-122 lint is suppressed: this field is not a resource name (which is what AIP-122 reserves the bare `name` for). It is the literal filename, and it serves as the join key against `AgentArtifact.name` on the backing Sobi task -- a structural role that `title` or `display_name` would not communicate to a client picking what to send. The internal mirror (`cloud/ml/discoveryengine/schema/assistant.proto`) uses the same field name so the round-trip converter stays name-for-name.
+     */
+    fileName?: string | null;
+    /**
+     * Optional. IANA MIME type. Used for icon/preview rendering.
+     */
+    mimeType?: string | null;
+  }
   /**
    * Metadata related to the progress of the SiteSearchEngineService.RecrawlUris operation. This will be returned by the google.longrunning.Operation.metadata field.
    */
@@ -5648,6 +5686,27 @@ export namespace discoveryengine_v1beta {
      * The condition under which search as you type should occur. Default to Condition.DISABLED.
      */
     condition?: string | null;
+    /**
+     * Optional. The list of fields to be used for Search As You Type scoring.
+     */
+    fields?: Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpecField[];
+    /**
+     * Optional. Search As You Type score threshold for filtering purpose. We keep the result if `score` \>= `score_threshold`.
+     */
+    scoreThreshold?: number | null;
+  }
+  /**
+   * A schema field to be used for Search As You Type scoring on this request. Overrides any data-store-level Search As You Type field configuration for the duration of the request.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpecField {
+    /**
+     * Required. A field key that has been indexed for Search As You Type.
+     */
+    key?: string | null;
+    /**
+     * Optional. Weight for scores from this field. Defaults to 1.0 if not specified.
+     */
+    weight?: number | null;
   }
   /**
    * Session specification.
@@ -7623,6 +7682,10 @@ export namespace discoveryengine_v1beta {
      * Reasons for not answering the assist call.
      */
     assistSkippedReasons?: string[] | null;
+    /**
+     * Output only. Maps an internal connector agent name (the machine identifier embedded in tool names, e.g. `custom_mcp__agent`) to the connector's human-readable display name. Populated at serving time for custom MCP / agent gateway connectors so user-facing surfaces (e.g. the tool-call chip) can show the connector name instead of its internal identifier. Empty when there are no such connectors.
+     */
+    connectorDisplayNames?: {[key: string]: string} | null;
     /**
      * Optional. The field contains information about the various policy checks' results like the banned phrases or the Model Armor checks. This field is populated only if the assist call was skipped due to a policy violation.
      */
@@ -8673,7 +8736,7 @@ export namespace discoveryengine_v1beta {
      */
     selectedPosition?: number | null;
     /**
-     * End user selected CompleteQueryResponse.QuerySuggestion.suggestion.
+     * Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion.
      */
     selectedSuggestion?: string | null;
   }
@@ -11555,6 +11618,10 @@ export namespace discoveryengine_v1beta {
      * Optional. Configuration for NotebookLM settings.
      */
     notebooklmConfig?: Schema$GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig;
+    /**
+     * Optional. Resource-level access control config for Gemini Enterprise users.
+     */
+    resourceAccessControlConfig?: Schema$GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigResourceAccessControlConfig;
   }
   /**
    * Configuration for NotebookLM.
@@ -11608,6 +11675,15 @@ export namespace discoveryengine_v1beta {
      */
     userPromptTemplate?: string | null;
   }
+  /**
+   * Controls resource-level access control for Gemini Enterprise users.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigResourceAccessControlConfig {
+    /**
+     * Optional. If `true`, the data stores and data connectors shown to Gemini Enterprise users are filtered to those the user has the required resource-level `.get` IAM permission on.
+     */
+    dataStoreAccessControlEnabled?: boolean | null;
+  }
   /**
    * Metadata about the terms of service.
    */
@@ -12278,7 +12354,7 @@ export namespace discoveryengine_v1beta {
      */
     orderBy?: string | null;
     /**
-     * The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.
+     * Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.
      */
     searchQuery?: string | null;
   }
@@ -12948,6 +13024,27 @@ export namespace discoveryengine_v1beta {
      * The condition under which search as you type should occur. Default to Condition.DISABLED.
      */
     condition?: string | null;
+    /**
+     * Optional. The list of fields to be used for Search As You Type scoring.
+     */
+    fields?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpecField[];
+    /**
+     * Optional. Search As You Type score threshold for filtering purpose. We keep the result if `score` \>= `score_threshold`.
+     */
+    scoreThreshold?: number | null;
+  }
+  /**
+   * A schema field to be used for Search As You Type scoring on this request. Overrides any data-store-level Search As You Type field configuration for the duration of the request.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpecField {
+    /**
+     * Required. A field key that has been indexed for Search As You Type.
+     */
+    key?: string | null;
+    /**
+     * Optional. Weight for scores from this field. Defaults to 1.0 if not specified.
+     */
+    weight?: number | null;
   }
   /**
    * Session specification.
@@ -14304,7 +14401,7 @@ export namespace discoveryengine_v1beta {
    */
   export interface Schema$GoogleCloudDiscoveryengineV1betaUserEvent {
     /**
-     * Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
+     * Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
      */
     attributes?: {
       [key: string]: Schema$GoogleCloudDiscoveryengineV1betaCustomAttribute;
@@ -15023,7 +15120,7 @@ export namespace discoveryengine_v1beta {
      */
     syncMode?: string | null;
     /**
-     * Optional. Immutable. User-facing, version-independent label for this connector. May be shared by multiple connectors under the same (project, location, collection, data_source); tag-based lookup returns the one with the greatest create_time. Optional at Create time. Agent Designer resolves connectors via (data_source, tag) when set, falling back to the legacy resource-name lookup when unset, so connectors created before the tag-write launch continue to work without a backfill.
+     * Optional. Immutable. User-facing, version-independent label for this connector. May be shared by multiple connectors under the same (project, location, collection, data_source); tag-based lookup returns the one with the greatest create_time. Optional at Create time. If the caller omits `tag`, the server auto-derives one from the collection_id (falling back to data_source, else a time-based `t-` sentinel). The auto-derived tag is subject to the same immutability guarantee as a caller-supplied one, so callers who care about the exact tag value should provide it explicitly rather than relying on the server default. Agent Designer resolves connectors via (data_source, tag) when set, falling back to the legacy resource-name lookup when unset, so connectors created before the tag-write launch continue to work without a backfill.
      */
     tag?: string | null;
     /**
@@ -16435,6 +16532,10 @@ export namespace discoveryengine_v1beta {
      * Optional. Configuration for NotebookLM settings.
      */
     notebooklmConfig?: Schema$GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig;
+    /**
+     * Optional. Resource-level access control config for Gemini Enterprise users.
+     */
+    resourceAccessControlConfig?: Schema$GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigResourceAccessControlConfig;
   }
   /**
    * Configuration for NotebookLM.
@@ -16488,6 +16589,15 @@ export namespace discoveryengine_v1beta {
      */
     userPromptTemplate?: string | null;
   }
+  /**
+   * Controls resource-level access control for Gemini Enterprise users.
+   */
+  export interface Schema$GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigResourceAccessControlConfig {
+    /**
+     * Optional. If `true`, the data stores and data connectors shown to Gemini Enterprise users are filtered to those the user has the required resource-level `.get` IAM permission on.
+     */
+    dataStoreAccessControlEnabled?: boolean | null;
+  }
   /**
    * Metadata about the terms of service.
    */