@googleapis/discoveryengine 29.0.0 → 31.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/v1.d.ts CHANGED
@@ -1594,6 +1594,283 @@ export declare namespace discoveryengine_v1 {
1594
1594
  [key: string]: string;
1595
1595
  } | null;
1596
1596
  }
1597
+ /**
1598
+ * Evaluation insights for a program.
1599
+ */
1600
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsights {
1601
+ /**
1602
+ * Optional. List of evaluation insights.
1603
+ */
1604
+ insights?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsightsAlphaEvolveEvaluationInsight[];
1605
+ }
1606
+ /**
1607
+ * A single evaluation insight.
1608
+ */
1609
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsightsAlphaEvolveEvaluationInsight {
1610
+ /**
1611
+ * Optional. Label of the insight.
1612
+ */
1613
+ label?: string | null;
1614
+ /**
1615
+ * Optional. Text of the insight.
1616
+ */
1617
+ text?: string | null;
1618
+ }
1619
+ /**
1620
+ * Contains the evaluation scores for the target metrics to optimize.
1621
+ */
1622
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScores {
1623
+ /**
1624
+ * Required. List of evaluation scores.
1625
+ */
1626
+ scores?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScoresAlphaEvolveEvaluationScore[];
1627
+ }
1628
+ /**
1629
+ * Score for a single metric.
1630
+ */
1631
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScoresAlphaEvolveEvaluationScore {
1632
+ /**
1633
+ * Required. Name of the metric.
1634
+ */
1635
+ metric?: string | null;
1636
+ /**
1637
+ * Required. Score of a program for this metric.
1638
+ */
1639
+ score?: number | null;
1640
+ }
1641
+ /**
1642
+ * An experiment is a single run of the AlphaEvolve agent, an evolutionary coding agent powered by LLM for algorithm discovery and optimization.
1643
+ */
1644
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperiment {
1645
+ /**
1646
+ * Required. Experiment configuration.
1647
+ */
1648
+ config?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfig;
1649
+ /**
1650
+ * Output only. Time when the experiment was created.
1651
+ */
1652
+ createTime?: string | null;
1653
+ /**
1654
+ * Output only. Specifies the name of the seed program used to start the experiment.
1655
+ */
1656
+ initialAlphaEvolveProgram?: string | null;
1657
+ /**
1658
+ * Identifier. The full resource name of the experiment. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}`
1659
+ */
1660
+ name?: string | null;
1661
+ /**
1662
+ * Output only. The state of the experiment.
1663
+ */
1664
+ state?: string | null;
1665
+ /**
1666
+ * Output only. Experiment stats.
1667
+ */
1668
+ stats?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentStats;
1669
+ }
1670
+ /**
1671
+ * Configuration of an experiment.
1672
+ */
1673
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfig {
1674
+ /**
1675
+ * Optional. Evolution settings for the experiment.
1676
+ */
1677
+ evolutionSettings?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettings;
1678
+ /**
1679
+ * Optional. Generation settings for the experiment, controlling how new program candidates are generated, including things LLM parameters and user-provided context and prompts.
1680
+ */
1681
+ generationSettings?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettings;
1682
+ /**
1683
+ * Required. Description of the problem to be solved by the experiment.
1684
+ */
1685
+ problemDescription?: string | null;
1686
+ /**
1687
+ * Required. Primary programming language of the code being optimized.
1688
+ */
1689
+ programLanguage?: string | null;
1690
+ /**
1691
+ * Required. Run settings for the experiment, controlling the overall behavior of the experiment run.
1692
+ */
1693
+ runSettings?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigRunSettings;
1694
+ /**
1695
+ * Required. Title of the experiment.
1696
+ */
1697
+ title?: string | null;
1698
+ }
1699
+ /**
1700
+ * Evolution settings for the experiment.
1701
+ */
1702
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettings {
1703
+ /**
1704
+ * Optional. Parent sampling configuration.
1705
+ */
1706
+ parentSamplingConfig?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfig;
1707
+ }
1708
+ /**
1709
+ * Configuration for parent sampling.
1710
+ */
1711
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfig {
1712
+ /**
1713
+ * Optional. Pareto sampling configuration.
1714
+ */
1715
+ paretoSamplingConfig?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfigParetoSamplingConfig;
1716
+ }
1717
+ /**
1718
+ * Configuration for Pareto sampling.
1719
+ */
1720
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfigParetoSamplingConfig {
1721
+ /**
1722
+ * Optional. Probability [0.0, 1.0] of sampling parent programs from the Pareto frontier instead of normal fitness-based sampling during candidate generation. Useful when optimizing multiple metrics simultaneously. Default 0.0 (disabled). Only effective when evaluation returns multiple metrics in scores_to_optimize.
1723
+ */
1724
+ paretoSamplingProbability?: number | null;
1725
+ }
1726
+ /**
1727
+ * Generation settings for the experiment.
1728
+ */
1729
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettings {
1730
+ /**
1731
+ * Optional. Additional user-provided context to be used during generation.
1732
+ */
1733
+ context?: string | null;
1734
+ /**
1735
+ * Optional. When true, the LLM prompt includes the full program text (both mutable EVOLVE-BLOCK regions and immutable boilerplate). When false (default), only the mutable EVOLVE-BLOCK regions are shown, saving context window.
1736
+ */
1737
+ includeFullProgramInPrompt?: boolean | null;
1738
+ /**
1739
+ * Optional. Per-model configuration. See `ModelConfig` for details. If left unset, the server selects a default model.
1740
+ */
1741
+ models?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettingsModelConfig[];
1742
+ }
1743
+ /**
1744
+ * Per-model configuration. Mutually exclusive with `model_mixture` and `model`: when `models` is set, both `model_mixture` and `model` must be left unset. The same allowed-model list and at-most-2-models rule as for `model_mixture` apply. In addition, each entry may specify a per-model `temperature` for LLM sampling. Unlike `model_mixture`, weights here are *relative*: only their ratios matter (the server normalizes them), so callers may use any positive numbers without having to ensure they sum to 1.0.
1745
+ */
1746
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettingsModelConfig {
1747
+ /**
1748
+ * Required. Model name (e.g. `gemini-2.5-flash`, `gemini-3.1-pro-preview`). See `model_mixture` for the list of allowed models.
1749
+ */
1750
+ name?: string | null;
1751
+ /**
1752
+ * Optional. Relative weight for this model in the mixture. Must be a finite, strictly positive value. Weights across all entries are normalized server-side, so they need not sum to 1.0. Defaults to 1.0 when unset, which is convenient when configuring a single model or an even mixture. Some Pro-tier models are capped at most 50% of the total weight; requests violating that cap are rejected with INVALID_ARGUMENT.
1753
+ */
1754
+ weight?: number | null;
1755
+ }
1756
+ /**
1757
+ * Run settings for the experiment.
1758
+ */
1759
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigRunSettings {
1760
+ /**
1761
+ * Required. Maximum number of programs that can be generated in parallel. Must be positive.
1762
+ */
1763
+ concurrency?: number | null;
1764
+ /**
1765
+ * Optional. Maximum duration of the experiment. If unset, defaults to 24 hours.
1766
+ */
1767
+ maxDuration?: string | null;
1768
+ /**
1769
+ * Required. Maximum number of programs to generate during the experiment run. The initial program counts towards this limit. Must be greater than 1.
1770
+ */
1771
+ maxPrograms?: number | null;
1772
+ }
1773
+ /**
1774
+ * Stats about the experiment.
1775
+ */
1776
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentStats {
1777
+ /**
1778
+ * Output only. Number of candidates generated.
1779
+ */
1780
+ candidatesCount?: number | null;
1781
+ /**
1782
+ * Output only. Number of candidates evaluated.
1783
+ */
1784
+ evaluatedCandidatesCount?: number | null;
1785
+ /**
1786
+ * Output only. Number of billed input tokens consumed by the experiment.
1787
+ */
1788
+ inputTokenCount?: string | null;
1789
+ /**
1790
+ * Output only. Number of billed output tokens consumed by the experiment.
1791
+ */
1792
+ outputTokenCount?: string | null;
1793
+ }
1794
+ /**
1795
+ * Represents a single program to be used within the context of an AlphaEvolve experiment.
1796
+ */
1797
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgram {
1798
+ /**
1799
+ * Optional. Content of the program.
1800
+ */
1801
+ content?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramContent;
1802
+ /**
1803
+ * Output only. Time when the program was created.
1804
+ */
1805
+ createTime?: string | null;
1806
+ /**
1807
+ * Optional. Evaluation results for the program.
1808
+ */
1809
+ evaluation?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramEvaluation;
1810
+ /**
1811
+ * Optional. Lock token for the program.
1812
+ */
1813
+ lockToken?: string | null;
1814
+ /**
1815
+ * Identifier. Unique identifier for the program. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}/alphaEvolvePrograms/{alpha_evolve_program\}`
1816
+ */
1817
+ name?: string | null;
1818
+ /**
1819
+ * Output only. Optionally specifies which parent programs this program was evolved from. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}/alphaEvolvePrograms/{alpha_evolve_program\}`
1820
+ */
1821
+ parentPrograms?: string[] | null;
1822
+ /**
1823
+ * Output only. State of the program.
1824
+ */
1825
+ state?: string | null;
1826
+ }
1827
+ /**
1828
+ * A self-contained message containing the content of a program. Can represent a collection of files.
1829
+ */
1830
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramContent {
1831
+ /**
1832
+ * Optional. Description of the program.
1833
+ */
1834
+ description?: string | null;
1835
+ /**
1836
+ * Required. A list of source files that make up the overall program.
1837
+ */
1838
+ files?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveSourceFile[];
1839
+ }
1840
+ /**
1841
+ * Evaluation results for a program candidate.
1842
+ */
1843
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramEvaluation {
1844
+ /**
1845
+ * Optional. Represents various insights about the candidate, which are not directly used as optimization target, but that can be used to improve subsequent generations, and as such can be used to construct the evolution prompt.
1846
+ */
1847
+ insights?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsights;
1848
+ /**
1849
+ * Optional. Contains the evaluation scores for the target metrics to optimize.
1850
+ */
1851
+ scores?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScores;
1852
+ }
1853
+ /**
1854
+ * A single source file with its path, content and metadata.
1855
+ */
1856
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveSourceFile {
1857
+ /**
1858
+ * Required. The raw content of the file. This is a string and not bytes, because it should be ultimately processed by the LLM as text.
1859
+ */
1860
+ content?: string | null;
1861
+ /**
1862
+ * Optional. Additional description of the file.
1863
+ */
1864
+ description?: string | null;
1865
+ /**
1866
+ * Required. The relative path of the file, including the filename. e.g., "src/main.py", "utils/helpers.js", "README.md"
1867
+ */
1868
+ path?: string | null;
1869
+ /**
1870
+ * Optional. The programming language of the file.
1871
+ */
1872
+ programLanguage?: string | null;
1873
+ }
1597
1874
  /**
1598
1875
  * Defines an answer.
1599
1876
  */
@@ -2310,6 +2587,25 @@ export declare namespace discoveryengine_v1 {
2310
2587
  * Required. The supported connector modes for the associated BAP connection.
2311
2588
  */
2312
2589
  supportedConnectorModes?: string[] | null;
2590
+ /**
2591
+ * Optional. Custom toolspec overrides for this connection. For Enterprise BAP connectors that support admin-curated tool definitions, this holds the (simplified) per-tool overrides. On Get, populated by the server by merging persisted overrides with live runtime tool definitions and trimming the result for UI consumption. On Update, the supplied value replaces the persisted overrides after server-side validation and merging: the `base_version` field MUST match the server's current base toolspec version (otherwise the request is rejected with a user-facing error directing the admin to re-download the latest tools first).
2592
+ */
2593
+ toolspecOverride?: Schema$GoogleCloudDiscoveryengineV1alphaBAPConfigToolspecOverride;
2594
+ }
2595
+ /**
2596
+ * Customer-facing view of the admin-curated toolspec for a BAP connection. Holds the (simplified) per-tool definitions surfaced to and editable by the admin in the Discovery Engine UI. Mirrors the shape of the backend `google.cloud.connectorexecution.v1.ToolspecOverride` message, but is intentionally kept as a separate public type so the Discovery Engine API surface can evolve independently of the fed-API surface (AIP-215). Handlers convert between the two via helpers in //cloud/ml/discoveryengine/external_service/v1main/data_connector_service/lib:bap_custom_tool_util.
2597
+ */
2598
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaBAPConfigToolspecOverride {
2599
+ /**
2600
+ * Required. Base toolspec version against which `tools` were authored. On Update, MUST match the server's current stable toolspec version for the connection; mismatch is rejected with a user-facing error directing the admin to re-download the latest tools first.
2601
+ */
2602
+ baseVersion?: string | null;
2603
+ /**
2604
+ * Required. Tool definitions (one Struct per tool) that the admin has customised on top of the base toolspec returned by the fed API. REQUIRED because it is the only user-editable field in the modify API; the request must carry at least one tool.
2605
+ */
2606
+ tools?: Array<{
2607
+ [key: string]: any;
2608
+ }> | null;
2313
2609
  }
2314
2610
  /**
2315
2611
  * Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.
@@ -2919,6 +3215,10 @@ export declare namespace discoveryengine_v1 {
2919
3215
  * Optional. The modes enabled for this connector. Default state is CONNECTOR_MODE_UNSPECIFIED.
2920
3216
  */
2921
3217
  connectorModes?: string[] | null;
3218
+ /**
3219
+ * Optional. If set, this value instead of `data_source` is used to fetch the corresponding connector source.
3220
+ */
3221
+ connectorSourceId?: string | null;
2922
3222
  /**
2923
3223
  * Output only. The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system.
2924
3224
  */
@@ -2936,7 +3236,7 @@ export declare namespace discoveryengine_v1 {
2936
3236
  */
2937
3237
  dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1alphaDataProtectionPolicy;
2938
3238
  /**
2939
- * Required. The identifier for the data source. This is a partial list of supported connectors. Please refer to the [documentation](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/introduction-to-connectors-and-data-stores) for the full list of connectors. Supported first-party connectors include: * `gcs` * `bigquery` * `gcp_fhir` * `google_mail` * `google_drive` * `google_calendar` * `google_chat` Supported third-party connectors include: Generally available (GA) connectors: * `onedrive` * `outlook` * `confluence` * `jira` * `servicenow` * `sharepoint` Preview connectors: * `asana` * `azure_active_directory` * `box` * `canva` * `confluence_server` * `custom_connector` * `docusign` * `dropbox` * `dynamics365` * `github` * `gitlab` * `hubspot` * `jira_server` * `linear` * `native_cloud_identity` * `notion` * `okta` * `pagerduty` * `peoplesoft` * `salesforce` * `shopify` * `slack` * `snowflake` * `teams` * `trello` * `workday` * `zendesk`
3239
+ * Required. The identifier for the data source. For the full, up-to-date list of supported connectors and their values, see [Connect a third-party data source](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/connect-third-party-data-source#sources-by-launch-stage).
2940
3240
  */
2941
3241
  dataSource?: string | null;
2942
3242
  /**
@@ -3003,6 +3303,10 @@ export declare namespace discoveryengine_v1 {
3003
3303
  * Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.
3004
3304
  */
3005
3305
  latestPauseTime?: string | null;
3306
+ /**
3307
+ * Optional. User-facing metadata for the connector. Populated from the connector's generated metadata / registry `ConnectorSource`.
3308
+ */
3309
+ metadata?: Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata;
3006
3310
  /**
3007
3311
  * Identifier. The full resource name of the Data Connector. Format: `projects/x/locations/x/collections/x/dataConnector`.
3008
3312
  */
@@ -3011,6 +3315,10 @@ export declare namespace discoveryengine_v1 {
3011
3315
  * Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity.
3012
3316
  */
3013
3317
  nextSyncTime?: Schema$GoogleTypeDateTime;
3318
+ /**
3319
+ * Output only. The static IP addresses used by this connector for OAuth APIs (e.g. end user authentication). These are surfaced separately from `static_ip_addresses` so that customers can apply granular firewall settings for OAuth endpoints. Only populated for connectors that have static IP enabled and are used for actions and/or federated search.
3320
+ */
3321
+ oauthStaticIpAddresses?: string[] | null;
3014
3322
  /**
3015
3323
  * Required data connector parameters in structured json format.
3016
3324
  */
@@ -3053,6 +3361,10 @@ export declare namespace discoveryengine_v1 {
3053
3361
  * The data synchronization mode supported by the data connector.
3054
3362
  */
3055
3363
  syncMode?: string | null;
3364
+ /**
3365
+ * 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.
3366
+ */
3367
+ tag?: string | null;
3056
3368
  /**
3057
3369
  * Output only. Timestamp the DataConnector was last updated.
3058
3370
  */
@@ -3062,6 +3374,35 @@ export declare namespace discoveryengine_v1 {
3062
3374
  */
3063
3375
  vpcscEnabled?: boolean | null;
3064
3376
  }
3377
+ /**
3378
+ * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
3379
+ */
3380
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata {
3381
+ /**
3382
+ * 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.
3383
+ */
3384
+ authenticatedAccount?: string | null;
3385
+ /**
3386
+ * 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).
3387
+ */
3388
+ author?: string | null;
3389
+ /**
3390
+ * Optional. Human-readable description of the connector, shown on the connector detail page. One connector has a single description.
3391
+ */
3392
+ description?: string | null;
3393
+ /**
3394
+ * Optional. Free-form, multi-line note about the connector's capabilities or a custom note that can be set for the connector.
3395
+ */
3396
+ note?: string | null;
3397
+ /**
3398
+ * Optional. Short, subtitle-length description of the connector (e.g. shown beneath the connector name in list and detail views).
3399
+ */
3400
+ shortDescription?: string | null;
3401
+ /**
3402
+ * Optional. Display title of the connector.
3403
+ */
3404
+ title?: string | null;
3405
+ }
3065
3406
  /**
3066
3407
  * Any params and credentials used specifically for EUA connectors.
3067
3408
  */
@@ -3253,6 +3594,10 @@ export declare namespace discoveryengine_v1 {
3253
3594
  * Optional. Configuration for `HEALTHCARE_FHIR` vertical.
3254
3595
  */
3255
3596
  healthcareFhirConfig?: Schema$GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig;
3597
+ /**
3598
+ * Output only. Provides the icon URI of the data store's connector source, if this is a connector-backed data store. Empty for data stores without an associated connector source. In DataStoreService.ListDataStores and DataStoreService.GetDataStore, this is only populated when DataStoreView.DATA_STORE_VIEW_FULL is requested via ListDataStoresRequest.view or GetDataStoreRequest.view respectively.
3599
+ */
3600
+ iconUri?: string | null;
3256
3601
  /**
3257
3602
  * Immutable. The fully qualified resource name of the associated IdentityMappingStore. This field can only be set for acl_enabled DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: `projects/{project\}/locations/{location\}/identityMappingStores/{identity_mapping_store\}`.
3258
3603
  */
@@ -3602,6 +3947,10 @@ export declare namespace discoveryengine_v1 {
3602
3947
  * The number of end users under the user store that were successfully deleted.
3603
3948
  */
3604
3949
  successCount?: string | null;
3950
+ /**
3951
+ * Operation last update time. If the operation is done, this is also the finish time.
3952
+ */
3953
+ updateTime?: string | null;
3605
3954
  }
3606
3955
  /**
3607
3956
  * Defines target endpoints used to connect to third-party sources.
@@ -3825,6 +4174,10 @@ export declare namespace discoveryengine_v1 {
3825
4174
  * Optional. Immutable. This the application type which this engine resource represents. NOTE: this is a new concept independ of existing industry vertical or solution type.
3826
4175
  */
3827
4176
  appType?: string | null;
4177
+ /**
4178
+ * Output only. The Agent registry containing the agents, MCP servers and tools associated with this engine. Derived server-side from the linked Agent Gateway's registry.
4179
+ */
4180
+ associatedAgentRegistry?: string | null;
3828
4181
  /**
3829
4182
  * Configurations for the Chat Engine. Only applicable if solution_type is SOLUTION_TYPE_CHAT.
3830
4183
  */
@@ -3868,7 +4221,7 @@ export declare namespace discoveryengine_v1 {
3868
4221
  */
3869
4222
  displayName?: string | null;
3870
4223
  /**
3871
- * 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` * `disable-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` * `disable-canvas-workspace` * `disable-skills`
4224
+ * 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`
3872
4225
  */
3873
4226
  features?: {
3874
4227
  [key: string]: string;
@@ -4129,7 +4482,7 @@ export declare namespace discoveryengine_v1 {
4129
4482
  */
4130
4483
  export interface Schema$GoogleCloudDiscoveryengineV1alphaEngineSearchEngineConfig {
4131
4484
  /**
4132
- * Optional. The required subscription tier of this engine. They cannot be modified after engine creation. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine.
4485
+ * Optional. The required subscription tier of this engine. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine. Web grounding feature is only available on the app if it is set as SubscriptionTier.SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT.
4133
4486
  */
4134
4487
  requiredSubscriptionTier?: string | null;
4135
4488
  /**
@@ -4294,7 +4647,7 @@ export declare namespace discoveryengine_v1 {
4294
4647
  */
4295
4648
  schemaOrgPaths?: string[] | null;
4296
4649
  /**
4297
- * Optional. Specifies the importance of the field when `searchable_option` is `SEARCHABLE_ENABLED`. If `searchable_option` is `SEARCHABLE_DISABLED`, this field is ignored. If `searchable_option` is `SEARCHABLE_ENABLED` and this is `SEARCHABLE_FIELD_IMPORTANCE_UNSPECIFIED`, it behaves as `DEFAULT_IMPORTANCE`.
4650
+ * Optional. Specifies the importance of the field when `searchable_option` is `SEARCHABLE_ENABLED`. If `searchable_option` is `SEARCHABLE_DISABLED`, this field is ignored. If `searchable_option` is `SEARCHABLE_ENABLED` and this is `SEARCHABLE_FIELD_IMPORTANCE_UNSPECIFIED`, it behaves as `DEFAULT_IMPORTANCE`. For more information, see [Weight searchable fields](https://cloud.google.com/generative-ai-app-builder/docs/configure-field-settings#weight-search).
4298
4651
  */
4299
4652
  searchableFieldImportance?: string | null;
4300
4653
  /**
@@ -4671,6 +5024,10 @@ export declare namespace discoveryengine_v1 {
4671
5024
  * Output only. Whether the license config is for Gemini bundle.
4672
5025
  */
4673
5026
  geminiBundle?: boolean | null;
5027
+ /**
5028
+ * Optional. Timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `update_time`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.).
5029
+ */
5030
+ lastUserUpdateTime?: string | null;
4674
5031
  /**
4675
5032
  * Required. Number of licenses purchased.
4676
5033
  */
@@ -4705,7 +5062,7 @@ export declare namespace discoveryengine_v1 {
4705
5062
  */
4706
5063
  filter?: string | null;
4707
5064
  /**
4708
- * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
5065
+ * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
4709
5066
  */
4710
5067
  orderBy?: string | null;
4711
5068
  /**
@@ -4846,6 +5203,10 @@ export declare namespace discoveryengine_v1 {
4846
5203
  * Represents the currently effective configurable billing parameters. These values are derived from the customer's subscription history stored internally and reflect the thresholds actively being used for billing purposes at the time of the GetProject call. This includes the start_time of the subscription and may differ from the values in `customer_provided_config` due to billing rules (e.g., scale-downs taking effect only at the start of a new month). We also include the update type to indicate the type of update performed on the configurable billing configuration in the UpdateProject operation.
4847
5204
  */
4848
5205
  export interface Schema$GoogleCloudDiscoveryengineV1alphaProjectConfigurableBillingStatus {
5206
+ /**
5207
+ * Output only. Per-model Agent Search TPM subscription status.
5208
+ */
5209
+ agentSearchTokenSubscriptionStatuses?: Schema$GoogleCloudDiscoveryengineV1alphaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus[];
4849
5210
  /**
4850
5211
  * Optional. The currently effective Indexing Core threshold. This is the threshold against which Indexing Core usage is compared for overage calculations.
4851
5212
  */
@@ -4875,6 +5236,35 @@ export declare namespace discoveryengine_v1 {
4875
5236
  */
4876
5237
  updateType?: string | null;
4877
5238
  }
5239
+ /**
5240
+ * Per-model Agent Search TPM subscription status. One entry per active `core_subscription.agent_search_token_subscriptions[*]` entry in the customer-provided config; populated by UpdateProject and GetProject. The lifecycle scalars on this message (`start_time`, `terminate_time`, `update_type`, `tpm_threshold_next_update_time`) are per (project, model_version) — siblings of the whole-relationship `start_time` / `terminate_time` / `update_type` on the enclosing ConfigurableBillingStatus, but scoped to this specific Agent Search TPM subscription instead of to the overall customer-configurable- pricing relationship. This per-instance granularity is intentional: the underlying SubV3 storage is per-(project, model_version), so each model has its own activation, termination, and deferred-update clock; surfacing that on the response gives customers the granularity they need to manage per-model commitments independently. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.
5241
+ */
5242
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus {
5243
+ /**
5244
+ * Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics.
5245
+ */
5246
+ effectiveTpmThreshold?: string | null;
5247
+ /**
5248
+ * Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
5249
+ */
5250
+ modelVersion?: string | null;
5251
+ /**
5252
+ * Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship.
5253
+ */
5254
+ startTime?: string | null;
5255
+ /**
5256
+ * Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down.
5257
+ */
5258
+ terminateTime?: string | null;
5259
+ /**
5260
+ * Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update.
5261
+ */
5262
+ tpmThresholdNextUpdateTime?: string | null;
5263
+ /**
5264
+ * Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together).
5265
+ */
5266
+ updateType?: string | null;
5267
+ }
4878
5268
  /**
4879
5269
  * Customer provided configurations.
4880
5270
  */
@@ -4980,7 +5370,7 @@ export declare namespace discoveryengine_v1 {
4980
5370
  updateTime?: string | null;
4981
5371
  }
4982
5372
  /**
4983
- * Response message for CompletionService.PurgeCompletionSuggestions method.
5373
+ * Response message for CompletionService.PurgeCompletionSuggestions method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.
4984
5374
  */
4985
5375
  export interface Schema$GoogleCloudDiscoveryengineV1alphaPurgeCompletionSuggestionsResponse {
4986
5376
  /**
@@ -5136,6 +5526,10 @@ export declare namespace discoveryengine_v1 {
5136
5526
  * Defines a user inputed query.
5137
5527
  */
5138
5528
  export interface Schema$GoogleCloudDiscoveryengineV1alphaQuery {
5529
+ /**
5530
+ * Output only. The time at which the server accepted this query.
5531
+ */
5532
+ createTime?: string | null;
5139
5533
  /**
5140
5534
  * Query content parts.
5141
5535
  */
@@ -5413,6 +5807,19 @@ export declare namespace discoveryengine_v1 {
5413
5807
  */
5414
5808
  filterGroups?: string[] | null;
5415
5809
  }
5810
+ /**
5811
+ * Metadata for AlphaEvolveService.ResumeExperiment long running operation.
5812
+ */
5813
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaResumeExperimentMetadata {
5814
+ /**
5815
+ * Output only. The time the operation was created.
5816
+ */
5817
+ createTime?: string | null;
5818
+ /**
5819
+ * Output only. The time the operation was last updated.
5820
+ */
5821
+ updateTime?: string | null;
5822
+ }
5416
5823
  /**
5417
5824
  * Safety rating corresponding to the generated content.
5418
5825
  */
@@ -5609,7 +6016,7 @@ export declare namespace discoveryengine_v1 {
5609
6016
  */
5610
6017
  queryExpansionSpec?: Schema$GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec;
5611
6018
  /**
5612
- * Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function \}; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double \> 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result
6019
+ * Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function \}; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double \> 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result * `media_actor_match`: whether the media actor matches the query * `media_director_match`: whether the media director matches the query * `media_genre_match`: whether the media genre matches the query * `media_language_match`: whether the media language matches the query * `media_title_match`: whether the media title matches the query * `media_prefix_similarity_rank`: prefix similarity rank for media results * `media_semantic_similarity_rank`: semantic similarity rank for media results
5613
6020
  */
5614
6021
  rankingExpression?: string | null;
5615
6022
  /**
@@ -6190,6 +6597,10 @@ export declare namespace discoveryengine_v1 {
6190
6597
  * Immutable. Fully qualified name `projects/{project\}/locations/global/collections/{collection\}/engines/{engine\}/sessions/x`
6191
6598
  */
6192
6599
  name?: string | null;
6600
+ /**
6601
+ * Output only. Full resource name of an in-progress AsyncAssist operation for this session, e.g. `projects/x/locations/x/collections/x/engines/x/sessions/x/operations/x`. Set when the operation starts and cleared when it finishes.
6602
+ */
6603
+ pendingAsyncAssistOperationId?: string | null;
6193
6604
  /**
6194
6605
  * Output only. The time the session started.
6195
6606
  */
@@ -6326,6 +6737,28 @@ export declare namespace discoveryengine_v1 {
6326
6737
  */
6327
6738
  verifyTime?: string | null;
6328
6739
  }
6740
+ /**
6741
+ * Metadata for AlphaEvolveService.StartExperiment long running operation.
6742
+ */
6743
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaStartExperimentMetadata {
6744
+ /**
6745
+ * Output only. The time the operation was created.
6746
+ */
6747
+ createTime?: string | null;
6748
+ /**
6749
+ * Output only. The time the operation was last updated.
6750
+ */
6751
+ updateTime?: string | null;
6752
+ }
6753
+ /**
6754
+ * Request message for AlphaEvolveService.StartExperiment.
6755
+ */
6756
+ export interface Schema$GoogleCloudDiscoveryengineV1alphaStartExperimentRequest {
6757
+ /**
6758
+ * Required. Experiment to start. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}`
6759
+ */
6760
+ name?: string | null;
6761
+ }
6329
6762
  /**
6330
6763
  * A target site for the SiteSearchEngine.
6331
6764
  */
@@ -6547,11 +6980,11 @@ export declare namespace discoveryengine_v1 {
6547
6980
  userId?: string | null;
6548
6981
  }
6549
6982
  /**
6550
- * Precise location info with multiple representation options. Currently only latitude and longitude point is supported.
6983
+ * Precise location info with multiple representation options.
6551
6984
  */
6552
6985
  export interface Schema$GoogleCloudDiscoveryengineV1alphaUserInfoPreciseLocation {
6553
6986
  /**
6554
- * Optional. Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
6987
+ * Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
6555
6988
  */
6556
6989
  address?: string | null;
6557
6990
  /**
@@ -6597,7 +7030,7 @@ export declare namespace discoveryengine_v1 {
6597
7030
  */
6598
7031
  export interface Schema$GoogleCloudDiscoveryengineV1alphaWorkspaceConfig {
6599
7032
  /**
6600
- * Obfuscated Dasher customer ID.
7033
+ * Output only. Obfuscated Dasher customer ID. Derived by the server from the project's GCP organization at data store creation time; any value supplied in the request payload is ignored.
6601
7034
  */
6602
7035
  dasherCustomerId?: string | null;
6603
7036
  /**
@@ -7921,6 +8354,25 @@ export declare namespace discoveryengine_v1 {
7921
8354
  * Required. The supported connector modes for the associated BAP connection.
7922
8355
  */
7923
8356
  supportedConnectorModes?: string[] | null;
8357
+ /**
8358
+ * Optional. Custom toolspec overrides for this connection. For Enterprise BAP connectors that support admin-curated tool definitions, this holds the (simplified) per-tool overrides. On Get, populated by the server by merging persisted overrides with live runtime tool definitions and trimming the result for UI consumption. On Update, the supplied value replaces the persisted overrides after server-side validation and merging: the `base_version` field MUST match the server's current base toolspec version (otherwise the request is rejected with a user-facing error directing the admin to re-download the latest tools first).
8359
+ */
8360
+ toolspecOverride?: Schema$GoogleCloudDiscoveryengineV1BAPConfigToolspecOverride;
8361
+ }
8362
+ /**
8363
+ * Customer-facing view of the admin-curated toolspec for a BAP connection. Holds the (simplified) per-tool definitions surfaced to and editable by the admin in the Discovery Engine UI. Mirrors the shape of the backend `google.cloud.connectorexecution.v1.ToolspecOverride` message, but is intentionally kept as a separate public type so the Discovery Engine API surface can evolve independently of the fed-API surface (AIP-215). Handlers convert between the two via helpers in //cloud/ml/discoveryengine/external_service/v1main/data_connector_service/lib:bap_custom_tool_util.
8364
+ */
8365
+ export interface Schema$GoogleCloudDiscoveryengineV1BAPConfigToolspecOverride {
8366
+ /**
8367
+ * Required. Base toolspec version against which `tools` were authored. On Update, MUST match the server's current stable toolspec version for the connection; mismatch is rejected with a user-facing error directing the admin to re-download the latest tools first.
8368
+ */
8369
+ baseVersion?: string | null;
8370
+ /**
8371
+ * Required. Tool definitions (one Struct per tool) that the admin has customised on top of the base toolspec returned by the fed API. REQUIRED because it is the only user-editable field in the modify API; the request must carry at least one tool.
8372
+ */
8373
+ tools?: Array<{
8374
+ [key: string]: any;
8375
+ }> | null;
7924
8376
  }
7925
8377
  /**
7926
8378
  * Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.
@@ -8969,6 +9421,10 @@ export declare namespace discoveryengine_v1 {
8969
9421
  * Optional. Immutable. This the application type which this engine resource represents. NOTE: this is a new concept independ of existing industry vertical or solution type.
8970
9422
  */
8971
9423
  appType?: string | null;
9424
+ /**
9425
+ * Output only. The Agent registry containing the agents, MCP servers and tools associated with this engine. Derived server-side from the linked Agent Gateway's registry.
9426
+ */
9427
+ associatedAgentRegistry?: string | null;
8972
9428
  /**
8973
9429
  * Configurations for the Chat Engine. Only applicable if solution_type is SOLUTION_TYPE_CHAT.
8974
9430
  */
@@ -9012,7 +9468,7 @@ export declare namespace discoveryengine_v1 {
9012
9468
  */
9013
9469
  displayName?: string | null;
9014
9470
  /**
9015
- * 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` * `disable-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` * `disable-canvas-workspace` * `disable-skills`
9471
+ * 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`
9016
9472
  */
9017
9473
  features?: {
9018
9474
  [key: string]: string;
@@ -9240,7 +9696,7 @@ export declare namespace discoveryengine_v1 {
9240
9696
  */
9241
9697
  export interface Schema$GoogleCloudDiscoveryengineV1betaEngineSearchEngineConfig {
9242
9698
  /**
9243
- * Optional. The required subscription tier of this engine. They cannot be modified after engine creation. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine.
9699
+ * Optional. The required subscription tier of this engine. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine. Web grounding feature is only available on the app if it is set as SubscriptionTier.SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT.
9244
9700
  */
9245
9701
  requiredSubscriptionTier?: string | null;
9246
9702
  /**
@@ -9637,6 +10093,10 @@ export declare namespace discoveryengine_v1 {
9637
10093
  * Output only. Whether the license config is for Gemini bundle.
9638
10094
  */
9639
10095
  geminiBundle?: boolean | null;
10096
+ /**
10097
+ * Optional. Timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `update_time`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.).
10098
+ */
10099
+ lastUserUpdateTime?: string | null;
9640
10100
  /**
9641
10101
  * Required. Number of licenses purchased.
9642
10102
  */
@@ -9753,6 +10213,10 @@ export declare namespace discoveryengine_v1 {
9753
10213
  * Represents the currently effective configurable billing parameters. These values are derived from the customer's subscription history stored internally and reflect the thresholds actively being used for billing purposes at the time of the GetProject call. This includes the start_time of the subscription and may differ from the values in `customer_provided_config` due to billing rules (e.g., scale-downs taking effect only at the start of a new month). We also include the update type to indicate the type of update performed on the configurable billing configuration in the UpdateProject operation.
9754
10214
  */
9755
10215
  export interface Schema$GoogleCloudDiscoveryengineV1betaProjectConfigurableBillingStatus {
10216
+ /**
10217
+ * Output only. Per-model Agent Search TPM subscription status.
10218
+ */
10219
+ agentSearchTokenSubscriptionStatuses?: Schema$GoogleCloudDiscoveryengineV1betaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus[];
9756
10220
  /**
9757
10221
  * Optional. The currently effective Indexing Core threshold. This is the threshold against which Indexing Core usage is compared for overage calculations.
9758
10222
  */
@@ -9782,6 +10246,35 @@ export declare namespace discoveryengine_v1 {
9782
10246
  */
9783
10247
  updateType?: string | null;
9784
10248
  }
10249
+ /**
10250
+ * Per-model Agent Search TPM subscription status. One entry per active `core_subscription.agent_search_token_subscriptions[*]` entry in the customer-provided config; populated by UpdateProject and GetProject. The lifecycle scalars on this message (`start_time`, `terminate_time`, `update_type`, `tpm_threshold_next_update_time`) are per (project, model_version) — siblings of the whole-relationship `start_time` / `terminate_time` / `update_type` on the enclosing ConfigurableBillingStatus, but scoped to this specific Agent Search TPM subscription instead of to the overall customer-configurable- pricing relationship. This per-instance granularity is intentional: the underlying SubV3 storage is per-(project, model_version), so each model has its own activation, termination, and deferred-update clock; surfacing that on the response gives customers the granularity they need to manage per-model commitments independently. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.
10251
+ */
10252
+ export interface Schema$GoogleCloudDiscoveryengineV1betaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus {
10253
+ /**
10254
+ * Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics.
10255
+ */
10256
+ effectiveTpmThreshold?: string | null;
10257
+ /**
10258
+ * Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
10259
+ */
10260
+ modelVersion?: string | null;
10261
+ /**
10262
+ * Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship.
10263
+ */
10264
+ startTime?: string | null;
10265
+ /**
10266
+ * Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down.
10267
+ */
10268
+ terminateTime?: string | null;
10269
+ /**
10270
+ * Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update.
10271
+ */
10272
+ tpmThresholdNextUpdateTime?: string | null;
10273
+ /**
10274
+ * Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together).
10275
+ */
10276
+ updateType?: string | null;
10277
+ }
9785
10278
  /**
9786
10279
  * Customer provided configurations.
9787
10280
  */
@@ -10168,7 +10661,7 @@ export declare namespace discoveryengine_v1 {
10168
10661
  */
10169
10662
  queryExpansionSpec?: Schema$GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec;
10170
10663
  /**
10171
- * Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function \}; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double \> 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result
10664
+ * Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function \}; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double \> 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result * `media_actor_match`: whether the media actor matches the query * `media_director_match`: whether the media director matches the query * `media_genre_match`: whether the media genre matches the query * `media_language_match`: whether the media language matches the query * `media_title_match`: whether the media title matches the query * `media_prefix_similarity_rank`: prefix similarity rank for media results * `media_semantic_similarity_rank`: semantic similarity rank for media results
10172
10665
  */
10173
10666
  rankingExpression?: string | null;
10174
10667
  /**
@@ -10951,11 +11444,11 @@ export declare namespace discoveryengine_v1 {
10951
11444
  userId?: string | null;
10952
11445
  }
10953
11446
  /**
10954
- * Precise location info with multiple representation options. Currently only latitude and longitude point is supported.
11447
+ * Precise location info with multiple representation options.
10955
11448
  */
10956
11449
  export interface Schema$GoogleCloudDiscoveryengineV1betaUserInfoPreciseLocation {
10957
11450
  /**
10958
- * Optional. Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
11451
+ * Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
10959
11452
  */
10960
11453
  address?: string | null;
10961
11454
  /**
@@ -11026,7 +11519,7 @@ export declare namespace discoveryengine_v1 {
11026
11519
  */
11027
11520
  export interface Schema$GoogleCloudDiscoveryengineV1betaWorkspaceConfig {
11028
11521
  /**
11029
- * Obfuscated Dasher customer ID.
11522
+ * Output only. Obfuscated Dasher customer ID. Derived by the server from the project's GCP organization at data store creation time; any value supplied in the request payload is ignored.
11030
11523
  */
11031
11524
  dasherCustomerId?: string | null;
11032
11525
  /**
@@ -12052,6 +12545,10 @@ export declare namespace discoveryengine_v1 {
12052
12545
  * Optional. The modes enabled for this connector. Default state is CONNECTOR_MODE_UNSPECIFIED.
12053
12546
  */
12054
12547
  connectorModes?: string[] | null;
12548
+ /**
12549
+ * Optional. If set, this value instead of `data_source` is used to fetch the corresponding connector source.
12550
+ */
12551
+ connectorSourceId?: string | null;
12055
12552
  /**
12056
12553
  * Output only. The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system.
12057
12554
  */
@@ -12065,7 +12562,7 @@ export declare namespace discoveryengine_v1 {
12065
12562
  */
12066
12563
  createTime?: string | null;
12067
12564
  /**
12068
- * Required. The identifier for the data source. This is a partial list of supported connectors. Please refer to the [documentation](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/introduction-to-connectors-and-data-stores) for the full list of connectors. Supported first-party connectors include: * `gcs` * `bigquery` * `gcp_fhir` * `google_mail` * `google_drive` * `google_calendar` * `google_chat` Supported third-party connectors include: Generally available (GA) connectors: * `onedrive` * `outlook` * `confluence` * `jira` * `servicenow` * `sharepoint` Preview connectors: * `asana` * `azure_active_directory` * `box` * `canva` * `confluence_server` * `custom_connector` * `docusign` * `dropbox` * `dynamics365` * `github` * `gitlab` * `hubspot` * `jira_server` * `linear` * `native_cloud_identity` * `notion` * `okta` * `pagerduty` * `peoplesoft` * `salesforce` * `shopify` * `slack` * `snowflake` * `teams` * `trello` * `workday` * `zendesk`
12565
+ * Required. The identifier for the data source. For the full, up-to-date list of supported connectors and their values, see [Connect a third-party data source](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/connect-third-party-data-source#sources-by-launch-stage).
12069
12566
  */
12070
12567
  dataSource?: string | null;
12071
12568
  /**
@@ -12132,6 +12629,10 @@ export declare namespace discoveryengine_v1 {
12132
12629
  * Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.
12133
12630
  */
12134
12631
  latestPauseTime?: string | null;
12632
+ /**
12633
+ * Optional. User-facing metadata for the connector. Populated from the connector's generated metadata / registry `ConnectorSource`.
12634
+ */
12635
+ metadata?: Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata;
12135
12636
  /**
12136
12637
  * Identifier. The full resource name of the Data Connector. Format: `projects/x/locations/x/collections/x/dataConnector`.
12137
12638
  */
@@ -12140,6 +12641,10 @@ export declare namespace discoveryengine_v1 {
12140
12641
  * Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity.
12141
12642
  */
12142
12643
  nextSyncTime?: Schema$GoogleTypeDateTime;
12644
+ /**
12645
+ * Output only. The static IP addresses used by this connector for OAuth APIs (e.g. end user authentication). These are surfaced separately from `static_ip_addresses` so that customers can apply granular firewall settings for OAuth endpoints. Only populated for connectors that have static IP enabled and are used for actions and/or federated search.
12646
+ */
12647
+ oauthStaticIpAddresses?: string[] | null;
12143
12648
  /**
12144
12649
  * Required data connector parameters in structured json format.
12145
12650
  */
@@ -12182,6 +12687,10 @@ export declare namespace discoveryengine_v1 {
12182
12687
  * The data synchronization mode supported by the data connector.
12183
12688
  */
12184
12689
  syncMode?: string | null;
12690
+ /**
12691
+ * 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.
12692
+ */
12693
+ tag?: string | null;
12185
12694
  /**
12186
12695
  * Output only. Timestamp the DataConnector was last updated.
12187
12696
  */
@@ -12191,6 +12700,35 @@ export declare namespace discoveryengine_v1 {
12191
12700
  */
12192
12701
  vpcscEnabled?: boolean | null;
12193
12702
  }
12703
+ /**
12704
+ * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
12705
+ */
12706
+ export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata {
12707
+ /**
12708
+ * 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.
12709
+ */
12710
+ authenticatedAccount?: string | null;
12711
+ /**
12712
+ * 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).
12713
+ */
12714
+ author?: string | null;
12715
+ /**
12716
+ * Optional. Human-readable description of the connector, shown on the connector detail page. One connector has a single description.
12717
+ */
12718
+ description?: string | null;
12719
+ /**
12720
+ * Optional. Free-form, multi-line note about the connector's capabilities or a custom note that can be set for the connector.
12721
+ */
12722
+ note?: string | null;
12723
+ /**
12724
+ * Optional. Short, subtitle-length description of the connector (e.g. shown beneath the connector name in list and detail views).
12725
+ */
12726
+ shortDescription?: string | null;
12727
+ /**
12728
+ * Optional. Display title of the connector.
12729
+ */
12730
+ title?: string | null;
12731
+ }
12194
12732
  /**
12195
12733
  * Any params and credentials used specifically for EUA connectors.
12196
12734
  */
@@ -13050,6 +13588,10 @@ export declare namespace discoveryengine_v1 {
13050
13588
  * Optional. Immutable. This the application type which this engine resource represents. NOTE: this is a new concept independ of existing industry vertical or solution type.
13051
13589
  */
13052
13590
  appType?: string | null;
13591
+ /**
13592
+ * Output only. The Agent registry containing the agents, MCP servers and tools associated with this engine. Derived server-side from the linked Agent Gateway's registry.
13593
+ */
13594
+ associatedAgentRegistry?: string | null;
13053
13595
  /**
13054
13596
  * Configurations for the Chat Engine. Only applicable if solution_type is SOLUTION_TYPE_CHAT.
13055
13597
  */
@@ -13093,7 +13635,7 @@ export declare namespace discoveryengine_v1 {
13093
13635
  */
13094
13636
  displayName?: string | null;
13095
13637
  /**
13096
- * 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` * `disable-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` * `disable-canvas-workspace` * `disable-skills`
13638
+ * 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`
13097
13639
  */
13098
13640
  features?: {
13099
13641
  [key: string]: string;
@@ -13321,7 +13863,7 @@ export declare namespace discoveryengine_v1 {
13321
13863
  */
13322
13864
  export interface Schema$GoogleCloudDiscoveryengineV1EngineSearchEngineConfig {
13323
13865
  /**
13324
- * Optional. The required subscription tier of this engine. They cannot be modified after engine creation. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine.
13866
+ * Optional. The required subscription tier of this engine. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine. Web grounding feature is only available on the app if it is set as SubscriptionTier.SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT.
13325
13867
  */
13326
13868
  requiredSubscriptionTier?: string | null;
13327
13869
  /**
@@ -13368,6 +13910,68 @@ export declare namespace discoveryengine_v1 {
13368
13910
  */
13369
13911
  uri?: string | null;
13370
13912
  }
13913
+ /**
13914
+ * Information about the user feedback. This information will be used for logging and metrics purpose.
13915
+ */
13916
+ export interface Schema$GoogleCloudDiscoveryengineV1Feedback {
13917
+ /**
13918
+ * Optional. The additional user comment of the feedback if user gives a thumb down.
13919
+ */
13920
+ comment?: string | null;
13921
+ /**
13922
+ * Optional. The version of the component that this report is being sent from.
13923
+ */
13924
+ componentVersion?: string | null;
13925
+ /**
13926
+ * The related conversation information when user gives feedback.
13927
+ */
13928
+ conversationInfo?: Schema$GoogleCloudDiscoveryengineV1FeedbackConversationInfo;
13929
+ /**
13930
+ * Optional. Whether the customer accepted data use terms.
13931
+ */
13932
+ dataTermsAccepted?: boolean | null;
13933
+ /**
13934
+ * Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
13935
+ */
13936
+ feedbackSource?: string | null;
13937
+ /**
13938
+ * Required. Indicate whether the user gives a positive or negative feedback. If the user gives a negative feedback, there might be more feedback details.
13939
+ */
13940
+ feedbackType?: string | null;
13941
+ /**
13942
+ * The version of the LLM model that was used to generate the response.
13943
+ */
13944
+ llmModelVersion?: string | null;
13945
+ /**
13946
+ * Optional. The reason if user gives a thumb down.
13947
+ */
13948
+ reasons?: string[] | null;
13949
+ }
13950
+ /**
13951
+ * The conversation information such as the question index and session name.
13952
+ */
13953
+ export interface Schema$GoogleCloudDiscoveryengineV1FeedbackConversationInfo {
13954
+ /**
13955
+ * Optional. The token which could be used to fetch the answer log.
13956
+ */
13957
+ answerQueryToken?: string | null;
13958
+ /**
13959
+ * Optional. The token which could be used to fetch the assistant log.
13960
+ */
13961
+ assistToken?: string | null;
13962
+ /**
13963
+ * Required. The user's search query.
13964
+ */
13965
+ query?: Schema$GoogleCloudDiscoveryengineV1Query;
13966
+ /**
13967
+ * The index of the user input within the conversation messages.
13968
+ */
13969
+ questionIndex?: number | null;
13970
+ /**
13971
+ * Name of the newly generated or continued session.
13972
+ */
13973
+ session?: string | null;
13974
+ }
13371
13975
  /**
13372
13976
  * Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.
13373
13977
  */
@@ -13965,6 +14569,10 @@ export declare namespace discoveryengine_v1 {
13965
14569
  * Output only. Whether the license config is for Gemini bundle.
13966
14570
  */
13967
14571
  geminiBundle?: boolean | null;
14572
+ /**
14573
+ * Optional. Timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `update_time`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.).
14574
+ */
14575
+ lastUserUpdateTime?: string | null;
13968
14576
  /**
13969
14577
  * Required. Number of licenses purchased.
13970
14578
  */
@@ -14125,6 +14733,19 @@ export declare namespace discoveryengine_v1 {
14125
14733
  */
14126
14734
  nextPageToken?: string | null;
14127
14735
  }
14736
+ /**
14737
+ * Response message for LicenseConfigService.ListLicenseConfigs method.
14738
+ */
14739
+ export interface Schema$GoogleCloudDiscoveryengineV1ListLicenseConfigsResponse {
14740
+ /**
14741
+ * All the customer's LicenseConfigs.
14742
+ */
14743
+ licenseConfigs?: Schema$GoogleCloudDiscoveryengineV1LicenseConfig[];
14744
+ /**
14745
+ * Not supported.
14746
+ */
14747
+ nextPageToken?: string | null;
14748
+ }
14128
14749
  /**
14129
14750
  * Response message for UserLicenseService.ListLicenseConfigsUsageStats method.
14130
14751
  */
@@ -14336,6 +14957,10 @@ export declare namespace discoveryengine_v1 {
14336
14957
  * Represents the currently effective configurable billing parameters. These values are derived from the customer's subscription history stored internally and reflect the thresholds actively being used for billing purposes at the time of the GetProject call. This includes the start_time of the subscription and may differ from the values in `customer_provided_config` due to billing rules (e.g., scale-downs taking effect only at the start of a new month). We also include the update type to indicate the type of update performed on the configurable billing configuration in the UpdateProject operation.
14337
14958
  */
14338
14959
  export interface Schema$GoogleCloudDiscoveryengineV1ProjectConfigurableBillingStatus {
14960
+ /**
14961
+ * Output only. Per-model Agent Search TPM subscription status.
14962
+ */
14963
+ agentSearchTokenSubscriptionStatuses?: Schema$GoogleCloudDiscoveryengineV1ProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus[];
14339
14964
  /**
14340
14965
  * Optional. The currently effective Indexing Core threshold. This is the threshold against which Indexing Core usage is compared for overage calculations.
14341
14966
  */
@@ -14365,6 +14990,35 @@ export declare namespace discoveryengine_v1 {
14365
14990
  */
14366
14991
  updateType?: string | null;
14367
14992
  }
14993
+ /**
14994
+ * Per-model Agent Search TPM subscription status. One entry per active `core_subscription.agent_search_token_subscriptions[*]` entry in the customer-provided config; populated by UpdateProject and GetProject. The lifecycle scalars on this message (`start_time`, `terminate_time`, `update_type`, `tpm_threshold_next_update_time`) are per (project, model_version) — siblings of the whole-relationship `start_time` / `terminate_time` / `update_type` on the enclosing ConfigurableBillingStatus, but scoped to this specific Agent Search TPM subscription instead of to the overall customer-configurable- pricing relationship. This per-instance granularity is intentional: the underlying SubV3 storage is per-(project, model_version), so each model has its own activation, termination, and deferred-update clock; surfacing that on the response gives customers the granularity they need to manage per-model commitments independently. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.
14995
+ */
14996
+ export interface Schema$GoogleCloudDiscoveryengineV1ProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus {
14997
+ /**
14998
+ * Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics.
14999
+ */
15000
+ effectiveTpmThreshold?: string | null;
15001
+ /**
15002
+ * Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
15003
+ */
15004
+ modelVersion?: string | null;
15005
+ /**
15006
+ * Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship.
15007
+ */
15008
+ startTime?: string | null;
15009
+ /**
15010
+ * Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down.
15011
+ */
15012
+ terminateTime?: string | null;
15013
+ /**
15014
+ * Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update.
15015
+ */
15016
+ tpmThresholdNextUpdateTime?: string | null;
15017
+ /**
15018
+ * Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together).
15019
+ */
15020
+ updateType?: string | null;
15021
+ }
14368
15022
  /**
14369
15023
  * Customer provided configurations.
14370
15024
  */
@@ -14505,7 +15159,7 @@ export declare namespace discoveryengine_v1 {
14505
15159
  export interface Schema$GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsRequest {
14506
15160
  }
14507
15161
  /**
14508
- * Response message for CompletionService.PurgeCompletionSuggestions method.
15162
+ * Response message for CompletionService.PurgeCompletionSuggestions method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.
14509
15163
  */
14510
15164
  export interface Schema$GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsResponse {
14511
15165
  /**
@@ -15060,7 +15714,7 @@ export declare namespace discoveryengine_v1 {
15060
15714
  */
15061
15715
  queryExpansionSpec?: Schema$GoogleCloudDiscoveryengineV1SearchRequestQueryExpansionSpec;
15062
15716
  /**
15063
- * Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function \}; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double \> 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result
15717
+ * Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function \}; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double \> 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result * `media_actor_match`: whether the media actor matches the query * `media_director_match`: whether the media director matches the query * `media_genre_match`: whether the media genre matches the query * `media_language_match`: whether the media language matches the query * `media_title_match`: whether the media title matches the query * `media_prefix_similarity_rank`: prefix similarity rank for media results * `media_semantic_similarity_rank`: semantic similarity rank for media results
15064
15718
  */
15065
15719
  rankingExpression?: string | null;
15066
15720
  /**
@@ -16111,6 +16765,10 @@ export declare namespace discoveryengine_v1 {
16111
16765
  * Immutable. Fully qualified name `projects/{project\}/locations/global/collections/{collection\}/engines/{engine\}/sessions/x`
16112
16766
  */
16113
16767
  name?: string | null;
16768
+ /**
16769
+ * Output only. Full resource name of an in-progress AsyncAssist operation for this session, e.g. `projects/x/locations/x/collections/x/engines/x/sessions/x/operations/x`. Set when the operation starts and cleared when it finishes.
16770
+ */
16771
+ pendingAsyncAssistOperationId?: string | null;
16114
16772
  /**
16115
16773
  * Output only. The time the session started.
16116
16774
  */
@@ -16349,15 +17007,49 @@ export declare namespace discoveryengine_v1 {
16349
17007
  * A global unique ID that identifies the current pair of request and stream of responses. Used for feedback and support.
16350
17008
  */
16351
17009
  assistToken?: string | null;
17010
+ /**
17011
+ * Per-connector authentication errors encountered during the request. Present when one or more connectors failed authentication but the request proceeded with the remaining connectors.
17012
+ */
17013
+ connectorAuthErrors?: Schema$GoogleCloudDiscoveryengineV1StreamAssistResponseConnectorAuthError[];
16352
17014
  /**
16353
17015
  * The tool names of the tools that were invoked.
16354
17016
  */
16355
17017
  invocationTools?: string[] | null;
17018
+ /**
17019
+ * The skills executed during the turn.
17020
+ */
17021
+ invokedSkills?: Schema$GoogleCloudDiscoveryengineV1StreamAssistResponseInvokedSkill[];
16356
17022
  /**
16357
17023
  * Session information. Only included in the final StreamAssistResponse of the response stream.
16358
17024
  */
16359
17025
  sessionInfo?: Schema$GoogleCloudDiscoveryengineV1StreamAssistResponseSessionInfo;
16360
17026
  }
17027
+ /**
17028
+ * Describes an authentication error for a specific data connector.
17029
+ */
17030
+ export interface Schema$GoogleCloudDiscoveryengineV1StreamAssistResponseConnectorAuthError {
17031
+ /**
17032
+ * Resource name of the data connector that failed authentication.
17033
+ */
17034
+ dataConnector?: string | null;
17035
+ /**
17036
+ * Human-readable error message describing the auth failure.
17037
+ */
17038
+ errorMessage?: string | null;
17039
+ }
17040
+ /**
17041
+ * Represents a skill used during the assist call.
17042
+ */
17043
+ export interface Schema$GoogleCloudDiscoveryengineV1StreamAssistResponseInvokedSkill {
17044
+ /**
17045
+ * The display name of the skill.
17046
+ */
17047
+ displayName?: string | null;
17048
+ /**
17049
+ * The resource name of the skill.
17050
+ */
17051
+ name?: string | null;
17052
+ }
16361
17053
  /**
16362
17054
  * Information about the session.
16363
17055
  */
@@ -16673,6 +17365,10 @@ export declare namespace discoveryengine_v1 {
16673
17365
  * Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \> Men \> Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. Custom conversion value: * `conversion`: Customer defined conversion event.
16674
17366
  */
16675
17367
  eventType?: string | null;
17368
+ /**
17369
+ * Optional. This field is optional except for the `add-feedback` event types.
17370
+ */
17371
+ feedback?: Schema$GoogleCloudDiscoveryengineV1Feedback;
16676
17372
  /**
16677
17373
  * Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendRequest, this field may be populated directly from RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
16678
17374
  */
@@ -16744,11 +17440,11 @@ export declare namespace discoveryengine_v1 {
16744
17440
  userId?: string | null;
16745
17441
  }
16746
17442
  /**
16747
- * Precise location info with multiple representation options. Currently only latitude and longitude point is supported.
17443
+ * Precise location info with multiple representation options.
16748
17444
  */
16749
17445
  export interface Schema$GoogleCloudDiscoveryengineV1UserInfoPreciseLocation {
16750
17446
  /**
16751
- * Optional. Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
17447
+ * Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
16752
17448
  */
16753
17449
  address?: string | null;
16754
17450
  /**
@@ -16835,7 +17531,11 @@ export declare namespace discoveryengine_v1 {
16835
17531
  */
16836
17532
  assistantSettings?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigAssistantSettings;
16837
17533
  /**
16838
- * Output only. Collection components that lists all collections and child data stores associated with the widget config, those data sources can be used for filtering in widget service APIs, users can return results that from selected data sources.
17534
+ * Output only. The batch authorization statuses for the widget's connectors.
17535
+ */
17536
+ batchAuthStatuses?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigBatchAuthStatus[];
17537
+ /**
17538
+ * Output only. Collection components that lists all collections and child data stores associated with the widget config, those data sources can be used for filtering in widget service APIs, users can return results that from selected data sources. For SaaS / Business engines, when `LookupWidgetConfig` is called with `view = WITH_AVAILABLE_CONNECTORS`, this list is additionally augmented with synthetic placeholder entries for connectors the caller may attach but has not yet attached (see `CollectionComponent` for the placeholder contract). The frontend can therefore render a unified list of already-attached and available-to-attach sources by iterating this single field. For Enterprise engines and for the default `view`, only already-attached connectors are returned (today's behavior).
16839
17539
  */
16840
17540
  collectionComponents?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigCollectionComponent[];
16841
17541
  /**
@@ -17016,9 +17716,30 @@ export declare namespace discoveryengine_v1 {
17016
17716
  webGroundingType?: string | null;
17017
17717
  }
17018
17718
  /**
17019
- * Read-only collection component that contains data store collections fields that may be used for filtering
17719
+ * Describes the batch authorization status for a batch_authorization_group.
17720
+ */
17721
+ export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigBatchAuthStatus {
17722
+ /**
17723
+ * Output only. The batch authorization group the placeholder belongs to.
17724
+ */
17725
+ batchAuthorizationGroup?: string | null;
17726
+ /**
17727
+ * Output only. The current authorization state for this connector.
17728
+ */
17729
+ connectorAuthState?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigConnectorAuthState;
17730
+ /**
17731
+ * Output only. It is the batch authorization group placeholder full resource name. This is not a real data connector (not existed in DataConnector table in spanner). It's a resource name existing only in the connector_authorization in the user table. E.g. projects/{project\}/locations/{location\}/collections/oauth_placeholder_google_workspace/dataStores/dataConnector.
17732
+ */
17733
+ placeholder?: string | null;
17734
+ }
17735
+ /**
17736
+ * Read-only collection component that contains data store collections fields that may be used for filtering. For SaaS / Business engines, when `LookupWidgetConfig` is called with `view = WITH_AVAILABLE_CONNECTORS`, instances of this message are also used to represent synthetic placeholder entries for connectors the caller may attach but has not yet attached. Placeholder entries have `connector_auth_state.auth_state == AUTH_STATE_UNSPECIFIED` (or `NO_AUTH`), an empty `connector_auth_state.authorization_uri` (the widget calls `WidgetBuildAuthorizationUrl` on the user's "Connect" click), and synthetic placeholder values in `name` / `id` (see field comments). Fields that only make sense for materialized connectors (`data_store_components`, `tenant`, `action_connector`) are left unset for placeholder entries.
17020
17737
  */
17021
17738
  export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigCollectionComponent {
17739
+ /**
17740
+ * Output only. The auth uri of the connector source.
17741
+ */
17742
+ connectorAuthState?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigConnectorAuthState;
17022
17743
  /**
17023
17744
  * Output only. The icon link of the connector source.
17024
17745
  */
@@ -17040,14 +17761,31 @@ export declare namespace discoveryengine_v1 {
17040
17761
  */
17041
17762
  displayName?: string | null;
17042
17763
  /**
17043
- * 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.
17764
+ * 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.
17044
17765
  */
17045
17766
  id?: string | null;
17046
17767
  /**
17047
- * 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.
17768
+ * 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.
17048
17769
  */
17049
17770
  name?: string | null;
17050
17771
  }
17772
+ /**
17773
+ * Read-only connector in CollectionComponent auth state.
17774
+ */
17775
+ export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigConnectorAuthState {
17776
+ /**
17777
+ * Output only. The authorization uri for the data connector. For synthetic placeholder `CollectionComponent` entries (returned by `LookupWidgetConfig` with `view = WITH_AVAILABLE_CONNECTORS` on SaaS / Business engines), this field is left empty. The widget should call `WidgetService.WidgetBuildAuthorizationUrl` on the user's "Connect" click to obtain a freshly-built authorization URL.
17778
+ */
17779
+ authorizationUri?: string | null;
17780
+ /**
17781
+ * Output only. The authorization state of the data connector.
17782
+ */
17783
+ authState?: string | null;
17784
+ /**
17785
+ * Output only. The authorization state update timestamp.
17786
+ */
17787
+ updateTime?: string | null;
17788
+ }
17051
17789
  /**
17052
17790
  * Customer provided configurations.
17053
17791
  */
@@ -17257,7 +17995,7 @@ export declare namespace discoveryengine_v1 {
17257
17995
  */
17258
17996
  enableVisualContentSummary?: boolean | null;
17259
17997
  /**
17260
- * 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` * `disable-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` * `disable-canvas-workspace` * `disable-skills`
17998
+ * 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`
17261
17999
  */
17262
18000
  features?: {
17263
18001
  [key: string]: string;
@@ -17266,20 +18004,36 @@ export declare namespace discoveryengine_v1 {
17266
18004
  * Describes generative answer configuration.
17267
18005
  */
17268
18006
  generativeAnswerConfig?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsGenerativeAnswerConfig;
18007
+ /**
18008
+ * Output only. Whether the Google Drive file picker is available to end-users. Declared `optional` for the same field-presence reason as `onedrive_picker_enabled` above.
18009
+ */
18010
+ googleDrivePickerEnabled?: boolean | null;
17269
18011
  /**
17270
18012
  * Describes widget (or web app) interaction type
17271
18013
  */
17272
18014
  interactionType?: string | null;
18015
+ /**
18016
+ * Output only. The resolved, server-side view of model selector configuration. Holds both the ordered list of models that should appear in the model selector dropdown and the model that should be selected by default. Clients should render this directly without applying their own filtering, ordering, or localization. The legacy `model_configs` map above is retained for backward compatibility with clients that have not yet migrated to consuming this field.
18017
+ */
18018
+ modelConfigInfo?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfo;
17273
18019
  /**
17274
18020
  * Output only. Maps a model name to its specific configuration for this engine. This allows admin users to turn on/off individual models. This only stores models whose states are overridden by the admin. When the state is unspecified, or model_configs is empty for this model, the system will decide if this model should be available or not based on the default configuration. For example, a preview model should be disabled by default if the admin has not chosen to enable it.
17275
18021
  */
17276
18022
  modelConfigs?: {
17277
18023
  [key: string]: string;
17278
18024
  } | null;
18025
+ /**
18026
+ * Output only. Whether the OneDrive file picker is available to end-users. Computed by the backend from admin connector enablement (Business edition) or attached OneDrive connectors (Enterprise edition), combined with the existing `disable-onedrive-upload` admin feature. Declared `optional` so an explicitly-computed `false` is serialized with field presence. A plain proto3 `bool` drops a default `false` on the wire, which prevented clients from distinguishing "picker disabled" (`false`) from "field not populated" (unset).
18027
+ */
18028
+ onedrivePickerEnabled?: boolean | null;
17279
18029
  /**
17280
18030
  * Controls whether result extract is display and how (snippet or extractive answer). Default to no result if unspecified.
17281
18031
  */
17282
18032
  resultDescriptionType?: string | null;
18033
+ /**
18034
+ * Optional. Whether to show the admin-configured display name for data connectors in the widget sources UI (instead of the connector kind). Opt-in; defaults to false.
18035
+ */
18036
+ sourceAdminDisplayNameEnabled?: boolean | null;
17283
18037
  }
17284
18038
  /**
17285
18039
  * Describes configuration for generative answer.
@@ -17326,12 +18080,71 @@ export declare namespace discoveryengine_v1 {
17326
18080
  */
17327
18081
  resultCount?: number | null;
17328
18082
  }
18083
+ /**
18084
+ * The resolved, server-side view of model selector configuration for the end-user. The backend computes this per-request by applying, in order: Mendel flag evaluation, regional availability rules based on the engine's location, and admin-panel overrides from `model_configs`. The backend is the single source of truth for this configuration; clients should render `resolved_models` directly in the model selector dropdown, in the order provided, without applying their own filtering, ordering, or localization.
18085
+ */
18086
+ export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfo {
18087
+ /**
18088
+ * Output only. The `model_id` of the model that should be selected by default in the model selector when the end-user has not made an explicit choice. The value is always one of the `model_id`s present in `resolved_models`.
18089
+ */
18090
+ defaultModelId?: string | null;
18091
+ /**
18092
+ * Output only. The list of models that are available to the end-user in the model selector, in the order in which they should be displayed.
18093
+ */
18094
+ resolvedModels?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfoResolvedModel[];
18095
+ }
18096
+ /**
18097
+ * A single model that is resolved to be available to the end-user in the model selector, with all of its localized display metadata.
18098
+ */
18099
+ export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfoResolvedModel {
18100
+ /**
18101
+ * Output only. Admin-surface metadata; populated only for the Console admin Feature Control page (see `AdminView`). Unset for end-user surfaces.
18102
+ */
18103
+ adminView?: Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfoResolvedModelAdminView;
18104
+ /**
18105
+ * Output only. Localized description text (e.g. `State-of-the-art reasoning`). Localized using the same locale as `display_name`.
18106
+ */
18107
+ description?: string | null;
18108
+ /**
18109
+ * Output only. Localized display name of the model (e.g. `Gemini 3.1 Pro`). Localized server-side based on the LookupWidgetConfigRequest.language_code and LookupWidgetConfigRequest.region_code of the request.
18110
+ */
18111
+ displayName?: string | null;
18112
+ /**
18113
+ * Output only. GM3-compatible icon token associated with the model (e.g. `rocket_launch`, `bolt`, `graph_5`).
18114
+ */
18115
+ icon?: string | null;
18116
+ /**
18117
+ * Output only. Whether the model is currently in preview. Clients should surface this via a "Preview" badge in the selector UI.
18118
+ */
18119
+ isPreview?: boolean | null;
18120
+ /**
18121
+ * 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.
18122
+ */
18123
+ modelId?: string | null;
18124
+ }
18125
+ /**
18126
+ * 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.
18127
+ */
18128
+ export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfoResolvedModelAdminView {
18129
+ /**
18130
+ * Output only. Whether the admin can toggle this model's enabled/disabled state via `UiSettings.model_configs`. Derived from `MODEL_TAG_ADMIN_OVERRIDABLE`. When false, the model is "forced" and its state is governed by `enabled_by_default`.
18131
+ */
18132
+ adminOverridable?: boolean | null;
18133
+ /**
18134
+ * Output only. Whether the model is enabled when the admin has set no explicit override in `UiSettings.model_configs`. Derived from `MODEL_TAG_ENABLED_BY_DEFAULT`.
18135
+ */
18136
+ enabledByDefault?: boolean | null;
18137
+ /**
18138
+ * Output only. Regions where this model is launched.
18139
+ */
18140
+ regions?: string[] | null;
18141
+ }
17329
18142
  /**
17330
18143
  * Config to store data store type configuration for workspace data
17331
18144
  */
17332
18145
  export interface Schema$GoogleCloudDiscoveryengineV1WorkspaceConfig {
17333
18146
  /**
17334
- * Obfuscated Dasher customer ID.
18147
+ * Output only. Obfuscated Dasher customer ID. Derived by the server from the project's GCP organization at data store creation time; any value supplied in the request payload is ignored.
17335
18148
  */
17336
18149
  dasherCustomerId?: string | null;
17337
18150
  /**
@@ -18223,6 +19036,7 @@ export declare namespace discoveryengine_v1 {
18223
19036
  * // "blockingReasons": [],
18224
19037
  * // "cliConfig": {},
18225
19038
  * // "connectorModes": [],
19039
+ * // "connectorSourceId": "my_connectorSourceId",
18226
19040
  * // "connectorType": "my_connectorType",
18227
19041
  * // "createEuaSaas": false,
18228
19042
  * // "createTime": "my_createTime",
@@ -18243,8 +19057,10 @@ export declare namespace discoveryengine_v1 {
18243
19057
  * // "kmsKeyName": "my_kmsKeyName",
18244
19058
  * // "lastSyncTime": "my_lastSyncTime",
18245
19059
  * // "latestPauseTime": "my_latestPauseTime",
19060
+ * // "metadata": {},
18246
19061
  * // "name": "my_name",
18247
19062
  * // "nextSyncTime": {},
19063
+ * // "oauthStaticIpAddresses": [],
18248
19064
  * // "params": {},
18249
19065
  * // "privateConnectivityProjectId": "my_privateConnectivityProjectId",
18250
19066
  * // "realtimeState": "my_realtimeState",
@@ -18255,6 +19071,7 @@ export declare namespace discoveryengine_v1 {
18255
19071
  * // "staticIpAddresses": [],
18256
19072
  * // "staticIpEnabled": false,
18257
19073
  * // "syncMode": "my_syncMode",
19074
+ * // "tag": "my_tag",
18258
19075
  * // "updateTime": "my_updateTime",
18259
19076
  * // "vpcscEnabled": false
18260
19077
  * // }
@@ -18966,6 +19783,7 @@ export declare namespace discoveryengine_v1 {
18966
19783
  * // "blockingReasons": [],
18967
19784
  * // "cliConfig": {},
18968
19785
  * // "connectorModes": [],
19786
+ * // "connectorSourceId": "my_connectorSourceId",
18969
19787
  * // "connectorType": "my_connectorType",
18970
19788
  * // "createEuaSaas": false,
18971
19789
  * // "createTime": "my_createTime",
@@ -18986,8 +19804,10 @@ export declare namespace discoveryengine_v1 {
18986
19804
  * // "kmsKeyName": "my_kmsKeyName",
18987
19805
  * // "lastSyncTime": "my_lastSyncTime",
18988
19806
  * // "latestPauseTime": "my_latestPauseTime",
19807
+ * // "metadata": {},
18989
19808
  * // "name": "my_name",
18990
19809
  * // "nextSyncTime": {},
19810
+ * // "oauthStaticIpAddresses": [],
18991
19811
  * // "params": {},
18992
19812
  * // "privateConnectivityProjectId": "my_privateConnectivityProjectId",
18993
19813
  * // "realtimeState": "my_realtimeState",
@@ -18998,6 +19818,7 @@ export declare namespace discoveryengine_v1 {
18998
19818
  * // "staticIpAddresses": [],
18999
19819
  * // "staticIpEnabled": false,
19000
19820
  * // "syncMode": "my_syncMode",
19821
+ * // "tag": "my_tag",
19001
19822
  * // "updateTime": "my_updateTime",
19002
19823
  * // "vpcscEnabled": false
19003
19824
  * // }
@@ -19076,6 +19897,7 @@ export declare namespace discoveryengine_v1 {
19076
19897
  * // "blockingReasons": [],
19077
19898
  * // "cliConfig": {},
19078
19899
  * // "connectorModes": [],
19900
+ * // "connectorSourceId": "my_connectorSourceId",
19079
19901
  * // "connectorType": "my_connectorType",
19080
19902
  * // "createEuaSaas": false,
19081
19903
  * // "createTime": "my_createTime",
@@ -19096,8 +19918,10 @@ export declare namespace discoveryengine_v1 {
19096
19918
  * // "kmsKeyName": "my_kmsKeyName",
19097
19919
  * // "lastSyncTime": "my_lastSyncTime",
19098
19920
  * // "latestPauseTime": "my_latestPauseTime",
19921
+ * // "metadata": {},
19099
19922
  * // "name": "my_name",
19100
19923
  * // "nextSyncTime": {},
19924
+ * // "oauthStaticIpAddresses": [],
19101
19925
  * // "params": {},
19102
19926
  * // "privateConnectivityProjectId": "my_privateConnectivityProjectId",
19103
19927
  * // "realtimeState": "my_realtimeState",
@@ -19108,6 +19932,7 @@ export declare namespace discoveryengine_v1 {
19108
19932
  * // "staticIpAddresses": [],
19109
19933
  * // "staticIpEnabled": false,
19110
19934
  * // "syncMode": "my_syncMode",
19935
+ * // "tag": "my_tag",
19111
19936
  * // "updateTime": "my_updateTime",
19112
19937
  * // "vpcscEnabled": false
19113
19938
  * // }
@@ -19126,6 +19951,7 @@ export declare namespace discoveryengine_v1 {
19126
19951
  * // "blockingReasons": [],
19127
19952
  * // "cliConfig": {},
19128
19953
  * // "connectorModes": [],
19954
+ * // "connectorSourceId": "my_connectorSourceId",
19129
19955
  * // "connectorType": "my_connectorType",
19130
19956
  * // "createEuaSaas": false,
19131
19957
  * // "createTime": "my_createTime",
@@ -19146,8 +19972,10 @@ export declare namespace discoveryengine_v1 {
19146
19972
  * // "kmsKeyName": "my_kmsKeyName",
19147
19973
  * // "lastSyncTime": "my_lastSyncTime",
19148
19974
  * // "latestPauseTime": "my_latestPauseTime",
19975
+ * // "metadata": {},
19149
19976
  * // "name": "my_name",
19150
19977
  * // "nextSyncTime": {},
19978
+ * // "oauthStaticIpAddresses": [],
19151
19979
  * // "params": {},
19152
19980
  * // "privateConnectivityProjectId": "my_privateConnectivityProjectId",
19153
19981
  * // "realtimeState": "my_realtimeState",
@@ -19158,6 +19986,7 @@ export declare namespace discoveryengine_v1 {
19158
19986
  * // "staticIpAddresses": [],
19159
19987
  * // "staticIpEnabled": false,
19160
19988
  * // "syncMode": "my_syncMode",
19989
+ * // "tag": "my_tag",
19161
19990
  * // "updateTime": "my_updateTime",
19162
19991
  * // "vpcscEnabled": false
19163
19992
  * // }
@@ -24839,6 +25668,7 @@ export declare namespace discoveryengine_v1 {
24839
25668
  * // "isPinned": false,
24840
25669
  * // "labels": [],
24841
25670
  * // "name": "my_name",
25671
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
24842
25672
  * // "startTime": "my_startTime",
24843
25673
  * // "state": "my_state",
24844
25674
  * // "turns": [],
@@ -24856,6 +25686,7 @@ export declare namespace discoveryengine_v1 {
24856
25686
  * // "isPinned": false,
24857
25687
  * // "labels": [],
24858
25688
  * // "name": "my_name",
25689
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
24859
25690
  * // "startTime": "my_startTime",
24860
25691
  * // "state": "my_state",
24861
25692
  * // "turns": [],
@@ -25000,6 +25831,7 @@ export declare namespace discoveryengine_v1 {
25000
25831
  * // "isPinned": false,
25001
25832
  * // "labels": [],
25002
25833
  * // "name": "my_name",
25834
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
25003
25835
  * // "startTime": "my_startTime",
25004
25836
  * // "state": "my_state",
25005
25837
  * // "turns": [],
@@ -25065,7 +25897,7 @@ export declare namespace discoveryengine_v1 {
25065
25897
  * {
25066
25898
  * // A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` * `collaborative_project` Examples: * `user_pseudo_id = some_id` * `display_name = "some_name"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time \> "1970-01-01T12:00:00Z"` * `collaborative_project = "projects/123/locations/global/collections/default_collection/engines/" "default_engine/collaborative_projects/cp1"`
25067
25899
  * filter: 'placeholder-value',
25068
- * // A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
25900
+ * // A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
25069
25901
  * orderBy: 'placeholder-value',
25070
25902
  * // Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
25071
25903
  * pageSize: 'placeholder-value',
@@ -25155,6 +25987,7 @@ export declare namespace discoveryengine_v1 {
25155
25987
  * // "isPinned": false,
25156
25988
  * // "labels": [],
25157
25989
  * // "name": "my_name",
25990
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
25158
25991
  * // "startTime": "my_startTime",
25159
25992
  * // "state": "my_state",
25160
25993
  * // "turns": [],
@@ -25172,6 +26005,7 @@ export declare namespace discoveryengine_v1 {
25172
26005
  * // "isPinned": false,
25173
26006
  * // "labels": [],
25174
26007
  * // "name": "my_name",
26008
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
25175
26009
  * // "startTime": "my_startTime",
25176
26010
  * // "state": "my_state",
25177
26011
  * // "turns": [],
@@ -25234,7 +26068,7 @@ export declare namespace discoveryengine_v1 {
25234
26068
  */
25235
26069
  filter?: string;
25236
26070
  /**
25237
- * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
26071
+ * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
25238
26072
  */
25239
26073
  orderBy?: string;
25240
26074
  /**
@@ -27446,6 +28280,7 @@ export declare namespace discoveryengine_v1 {
27446
28280
  * // "entity": "my_entity",
27447
28281
  * // "eventTime": "my_eventTime",
27448
28282
  * // "eventType": "my_eventType",
28283
+ * // "feedback": {},
27449
28284
  * // "filter": "my_filter",
27450
28285
  * // "mediaInfo": {},
27451
28286
  * // "pageInfo": {},
@@ -27477,6 +28312,7 @@ export declare namespace discoveryengine_v1 {
27477
28312
  * // "entity": "my_entity",
27478
28313
  * // "eventTime": "my_eventTime",
27479
28314
  * // "eventType": "my_eventType",
28315
+ * // "feedback": {},
27480
28316
  * // "filter": "my_filter",
27481
28317
  * // "mediaInfo": {},
27482
28318
  * // "pageInfo": {},
@@ -27609,6 +28445,10 @@ export declare namespace discoveryengine_v1 {
27609
28445
  * // Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.
27610
28446
  * 'getWidgetConfigRequestOption.turnOffCollectionComponents':
27611
28447
  * 'placeholder-value',
28448
+ * // Optional. BCP-47 language tag (e.g. "en", "fr-CA"). Used to localize human-readable strings in the response, such as the model selector `display_name` / `description` on `WidgetConfig.UiSettings.ModelConfigInfo`. Empty / unset falls back to the default language (English).
28449
+ * languageCode: 'placeholder-value',
28450
+ * // Optional. Selects which view of `WidgetConfig.UiSettings.ModelConfigInfo` the backend computes. `MODEL_INFO_VIEW_ADMIN` is set by the Cloud Console admin "Feature Management" page (screen/4Vn9gQKbN8tb7gm) to receive the admin-surfaced model set with `ResolvedModel.admin_view` populated; unset / `MODEL_INFO_VIEW_WEB` returns the end-user selector. The mobile surface is detected from the `X-Goog-Gemini-Enterprise-Mobile` header instead (see `ModelInfoView`).
28451
+ * modelInfoView: 'placeholder-value',
27612
28452
  * // Required. Full WidgetConfig resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}/dataStores/{data_store_id\}/widgetConfigs/{widget_config_id\}`
27613
28453
  * name: 'projects/my-project/locations/my-location/collections/my-collection/dataStores/my-dataStore/widgetConfigs/my-widgetConfig',
27614
28454
  * },
@@ -27621,6 +28461,7 @@ export declare namespace discoveryengine_v1 {
27621
28461
  * // "allowPublicAccess": false,
27622
28462
  * // "allowlistedDomains": [],
27623
28463
  * // "assistantSettings": {},
28464
+ * // "batchAuthStatuses": [],
27624
28465
  * // "collectionComponents": [],
27625
28466
  * // "configId": "my_configId",
27626
28467
  * // "contentSearchSpec": {},
@@ -27726,6 +28567,7 @@ export declare namespace discoveryengine_v1 {
27726
28567
  * // "allowPublicAccess": false,
27727
28568
  * // "allowlistedDomains": [],
27728
28569
  * // "assistantSettings": {},
28570
+ * // "batchAuthStatuses": [],
27729
28571
  * // "collectionComponents": [],
27730
28572
  * // "configId": "my_configId",
27731
28573
  * // "contentSearchSpec": {},
@@ -27771,6 +28613,7 @@ export declare namespace discoveryengine_v1 {
27771
28613
  * // "allowPublicAccess": false,
27772
28614
  * // "allowlistedDomains": [],
27773
28615
  * // "assistantSettings": {},
28616
+ * // "batchAuthStatuses": [],
27774
28617
  * // "collectionComponents": [],
27775
28618
  * // "configId": "my_configId",
27776
28619
  * // "contentSearchSpec": {},
@@ -27835,6 +28678,14 @@ export declare namespace discoveryengine_v1 {
27835
28678
  * Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.
27836
28679
  */
27837
28680
  'getWidgetConfigRequestOption.turnOffCollectionComponents'?: boolean;
28681
+ /**
28682
+ * Optional. BCP-47 language tag (e.g. "en", "fr-CA"). Used to localize human-readable strings in the response, such as the model selector `display_name` / `description` on `WidgetConfig.UiSettings.ModelConfigInfo`. Empty / unset falls back to the default language (English).
28683
+ */
28684
+ languageCode?: string;
28685
+ /**
28686
+ * Optional. Selects which view of `WidgetConfig.UiSettings.ModelConfigInfo` the backend computes. `MODEL_INFO_VIEW_ADMIN` is set by the Cloud Console admin "Feature Management" page (screen/4Vn9gQKbN8tb7gm) to receive the admin-surfaced model set with `ResolvedModel.admin_view` populated; unset / `MODEL_INFO_VIEW_WEB` returns the end-user selector. The mobile surface is detected from the `X-Goog-Gemini-Enterprise-Mobile` header instead (see `ModelInfoView`).
28687
+ */
28688
+ modelInfoView?: string;
27838
28689
  /**
27839
28690
  * Required. Full WidgetConfig resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}/dataStores/{data_store_id\}/widgetConfigs/{widget_config_id\}`
27840
28691
  */
@@ -27913,6 +28764,7 @@ export declare namespace discoveryengine_v1 {
27913
28764
  * // {
27914
28765
  * // "agentGatewaySetting": {},
27915
28766
  * // "appType": "my_appType",
28767
+ * // "associatedAgentRegistry": "my_associatedAgentRegistry",
27916
28768
  * // "chatEngineConfig": {},
27917
28769
  * // "chatEngineMetadata": {},
27918
28770
  * // "cmekConfig": {},
@@ -28081,6 +28933,7 @@ export declare namespace discoveryengine_v1 {
28081
28933
  * // {
28082
28934
  * // "agentGatewaySetting": {},
28083
28935
  * // "appType": "my_appType",
28936
+ * // "associatedAgentRegistry": "my_associatedAgentRegistry",
28084
28937
  * // "chatEngineConfig": {},
28085
28938
  * // "chatEngineMetadata": {},
28086
28939
  * // "cmekConfig": {},
@@ -28315,6 +29168,7 @@ export declare namespace discoveryengine_v1 {
28315
29168
  * // {
28316
29169
  * // "agentGatewaySetting": {},
28317
29170
  * // "appType": "my_appType",
29171
+ * // "associatedAgentRegistry": "my_associatedAgentRegistry",
28318
29172
  * // "chatEngineConfig": {},
28319
29173
  * // "chatEngineMetadata": {},
28320
29174
  * // "cmekConfig": {},
@@ -28346,6 +29200,7 @@ export declare namespace discoveryengine_v1 {
28346
29200
  * // {
28347
29201
  * // "agentGatewaySetting": {},
28348
29202
  * // "appType": "my_appType",
29203
+ * // "associatedAgentRegistry": "my_associatedAgentRegistry",
28349
29204
  * // "chatEngineConfig": {},
28350
29205
  * // "chatEngineMetadata": {},
28351
29206
  * // "cmekConfig": {},
@@ -28390,7 +29245,7 @@ export declare namespace discoveryengine_v1 {
28390
29245
  patch(params: Params$Resource$Projects$Locations$Collections$Engines$Patch, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1Engine>): void;
28391
29246
  patch(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1Engine>): void;
28392
29247
  /**
28393
- * Sets the IAM access control policy for an Engine. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on an Engine resource, the only recommended roles in the bindings are: `roles/discoveryengine.user` and `roles/discoveryengine.agentspaceUser`. Attempting to grant any other role will result in a warning in logging.
29248
+ * Sets the IAM access control policy for an Engine. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on an Engine resource, the only recommended roles in the bindings are: `roles/discoveryengine.admin`, `roles/discoveryengine.agentspaceAdmin`, `roles/discoveryengine.user`, `roles/discoveryengine.agentspaceUser`, `roles/discoveryengine.viewer`, `roles/discoveryengine.agentspaceViewer`. Attempting to grant any other role will result in a warning in logging.
28394
29249
  * @example
28395
29250
  * ```js
28396
29251
  * // Before running the sample:
@@ -29018,7 +29873,9 @@ export declare namespace discoveryengine_v1 {
29018
29873
  * // {
29019
29874
  * // "answer": {},
29020
29875
  * // "assistToken": "my_assistToken",
29876
+ * // "connectorAuthErrors": [],
29021
29877
  * // "invocationTools": [],
29878
+ * // "invokedSkills": [],
29022
29879
  * // "sessionInfo": {}
29023
29880
  * // }
29024
29881
  * }
@@ -32617,6 +33474,7 @@ export declare namespace discoveryengine_v1 {
32617
33474
  * // "isPinned": false,
32618
33475
  * // "labels": [],
32619
33476
  * // "name": "my_name",
33477
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
32620
33478
  * // "startTime": "my_startTime",
32621
33479
  * // "state": "my_state",
32622
33480
  * // "turns": [],
@@ -32634,6 +33492,7 @@ export declare namespace discoveryengine_v1 {
32634
33492
  * // "isPinned": false,
32635
33493
  * // "labels": [],
32636
33494
  * // "name": "my_name",
33495
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
32637
33496
  * // "startTime": "my_startTime",
32638
33497
  * // "state": "my_state",
32639
33498
  * // "turns": [],
@@ -32776,6 +33635,7 @@ export declare namespace discoveryengine_v1 {
32776
33635
  * // "isPinned": false,
32777
33636
  * // "labels": [],
32778
33637
  * // "name": "my_name",
33638
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
32779
33639
  * // "startTime": "my_startTime",
32780
33640
  * // "state": "my_state",
32781
33641
  * // "turns": [],
@@ -32840,7 +33700,7 @@ export declare namespace discoveryengine_v1 {
32840
33700
  * await discoveryengine.projects.locations.collections.engines.sessions.list({
32841
33701
  * // A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` * `collaborative_project` Examples: * `user_pseudo_id = some_id` * `display_name = "some_name"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time \> "1970-01-01T12:00:00Z"` * `collaborative_project = "projects/123/locations/global/collections/default_collection/engines/" "default_engine/collaborative_projects/cp1"`
32842
33702
  * filter: 'placeholder-value',
32843
- * // A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
33703
+ * // A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
32844
33704
  * orderBy: 'placeholder-value',
32845
33705
  * // Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
32846
33706
  * pageSize: 'placeholder-value',
@@ -32929,6 +33789,7 @@ export declare namespace discoveryengine_v1 {
32929
33789
  * // "isPinned": false,
32930
33790
  * // "labels": [],
32931
33791
  * // "name": "my_name",
33792
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
32932
33793
  * // "startTime": "my_startTime",
32933
33794
  * // "state": "my_state",
32934
33795
  * // "turns": [],
@@ -32946,6 +33807,7 @@ export declare namespace discoveryengine_v1 {
32946
33807
  * // "isPinned": false,
32947
33808
  * // "labels": [],
32948
33809
  * // "name": "my_name",
33810
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
32949
33811
  * // "startTime": "my_startTime",
32950
33812
  * // "state": "my_state",
32951
33813
  * // "turns": [],
@@ -33008,7 +33870,7 @@ export declare namespace discoveryengine_v1 {
33008
33870
  */
33009
33871
  filter?: string;
33010
33872
  /**
33011
- * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
33873
+ * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
33012
33874
  */
33013
33875
  orderBy?: string;
33014
33876
  /**
@@ -33174,6 +34036,10 @@ export declare namespace discoveryengine_v1 {
33174
34036
  * // Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.
33175
34037
  * 'getWidgetConfigRequestOption.turnOffCollectionComponents':
33176
34038
  * 'placeholder-value',
34039
+ * // Optional. BCP-47 language tag (e.g. "en", "fr-CA"). Used to localize human-readable strings in the response, such as the model selector `display_name` / `description` on `WidgetConfig.UiSettings.ModelConfigInfo`. Empty / unset falls back to the default language (English).
34040
+ * languageCode: 'placeholder-value',
34041
+ * // Optional. Selects which view of `WidgetConfig.UiSettings.ModelConfigInfo` the backend computes. `MODEL_INFO_VIEW_ADMIN` is set by the Cloud Console admin "Feature Management" page (screen/4Vn9gQKbN8tb7gm) to receive the admin-surfaced model set with `ResolvedModel.admin_view` populated; unset / `MODEL_INFO_VIEW_WEB` returns the end-user selector. The mobile surface is detected from the `X-Goog-Gemini-Enterprise-Mobile` header instead (see `ModelInfoView`).
34042
+ * modelInfoView: 'placeholder-value',
33177
34043
  * // Required. Full WidgetConfig resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}/dataStores/{data_store_id\}/widgetConfigs/{widget_config_id\}`
33178
34044
  * name: 'projects/my-project/locations/my-location/collections/my-collection/engines/my-engine/widgetConfigs/my-widgetConfig',
33179
34045
  * },
@@ -33186,6 +34052,7 @@ export declare namespace discoveryengine_v1 {
33186
34052
  * // "allowPublicAccess": false,
33187
34053
  * // "allowlistedDomains": [],
33188
34054
  * // "assistantSettings": {},
34055
+ * // "batchAuthStatuses": [],
33189
34056
  * // "collectionComponents": [],
33190
34057
  * // "configId": "my_configId",
33191
34058
  * // "contentSearchSpec": {},
@@ -33291,6 +34158,7 @@ export declare namespace discoveryengine_v1 {
33291
34158
  * // "allowPublicAccess": false,
33292
34159
  * // "allowlistedDomains": [],
33293
34160
  * // "assistantSettings": {},
34161
+ * // "batchAuthStatuses": [],
33294
34162
  * // "collectionComponents": [],
33295
34163
  * // "configId": "my_configId",
33296
34164
  * // "contentSearchSpec": {},
@@ -33336,6 +34204,7 @@ export declare namespace discoveryengine_v1 {
33336
34204
  * // "allowPublicAccess": false,
33337
34205
  * // "allowlistedDomains": [],
33338
34206
  * // "assistantSettings": {},
34207
+ * // "batchAuthStatuses": [],
33339
34208
  * // "collectionComponents": [],
33340
34209
  * // "configId": "my_configId",
33341
34210
  * // "contentSearchSpec": {},
@@ -33400,6 +34269,14 @@ export declare namespace discoveryengine_v1 {
33400
34269
  * Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.
33401
34270
  */
33402
34271
  'getWidgetConfigRequestOption.turnOffCollectionComponents'?: boolean;
34272
+ /**
34273
+ * Optional. BCP-47 language tag (e.g. "en", "fr-CA"). Used to localize human-readable strings in the response, such as the model selector `display_name` / `description` on `WidgetConfig.UiSettings.ModelConfigInfo`. Empty / unset falls back to the default language (English).
34274
+ */
34275
+ languageCode?: string;
34276
+ /**
34277
+ * Optional. Selects which view of `WidgetConfig.UiSettings.ModelConfigInfo` the backend computes. `MODEL_INFO_VIEW_ADMIN` is set by the Cloud Console admin "Feature Management" page (screen/4Vn9gQKbN8tb7gm) to receive the admin-surfaced model set with `ResolvedModel.admin_view` populated; unset / `MODEL_INFO_VIEW_WEB` returns the end-user selector. The mobile surface is detected from the `X-Goog-Gemini-Enterprise-Mobile` header instead (see `ModelInfoView`).
34278
+ */
34279
+ modelInfoView?: string;
33403
34280
  /**
33404
34281
  * Required. Full WidgetConfig resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}/dataStores/{data_store_id\}/widgetConfigs/{widget_config_id\}`
33405
34282
  */
@@ -38515,6 +39392,7 @@ export declare namespace discoveryengine_v1 {
38515
39392
  * // "isPinned": false,
38516
39393
  * // "labels": [],
38517
39394
  * // "name": "my_name",
39395
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
38518
39396
  * // "startTime": "my_startTime",
38519
39397
  * // "state": "my_state",
38520
39398
  * // "turns": [],
@@ -38531,6 +39409,7 @@ export declare namespace discoveryengine_v1 {
38531
39409
  * // "isPinned": false,
38532
39410
  * // "labels": [],
38533
39411
  * // "name": "my_name",
39412
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
38534
39413
  * // "startTime": "my_startTime",
38535
39414
  * // "state": "my_state",
38536
39415
  * // "turns": [],
@@ -38670,6 +39549,7 @@ export declare namespace discoveryengine_v1 {
38670
39549
  * // "isPinned": false,
38671
39550
  * // "labels": [],
38672
39551
  * // "name": "my_name",
39552
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
38673
39553
  * // "startTime": "my_startTime",
38674
39554
  * // "state": "my_state",
38675
39555
  * // "turns": [],
@@ -38734,7 +39614,7 @@ export declare namespace discoveryengine_v1 {
38734
39614
  * {
38735
39615
  * // A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` * `collaborative_project` Examples: * `user_pseudo_id = some_id` * `display_name = "some_name"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time \> "1970-01-01T12:00:00Z"` * `collaborative_project = "projects/123/locations/global/collections/default_collection/engines/" "default_engine/collaborative_projects/cp1"`
38736
39616
  * filter: 'placeholder-value',
38737
- * // A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
39617
+ * // A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
38738
39618
  * orderBy: 'placeholder-value',
38739
39619
  * // Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
38740
39620
  * pageSize: 'placeholder-value',
@@ -38823,6 +39703,7 @@ export declare namespace discoveryengine_v1 {
38823
39703
  * // "isPinned": false,
38824
39704
  * // "labels": [],
38825
39705
  * // "name": "my_name",
39706
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
38826
39707
  * // "startTime": "my_startTime",
38827
39708
  * // "state": "my_state",
38828
39709
  * // "turns": [],
@@ -38839,6 +39720,7 @@ export declare namespace discoveryengine_v1 {
38839
39720
  * // "isPinned": false,
38840
39721
  * // "labels": [],
38841
39722
  * // "name": "my_name",
39723
+ * // "pendingAsyncAssistOperationId": "my_pendingAsyncAssistOperationId",
38842
39724
  * // "startTime": "my_startTime",
38843
39725
  * // "state": "my_state",
38844
39726
  * // "turns": [],
@@ -38901,7 +39783,7 @@ export declare namespace discoveryengine_v1 {
38901
39783
  */
38902
39784
  filter?: string;
38903
39785
  /**
38904
- * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
39786
+ * A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` * `is_pinned` * `display_name` Example: * `update_time desc` * `create_time` * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by update_time.
38905
39787
  */
38906
39788
  orderBy?: string;
38907
39789
  /**
@@ -40565,6 +41447,7 @@ export declare namespace discoveryengine_v1 {
40565
41447
  * // "entity": "my_entity",
40566
41448
  * // "eventTime": "my_eventTime",
40567
41449
  * // "eventType": "my_eventType",
41450
+ * // "feedback": {},
40568
41451
  * // "filter": "my_filter",
40569
41452
  * // "mediaInfo": {},
40570
41453
  * // "pageInfo": {},
@@ -40595,6 +41478,7 @@ export declare namespace discoveryengine_v1 {
40595
41478
  * // "entity": "my_entity",
40596
41479
  * // "eventTime": "my_eventTime",
40597
41480
  * // "eventType": "my_eventType",
41481
+ * // "feedback": {},
40598
41482
  * // "filter": "my_filter",
40599
41483
  * // "mediaInfo": {},
40600
41484
  * // "pageInfo": {},
@@ -40726,6 +41610,10 @@ export declare namespace discoveryengine_v1 {
40726
41610
  * // Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.
40727
41611
  * 'getWidgetConfigRequestOption.turnOffCollectionComponents':
40728
41612
  * 'placeholder-value',
41613
+ * // Optional. BCP-47 language tag (e.g. "en", "fr-CA"). Used to localize human-readable strings in the response, such as the model selector `display_name` / `description` on `WidgetConfig.UiSettings.ModelConfigInfo`. Empty / unset falls back to the default language (English).
41614
+ * languageCode: 'placeholder-value',
41615
+ * // Optional. Selects which view of `WidgetConfig.UiSettings.ModelConfigInfo` the backend computes. `MODEL_INFO_VIEW_ADMIN` is set by the Cloud Console admin "Feature Management" page (screen/4Vn9gQKbN8tb7gm) to receive the admin-surfaced model set with `ResolvedModel.admin_view` populated; unset / `MODEL_INFO_VIEW_WEB` returns the end-user selector. The mobile surface is detected from the `X-Goog-Gemini-Enterprise-Mobile` header instead (see `ModelInfoView`).
41616
+ * modelInfoView: 'placeholder-value',
40729
41617
  * // Required. Full WidgetConfig resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}/dataStores/{data_store_id\}/widgetConfigs/{widget_config_id\}`
40730
41618
  * name: 'projects/my-project/locations/my-location/dataStores/my-dataStore/widgetConfigs/my-widgetConfig',
40731
41619
  * });
@@ -40737,6 +41625,7 @@ export declare namespace discoveryengine_v1 {
40737
41625
  * // "allowPublicAccess": false,
40738
41626
  * // "allowlistedDomains": [],
40739
41627
  * // "assistantSettings": {},
41628
+ * // "batchAuthStatuses": [],
40740
41629
  * // "collectionComponents": [],
40741
41630
  * // "configId": "my_configId",
40742
41631
  * // "contentSearchSpec": {},
@@ -40841,6 +41730,7 @@ export declare namespace discoveryengine_v1 {
40841
41730
  * // "allowPublicAccess": false,
40842
41731
  * // "allowlistedDomains": [],
40843
41732
  * // "assistantSettings": {},
41733
+ * // "batchAuthStatuses": [],
40844
41734
  * // "collectionComponents": [],
40845
41735
  * // "configId": "my_configId",
40846
41736
  * // "contentSearchSpec": {},
@@ -40885,6 +41775,7 @@ export declare namespace discoveryengine_v1 {
40885
41775
  * // "allowPublicAccess": false,
40886
41776
  * // "allowlistedDomains": [],
40887
41777
  * // "assistantSettings": {},
41778
+ * // "batchAuthStatuses": [],
40888
41779
  * // "collectionComponents": [],
40889
41780
  * // "configId": "my_configId",
40890
41781
  * // "contentSearchSpec": {},
@@ -40949,6 +41840,14 @@ export declare namespace discoveryengine_v1 {
40949
41840
  * Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.
40950
41841
  */
40951
41842
  'getWidgetConfigRequestOption.turnOffCollectionComponents'?: boolean;
41843
+ /**
41844
+ * Optional. BCP-47 language tag (e.g. "en", "fr-CA"). Used to localize human-readable strings in the response, such as the model selector `display_name` / `description` on `WidgetConfig.UiSettings.ModelConfigInfo`. Empty / unset falls back to the default language (English).
41845
+ */
41846
+ languageCode?: string;
41847
+ /**
41848
+ * Optional. Selects which view of `WidgetConfig.UiSettings.ModelConfigInfo` the backend computes. `MODEL_INFO_VIEW_ADMIN` is set by the Cloud Console admin "Feature Management" page (screen/4Vn9gQKbN8tb7gm) to receive the admin-surfaced model set with `ResolvedModel.admin_view` populated; unset / `MODEL_INFO_VIEW_WEB` returns the end-user selector. The mobile surface is detected from the `X-Goog-Gemini-Enterprise-Mobile` header instead (see `ModelInfoView`).
41849
+ */
41850
+ modelInfoView?: string;
40952
41851
  /**
40953
41852
  * Required. Full WidgetConfig resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}/dataStores/{data_store_id\}/widgetConfigs/{widget_config_id\}`
40954
41853
  */
@@ -41905,6 +42804,7 @@ export declare namespace discoveryengine_v1 {
41905
42804
  * // "endDate": {},
41906
42805
  * // "freeTrial": false,
41907
42806
  * // "geminiBundle": false,
42807
+ * // "lastUserUpdateTime": "my_lastUserUpdateTime",
41908
42808
  * // "licenseCount": "my_licenseCount",
41909
42809
  * // "name": "my_name",
41910
42810
  * // "startDate": {},
@@ -41924,6 +42824,7 @@ export declare namespace discoveryengine_v1 {
41924
42824
  * // "endDate": {},
41925
42825
  * // "freeTrial": false,
41926
42826
  * // "geminiBundle": false,
42827
+ * // "lastUserUpdateTime": "my_lastUserUpdateTime",
41927
42828
  * // "licenseCount": "my_licenseCount",
41928
42829
  * // "name": "my_name",
41929
42830
  * // "startDate": {},
@@ -41999,6 +42900,7 @@ export declare namespace discoveryengine_v1 {
41999
42900
  * // "endDate": {},
42000
42901
  * // "freeTrial": false,
42001
42902
  * // "geminiBundle": false,
42903
+ * // "lastUserUpdateTime": "my_lastUserUpdateTime",
42002
42904
  * // "licenseCount": "my_licenseCount",
42003
42905
  * // "name": "my_name",
42004
42906
  * // "startDate": {},
@@ -42026,6 +42928,77 @@ export declare namespace discoveryengine_v1 {
42026
42928
  get(params: Params$Resource$Projects$Locations$Licenseconfigs$Get, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1LicenseConfig>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1LicenseConfig>): void;
42027
42929
  get(params: Params$Resource$Projects$Locations$Licenseconfigs$Get, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1LicenseConfig>): void;
42028
42930
  get(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1LicenseConfig>): void;
42931
+ /**
42932
+ * Lists all the LicenseConfigs associated with the project.
42933
+ * @example
42934
+ * ```js
42935
+ * // Before running the sample:
42936
+ * // - Enable the API at:
42937
+ * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com
42938
+ * // - Login into gcloud by running:
42939
+ * // ```sh
42940
+ * // $ gcloud auth application-default login
42941
+ * // ```
42942
+ * // - Install the npm module by running:
42943
+ * // ```sh
42944
+ * // $ npm install googleapis
42945
+ * // ```
42946
+ *
42947
+ * const {google} = require('googleapis');
42948
+ * const discoveryengine = google.discoveryengine('v1');
42949
+ *
42950
+ * async function main() {
42951
+ * const auth = new google.auth.GoogleAuth({
42952
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
42953
+ * scopes: [
42954
+ * 'https://www.googleapis.com/auth/cloud-platform',
42955
+ * 'https://www.googleapis.com/auth/discoveryengine.readwrite',
42956
+ * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite',
42957
+ * ],
42958
+ * });
42959
+ *
42960
+ * // Acquire an auth client, and bind it to all future calls
42961
+ * const authClient = await auth.getClient();
42962
+ * google.options({auth: authClient});
42963
+ *
42964
+ * // Do the magic
42965
+ * const res = await discoveryengine.projects.locations.licenseConfigs.list({
42966
+ * // Optional. The filter to apply to the list results. The supported fields are: * `subscription_tier` * `state` Examples: * `subscription_tier=SUBSCRIPTION_TIER_SEARCH,state=ACTIVE` - Lists all active search license configs. * `state=ACTIVE` - Lists all active license configs. The filter string should be a comma-separated list of field=value pairs.
42967
+ * filter: 'placeholder-value',
42968
+ * // Optional. Not supported.
42969
+ * pageSize: 'placeholder-value',
42970
+ * // Optional. Not supported.
42971
+ * pageToken: 'placeholder-value',
42972
+ * // Required. The parent branch resource name, such as `projects/{project\}/locations/{location\}`.
42973
+ * parent: 'projects/my-project/locations/my-location',
42974
+ * });
42975
+ * console.log(res.data);
42976
+ *
42977
+ * // Example response
42978
+ * // {
42979
+ * // "licenseConfigs": [],
42980
+ * // "nextPageToken": "my_nextPageToken"
42981
+ * // }
42982
+ * }
42983
+ *
42984
+ * main().catch(e => {
42985
+ * console.error(e);
42986
+ * throw e;
42987
+ * });
42988
+ *
42989
+ * ```
42990
+ *
42991
+ * @param params - Parameters for request
42992
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
42993
+ * @param callback - Optional callback that handles the response.
42994
+ * @returns A promise if used with async/await, or void if used with a callback.
42995
+ */
42996
+ list(params: Params$Resource$Projects$Locations$Licenseconfigs$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
42997
+ list(params?: Params$Resource$Projects$Locations$Licenseconfigs$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudDiscoveryengineV1ListLicenseConfigsResponse>>;
42998
+ list(params: Params$Resource$Projects$Locations$Licenseconfigs$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
42999
+ list(params: Params$Resource$Projects$Locations$Licenseconfigs$List, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1ListLicenseConfigsResponse>, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1ListLicenseConfigsResponse>): void;
43000
+ list(params: Params$Resource$Projects$Locations$Licenseconfigs$List, callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1ListLicenseConfigsResponse>): void;
43001
+ list(callback: BodyResponseCallback<Schema$GoogleCloudDiscoveryengineV1ListLicenseConfigsResponse>): void;
42029
43002
  /**
42030
43003
  * Updates the LicenseConfig
42031
43004
  * @example
@@ -42076,6 +43049,7 @@ export declare namespace discoveryengine_v1 {
42076
43049
  * // "endDate": {},
42077
43050
  * // "freeTrial": false,
42078
43051
  * // "geminiBundle": false,
43052
+ * // "lastUserUpdateTime": "my_lastUserUpdateTime",
42079
43053
  * // "licenseCount": "my_licenseCount",
42080
43054
  * // "name": "my_name",
42081
43055
  * // "startDate": {},
@@ -42095,6 +43069,7 @@ export declare namespace discoveryengine_v1 {
42095
43069
  * // "endDate": {},
42096
43070
  * // "freeTrial": false,
42097
43071
  * // "geminiBundle": false,
43072
+ * // "lastUserUpdateTime": "my_lastUserUpdateTime",
42098
43073
  * // "licenseCount": "my_licenseCount",
42099
43074
  * // "name": "my_name",
42100
43075
  * // "startDate": {},
@@ -42143,6 +43118,24 @@ export declare namespace discoveryengine_v1 {
42143
43118
  */
42144
43119
  name?: string;
42145
43120
  }
43121
+ export interface Params$Resource$Projects$Locations$Licenseconfigs$List extends StandardParameters {
43122
+ /**
43123
+ * Optional. The filter to apply to the list results. The supported fields are: * `subscription_tier` * `state` Examples: * `subscription_tier=SUBSCRIPTION_TIER_SEARCH,state=ACTIVE` - Lists all active search license configs. * `state=ACTIVE` - Lists all active license configs. The filter string should be a comma-separated list of field=value pairs.
43124
+ */
43125
+ filter?: string;
43126
+ /**
43127
+ * Optional. Not supported.
43128
+ */
43129
+ pageSize?: number;
43130
+ /**
43131
+ * Optional. Not supported.
43132
+ */
43133
+ pageToken?: string;
43134
+ /**
43135
+ * Required. The parent branch resource name, such as `projects/{project\}/locations/{location\}`.
43136
+ */
43137
+ parent?: string;
43138
+ }
42146
43139
  export interface Params$Resource$Projects$Locations$Licenseconfigs$Patch extends StandardParameters {
42147
43140
  /**
42148
43141
  * Immutable. Identifier. The fully qualified resource name of the license config. Format: `projects/{project\}/locations/{location\}/licenseConfigs/{license_config\}`
@@ -42718,6 +43711,7 @@ export declare namespace discoveryengine_v1 {
42718
43711
  * // "entity": "my_entity",
42719
43712
  * // "eventTime": "my_eventTime",
42720
43713
  * // "eventType": "my_eventType",
43714
+ * // "feedback": {},
42721
43715
  * // "filter": "my_filter",
42722
43716
  * // "mediaInfo": {},
42723
43717
  * // "pageInfo": {},
@@ -42748,6 +43742,7 @@ export declare namespace discoveryengine_v1 {
42748
43742
  * // "entity": "my_entity",
42749
43743
  * // "eventTime": "my_eventTime",
42750
43744
  * // "eventType": "my_eventType",
43745
+ * // "feedback": {},
42751
43746
  * // "filter": "my_filter",
42752
43747
  * // "mediaInfo": {},
42753
43748
  * // "pageInfo": {},
@@ -43212,7 +44207,7 @@ export declare namespace discoveryengine_v1 {
43212
44207
  * filter: 'placeholder-value',
43213
44208
  * // Optional. The order in which the UserLicenses are listed. The value must be a comma-separated list of fields. Default sorting order is ascending. To specify descending order for a field, append a " desc" suffix. Redundant space characters in the syntax are insignificant. Supported fields (only `user_principal` is supported for now): * `user_principal` If not set, the default ordering is by `user_principal`. Examples: * `user_principal` to order by `user_principal` in ascending order. * `user_principal desc` to order by `user_principal` in descending order.
43214
44209
  * orderBy: 'placeholder-value',
43215
- * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 10. The maximum value is 50; values above 50 will be coerced to 50. If this field is negative, an INVALID_ARGUMENT error is returned.
44210
+ * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 100. The maximum value is 1000; values above 1000 will be coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is returned.
43216
44211
  * pageSize: 'placeholder-value',
43217
44212
  * // Optional. A page token, received from a previous `ListUserLicenses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLicenses` must match the call that provided the page token.
43218
44213
  * pageToken: 'placeholder-value',
@@ -43258,7 +44253,7 @@ export declare namespace discoveryengine_v1 {
43258
44253
  */
43259
44254
  orderBy?: string;
43260
44255
  /**
43261
- * Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 10. The maximum value is 50; values above 50 will be coerced to 50. If this field is negative, an INVALID_ARGUMENT error is returned.
44256
+ * Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 100. The maximum value is 1000; values above 1000 will be coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is returned.
43262
44257
  */
43263
44258
  pageSize?: number;
43264
44259
  /**