@google-cloud/discoveryengine 1.0.0 → 1.2.0

package/build/src/v1/search_service_client.js

@@ -60,8 +60,7 @@ class SearchServiceClient {
      *     API remote host.
      * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
      *     Follows the structure of {@link gapicConfig}.
-     * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
-     *     Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
+     * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
      *     For more information, please check the
      *     {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
      * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
@@ -69,7 +68,7 @@ class SearchServiceClient {
      *     HTTP implementation. Load only fallback version and pass it to the constructor:
      *     ```
      *     const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
-     *     const client = new SearchServiceClient({fallback: 'rest'}, gax);
+     *     const client = new SearchServiceClient({fallback: true}, gax);
      *     ```
      */
     constructor(opts, gaxInstance) {
@@ -115,6 +114,7 @@ class SearchServiceClient {
         if (servicePath === staticMembers.servicePath) {
             this.auth.defaultScopes = staticMembers.scopes;
         }
+        this.locationsClient = new this._gaxModule.LocationsClient(this._gaxGrpc, opts);
         // Determine the client header string.
         const clientHeader = [`gax/${this._gaxModule.version}`, `gapic/${version}`];
         if (typeof process !== 'undefined' && 'versions' in process) {
@@ -126,7 +126,7 @@ class SearchServiceClient {
         if (!opts.fallback) {
             clientHeader.push(`grpc/${this._gaxGrpc.grpcVersion}`);
         }
-        else if (opts.fallback === 'rest') {
+        else {
             clientHeader.push(`rest/${this._gaxGrpc.grpcVersion}`);
         }
         if (opts.libName && opts.libVersion) {
@@ -140,10 +140,12 @@ class SearchServiceClient {
         this.pathTemplates = {
             projectLocationCollectionDataStoreBranchPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}'),
             projectLocationCollectionDataStoreBranchDocumentPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}'),
+            projectLocationCollectionDataStoreConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/conversations/{conversation}'),
             projectLocationCollectionDataStoreSchemaPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/schemas/{schema}'),
             projectLocationCollectionDataStoreServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config}'),
             projectLocationDataStoreBranchPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}'),
             projectLocationDataStoreBranchDocumentPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}'),
+            projectLocationDataStoreConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/conversations/{conversation}'),
             projectLocationDataStoreSchemaPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/schemas/{schema}'),
             projectLocationDataStoreServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/servingConfigs/{serving_config}'),
         };
@@ -282,10 +284,12 @@ class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.ImageQuery} request.imageQuery
+     *   Raw image query.
      * @param {number} request.pageSize
      *   Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
      *   return. If unspecified, defaults to a reasonable value. The maximum allowed
-     *   value is 100. Values above 100 will be coerced to 100.
+     *   value is 100. Values above 100 are coerced to 100.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.pageToken
@@ -306,10 +310,31 @@ class SearchServiceClient {
      *   unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+     * @param {string} request.filter
+     *   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.
+     *
+     *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     * @param {string} request.orderBy
+     *   The order in which documents are returned. Documents can be ordered by
+     *   a field in an {@link protos.google.cloud.discoveryengine.v1.Document|Document} object.
+     *   Leave it unset if ordered by relevance. `order_by` expression is
+     *   case-sensitive.
+     *
+     *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1.UserInfo} request.userInfo
      *   Information about the end user.
-     *   Highly recommended for analytics. The user_agent string in UserInfo will
-     *   be used to deduce device_type for analytics.
+     *   Highly recommended for analytics.
+     *   {@link protos.google.cloud.discoveryengine.v1.UserInfo.user_agent|UserInfo.user_agent}
+     *   is used to deduce `device_type` for analytics.
+     * @param {number[]} request.facetSpecs
+     *   Facet specifications for faceted search. If empty, no facets are returned.
+     *
+     *   A maximum of 100 values are allowed. Otherwise, an  `INVALID_ARGUMENT`
+     *   error is returned.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.BoostSpec} request.boostSpec
+     *   Boost specification to boost certain documents.
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -322,10 +347,10 @@ class SearchServiceClient {
      *     which enables image searching.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
-     *   query expansion will occur.
+     *   query expansion occurs.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
-     *   which spell correction will take effect.
+     *   which spell correction takes effect.
      * @param {string} request.userPseudoId
      *   A unique identifier for tracking visitors. For example, this could be
      *   implemented with an HTTP cookie, which should be able to uniquely identify
@@ -342,11 +367,10 @@ class SearchServiceClient {
      *   The field must be a UTF-8 encoded string with a length limit of 128
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec} request.contentSearchSpec
-     *   The content search spec that configs the desired behavior of content
-     *   search.
+     *   A specification for configuring the behavior of content search.
      * @param {boolean} request.safeSearch
      *   Whether to turn on safe search. This is only supported for
-     *   {@link protos.|ContentConfig.PUBLIC_WEBSITE}.
+     *   website search.
      * @param {number[]} request.userLabels
      *   The user labels applied to a resource must meet the following requirements:
      *
@@ -410,10 +434,12 @@ class SearchServiceClient {
      *   documents under the default branch.
      * @param {string} request.query
      *   Raw search query.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.ImageQuery} request.imageQuery
+     *   Raw image query.
      * @param {number} request.pageSize
      *   Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
      *   return. If unspecified, defaults to a reasonable value. The maximum allowed
-     *   value is 100. Values above 100 will be coerced to 100.
+     *   value is 100. Values above 100 are coerced to 100.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
      * @param {string} request.pageToken
@@ -434,10 +460,31 @@ class SearchServiceClient {
      *   unset.
      *
      *   If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+     * @param {string} request.filter
+     *   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.
+     *
+     *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     * @param {string} request.orderBy
+     *   The order in which documents are returned. Documents can be ordered by
+     *   a field in an {@link protos.google.cloud.discoveryengine.v1.Document|Document} object.
+     *   Leave it unset if ordered by relevance. `order_by` expression is
+     *   case-sensitive.
+     *
+     *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1.UserInfo} request.userInfo
      *   Information about the end user.
-     *   Highly recommended for analytics. The user_agent string in UserInfo will
-     *   be used to deduce device_type for analytics.
+     *   Highly recommended for analytics.
+     *   {@link protos.google.cloud.discoveryengine.v1.UserInfo.user_agent|UserInfo.user_agent}
+     *   is used to deduce `device_type` for analytics.
+     * @param {number[]} request.facetSpecs
+     *   Facet specifications for faceted search. If empty, no facets are returned.
+     *
+     *   A maximum of 100 values are allowed. Otherwise, an  `INVALID_ARGUMENT`
+     *   error is returned.
+     * @param {google.cloud.discoveryengine.v1.SearchRequest.BoostSpec} request.boostSpec
+     *   Boost specification to boost certain documents.
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -450,10 +497,10 @@ class SearchServiceClient {
      *     which enables image searching.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
-     *   query expansion will occur.
+     *   query expansion occurs.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.SpellCorrectionSpec} request.spellCorrectionSpec
      *   The spell correction specification that specifies the mode under
-     *   which spell correction will take effect.
+     *   which spell correction takes effect.
      * @param {string} request.userPseudoId
      *   A unique identifier for tracking visitors. For example, this could be
      *   implemented with an HTTP cookie, which should be able to uniquely identify
@@ -470,11 +517,10 @@ class SearchServiceClient {
      *   The field must be a UTF-8 encoded string with a length limit of 128
      *   characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
      * @param {google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec} request.contentSearchSpec
-     *   The content search spec that configs the desired behavior of content
-     *   search.
+     *   A specification for configuring the behavior of content search.
      * @param {boolean} request.safeSearch
      *   Whether to turn on safe search. This is only supported for
-     *   {@link protos.|ContentConfig.PUBLIC_WEBSITE}.
+     *   website search.
      * @param {number[]} request.userLabels
      *   The user labels applied to a resource must meet the following requirements:
      *
@@ -520,6 +566,61 @@ class SearchServiceClient {
         this.initialize();
         return this.descriptors.page.search.asyncIterate(this.innerApiCalls['search'], request, callSettings);
     }
+    /**
+     * Gets information about a location.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Resource name for the location.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example
+     * ```
+     * const [response] = await client.getLocation(request);
+     * ```
+     */
+    getLocation(request, options, callback) {
+        return this.locationsClient.getLocation(request, options, callback);
+    }
+    /**
+     * Lists information about the supported locations for this service. Returns an iterable object.
+     *
+     * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   The resource that owns the locations collection, if applicable.
+     * @param {string} request.filter
+     *   The standard list filter.
+     * @param {number} request.pageSize
+     *   The standard list page size.
+     * @param {string} request.pageToken
+     *   The standard list page token.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Object}
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
+     *   so you can stop the iteration when you don't need more results.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     * @example
+     * ```
+     * const iterable = client.listLocationsAsync(request);
+     * for await (const response of iterable) {
+     *   // process response
+     * }
+     * ```
+     */
+    listLocationsAsync(request, options) {
+        return this.locationsClient.listLocationsAsync(request, options);
+    }
     // --------------------
     // -- Path templates --
     // --------------------
@@ -673,6 +774,75 @@ class SearchServiceClient {
     matchDocumentFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName) {
         return this.pathTemplates.projectLocationCollectionDataStoreBranchDocumentPathTemplate.match(projectLocationCollectionDataStoreBranchDocumentName).document;
     }
+    /**
+     * Return a fully-qualified projectLocationCollectionDataStoreConversation resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} data_store
+     * @param {string} conversation
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionDataStoreConversationPath(project, location, collection, dataStore, conversation) {
+        return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.render({
+            project: project,
+            location: location,
+            collection: collection,
+            data_store: dataStore,
+            conversation: conversation,
+        });
+    }
+    /**
+     * Parse the project from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName) {
+        return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.match(projectLocationCollectionDataStoreConversationName).project;
+    }
+    /**
+     * Parse the location from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName) {
+        return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.match(projectLocationCollectionDataStoreConversationName).location;
+    }
+    /**
+     * Parse the collection from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName) {
+        return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.match(projectLocationCollectionDataStoreConversationName).collection;
+    }
+    /**
+     * Parse the data_store from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName) {
+        return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.match(projectLocationCollectionDataStoreConversationName).data_store;
+    }
+    /**
+     * Parse the conversation from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the conversation.
+     */
+    matchConversationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName) {
+        return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.match(projectLocationCollectionDataStoreConversationName).conversation;
+    }
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreSchema resource name string.
      *
@@ -937,6 +1107,63 @@ class SearchServiceClient {
     matchDocumentFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName) {
         return this.pathTemplates.projectLocationDataStoreBranchDocumentPathTemplate.match(projectLocationDataStoreBranchDocumentName).document;
     }
+    /**
+     * Return a fully-qualified projectLocationDataStoreConversation resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} data_store
+     * @param {string} conversation
+     * @returns {string} Resource name string.
+     */
+    projectLocationDataStoreConversationPath(project, location, dataStore, conversation) {
+        return this.pathTemplates.projectLocationDataStoreConversationPathTemplate.render({
+            project: project,
+            location: location,
+            data_store: dataStore,
+            conversation: conversation,
+        });
+    }
+    /**
+     * Parse the project from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName) {
+        return this.pathTemplates.projectLocationDataStoreConversationPathTemplate.match(projectLocationDataStoreConversationName).project;
+    }
+    /**
+     * Parse the location from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName) {
+        return this.pathTemplates.projectLocationDataStoreConversationPathTemplate.match(projectLocationDataStoreConversationName).location;
+    }
+    /**
+     * Parse the data_store from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName) {
+        return this.pathTemplates.projectLocationDataStoreConversationPathTemplate.match(projectLocationDataStoreConversationName).data_store;
+    }
+    /**
+     * Parse the conversation from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the conversation.
+     */
+    matchConversationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName) {
+        return this.pathTemplates.projectLocationDataStoreConversationPathTemplate.match(projectLocationDataStoreConversationName).conversation;
+    }
     /**
      * Return a fully-qualified projectLocationDataStoreSchema resource name string.
      *
@@ -1062,6 +1289,7 @@ class SearchServiceClient {
             return this.searchServiceStub.then(stub => {
                 this._terminated = true;
                 stub.close();
+                this.locationsClient.close();
             });
         }
         return Promise.resolve();

package/build/src/v1/user_event_service_client.d.ts

@@ -1,5 +1,5 @@
 import type * as gax from 'google-gax';
-import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation } from 'google-gax';
+import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation, LocationsClient, LocationProtos } from 'google-gax';
 import * as protos from '../../protos/protos';
 /**
  *  Service for ingesting end user actions on a website to Discovery Engine API.
@@ -20,6 +20,7 @@ export declare class UserEventServiceClient {
     innerApiCalls: {
         [name: string]: Function;
     };
+    locationsClient: LocationsClient;
     pathTemplates: {
         [name: string]: gax.PathTemplate;
     };
@@ -55,8 +56,7 @@ export declare class UserEventServiceClient {
      *     API remote host.
      * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
      *     Follows the structure of {@link gapicConfig}.
-     * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
-     *     Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
+     * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
      *     For more information, please check the
      *     {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
      * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
@@ -64,7 +64,7 @@ export declare class UserEventServiceClient {
      *     HTTP implementation. Load only fallback version and pass it to the constructor:
      *     ```
      *     const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
-     *     const client = new UserEventServiceClient({fallback: 'rest'}, gax);
+     *     const client = new UserEventServiceClient({fallback: true}, gax);
      *     ```
      */
     constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
@@ -134,7 +134,7 @@ export declare class UserEventServiceClient {
     writeUserEvent(request: protos.google.cloud.discoveryengine.v1.IWriteUserEventRequest, callback: Callback<protos.google.cloud.discoveryengine.v1.IUserEvent, protos.google.cloud.discoveryengine.v1.IWriteUserEventRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Writes a single user event from the browser. This uses a GET request to
-     * due to browser restriction of POST-ing to a 3rd party domain.
+     * due to browser restriction of POST-ing to a third-party domain.
      *
      * This method is used only by the Discovery Engine API JavaScript pixel and
      * Google Tag Manager. Users should not call this method directly.
@@ -150,7 +150,7 @@ export declare class UserEventServiceClient {
      * @param {string} request.uri
      *   The URL including cgi-parameters but excluding the hash fragment with a
      *   length limit of 5,000 characters. This is often more useful than the
-     *   referer URL, because many browsers only send the domain for 3rd party
+     *   referer URL, because many browsers only send the domain for third-party
      *   requests.
      * @param {number} request.ets
      *   The event timestamp in milliseconds. This prevents browser caching of
@@ -184,11 +184,11 @@ export declare class UserEventServiceClient {
      * @param {Object} request
      *   The request object that will be sent.
      * @param {google.cloud.discoveryengine.v1.ImportUserEventsRequest.InlineSource} request.inlineSource
-     *   Required. The Inline source for the input content for UserEvents.
+     *   The Inline source for the input content for UserEvents.
      * @param {google.cloud.discoveryengine.v1.GcsSource} request.gcsSource
-     *   Required. Cloud Storage location for the input content.
+     *   Cloud Storage location for the input content.
      * @param {google.cloud.discoveryengine.v1.BigQuerySource} request.bigquerySource
-     *   Required. BigQuery input source.
+     *   BigQuery input source.
      * @param {string} request.parent
      *   Required. Parent DataStore resource name, of the form
      *   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`
@@ -225,6 +225,57 @@ export declare class UserEventServiceClient {
      * region_tag:discoveryengine_v1_generated_UserEventService_ImportUserEvents_async
      */
     checkImportUserEventsProgress(name: string): Promise<LROperation<protos.google.cloud.discoveryengine.v1.ImportUserEventsResponse, protos.google.cloud.discoveryengine.v1.ImportUserEventsMetadata>>;
+    /**
+     * Gets information about a location.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Resource name for the location.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example
+     * ```
+     * const [response] = await client.getLocation(request);
+     * ```
+     */
+    getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
+    /**
+     * Lists information about the supported locations for this service. Returns an iterable object.
+     *
+     * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   The resource that owns the locations collection, if applicable.
+     * @param {string} request.filter
+     *   The standard list filter.
+     * @param {number} request.pageSize
+     *   The standard list page size.
+     * @param {string} request.pageToken
+     *   The standard list page token.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Object}
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
+     *   so you can stop the iteration when you don't need more results.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     * @example
+     * ```
+     * const iterable = client.listLocationsAsync(request);
+     * for await (const response of iterable) {
+     *   // process response
+     * }
+     * ```
+     */
+    listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
     /**
      * Gets the latest state of a long-running operation.  Clients can use this
      * method to poll the operation result at intervals as recommended by the API
@@ -447,6 +498,57 @@ export declare class UserEventServiceClient {
      * @returns {string} A string representing the document.
      */
     matchDocumentFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationCollectionDataStoreConversation resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} data_store
+     * @param {string} conversation
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionDataStoreConversationPath(project: string, location: string, collection: string, dataStore: string, conversation: string): string;
+    /**
+     * Parse the project from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the collection from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
+    /**
+     * Parse the conversation from ProjectLocationCollectionDataStoreConversation resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreConversationName
+     *   A fully-qualified path representing project_location_collection_data_store_conversation resource.
+     * @returns {string} A string representing the conversation.
+     */
+    matchConversationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName: string): string | number;
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreSchema resource name string.
      *
@@ -582,6 +684,48 @@ export declare class UserEventServiceClient {
      * @returns {string} A string representing the document.
      */
     matchDocumentFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationDataStoreConversation resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} data_store
+     * @param {string} conversation
+     * @returns {string} Resource name string.
+     */
+    projectLocationDataStoreConversationPath(project: string, location: string, dataStore: string, conversation: string): string;
+    /**
+     * Parse the project from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
+    /**
+     * Parse the conversation from ProjectLocationDataStoreConversation resource.
+     *
+     * @param {string} projectLocationDataStoreConversationName
+     *   A fully-qualified path representing project_location_data_store_conversation resource.
+     * @returns {string} A string representing the conversation.
+     */
+    matchConversationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName: string): string | number;
     /**
      * Return a fully-qualified projectLocationDataStoreSchema resource name string.
      *