@googleapis/discoveryengine 32.0.0 → 32.1.0

package/build/v1.d.ts

@@ -2322,6 +2322,10 @@ export declare namespace discoveryengine_v1 {
          * Final verdict of the customer policy enforcement. If only one policy blocked the processing, the verdict is BLOCK.
          */
         verdict?: string | null;
+        /**
+         * Output only. The source of the violation.
+         */
+        violationSource?: string | null;
     }
     /**
      * Customer policy enforcement result for the banned phrase policy.
@@ -4217,7 +4221,7 @@ export declare namespace discoveryengine_v1 {
          */
         displayName?: string | null;
         /**
-         * 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`
+         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
          */
         features?: {
             [key: string]: string;
@@ -7930,6 +7934,10 @@ export declare namespace discoveryengine_v1 {
          * Final verdict of the customer policy enforcement. If only one policy blocked the processing, the verdict is BLOCK.
          */
         verdict?: string | null;
+        /**
+         * Output only. The source of the violation.
+         */
+        violationSource?: string | null;
     }
     /**
      * Customer policy enforcement result for the banned phrase policy.
@@ -9464,7 +9472,7 @@ export declare namespace discoveryengine_v1 {
          */
         displayName?: string | null;
         /**
-         * 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`
+         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
          */
         features?: {
             [key: string]: string;
@@ -13627,7 +13635,7 @@ export declare namespace discoveryengine_v1 {
          */
         displayName?: string | null;
         /**
-         * 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`
+         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
          */
         features?: {
             [key: string]: string;
@@ -15713,6 +15721,10 @@ export declare namespace discoveryengine_v1 {
          * Optional. The backend to use for the ranking expression evaluation.
          */
         rankingExpressionBackend?: string | null;
+        /**
+         * Optional. The granular relevance filtering specification. If not specified, the global `relevance_threshold` will be used for all sub-searches. If specified, this overrides the global `relevance_threshold` to use thresholds on a per sub-search basis. This feature is currently supported only for custom and site search.
+         */
+        relevanceFilterSpec?: Schema$GoogleCloudDiscoveryengineV1SearchRequestRelevanceFilterSpec;
         /**
          * Optional. The specification for returning the relevance score.
          */
@@ -16116,6 +16128,32 @@ export declare namespace discoveryengine_v1 {
          */
         pinUnexpandedResults?: boolean | null;
     }
+    /**
+     * Relevance filtering specification.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1SearchRequestRelevanceFilterSpec {
+        /**
+         * Optional. Relevance filtering threshold specification for keyword search.
+         */
+        keywordSearchThreshold?: Schema$GoogleCloudDiscoveryengineV1SearchRequestRelevanceFilterSpecRelevanceThresholdSpec;
+        /**
+         * Optional. Relevance filtering threshold specification for semantic search.
+         */
+        semanticSearchThreshold?: Schema$GoogleCloudDiscoveryengineV1SearchRequestRelevanceFilterSpecRelevanceThresholdSpec;
+    }
+    /**
+     * Specification for relevance filtering on a specific sub-search.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1SearchRequestRelevanceFilterSpecRelevanceThresholdSpec {
+        /**
+         * Pre-defined relevance threshold for the sub-search.
+         */
+        relevanceThreshold?: string | null;
+        /**
+         * Custom relevance threshold for the sub-search. The value must be in [0.0, 1.0].
+         */
+        semanticRelevanceThreshold?: number | null;
+    }
     /**
      * The specification for returning the document relevance score.
      */
@@ -16160,6 +16198,10 @@ export declare namespace discoveryengine_v1 {
      * Response message for SearchService.Search method.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1SearchResponse {
+        /**
+         * Optional. Controls applied as part of the Control service.
+         */
+        appliedControls?: string[] | null;
         /**
          * A unique search token. This should be included in the UserEvent logs resulting from this search, which enables accurate attribution of search model performance. This also helps to identify a request during the customer support scenarios.
          */
@@ -16422,6 +16464,10 @@ export declare namespace discoveryengine_v1 {
          * Optional. A set of ranking signals associated with the result.
          */
         rankSignals?: Schema$GoogleCloudDiscoveryengineV1SearchResponseSearchResultRankSignals;
+        /**
+         * Optional. A set of signals used by the relevance filter meant for use to fine-tune the relevance filter thresholds.
+         */
+        retrievalSignals?: Schema$GoogleCloudDiscoveryengineV1SearchResponseSearchResultRetrievalSignals;
     }
     /**
      * A set of ranking signals.
@@ -16481,6 +16527,19 @@ export declare namespace discoveryengine_v1 {
          */
         value?: number | null;
     }
+    /**
+     * Contains a set of signals used by the relevance filter.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1SearchResponseSearchResultRetrievalSignals {
+        /**
+         * Optional. Indicates how the result was retrieved.
+         */
+        retrievalSources?: string[] | null;
+        /**
+         * Optional. Relevance score used by the filter when semantic_relevance_threshold is set.
+         */
+        semanticRelevanceScore?: number | null;
+    }
     /**
      * Information about the session.
      */
@@ -18003,7 +18062,7 @@ export declare namespace discoveryengine_v1 {
          */
         enableVisualContentSummary?: boolean | null;
         /**
-         * 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`
+         * 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` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
          */
         features?: {
             [key: string]: string;
@@ -18125,6 +18184,10 @@ export declare namespace discoveryengine_v1 {
          * Output only. Whether the model is currently in preview. Clients should surface this via a "Preview" badge in the selector UI.
          */
         isPreview?: boolean | null;
+        /**
+         * Output only. Short label shown in the compact selector bar chip (e.g. `3.x Flash`) as opposed to the full `display_name` (`Gemini 3.x Flash`). Falls back to `display_name` when the backend registry does not specify a distinct short label.
+         */
+        label?: string | null;
         /**
          * 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.
          */
@@ -25337,6 +25400,7 @@ export declare namespace discoveryengine_v1 {
          *           //   "queryExpansionSpec": {},
          *           //   "rankingExpression": "my_rankingExpression",
          *           //   "rankingExpressionBackend": "my_rankingExpressionBackend",
+         *           //   "relevanceFilterSpec": {},
          *           //   "relevanceScoreSpec": {},
          *           //   "relevanceThreshold": "my_relevanceThreshold",
          *           //   "safeSearch": false,
@@ -25355,6 +25419,7 @@ export declare namespace discoveryengine_v1 {
          *
          *   // Example response
          *   // {
+         *   //   "appliedControls": [],
          *   //   "attributionToken": "my_attributionToken",
          *   //   "correctedQuery": "my_correctedQuery",
          *   //   "facets": [],
@@ -25461,6 +25526,7 @@ export declare namespace discoveryengine_v1 {
          *           //   "queryExpansionSpec": {},
          *           //   "rankingExpression": "my_rankingExpression",
          *           //   "rankingExpressionBackend": "my_rankingExpressionBackend",
+         *           //   "relevanceFilterSpec": {},
          *           //   "relevanceScoreSpec": {},
          *           //   "relevanceThreshold": "my_relevanceThreshold",
          *           //   "safeSearch": false,
@@ -25479,6 +25545,7 @@ export declare namespace discoveryengine_v1 {
          *
          *   // Example response
          *   // {
+         *   //   "appliedControls": [],
          *   //   "attributionToken": "my_attributionToken",
          *   //   "correctedQuery": "my_correctedQuery",
          *   //   "facets": [],
@@ -33143,6 +33210,7 @@ export declare namespace discoveryengine_v1 {
          *           //   "queryExpansionSpec": {},
          *           //   "rankingExpression": "my_rankingExpression",
          *           //   "rankingExpressionBackend": "my_rankingExpressionBackend",
+         *           //   "relevanceFilterSpec": {},
          *           //   "relevanceScoreSpec": {},
          *           //   "relevanceThreshold": "my_relevanceThreshold",
          *           //   "safeSearch": false,
@@ -33161,6 +33229,7 @@ export declare namespace discoveryengine_v1 {
          *
          *   // Example response
          *   // {
+         *   //   "appliedControls": [],
          *   //   "attributionToken": "my_attributionToken",
          *   //   "correctedQuery": "my_correctedQuery",
          *   //   "facets": [],
@@ -33267,6 +33336,7 @@ export declare namespace discoveryengine_v1 {
          *           //   "queryExpansionSpec": {},
          *           //   "rankingExpression": "my_rankingExpression",
          *           //   "rankingExpressionBackend": "my_rankingExpressionBackend",
+         *           //   "relevanceFilterSpec": {},
          *           //   "relevanceScoreSpec": {},
          *           //   "relevanceThreshold": "my_relevanceThreshold",
          *           //   "safeSearch": false,
@@ -33285,6 +33355,7 @@ export declare namespace discoveryengine_v1 {
          *
          *   // Example response
          *   // {
+         *   //   "appliedControls": [],
          *   //   "attributionToken": "my_attributionToken",
          *   //   "correctedQuery": "my_correctedQuery",
          *   //   "facets": [],
@@ -39063,6 +39134,7 @@ export declare namespace discoveryengine_v1 {
          *         //   "queryExpansionSpec": {},
          *         //   "rankingExpression": "my_rankingExpression",
          *         //   "rankingExpressionBackend": "my_rankingExpressionBackend",
+         *         //   "relevanceFilterSpec": {},
          *         //   "relevanceScoreSpec": {},
          *         //   "relevanceThreshold": "my_relevanceThreshold",
          *         //   "safeSearch": false,
@@ -39080,6 +39152,7 @@ export declare namespace discoveryengine_v1 {
          *
          *   // Example response
          *   // {
+         *   //   "appliedControls": [],
          *   //   "attributionToken": "my_attributionToken",
          *   //   "correctedQuery": "my_correctedQuery",
          *   //   "facets": [],
@@ -39186,6 +39259,7 @@ export declare namespace discoveryengine_v1 {
          *           //   "queryExpansionSpec": {},
          *           //   "rankingExpression": "my_rankingExpression",
          *           //   "rankingExpressionBackend": "my_rankingExpressionBackend",
+         *           //   "relevanceFilterSpec": {},
          *           //   "relevanceScoreSpec": {},
          *           //   "relevanceThreshold": "my_relevanceThreshold",
          *           //   "safeSearch": false,
@@ -39204,6 +39278,7 @@ export declare namespace discoveryengine_v1 {
          *
          *   // Example response
          *   // {
+         *   //   "appliedControls": [],
          *   //   "attributionToken": "my_attributionToken",
          *   //   "correctedQuery": "my_correctedQuery",
          *   //   "facets": [],