@google-cloud/discoveryengine 2.0.1 → 2.2.0

package/build/src/v1alpha/search_tuning_service_client.js

@@ -98,26 +98,17 @@ class SearchTuningServiceClient {
     constructor(opts, gaxInstance) {
         // Ensure that options include all the required fields.
         const staticMembers = this.constructor;
-        if (opts?.universe_domain &&
-            opts?.universeDomain &&
-            opts?.universe_domain !== opts?.universeDomain) {
+        if (opts?.universe_domain && opts?.universeDomain && opts?.universe_domain !== opts?.universeDomain) {
             throw new Error('Please set either universe_domain or universeDomain, but not both.');
         }
-        const universeDomainEnvVar = typeof process === 'object' && typeof process.env === 'object'
-            ? process.env['GOOGLE_CLOUD_UNIVERSE_DOMAIN']
-            : undefined;
-        this._universeDomain =
-            opts?.universeDomain ??
-                opts?.universe_domain ??
-                universeDomainEnvVar ??
-                'googleapis.com';
+        const universeDomainEnvVar = (typeof process === 'object' && typeof process.env === 'object') ? process.env['GOOGLE_CLOUD_UNIVERSE_DOMAIN'] : undefined;
+        this._universeDomain = opts?.universeDomain ?? opts?.universe_domain ?? universeDomainEnvVar ?? 'googleapis.com';
         this._servicePath = 'discoveryengine.' + this._universeDomain;
         const servicePath = opts?.servicePath || opts?.apiEndpoint || this._servicePath;
         this._providedCustomServicePath = !!(opts?.servicePath || opts?.apiEndpoint);
         const port = opts?.port || staticMembers.port;
         const clientConfig = opts?.clientConfig ?? {};
-        const fallback = opts?.fallback ??
-            (typeof window !== 'undefined' && typeof window?.fetch === 'function');
+        const fallback = opts?.fallback ?? (typeof window !== 'undefined' && typeof window?.fetch === 'function');
         opts = Object.assign({ servicePath, port, clientConfig, fallback }, opts);
         // Request numeric enum values if REST transport is used.
         opts.numericEnums = true;
@@ -147,7 +138,10 @@ class SearchTuningServiceClient {
         }
         this.locationsClient = new this._gaxModule.LocationsClient(this._gaxGrpc, opts);
         // Determine the client header string.
-        const clientHeader = [`gax/${this._gaxModule.version}`, `gapic/${version}`];
+        const clientHeader = [
+            `gax/${this._gaxModule.version}`,
+            `gapic/${version}`,
+        ];
         if (typeof process === 'object' && 'versions' in process) {
             clientHeader.push(`gl-node/${process.versions.node}`);
         }
@@ -213,125 +207,20 @@ class SearchTuningServiceClient {
         // rather than holding a request open.
         const lroOptions = {
             auth: this.auth,
-            grpc: 'grpc' in this._gaxGrpc ? this._gaxGrpc.grpc : undefined,
+            grpc: 'grpc' in this._gaxGrpc ? this._gaxGrpc.grpc : undefined
         };
         if (opts.fallback) {
             lroOptions.protoJson = protoFilesRoot;
-            lroOptions.httpRules = [
-                {
-                    selector: 'google.longrunning.Operations.CancelOperation',
-                    post: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/operations/*}:cancel',
-                    body: '*',
-                    additional_bindings: [
-                        {
-                            post: '/v1alpha/{name=projects/*/locations/*/dataStores/*/branches/*/operations/*}:cancel',
-                            body: '*',
-                        },
-                    ],
-                },
-                {
-                    selector: 'google.longrunning.Operations.GetOperation',
-                    get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector/operations/*}',
-                    additional_bindings: [
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/models/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/schemas/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/targetSites/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/branches/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/models/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/evaluations/*/operations/*}',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/identity_mapping_stores/*/operations/*}',
-                        },
-                        { get: '/v1alpha/{name=projects/*/locations/*/operations/*}' },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/sampleQuerySets/*/operations/*}',
-                        },
-                        { get: '/v1alpha/{name=projects/*/operations/*}' },
-                    ],
-                },
-                {
-                    selector: 'google.longrunning.Operations.ListOperations',
-                    get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}/operations',
-                    additional_bindings: [
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/models/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/schemas/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/targetSites}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*/engines/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/collections/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/branches/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/models/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/dataStores/*}/operations',
-                        },
-                        {
-                            get: '/v1alpha/{name=projects/*/locations/*/identity_mapping_stores/*}/operations',
-                        },
-                        { get: '/v1alpha/{name=projects/*/locations/*}/operations' },
-                        { get: '/v1alpha/{name=projects/*}/operations' },
-                    ],
-                },
-            ];
+            lroOptions.httpRules = [{ selector: 'google.longrunning.Operations.CancelOperation', post: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/operations/*}:cancel', body: '*', additional_bindings: [{ post: '/v1alpha/{name=projects/*/locations/*/dataStores/*/branches/*/operations/*}:cancel', body: '*', }],
+                }, { selector: 'google.longrunning.Operations.GetOperation', get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector/operations/*}', additional_bindings: [{ get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/models/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/schemas/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/targetSites/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/branches/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/models/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/evaluations/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/identity_mapping_stores/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/locations/*/sampleQuerySets/*/operations/*}', }, { get: '/v1alpha/{name=projects/*/operations/*}', }],
+                }, { selector: 'google.longrunning.Operations.ListOperations', get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}/operations', additional_bindings: [{ get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/models/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/schemas/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/targetSites}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*/engines/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/collections/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/branches/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/dataStores/*/models/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/dataStores/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*/identity_mapping_stores/*}/operations', }, { get: '/v1alpha/{name=projects/*/locations/*}/operations', }, { get: '/v1alpha/{name=projects/*}/operations', }],
+                }];
         }
-        this.operationsClient = this._gaxModule
-            .lro(lroOptions)
-            .operationsClient(opts);
+        this.operationsClient = this._gaxModule.lro(lroOptions).operationsClient(opts);
         const trainCustomModelResponse = protoFilesRoot.lookup('.google.cloud.discoveryengine.v1alpha.TrainCustomModelResponse');
         const trainCustomModelMetadata = protoFilesRoot.lookup('.google.cloud.discoveryengine.v1alpha.TrainCustomModelMetadata');
         this.descriptors.longrunning = {
-            trainCustomModel: new this._gaxModule.LongrunningDescriptor(this.operationsClient, trainCustomModelResponse.decode.bind(trainCustomModelResponse), trainCustomModelMetadata.decode.bind(trainCustomModelMetadata)),
+            trainCustomModel: new this._gaxModule.LongrunningDescriptor(this.operationsClient, trainCustomModelResponse.decode.bind(trainCustomModelResponse), trainCustomModelMetadata.decode.bind(trainCustomModelMetadata))
         };
         // Put together the default options sent with requests.
         this._defaults = this._gaxGrpc.constructSettings('google.cloud.discoveryengine.v1alpha.SearchTuningService', gapicConfig, opts.clientConfig || {}, { 'x-goog-api-client': clientHeader.join(' ') });
@@ -360,17 +249,13 @@ class SearchTuningServiceClient {
         }
         // Put together the "service stub" for
         // google.cloud.discoveryengine.v1alpha.SearchTuningService.
-        this.searchTuningServiceStub = this._gaxGrpc.createStub(this._opts.fallback
-            ? this._protos.lookupService('google.cloud.discoveryengine.v1alpha.SearchTuningService')
-            : // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                this._protos.google.cloud.discoveryengine.v1alpha
-                    .SearchTuningService, this._opts, this._providedCustomServicePath);
+        this.searchTuningServiceStub = this._gaxGrpc.createStub(this._opts.fallback ?
+            this._protos.lookupService('google.cloud.discoveryengine.v1alpha.SearchTuningService') :
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this._protos.google.cloud.discoveryengine.v1alpha.SearchTuningService, this._opts, this._providedCustomServicePath);
         // Iterate over each of the methods that the service provides
         // and create an API call method for each.
-        const searchTuningServiceStubMethods = [
-            'trainCustomModel',
-            'listCustomModels',
-        ];
+        const searchTuningServiceStubMethods = ['trainCustomModel', 'listCustomModels'];
         for (const methodName of searchTuningServiceStubMethods) {
             const callPromise = this.searchTuningServiceStub.then(stub => (...args) => {
                 if (this._terminated) {
@@ -381,7 +266,8 @@ class SearchTuningServiceClient {
             }, (err) => () => {
                 throw err;
             });
-            const descriptor = this.descriptors.longrunning[methodName] || undefined;
+            const descriptor = this.descriptors.longrunning[methodName] ||
+                undefined;
             const apiCall = this._gaxModule.createApiCall(callPromise, this._defaults[methodName], descriptor, this._opts.fallback);
             this.innerApiCalls[methodName] = apiCall;
         }
@@ -393,8 +279,7 @@ class SearchTuningServiceClient {
      * @returns {string} The DNS address for this service.
      */
     static get servicePath() {
-        if (typeof process === 'object' &&
-            typeof process.emitWarning === 'function') {
+        if (typeof process === 'object' && typeof process.emitWarning === 'function') {
             process.emitWarning('Static servicePath is deprecated, please use the instance method instead.', 'DeprecationWarning');
         }
         return 'discoveryengine.googleapis.com';
@@ -405,8 +290,7 @@ class SearchTuningServiceClient {
      * @returns {string} The DNS address for this service.
      */
     static get apiEndpoint() {
-        if (typeof process === 'object' &&
-            typeof process.emitWarning === 'function') {
+        if (typeof process === 'object' && typeof process.emitWarning === 'function') {
             process.emitWarning('Static apiEndpoint is deprecated, please use the instance method instead.', 'DeprecationWarning');
         }
         return 'discoveryengine.googleapis.com';
@@ -434,7 +318,9 @@ class SearchTuningServiceClient {
      * @returns {string[]} List of default scopes.
      */
     static get scopes() {
-        return ['https://www.googleapis.com/auth/cloud-platform'];
+        return [
+            'https://www.googleapis.com/auth/cloud-platform'
+        ];
     }
     /**
      * Return the project ID used by this class.
@@ -460,13 +346,10 @@ class SearchTuningServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] =
-            this._gaxModule.routingHeader.fromParams({
-                data_store: request.dataStore ?? '',
-            });
-        this.initialize().catch(err => {
-            throw err;
+        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
+            'data_store': request.dataStore ?? '',
         });
+        this.initialize().catch(err => { throw err; });
         this._log.info('listCustomModels request %j', request);
         const wrappedCallback = callback
             ? (error, response, options, rawResponse) => {
@@ -474,8 +357,7 @@ class SearchTuningServiceClient {
                 callback(error, response, options, rawResponse); // We verified callback above.
             }
             : undefined;
-        return this.innerApiCalls
-            .listCustomModels(request, options, wrappedCallback)
+        return this.innerApiCalls.listCustomModels(request, options, wrappedCallback)
             ?.then(([response, options, rawResponse]) => {
             this._log.info('listCustomModels response %j', response);
             return [response, options, rawResponse];
@@ -494,13 +376,10 @@ class SearchTuningServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] =
-            this._gaxModule.routingHeader.fromParams({
-                data_store: request.dataStore ?? '',
-            });
-        this.initialize().catch(err => {
-            throw err;
+        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
+            'data_store': request.dataStore ?? '',
         });
+        this.initialize().catch(err => { throw err; });
         const wrappedCallback = callback
             ? (error, response, rawResponse, _) => {
                 this._log.info('trainCustomModel response %j', rawResponse);
@@ -508,8 +387,7 @@ class SearchTuningServiceClient {
             }
             : undefined;
         this._log.info('trainCustomModel request %j', request);
-        return this.innerApiCalls
-            .trainCustomModel(request, options, wrappedCallback)
+        return this.innerApiCalls.trainCustomModel(request, options, wrappedCallback)
             ?.then(([response, rawResponse, _]) => {
             this._log.info('trainCustomModel response %j', rawResponse);
             return [response, rawResponse, _];
@@ -534,90 +412,90 @@ class SearchTuningServiceClient {
         return decodeOperation;
     }
     /**
-     * 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);
-     * ```
-     */
+       * 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
-     * }
-     * ```
-     */
+       * 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);
     }
     /**
-     * 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
-     * service.
-     *
-     * @param {Object} request - The request object that will be sent.
-     * @param {string} request.name - The name of the operation resource.
-     * @param {Object=} options
-     *   Optional parameters. You can override the default settings for this call,
-     *   e.g, timeout, retries, paginations, etc. See {@link
-     *   https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
-     *   for the details.
-     * @param {function(?Error, ?Object)=} callback
-     *   The function which will be called with the result of the API call.
-     *
-     *   The second parameter to the callback is an object representing
-     *   {@link google.longrunning.Operation | google.longrunning.Operation}.
-     * @return {Promise} - The promise which resolves to an array.
-     *   The first element of the array is an object representing
-     * {@link google.longrunning.Operation | google.longrunning.Operation}.
-     * The promise has a method named "cancel" which cancels the ongoing API call.
-     *
-     * @example
-     * ```
-     * const client = longrunning.operationsClient();
-     * const name = '';
-     * const [response] = await client.getOperation({name});
-     * // doThingsWith(response)
-     * ```
-     */
+       * 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
+       * service.
+       *
+       * @param {Object} request - The request object that will be sent.
+       * @param {string} request.name - The name of the operation resource.
+       * @param {Object=} options
+       *   Optional parameters. You can override the default settings for this call,
+       *   e.g, timeout, retries, paginations, etc. See {@link
+       *   https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
+       *   for the details.
+       * @param {function(?Error, ?Object)=} callback
+       *   The function which will be called with the result of the API call.
+       *
+       *   The second parameter to the callback is an object representing
+       *   {@link google.longrunning.Operation | google.longrunning.Operation}.
+       * @return {Promise} - The promise which resolves to an array.
+       *   The first element of the array is an object representing
+       * {@link google.longrunning.Operation | google.longrunning.Operation}.
+       * The promise has a method named "cancel" which cancels the ongoing API call.
+       *
+       * @example
+       * ```
+       * const client = longrunning.operationsClient();
+       * const name = '';
+       * const [response] = await client.getOperation({name});
+       * // doThingsWith(response)
+       * ```
+       */
     getOperation(request, optionsOrCallback, callback) {
         let options;
         if (typeof optionsOrCallback === 'function' && callback === undefined) {
@@ -792,8 +670,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the project.
      */
     matchProjectFromAclConfigName(aclConfigName) {
-        return this.pathTemplates.aclConfigPathTemplate.match(aclConfigName)
-            .project;
+        return this.pathTemplates.aclConfigPathTemplate.match(aclConfigName).project;
     }
     /**
      * Parse the location from AclConfig resource.
@@ -803,8 +680,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the location.
      */
     matchLocationFromAclConfigName(aclConfigName) {
-        return this.pathTemplates.aclConfigPathTemplate.match(aclConfigName)
-            .location;
+        return this.pathTemplates.aclConfigPathTemplate.match(aclConfigName).location;
     }
     /**
      * Return a fully-qualified engine resource name string.
@@ -886,8 +762,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the project.
      */
     matchProjectFromEvaluationName(evaluationName) {
-        return this.pathTemplates.evaluationPathTemplate.match(evaluationName)
-            .project;
+        return this.pathTemplates.evaluationPathTemplate.match(evaluationName).project;
     }
     /**
      * Parse the location from Evaluation resource.
@@ -897,8 +772,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the location.
      */
     matchLocationFromEvaluationName(evaluationName) {
-        return this.pathTemplates.evaluationPathTemplate.match(evaluationName)
-            .location;
+        return this.pathTemplates.evaluationPathTemplate.match(evaluationName).location;
     }
     /**
      * Parse the evaluation from Evaluation resource.
@@ -908,8 +782,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the evaluation.
      */
     matchEvaluationFromEvaluationName(evaluationName) {
-        return this.pathTemplates.evaluationPathTemplate.match(evaluationName)
-            .evaluation;
+        return this.pathTemplates.evaluationPathTemplate.match(evaluationName).evaluation;
     }
     /**
      * Return a fully-qualified project resource name string.
@@ -2976,8 +2849,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the project.
      */
     matchProjectFromSampleQueryName(sampleQueryName) {
-        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName)
-            .project;
+        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName).project;
     }
     /**
      * Parse the location from SampleQuery resource.
@@ -2987,8 +2859,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the location.
      */
     matchLocationFromSampleQueryName(sampleQueryName) {
-        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName)
-            .location;
+        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName).location;
     }
     /**
      * Parse the sample_query_set from SampleQuery resource.
@@ -2998,8 +2869,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the sample_query_set.
      */
     matchSampleQuerySetFromSampleQueryName(sampleQueryName) {
-        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName)
-            .sample_query_set;
+        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName).sample_query_set;
     }
     /**
      * Parse the sample_query from SampleQuery resource.
@@ -3009,8 +2879,7 @@ class SearchTuningServiceClient {
      * @returns {string} A string representing the sample_query.
      */
     matchSampleQueryFromSampleQueryName(sampleQueryName) {
-        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName)
-            .sample_query;
+        return this.pathTemplates.sampleQueryPathTemplate.match(sampleQueryName).sample_query;
     }
     /**
      * Return a fully-qualified sampleQuerySet resource name string.
@@ -3069,8 +2938,8 @@ class SearchTuningServiceClient {
                 this._log.info('ending gRPC channel');
                 this._terminated = true;
                 stub.close();
-                this.locationsClient.close();
-                this.operationsClient.close();
+                this.locationsClient.close().catch(err => { throw err; });
+                void this.operationsClient.close();
             });
         }
         return Promise.resolve();