@maxim_mazurok/gapi.client.discoveryengine-v1beta 0.0.20240512 → 0.0.20240526

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://discoveryengine.googleapis.com/$discovery/rest?version=v1beta
-// Revision: 20240512
+// Revision: 20240526
 
 /// <reference types="gapi.client" />
 
@@ -155,6 +155,8 @@ declare namespace gapi.client {
       document?: string;
       /** Page identifier. */
       pageIdentifier?: string;
+      /** The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result. */
+      structData?: {[P in string]: any};
       /** Title. */
       title?: string;
       /** URI for the document. */
@@ -165,6 +167,8 @@ declare namespace gapi.client {
       chunkContents?: GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent[];
       /** Document resource name. */
       document?: string;
+      /** The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result. */
+      structData?: {[P in string]: any};
       /** Title. */
       title?: string;
       /** URI for the document. */
@@ -236,6 +240,68 @@ declare namespace gapi.client {
       /** TargetSites created. */
       targetSites?: GoogleCloudDiscoveryengineV1alphaTargetSite[];
     }
+    interface GoogleCloudDiscoveryengineV1alphaCondition {
+      /** Range of time(s) specifying when condition is active. Maximum of 10 time ranges. */
+      activeTimeRange?: GoogleCloudDiscoveryengineV1alphaConditionTimeRange[];
+      /** Search only A list of terms to match the query on. Maximum of 10 query terms. */
+      queryTerms?: GoogleCloudDiscoveryengineV1alphaConditionQueryTerm[];
+    }
+    interface GoogleCloudDiscoveryengineV1alphaConditionQueryTerm {
+      /** Whether the search query needs to exactly match the query term. */
+      fullMatch?: boolean;
+      /** The specific query value to match against Must be lowercase, must be UTF-8. Can have at most 3 space separated terms if full_match is true. Cannot be an empty string. Maximum length of 5000 characters. */
+      value?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1alphaConditionTimeRange {
+      /** End of time range. Range is inclusive. Must be in the future. */
+      endTime?: string;
+      /** Start of time range. Range is inclusive. */
+      startTime?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1alphaControl {
+      /** Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes. */
+      associatedServingConfigIds?: string[];
+      /** Defines a boost-type control */
+      boostAction?: GoogleCloudDiscoveryengineV1alphaControlBoostAction;
+      /** Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown. */
+      conditions?: GoogleCloudDiscoveryengineV1alphaCondition[];
+      /** Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      displayName?: string;
+      /** Defines a filter-type control Currently not supported by Recommendation */
+      filterAction?: GoogleCloudDiscoveryengineV1alphaControlFilterAction;
+      /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+      name?: string;
+      /** Defines a redirect-type control. */
+      redirectAction?: GoogleCloudDiscoveryengineV1alphaControlRedirectAction;
+      /** Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown. */
+      solutionType?: string;
+      /** Treats a group of terms as synonyms of one another. */
+      synonymsAction?: GoogleCloudDiscoveryengineV1alphaControlSynonymsAction;
+      /** Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH. */
+      useCases?: string[];
+    }
+    interface GoogleCloudDiscoveryengineV1alphaControlBoostAction {
+      /** Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op). */
+      boost?: number;
+      /** Required. Specifies which data store's documents can be boosted by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store */
+      dataStore?: string;
+      /** Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      filter?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1alphaControlFilterAction {
+      /** Required. Specifies which data store's documents can be filtered by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store */
+      dataStore?: string;
+      /** Required. A filter to apply on the matching condition results. Required Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      filter?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1alphaControlRedirectAction {
+      /** Required. The URI to which the shopper will be redirected. Required. URI must have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      redirectUri?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1alphaControlSynonymsAction {
+      /** Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown. */
+      synonyms?: string[];
+    }
     interface GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -267,6 +333,7 @@ declare namespace gapi.client {
       displayName?: string;
       /** The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`). */
       modelState?: string;
+      /** The version of the model. */
       modelVersion?: string;
       /** Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters. */
       name?: string;
@@ -386,7 +453,7 @@ declare namespace gapi.client {
       dataStoreIds?: string[];
       /** Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters. */
       displayName?: string;
-      /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore liniked to the engine. */
+      /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine. */
       industryVertical?: string;
       /** Configurations for the Media Engine. Only applicable on the data stores with solution_type SOLUTION_TYPE_RECOMMENDATION and IndustryVertical.MEDIA vertical. */
       mediaRecommendationEngineConfig?: GoogleCloudDiscoveryengineV1alphaEngineMediaRecommendationEngineConfig;
@@ -424,7 +491,7 @@ declare namespace gapi.client {
       dialogflowAgent?: string;
     }
     interface GoogleCloudDiscoveryengineV1alphaEngineCommonConfig {
-      /** Immutable. The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. */
+      /** The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. */
       companyName?: string;
     }
     interface GoogleCloudDiscoveryengineV1alphaEngineMediaRecommendationEngineConfig {
@@ -489,6 +556,8 @@ declare namespace gapi.client {
       recsFilterableOption?: string;
       /** If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error. */
       retrievableOption?: string;
+      /** Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished */
+      schemaOrgPaths?: string[];
       /** If searchable_option is SEARCHABLE_ENABLED, field values are searchable by text queries in SearchService.Search. If SEARCHABLE_ENABLED but field type is numerical, field values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical fields. If searchable_option is unset, the server behavior defaults to SEARCHABLE_DISABLED for fields that support setting searchable options. Only `string` fields that have no key property mapping support setting searchable_option. For those fields that do not support setting searchable options, the server will skip searchable option setting, and setting searchable_option for those fields will throw `INVALID_ARGUMENT` error. */
       searchableOption?: string;
     }
@@ -696,7 +765,7 @@ declare namespace gapi.client {
       userPseudoId?: string;
     }
     interface GoogleCloudDiscoveryengineV1alphaSessionTurn {
-      /** The resource name of the answer to the user query. */
+      /** The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn. */
       answer?: string;
       /** The user query. */
       query?: GoogleCloudDiscoveryengineV1alphaQuery;
@@ -833,7 +902,7 @@ declare namespace gapi.client {
       safetySpec?: GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpec;
       /** Search specification. */
       searchSpec?: GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpec;
-      /** The session resource name. Not required. When session field is not set, the API is in sessionless mode. We support auto session mode: users can use the wildcard symbol “-” as session id. A new id will be automatically generated and assigned. */
+      /** The session resource name. Not required. When session field is not set, the API is in sessionless mode. We support auto session mode: users can use the wildcard symbol `-` as session ID. A new ID will be automatically generated and assigned. */
       session?: string;
       /** A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
       userPseudoId?: string;
@@ -843,6 +912,8 @@ declare namespace gapi.client {
       answerLanguageCode?: string;
       /** Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead. */
       ignoreAdversarialQuery?: boolean;
+      /** Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service. */
+      ignoreLowRelevantContent?: boolean;
       /** Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead. */
       ignoreNonAnswerSeekingQuery?: boolean;
       /** Specifies whether to include citation metadata in the answer. The default value is `false`. */
@@ -893,6 +964,8 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpecSearchParams {
       /** Boost specification to boost certain documents in search results which may affect the answer query response. For more information on boosting, see [Boosting](https://cloud.google.com/retail/docs/boosting#boost) */
       boostSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec;
+      /** Specs defining dataStores to filter on in a search call and configurations for those dataStores. This is only considered for engines with multiple dataStores use case. For single dataStore within an engine, they should use the specs at the top level. */
+      dataStoreSpecs?: GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec[];
       /** The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. This will be used to filter search results which may affect the Answer response. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customers might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY("king kong")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) */
       filter?: string;
       /** Number of search results to return. The default value is 10. */
@@ -987,6 +1060,8 @@ declare namespace gapi.client {
       document?: string;
       /** Page identifier. */
       pageIdentifier?: string;
+      /** The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result. */
+      structData?: {[P in string]: any};
       /** Title. */
       title?: string;
       /** URI for the document. */
@@ -997,6 +1072,8 @@ declare namespace gapi.client {
       chunkContents?: GoogleCloudDiscoveryengineV1betaAnswerReferenceUnstructuredDocumentInfoChunkContent[];
       /** Document resource name. */
       document?: string;
+      /** The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result. */
+      structData?: {[P in string]: any};
       /** Title. */
       title?: string;
       /** URI for the document. */
@@ -1191,6 +1268,68 @@ declare namespace gapi.client {
       /** End user selected CompleteQueryResponse.QuerySuggestion.suggestion. */
       selectedSuggestion?: string;
     }
+    interface GoogleCloudDiscoveryengineV1betaCondition {
+      /** Range of time(s) specifying when condition is active. Maximum of 10 time ranges. */
+      activeTimeRange?: GoogleCloudDiscoveryengineV1betaConditionTimeRange[];
+      /** Search only A list of terms to match the query on. Maximum of 10 query terms. */
+      queryTerms?: GoogleCloudDiscoveryengineV1betaConditionQueryTerm[];
+    }
+    interface GoogleCloudDiscoveryengineV1betaConditionQueryTerm {
+      /** Whether the search query needs to exactly match the query term. */
+      fullMatch?: boolean;
+      /** The specific query value to match against Must be lowercase, must be UTF-8. Can have at most 3 space separated terms if full_match is true. Cannot be an empty string. Maximum length of 5000 characters. */
+      value?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1betaConditionTimeRange {
+      /** End of time range. Range is inclusive. Must be in the future. */
+      endTime?: string;
+      /** Start of time range. Range is inclusive. */
+      startTime?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1betaControl {
+      /** Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes. */
+      associatedServingConfigIds?: string[];
+      /** Defines a boost-type control */
+      boostAction?: GoogleCloudDiscoveryengineV1betaControlBoostAction;
+      /** Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown. */
+      conditions?: GoogleCloudDiscoveryengineV1betaCondition[];
+      /** Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      displayName?: string;
+      /** Defines a filter-type control Currently not supported by Recommendation */
+      filterAction?: GoogleCloudDiscoveryengineV1betaControlFilterAction;
+      /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+      name?: string;
+      /** Defines a redirect-type control. */
+      redirectAction?: GoogleCloudDiscoveryengineV1betaControlRedirectAction;
+      /** Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown. */
+      solutionType?: string;
+      /** Treats a group of terms as synonyms of one another. */
+      synonymsAction?: GoogleCloudDiscoveryengineV1betaControlSynonymsAction;
+      /** Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH. */
+      useCases?: string[];
+    }
+    interface GoogleCloudDiscoveryengineV1betaControlBoostAction {
+      /** Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op). */
+      boost?: number;
+      /** Required. Specifies which data store's documents can be boosted by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store */
+      dataStore?: string;
+      /** Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      filter?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1betaControlFilterAction {
+      /** Required. Specifies which data store's documents can be filtered by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store */
+      dataStore?: string;
+      /** Required. A filter to apply on the matching condition results. Required Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      filter?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1betaControlRedirectAction {
+      /** Required. The URI to which the shopper will be redirected. Required. URI must have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      redirectUri?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1betaControlSynonymsAction {
+      /** Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown. */
+      synonyms?: string[];
+    }
     interface GoogleCloudDiscoveryengineV1betaConversation {
       /** Output only. The time the conversation finished. */
       endTime?: string;
@@ -1290,6 +1429,7 @@ declare namespace gapi.client {
       displayName?: string;
       /** The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`). */
       modelState?: string;
+      /** The version of the model. */
       modelVersion?: string;
       /** Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters. */
       name?: string;
@@ -1383,7 +1523,7 @@ declare namespace gapi.client {
       name?: string;
       /** The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID. */
       promotionIds?: string[];
-      /** Quantity of the Document associated with the user event. Defaults to 1. For example, this field will be 2 if two quantities of the same Document are involved in a `add-to-cart` event. Required for events of the following event types: * `add-to-cart` * `purchase` */
+      /** Quantity of the Document associated with the user event. Defaults to 1. For example, this field is 2 if two quantities of the same Document are involved in a `add-to-cart` event. Required for events of the following event types: * `add-to-cart` * `purchase` */
       quantity?: number;
       /** The Document URI - only allowed for website data stores. */
       uri?: string;
@@ -1440,7 +1580,7 @@ declare namespace gapi.client {
       dataStoreIds?: string[];
       /** Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters. */
       displayName?: string;
-      /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore liniked to the engine. */
+      /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine. */
       industryVertical?: string;
       /** Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*‍/. Otherwise, an INVALID_ARGUMENT error is returned. */
       name?: string;
@@ -1472,7 +1612,7 @@ declare namespace gapi.client {
       dialogflowAgent?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaEngineCommonConfig {
-      /** Immutable. The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. */
+      /** The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. */
       companyName?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaEngineSearchEngineConfig {
@@ -1506,7 +1646,7 @@ declare namespace gapi.client {
       gcsStagingDir?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaFirestoreSource {
-      /** Required. The Firestore collection to copy the data from with a length limit of 1,500 characters. */
+      /** Required. The Firestore collection (or entity) to copy the data from with a length limit of 1,500 characters. */
       collectionId?: string;
       /** Required. The Firestore database to copy the data from with a length limit of 256 characters. */
       databaseId?: string;
@@ -1516,9 +1656,9 @@ declare namespace gapi.client {
       projectId?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaGcsSource {
-      /** The schema to use when parsing the data from the source. Supported values for document imports: * `document` (default): One JSON Document per line. Each document must have a valid Document.id. * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by `input_uris` becomes a document, with the ID set to the first 128 bits of SHA256(URI) encoded as a hex string. * `custom`: One custom data JSON per row in arbitrary format that conforms to the defined Schema of the data store. This can only be used by the GENERIC Data Store vertical. * `csv`: A CSV file with header conforming to the defined Schema of the data store. Each entry after the header is imported as a Document. This can only be used by the GENERIC Data Store vertical. Supported values for user even imports: * `user_event` (default): One JSON UserEvent per line. */
+      /** The schema to use when parsing the data from the source. Supported values for document imports: * `document` (default): One JSON Document per line. Each document must have a valid Document.id. * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by `input_uris` becomes a document, with the ID set to the first 128 bits of SHA256(URI) encoded as a hex string. * `custom`: One custom data JSON per row in arbitrary format that conforms to the defined Schema of the data store. This can only be used by the GENERIC Data Store vertical. * `csv`: A CSV file with header conforming to the defined Schema of the data store. Each entry after the header is imported as a Document. This can only be used by the GENERIC Data Store vertical. Supported values for user event imports: * `user_event` (default): One JSON UserEvent per line. */
       dataSchema?: string;
-      /** Required. Cloud Storage URIs to input files. URI can be up to 2000 characters long. URIs can match the full object path (for example, `gs://bucket/directory/object.json`) or a pattern matching one or more files, such as `gs://bucket/directory/*.json`. A request can contain at most 100 files (or 100,000 files if `data_schema` is `content`). Each file can be up to 2 GB (or 100 MB if `data_schema` is `content`). */
+      /** Required. Cloud Storage URIs to input files. Each URI can be up to 2000 characters long. URIs can match the full object path (for example, `gs://bucket/directory/object.json`) or a pattern matching one or more files, such as `gs://bucket/directory/*.json`. A request can contain at most 100 files (or 100,000 files if `data_schema` is `content`). Each file can be up to 2 GB (or 100 MB if `data_schema` is `content`). */
       inputUris?: string[];
     }
     interface GoogleCloudDiscoveryengineV1betaGroundingFact {
@@ -1649,6 +1789,12 @@ declare namespace gapi.client {
       /** Inclusive lower bound. */
       minimum?: number;
     }
+    interface GoogleCloudDiscoveryengineV1betaListControlsResponse {
+      /** All the Controls for a given data store. */
+      controls?: GoogleCloudDiscoveryengineV1betaControl[];
+      /** Pagination token, if not returned indicates the last page. */
+      nextPageToken?: string;
+    }
     interface GoogleCloudDiscoveryengineV1betaListConversationsResponse {
       /** All the Conversations for a given data store. */
       conversations?: GoogleCloudDiscoveryengineV1betaConversation[];
@@ -1730,6 +1876,37 @@ declare namespace gapi.client {
       totalPanels?: number;
     }
     interface GoogleCloudDiscoveryengineV1betaPauseEngineRequest {}
+    interface GoogleCloudDiscoveryengineV1betaProject {
+      /** Output only. The timestamp when this project is created. */
+      createTime?: string;
+      /** Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number. */
+      name?: string;
+      /** Output only. The timestamp when this project is successfully provisioned. Empty value means this project is still provisioning and is not ready for use. */
+      provisionCompletionTime?: string;
+      /** Output only. A map of terms of services. The key is the `id` of ServiceTerms. */
+      serviceTermsMap?: {
+        [P in string]: GoogleCloudDiscoveryengineV1betaProjectServiceTerms;
+      };
+    }
+    interface GoogleCloudDiscoveryengineV1betaProjectServiceTerms {
+      /** The last time when the project agreed to the terms of service. */
+      acceptTime?: string;
+      /** The last time when the project declined or revoked the agreement to terms of service. */
+      declineTime?: string;
+      /** The unique identifier of this terms of service. Available terms: * `GA_DATA_USE_TERMS`: [Terms for data use](https://cloud.google.com/retail/data-use-terms). When using this as `id`, the acceptable version to provide is `2022-11-23`. */
+      id?: string;
+      /** Whether the project has accepted/rejected the service terms or it is still pending. */
+      state?: string;
+      /** The version string of the terms of service. For acceptable values, see the comments for id above. */
+      version?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1betaProvisionProjectMetadata {}
+    interface GoogleCloudDiscoveryengineV1betaProvisionProjectRequest {
+      /** Required. Set to `true` to specify that caller has read and would like to give consent to the [Terms for data use](https://cloud.google.com/retail/data-use-terms). */
+      acceptDataUseTerms?: boolean;
+      /** Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time. */
+      dataUseTermsVersion?: string;
+    }
     interface GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -1794,23 +1971,25 @@ declare namespace gapi.client {
       records?: GoogleCloudDiscoveryengineV1betaRankingRecord[];
       /** The number of results to return. If this is unset or no bigger than zero, returns all results. */
       topN?: number;
+      /** The user labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. See [Google Cloud Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) for more details. */
+      userLabels?: {[P in string]: string};
     }
     interface GoogleCloudDiscoveryengineV1betaRankResponse {
       /** A list of records sorted by descending score. */
       records?: GoogleCloudDiscoveryengineV1betaRankingRecord[];
     }
     interface GoogleCloudDiscoveryengineV1betaRecommendRequest {
-      /** Filter for restricting recommendation results with a length limit of 5,000 characters. Currently, only filter expressions on the `filter_tags` attribute is supported. Examples: * `(filter_tags: ANY("Red", "Blue") OR filter_tags: ANY("Hot", "Cold"))` * `(filter_tags: ANY("Red", "Blue")) AND NOT (filter_tags: ANY("Green"))` If `attributeFilteringSyntax` is set to true under the `params` field, then attribute-based expressions are expected instead of the above described tag-based syntax. Examples: * (launguage: ANY("en", "es")) AND NOT (categories: ANY("Movie")) * (available: true) AND (launguage: ANY("en", "es")) OR (categories: ANY("Movie")) If your filter blocks all results, the API will return generic (unfiltered) popular Documents. If you only want results strictly matching the filters, set `strictFiltering` to True in RecommendRequest.params to receive empty results instead. Note that the API will never return Documents with `storageStatus` of `EXPIRED` or `DELETED` regardless of filter choices. */
+      /** Filter for restricting recommendation results with a length limit of 5,000 characters. Currently, only filter expressions on the `filter_tags` attribute is supported. Examples: * `(filter_tags: ANY("Red", "Blue") OR filter_tags: ANY("Hot", "Cold"))` * `(filter_tags: ANY("Red", "Blue")) AND NOT (filter_tags: ANY("Green"))` If `attributeFilteringSyntax` is set to true under the `params` field, then attribute-based expressions are expected instead of the above described tag-based syntax. Examples: * (launguage: ANY("en", "es")) AND NOT (categories: ANY("Movie")) * (available: true) AND (launguage: ANY("en", "es")) OR (categories: ANY("Movie")) If your filter blocks all results, the API returns generic (unfiltered) popular Documents. If you only want results strictly matching the filters, set `strictFiltering` to `true` in RecommendRequest.params to receive empty results instead. Note that the API never returns Documents with `storageStatus` as `EXPIRED` or `DELETED` regardless of filter choices. */
       filter?: string;
-      /** Maximum number of results to return. Set this property to the number of recommendation results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100. */
+      /** Maximum number of results to return. Set this property to the number of recommendation results needed. If zero, the service chooses a reasonable default. The maximum allowed value is 100. Values above 100 are set to 100. */
       pageSize?: number;
-      /** Additional domain specific parameters for the recommendations. Allowed values: * `returnDocument`: Boolean. If set to true, the associated Document object will be returned in RecommendResponse.RecommendationResult.document. * `returnScore`: Boolean. If set to true, the recommendation 'score' corresponding to each returned Document will be set in RecommendResponse.RecommendationResult.metadata. The given 'score' indicates the probability of a Document conversion given the user's context and history. * `strictFiltering`: Boolean. True by default. If set to false, the service will return generic (unfiltered) popular Documents instead of empty if your filter blocks all recommendation results. * `diversityLevel`: String. Default empty. If set to be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-level control and adjusts recommendation results based on Document category. * `attributeFilteringSyntax`: Boolean. False by default. If set to true, the `filter` field is interpreted according to the new, attribute-based syntax. */
+      /** Additional domain specific parameters for the recommendations. Allowed values: * `returnDocument`: Boolean. If set to `true`, the associated Document object is returned in RecommendResponse.RecommendationResult.document. * `returnScore`: Boolean. If set to true, the recommendation score corresponding to each returned Document is set in RecommendResponse.RecommendationResult.metadata. The given score indicates the probability of a Document conversion given the user's context and history. * `strictFiltering`: Boolean. True by default. If set to `false`, the service returns generic (unfiltered) popular Documents instead of empty if your filter blocks all recommendation results. * `diversityLevel`: String. Default empty. If set to be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-level control and adjusts recommendation results based on Document category. * `attributeFilteringSyntax`: Boolean. False by default. If set to true, the `filter` field is interpreted according to the new, attribute-based syntax. */
       params?: {[P in string]: any};
       /** Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. */
       userEvent?: GoogleCloudDiscoveryengineV1betaUserEvent;
       /** The user labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. See [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) for more details. */
       userLabels?: {[P in string]: string};
-      /** Use validate only mode for this recommendation query. If set to true, a fake model will be used that returns arbitrary Document IDs. Note that the validate only mode should only be used for testing the API, or if the model is not ready. */
+      /** Use validate only mode for this recommendation query. If set to `true`, a fake model is used that returns arbitrary Document IDs. Note that the validate only mode should only be used for testing the API, or if the model is not ready. */
       validateOnly?: boolean;
     }
     interface GoogleCloudDiscoveryengineV1betaRecommendResponse {
@@ -1828,7 +2007,7 @@ declare namespace gapi.client {
       document?: GoogleCloudDiscoveryengineV1betaDocument;
       /** Resource ID of the recommended Document. */
       id?: string;
-      /** Additional Document metadata / annotations. Possible values: * `score`: Recommendation score in double value. Is set if `returnScore` is set to true in RecommendRequest.params. */
+      /** Additional Document metadata or annotations. Possible values: * `score`: Recommendation score in double value. Is set if `returnScore` is set to true in RecommendRequest.params. */
       metadata?: {[P in string]: any};
     }
     interface GoogleCloudDiscoveryengineV1betaRecrawlUrisRequest {
@@ -1871,7 +2050,7 @@ declare namespace gapi.client {
       searchQuery?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchRequest {
-      /** Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/retail/docs/boosting#boost) */
+      /** Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results) */
       boostSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec;
       /** The branch resource name, such as `projects/*‍/locations/global/collections/default_collection/dataStores/default_data_store/branches/0`. Use `default_branch` as the branch ID or leave this field empty, to search documents under the default branch. */
       branch?: string;
@@ -1879,7 +2058,7 @@ declare namespace gapi.client {
       canonicalFilter?: string;
       /** A specification for configuring the behavior of content search. */
       contentSearchSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpec;
-      /** A list of data store specs to apply on a search call. */
+      /** Specs defining dataStores to filter on in a search call and configurations for those dataStores. This is only considered for engines with multiple dataStores use case. For single dataStore within an engine, they should use the specs at the top level. */
       dataStoreSpecs?: GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec[];
       /** Uses the provided embedding to do additional semantic document retrieval. The retrieval is based on the dot product of SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document embedding that is provided in SearchRequest.EmbeddingSpec.EmbeddingVector.field_path. If SearchRequest.EmbeddingSpec.EmbeddingVector.field_path is not provided, it will use ServingConfig.EmbeddingConfig.field_path. */
       embeddingSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec;
@@ -1897,7 +2076,7 @@ declare namespace gapi.client {
       pageSize?: number;
       /** A page token received from a previous SearchService.Search call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to SearchService.Search must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. */
       pageToken?: string;
-      /** Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. Example: user_country_code: "au" For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. Example: search_type: 1 */
+      /** Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: "au"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1` */
       params?: {[P in string]: any};
       /** Raw search query. */
       query?: string;
@@ -2019,13 +2198,13 @@ declare namespace gapi.client {
       excludedFilterKeys?: string[];
       /** Required. The facet key specification. */
       facetKey?: GoogleCloudDiscoveryengineV1betaSearchRequestFacetSpecFacetKey;
-      /** Maximum of facet values that should be returned for this facet. If unspecified, defaults to 20. The maximum allowed value is 300. Values above 300 are coerced to 300. If this field is negative, an `INVALID_ARGUMENT` is returned. */
+      /** Maximum facet values that are returned for this facet. If unspecified, defaults to 20. The maximum allowed value is 300. Values above 300 are coerced to 300. If this field is negative, an `INVALID_ARGUMENT` is returned. */
       limit?: number;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchRequestFacetSpecFacetKey {
       /** True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise. */
       caseInsensitive?: boolean;
-      /** Only get facet values that contains the given strings. For example, suppose "category" has three values "Action > 2022", "Action > 2021" and "Sci-Fi > 2022". If set "contains" to "2022", the "category" facet only contains "Action > 2022" and "Sci-Fi > 2022". Only supported on textual fields. Maximum is 10. */
+      /** Only get facet values that contain the given strings. For example, suppose "category" has three values "Action > 2022", "Action > 2021" and "Sci-Fi > 2022". If set "contains" to "2022", the "category" facet only contains "Action > 2022" and "Sci-Fi > 2022". Only supported on textual fields. Maximum is 10. */
       contains?: string[];
       /** Set only if values should be bucketed into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 30. */
       intervals?: GoogleCloudDiscoveryengineV1betaInterval[];
@@ -2049,7 +2228,7 @@ declare namespace gapi.client {
       pinUnexpandedResults?: boolean;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchRequestSpellCorrectionSpec {
-      /** The mode under which spell correction should take effect to replace the original search query. Default to Mode.AUTO. */
+      /** The mode under which spell correction replaces the original search query. Defaults to Mode.AUTO. */
       mode?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchResponse {
@@ -2080,7 +2259,7 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1betaSearchResponseFacet {
       /** Whether the facet is dynamically generated. */
       dynamicFacet?: boolean;
-      /** The key for this facet. E.g., "colors" or "price". It matches SearchRequest.FacetSpec.FacetKey.key. */
+      /** The key for this facet. For example, `"colors"` or `"price"`. It matches SearchRequest.FacetSpec.FacetKey.key. */
       key?: string;
       /** The facet values for this field. */
       values?: GoogleCloudDiscoveryengineV1betaSearchResponseFacetFacetValue[];
@@ -2106,9 +2285,9 @@ declare namespace gapi.client {
       refinementAttributes?: GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResultRefinementAttribute[];
     }
     interface GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResultRefinementAttribute {
-      /** Attribute key used to refine the results e.g. 'movie_type'. */
+      /** Attribute key used to refine the results. For example, `"movie_type"`. */
       attributeKey?: string;
-      /** Attribute value used to refine the results e.g. 'drama'. */
+      /** Attribute value used to refine the results. For example, `"drama"`. */
       attributeValue?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchResponseQueryExpansionInfo {
@@ -2118,7 +2297,7 @@ declare namespace gapi.client {
       pinnedResultCount?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchResponseSearchResult {
-      /** The document data snippet in the search response. Only fields that are marked as retrievable are populated. */
+      /** The document data snippet in the search response. Only fields that are marked as `retrievable` are populated. */
       document?: GoogleCloudDiscoveryengineV1betaDocument;
       /** Document.id of the searched Document. */
       id?: string;
@@ -2250,7 +2429,7 @@ declare namespace gapi.client {
       userPseudoId?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaSessionTurn {
-      /** The resource name of the answer to the user query. */
+      /** The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn. */
       answer?: string;
       /** The user query. */
       query?: GoogleCloudDiscoveryengineV1betaQuery;
@@ -2398,10 +2577,14 @@ declare namespace gapi.client {
       attributionToken?: string;
       /** CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. */
       completionInfo?: GoogleCloudDiscoveryengineV1betaCompletionInfo;
+      /** The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. */
+      dataStore?: string;
       /** Should set to true if the request is made directly from the end user, in which case the UserEvent.user_info.user_agent can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent. */
       directUserRequest?: boolean;
       /** List of Documents associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different UserEvent.documents is desired. */
       documents?: GoogleCloudDiscoveryengineV1betaDocumentInfo[];
+      /** The Engine resource name, in the form of `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. Optional. Only required for Engine produced user events. For example, user events from blended search. */
+      engine?: string;
       /** Only required for UserEventService.ImportUserEvents method. Timestamp of when the user event happened. */
       eventTime?: string;
       /** 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. */
@@ -2420,7 +2603,7 @@ declare namespace gapi.client {
       searchInfo?: GoogleCloudDiscoveryengineV1betaSearchInfo;
       /** A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. */
       sessionId?: string;
-      /** A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups on the customer end. */
+      /** A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. */
       tagIds?: string[];
       /** The transaction metadata (if any) associated with this user event. */
       transactionInfo?: GoogleCloudDiscoveryengineV1betaTransactionInfo;
@@ -2435,6 +2618,68 @@ declare namespace gapi.client {
       /** Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users. Always use a hashed value for this ID. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
       userId?: string;
     }
+    interface GoogleCloudDiscoveryengineV1Condition {
+      /** Range of time(s) specifying when condition is active. Maximum of 10 time ranges. */
+      activeTimeRange?: GoogleCloudDiscoveryengineV1ConditionTimeRange[];
+      /** Search only A list of terms to match the query on. Maximum of 10 query terms. */
+      queryTerms?: GoogleCloudDiscoveryengineV1ConditionQueryTerm[];
+    }
+    interface GoogleCloudDiscoveryengineV1ConditionQueryTerm {
+      /** Whether the search query needs to exactly match the query term. */
+      fullMatch?: boolean;
+      /** The specific query value to match against Must be lowercase, must be UTF-8. Can have at most 3 space separated terms if full_match is true. Cannot be an empty string. Maximum length of 5000 characters. */
+      value?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1ConditionTimeRange {
+      /** End of time range. Range is inclusive. Must be in the future. */
+      endTime?: string;
+      /** Start of time range. Range is inclusive. */
+      startTime?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1Control {
+      /** Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes. */
+      associatedServingConfigIds?: string[];
+      /** Defines a boost-type control */
+      boostAction?: GoogleCloudDiscoveryengineV1ControlBoostAction;
+      /** Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown. */
+      conditions?: GoogleCloudDiscoveryengineV1Condition[];
+      /** Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      displayName?: string;
+      /** Defines a filter-type control Currently not supported by Recommendation */
+      filterAction?: GoogleCloudDiscoveryengineV1ControlFilterAction;
+      /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+      name?: string;
+      /** Defines a redirect-type control. */
+      redirectAction?: GoogleCloudDiscoveryengineV1ControlRedirectAction;
+      /** Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown. */
+      solutionType?: string;
+      /** Treats a group of terms as synonyms of one another. */
+      synonymsAction?: GoogleCloudDiscoveryengineV1ControlSynonymsAction;
+      /** Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH. */
+      useCases?: string[];
+    }
+    interface GoogleCloudDiscoveryengineV1ControlBoostAction {
+      /** Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op). */
+      boost?: number;
+      /** Required. Specifies which data store's documents can be boosted by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store */
+      dataStore?: string;
+      /** Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      filter?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1ControlFilterAction {
+      /** Required. Specifies which data store's documents can be filtered by this control. Full data store name e.g. projects/123/locations/global/collections/default_collection/dataStores/default_data_store */
+      dataStore?: string;
+      /** Required. A filter to apply on the matching condition results. Required Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      filter?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1ControlRedirectAction {
+      /** Required. The URI to which the shopper will be redirected. Required. URI must have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT error is thrown. */
+      redirectUri?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1ControlSynonymsAction {
+      /** Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown. */
+      synonyms?: string[];
+    }
     interface GoogleCloudDiscoveryengineV1CreateDataStoreMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -2553,7 +2798,7 @@ declare namespace gapi.client {
       dataStoreIds?: string[];
       /** Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters. */
       displayName?: string;
-      /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore liniked to the engine. */
+      /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine. */
       industryVertical?: string;
       /** Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*‍/. Otherwise, an INVALID_ARGUMENT error is returned. */
       name?: string;
@@ -2585,7 +2830,7 @@ declare namespace gapi.client {
       dialogflowAgent?: string;
     }
     interface GoogleCloudDiscoveryengineV1EngineCommonConfig {
-      /** Immutable. The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. */
+      /** The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. */
       companyName?: string;
     }
     interface GoogleCloudDiscoveryengineV1EngineSearchEngineConfig {
@@ -2650,6 +2895,31 @@ declare namespace gapi.client {
       /** Count of user events imported, but with Document information not found in the existing Branch. */
       unjoinedEventsCount?: string;
     }
+    interface GoogleCloudDiscoveryengineV1Project {
+      /** Output only. The timestamp when this project is created. */
+      createTime?: string;
+      /** Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number. */
+      name?: string;
+      /** Output only. The timestamp when this project is successfully provisioned. Empty value means this project is still provisioning and is not ready for use. */
+      provisionCompletionTime?: string;
+      /** Output only. A map of terms of services. The key is the `id` of ServiceTerms. */
+      serviceTermsMap?: {
+        [P in string]: GoogleCloudDiscoveryengineV1ProjectServiceTerms;
+      };
+    }
+    interface GoogleCloudDiscoveryengineV1ProjectServiceTerms {
+      /** The last time when the project agreed to the terms of service. */
+      acceptTime?: string;
+      /** The last time when the project declined or revoked the agreement to terms of service. */
+      declineTime?: string;
+      /** The unique identifier of this terms of service. Available terms: * `GA_DATA_USE_TERMS`: [Terms for data use](https://cloud.google.com/retail/data-use-terms). When using this as `id`, the acceptable version to provide is `2022-11-23`. */
+      id?: string;
+      /** Whether the project has accepted/rejected the service terms or it is still pending. */
+      state?: string;
+      /** The version string of the terms of service. For acceptable values, see the comments for id above. */
+      version?: string;
+    }
+    interface GoogleCloudDiscoveryengineV1ProvisionProjectMetadata {}
     interface GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -2848,7 +3118,7 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: string;
-        /** Required. The ID to use for the Document, which will become the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
+        /** Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
         documentId?: string;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
@@ -2879,7 +3149,7 @@ declare namespace gapi.client {
           alt?: string;
           /** JSONP */
           callback?: string;
-          /** Required. The ID to use for the Document, which will become the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
+          /** Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
           documentId?: string;
           /** Selector specifying which fields to include in a partial response. */
           fields?: string;
@@ -2954,7 +3224,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<GoogleCloudDiscoveryengineV1betaDocument>;
-      /** Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items will be created. Note: It is possible for a subset of the Documents to be successfully updated. */
+      /** Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items are created. Note: It is possible for a subset of the Documents to be successfully updated. */
       import(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -3028,7 +3298,7 @@ declare namespace gapi.client {
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. */
+        /** Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 are set to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. */
         pageSize?: number;
         /** A page token ListDocumentsResponse.next_page_token, received from a previous DocumentService.ListDocuments call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to DocumentService.ListDocuments must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. */
         pageToken?: string;
@@ -3049,7 +3319,7 @@ declare namespace gapi.client {
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** If set to true, and the Document is not found, a new Document will be created. */
+        /** If set to `true` and the Document is not found, a new Document is be created. */
         allowMissing?: boolean;
         /** Data format for response. */
         alt?: string;
@@ -3067,7 +3337,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Indicates which fields in the provided imported 'document' to update. If not set, will by default update all fields. */
+        /** Indicates which fields in the provided imported 'document' to update. If not set, by default updates all fields. */
         updateMask?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -3082,7 +3352,7 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** If set to true, and the Document is not found, a new Document will be created. */
+          /** If set to `true` and the Document is not found, a new Document is be created. */
           allowMissing?: boolean;
           /** Data format for response. */
           alt?: string;
@@ -3100,7 +3370,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Indicates which fields in the provided imported 'document' to update. If not set, will by default update all fields. */
+          /** Indicates which fields in the provided imported 'document' to update. If not set, by default updates all fields. */
           updateMask?: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -3292,6 +3562,219 @@ declare namespace gapi.client {
       documents: DocumentsResource;
       operations: OperationsResource;
     }
+    interface ControlsResource {
+      /** Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/. */
+        controlId?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaControl;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/. */
+          controlId?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaControl
+      ): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      /** Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets a Control. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      /** Lists all Controls by their parent DataStore. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000. */
+        pageSize?: number;
+        /** Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page. */
+        pageToken?: string;
+        /** Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<GoogleCloudDiscoveryengineV1betaListControlsResponse>;
+      /** Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaControl;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaControl
+      ): Request<GoogleCloudDiscoveryengineV1betaControl>;
+    }
     interface ConversationsResource {
       /** Converses a conversation. */
       converse(request: {
@@ -3802,7 +4285,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Required. The ID to use for the Schema, which will become the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
+        /** Required. The ID to use for the Schema, which becomes the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
         schemaId?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -3833,7 +4316,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Required. The ID to use for the Schema, which will become the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
+          /** Required. The ID to use for the Schema, which becomes the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
           schemaId?: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -3912,7 +4395,7 @@ declare namespace gapi.client {
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. */
+        /** The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas are returned. The maximum value is 1000; values above 1000 are set to 1000. */
         pageSize?: number;
         /** A page token, received from a previous SchemaService.ListSchemas call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to SchemaService.ListSchemas must match the call that provided the page token. */
         pageToken?: string;
@@ -3933,7 +4416,7 @@ declare namespace gapi.client {
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** If set to true, and the Schema is not found, a new Schema will be created. In this situation, `update_mask` is ignored. */
+        /** If set to true, and the Schema is not found, a new Schema is created. In this situation, `update_mask` is ignored. */
         allowMissing?: boolean;
         /** Data format for response. */
         alt?: string;
@@ -3964,7 +4447,7 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** If set to true, and the Schema is not found, a new Schema will be created. In this situation, `update_mask` is ignored. */
+          /** If set to true, and the Schema is not found, a new Schema is created. In this situation, `update_mask` is ignored. */
           allowMissing?: boolean;
           /** Data format for response. */
           alt?: string;
@@ -4190,7 +4673,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
+        /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
         servingConfig: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -4219,7 +4702,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
+          /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
           servingConfig: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -5333,7 +5816,7 @@ declare namespace gapi.client {
         /** Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters. */
         userEvent?: string;
       }): Request<GoogleApiHttpBody>;
-      /** Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata. */
+      /** Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata. */
       import(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -5417,6 +5900,8 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
+        /** If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write. */
+        writeAsync?: boolean;
         /** Request body */
         resource: GoogleCloudDiscoveryengineV1betaUserEvent;
       }): Request<GoogleCloudDiscoveryengineV1betaUserEvent>;
@@ -5446,6 +5931,8 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
+          /** If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write. */
+          writeAsync?: boolean;
         },
         body: GoogleCloudDiscoveryengineV1betaUserEvent
       ): Request<GoogleCloudDiscoveryengineV1betaUserEvent>;
@@ -5645,7 +6132,7 @@ declare namespace gapi.client {
         callback?: string;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
-        /** Filter by solution type . For example: filter = 'solution_type:SOLUTION_TYPE_SEARCH' */
+        /** Filter by solution type . For example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'` */
         filter?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -5755,9 +6242,232 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
         /** Request body */
-        resource: GoogleCloudDiscoveryengineV1betaTrainCustomModelRequest;
-      }): Request<GoogleLongrunningOperation>;
-      trainCustomModel(
+        resource: GoogleCloudDiscoveryengineV1betaTrainCustomModelRequest;
+      }): Request<GoogleLongrunningOperation>;
+      trainCustomModel(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Required. The resource name of the Data Store, such as `projects/*‍/locations/global/collections/default_collection/dataStores/default_data_store`. This field is used to identify the data store where to train the models. */
+          dataStore: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaTrainCustomModelRequest
+      ): Request<GoogleLongrunningOperation>;
+      branches: BranchesResource;
+      controls: ControlsResource;
+      conversations: ConversationsResource;
+      customModels: CustomModelsResource;
+      models: ModelsResource;
+      operations: OperationsResource;
+      schemas: SchemasResource;
+      servingConfigs: ServingConfigsResource;
+      sessions: SessionsResource;
+      siteSearchEngine: SiteSearchEngineResource;
+      suggestionDenyListEntries: SuggestionDenyListEntriesResource;
+      userEvents: UserEventsResource;
+    }
+    interface ControlsResource {
+      /** Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/. */
+        controlId?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaControl;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/. */
+          controlId?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaControl
+      ): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      /** Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets a Control. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      /** Lists all Controls by their parent DataStore. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000. */
+        pageSize?: number;
+        /** Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page. */
+        pageToken?: string;
+        /** Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<GoogleCloudDiscoveryengineV1betaListControlsResponse>;
+      /** Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaControl;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      patch(
         request: {
           /** V1 error format. */
           '$.xgafv'?: string;
@@ -5767,36 +6477,27 @@ declare namespace gapi.client {
           alt?: string;
           /** JSONP */
           callback?: string;
-          /** Required. The resource name of the Data Store, such as `projects/*‍/locations/global/collections/default_collection/dataStores/default_data_store`. This field is used to identify the data store where to train the models. */
-          dataStore: string;
           /** Selector specifying which fields to include in a partial response. */
           fields?: string;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
+          /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+          name: string;
           /** OAuth 2.0 token for the current user. */
           oauth_token?: string;
           /** Returns response with indentations and line breaks. */
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
+          /** Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated. */
+          updateMask?: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
         },
-        body: GoogleCloudDiscoveryengineV1betaTrainCustomModelRequest
-      ): Request<GoogleLongrunningOperation>;
-      branches: BranchesResource;
-      conversations: ConversationsResource;
-      customModels: CustomModelsResource;
-      models: ModelsResource;
-      operations: OperationsResource;
-      schemas: SchemasResource;
-      servingConfigs: ServingConfigsResource;
-      sessions: SessionsResource;
-      siteSearchEngine: SiteSearchEngineResource;
-      suggestionDenyListEntries: SuggestionDenyListEntriesResource;
-      userEvents: UserEventsResource;
+        body: GoogleCloudDiscoveryengineV1betaControl
+      ): Request<GoogleCloudDiscoveryengineV1betaControl>;
     }
     interface ConversationsResource {
       /** Converses a conversation. */
@@ -6328,7 +7029,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
+        /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
         servingConfig: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -6357,7 +7058,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
+          /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
           servingConfig: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -7052,6 +7753,7 @@ declare namespace gapi.client {
         },
         body: GoogleCloudDiscoveryengineV1betaTuneEngineRequest
       ): Request<GoogleLongrunningOperation>;
+      controls: ControlsResource;
       conversations: ConversationsResource;
       operations: OperationsResource;
       servingConfigs: ServingConfigsResource;
@@ -7136,7 +7838,7 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: string;
-        /** Required. The ID to use for the Document, which will become the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
+        /** Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
         documentId?: string;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
@@ -7167,7 +7869,7 @@ declare namespace gapi.client {
           alt?: string;
           /** JSONP */
           callback?: string;
-          /** Required. The ID to use for the Document, which will become the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
+          /** Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. */
           documentId?: string;
           /** Selector specifying which fields to include in a partial response. */
           fields?: string;
@@ -7242,7 +7944,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<GoogleCloudDiscoveryengineV1betaDocument>;
-      /** Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items will be created. Note: It is possible for a subset of the Documents to be successfully updated. */
+      /** Bulk import of multiple Documents. Request processing may be synchronous. Non-existing items are created. Note: It is possible for a subset of the Documents to be successfully updated. */
       import(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -7316,7 +8018,7 @@ declare namespace gapi.client {
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. */
+        /** Maximum number of Documents to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 are set to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. */
         pageSize?: number;
         /** A page token ListDocumentsResponse.next_page_token, received from a previous DocumentService.ListDocuments call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to DocumentService.ListDocuments must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. */
         pageToken?: string;
@@ -7337,7 +8039,7 @@ declare namespace gapi.client {
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** If set to true, and the Document is not found, a new Document will be created. */
+        /** If set to `true` and the Document is not found, a new Document is be created. */
         allowMissing?: boolean;
         /** Data format for response. */
         alt?: string;
@@ -7355,7 +8057,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Indicates which fields in the provided imported 'document' to update. If not set, will by default update all fields. */
+        /** Indicates which fields in the provided imported 'document' to update. If not set, by default updates all fields. */
         updateMask?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -7370,7 +8072,7 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** If set to true, and the Document is not found, a new Document will be created. */
+          /** If set to `true` and the Document is not found, a new Document is be created. */
           allowMissing?: boolean;
           /** Data format for response. */
           alt?: string;
@@ -7388,7 +8090,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Indicates which fields in the provided imported 'document' to update. If not set, will by default update all fields. */
+          /** Indicates which fields in the provided imported 'document' to update. If not set, by default updates all fields. */
           updateMask?: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -7580,6 +8282,219 @@ declare namespace gapi.client {
       documents: DocumentsResource;
       operations: OperationsResource;
     }
+    interface ControlsResource {
+      /** Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/. */
+        controlId?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaControl;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /a-z-_/. */
+          controlId?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaControl
+      ): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      /** Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets a Control. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      /** Lists all Controls by their parent DataStore. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000. */
+        pageSize?: number;
+        /** Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page. */
+        pageToken?: string;
+        /** Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<GoogleCloudDiscoveryengineV1betaListControlsResponse>;
+      /** Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaControl;
+      }): Request<GoogleCloudDiscoveryengineV1betaControl>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Immutable. Fully qualified name `projects/*‍/locations/global/dataStore/*‍/controls/*` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name * Control.solution_type If not set or empty, all supported fields are updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaControl
+      ): Request<GoogleCloudDiscoveryengineV1betaControl>;
+    }
     interface ConversationsResource {
       /** Converses a conversation. */
       converse(request: {
@@ -7999,7 +8914,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Required. The ID to use for the Schema, which will become the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
+        /** Required. The ID to use for the Schema, which becomes the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
         schemaId?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -8030,7 +8945,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Required. The ID to use for the Schema, which will become the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
+          /** Required. The ID to use for the Schema, which becomes the final component of the Schema.name. This field should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. */
           schemaId?: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -8109,7 +9024,7 @@ declare namespace gapi.client {
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. */
+        /** The maximum number of Schemas to return. The service may return fewer than this value. If unspecified, at most 100 Schemas are returned. The maximum value is 1000; values above 1000 are set to 1000. */
         pageSize?: number;
         /** A page token, received from a previous SchemaService.ListSchemas call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to SchemaService.ListSchemas must match the call that provided the page token. */
         pageToken?: string;
@@ -8130,7 +9045,7 @@ declare namespace gapi.client {
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** If set to true, and the Schema is not found, a new Schema will be created. In this situation, `update_mask` is ignored. */
+        /** If set to true, and the Schema is not found, a new Schema is created. In this situation, `update_mask` is ignored. */
         allowMissing?: boolean;
         /** Data format for response. */
         alt?: string;
@@ -8161,7 +9076,7 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** If set to true, and the Schema is not found, a new Schema will be created. In this situation, `update_mask` is ignored. */
+          /** If set to true, and the Schema is not found, a new Schema is created. In this situation, `update_mask` is ignored. */
           allowMissing?: boolean;
           /** Data format for response. */
           alt?: string;
@@ -8386,7 +9301,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
+        /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
         servingConfig: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -8415,7 +9330,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID will be used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
+          /** Required. Full resource name of a ServingConfig: `projects/*‍/locations/global/collections/*‍/engines/*‍/servingConfigs/*`, or `projects/*‍/locations/global/collections/*‍/dataStores/*‍/servingConfigs/*` One default serving config is created along with your recommendation engine creation. The engine ID is used as the ID of the default serving config. For example, for Engine `projects/*‍/locations/global/collections/*‍/engines/my-engine`, you can use `projects/*‍/locations/global/collections/*‍/engines/my-engine/servingConfigs/my-engine` for your RecommendationService.Recommend requests. */
           servingConfig: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -9314,7 +10229,7 @@ declare namespace gapi.client {
         /** Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters. */
         userEvent?: string;
       }): Request<GoogleApiHttpBody>;
-      /** Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata. */
+      /** Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata. */
       import(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -9398,6 +10313,8 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
+        /** If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write. */
+        writeAsync?: boolean;
         /** Request body */
         resource: GoogleCloudDiscoveryengineV1betaUserEvent;
       }): Request<GoogleCloudDiscoveryengineV1betaUserEvent>;
@@ -9427,6 +10344,8 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
+          /** If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write. */
+          writeAsync?: boolean;
         },
         body: GoogleCloudDiscoveryengineV1betaUserEvent
       ): Request<GoogleCloudDiscoveryengineV1betaUserEvent>;
@@ -9626,7 +10545,7 @@ declare namespace gapi.client {
         callback?: string;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
-        /** Filter by solution type . For example: filter = 'solution_type:SOLUTION_TYPE_SEARCH' */
+        /** Filter by solution type . For example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'` */
         filter?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -9710,6 +10629,7 @@ declare namespace gapi.client {
         body: GoogleCloudDiscoveryengineV1betaDataStore
       ): Request<GoogleCloudDiscoveryengineV1betaDataStore>;
       branches: BranchesResource;
+      controls: ControlsResource;
       conversations: ConversationsResource;
       models: ModelsResource;
       operations: OperationsResource;
@@ -9929,6 +10849,8 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
+        /** If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write. */
+        writeAsync?: boolean;
         /** Request body */
         resource: GoogleCloudDiscoveryengineV1betaUserEvent;
       }): Request<GoogleCloudDiscoveryengineV1betaUserEvent>;
@@ -9958,6 +10880,8 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
+          /** If set to true, the user event is written asynchronously after validation, and the API responds without waiting for the write. */
+          writeAsync?: boolean;
         },
         body: GoogleCloudDiscoveryengineV1betaUserEvent
       ): Request<GoogleCloudDiscoveryengineV1betaUserEvent>;
@@ -10033,6 +10957,64 @@ declare namespace gapi.client {
       }): Request<GoogleLongrunningListOperationsResponse>;
     }
     interface ProjectsResource {
+      /** Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms. */
+      provision(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. Full resource name of a Project, such as `projects/{project_id_or_number}`. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GoogleCloudDiscoveryengineV1betaProvisionProjectRequest;
+      }): Request<GoogleLongrunningOperation>;
+      provision(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Required. Full resource name of a Project, such as `projects/{project_id_or_number}`. */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GoogleCloudDiscoveryengineV1betaProvisionProjectRequest
+      ): Request<GoogleLongrunningOperation>;
       locations: LocationsResource;
       operations: OperationsResource;
     }