@google-ads/admanager 0.5.1 → 0.6.0

package/build/src/v1/ad_review_center_ad_service_client.js

@@ -96,12 +96,21 @@ class AdReviewCenterAdServiceClient {
      */
     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) {
+        const staticMembers = this
+            .constructor;
+        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 = 'admanager.' + this._universeDomain;
         const servicePath = opts?.servicePath || opts?.apiEndpoint || this._servicePath;
         this._providedCustomServicePath = !!(opts?.servicePath || opts?.apiEndpoint);
@@ -114,7 +123,8 @@ class AdReviewCenterAdServiceClient {
         else {
             opts.fallback = opts.fallback ?? true;
         }
-        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;
@@ -143,10 +153,7 @@ class AdReviewCenterAdServiceClient {
             this.auth.defaultScopes = staticMembers.scopes;
         }
         // 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}`);
         }
@@ -176,6 +183,7 @@ class AdReviewCenterAdServiceClient {
             bandwidthGroupPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/bandwidthGroups/{bandwidth_group}'),
             browserPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/browsers/{browser}'),
             browserLanguagePathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/browserLanguages/{browser_language}'),
+            childPublisherPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/childPublishers/{child_publisher}'),
             cmsMetadataKeyPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/cmsMetadataKeys/{cms_metadata_key}'),
             cmsMetadataValuePathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/cmsMetadataValues/{cms_metadata_value}'),
             companyPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/companies/{company}'),
@@ -194,6 +202,7 @@ class AdReviewCenterAdServiceClient {
             geoTargetPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/geoTargets/{geo_target}'),
             labelPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/labels/{label}'),
             lineItemPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/lineItems/{line_item}'),
+            linkedDevicePathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/linkedDevices/{linked_device}'),
             liveStreamEventPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/liveStreamEvents/{live_stream_event}'),
             mobileCarrierPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/mobileCarriers/{mobile_carrier}'),
             mobileDevicePathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/mobileDevices/{mobile_device}'),
@@ -207,6 +216,7 @@ class AdReviewCenterAdServiceClient {
             privateAuctionDealPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/privateAuctionDeals/{private_auction_deal}'),
             programmaticBuyerPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/programmaticBuyers/{programmatic_buyer}'),
             reportPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/reports/{report}'),
+            richMediaAdsCompanyPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/richMediaAdsCompanies/{rich_media_ads_company}'),
             rolePathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/roles/{role}'),
             sitePathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/sites/{site}'),
             taxonomyCategoryPathTemplate: new this._gaxModule.PathTemplate('networks/{network_code}/taxonomyCategories/{taxonomy_category}'),
@@ -218,7 +228,7 @@ class AdReviewCenterAdServiceClient {
         // (e.g. 50 results at a time, with tokens to get subsequent
         // pages). Denote the keys used for pagination and results.
         this.descriptors.page = {
-            searchAdReviewCenterAds: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'adReviewCenterAds')
+            searchAdReviewCenterAds: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'adReviewCenterAds'),
         };
         const protoFilesRoot = this._gaxModule.protobufFromJSON(jsonProtos);
         // This API contains "long-running operations", which return a
@@ -226,20 +236,31 @@ class AdReviewCenterAdServiceClient {
         // 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.GetOperation', get: '/v1/{name=networks/*/operations/reports/runs/*}', }];
+            lroOptions.httpRules = [
+                {
+                    selector: 'google.longrunning.Operations.CancelOperation',
+                    post: '/v1/{name=networks/*/operations/reports/runs/*}:cancel',
+                },
+                {
+                    selector: 'google.longrunning.Operations.GetOperation',
+                    get: '/v1/{name=networks/*/operations/reports/runs/*}',
+                },
+            ];
         }
-        this.operationsClient = this._gaxModule.lro(lroOptions).operationsClient(opts);
+        this.operationsClient = this._gaxModule
+            .lro(lroOptions)
+            .operationsClient(opts);
         const batchAllowAdReviewCenterAdsResponse = protoFilesRoot.lookup('.google.ads.admanager.v1.BatchAllowAdReviewCenterAdsResponse');
         const batchAllowAdReviewCenterAdsMetadata = protoFilesRoot.lookup('.google.ads.admanager.v1.BatchAdReviewCenterAdsOperationMetadata');
         const batchBlockAdReviewCenterAdsResponse = protoFilesRoot.lookup('.google.ads.admanager.v1.BatchBlockAdReviewCenterAdsResponse');
         const batchBlockAdReviewCenterAdsMetadata = protoFilesRoot.lookup('.google.ads.admanager.v1.BatchAdReviewCenterAdsOperationMetadata');
         this.descriptors.longrunning = {
             batchAllowAdReviewCenterAds: new this._gaxModule.LongrunningDescriptor(this.operationsClient, batchAllowAdReviewCenterAdsResponse.decode.bind(batchAllowAdReviewCenterAdsResponse), batchAllowAdReviewCenterAdsMetadata.decode.bind(batchAllowAdReviewCenterAdsMetadata)),
-            batchBlockAdReviewCenterAds: new this._gaxModule.LongrunningDescriptor(this.operationsClient, batchBlockAdReviewCenterAdsResponse.decode.bind(batchBlockAdReviewCenterAdsResponse), batchBlockAdReviewCenterAdsMetadata.decode.bind(batchBlockAdReviewCenterAdsMetadata))
+            batchBlockAdReviewCenterAds: new this._gaxModule.LongrunningDescriptor(this.operationsClient, batchBlockAdReviewCenterAdsResponse.decode.bind(batchBlockAdReviewCenterAdsResponse), batchBlockAdReviewCenterAdsMetadata.decode.bind(batchBlockAdReviewCenterAdsMetadata)),
         };
         // Put together the default options sent with requests.
         this._defaults = this._gaxGrpc.constructSettings('google.ads.admanager.v1.AdReviewCenterAdService', gapicConfig, opts.clientConfig || {}, { 'x-goog-api-client': clientHeader.join(' ') });
@@ -268,15 +289,19 @@ class AdReviewCenterAdServiceClient {
         }
         // Put together the "service stub" for
         // google.ads.admanager.v1.AdReviewCenterAdService.
-        this.adReviewCenterAdServiceStub = this._gaxGrpc.createStub(this._opts.fallback ?
-            this._protos.lookupService('google.ads.admanager.v1.AdReviewCenterAdService') :
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            this._protos.google.ads.admanager.v1.AdReviewCenterAdService, this._opts, this._providedCustomServicePath);
+        this.adReviewCenterAdServiceStub = this._gaxGrpc.createStub(this._opts.fallback
+            ? this._protos.lookupService('google.ads.admanager.v1.AdReviewCenterAdService')
+            : // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                this._protos.google.ads.admanager.v1.AdReviewCenterAdService, this._opts, this._providedCustomServicePath);
         // Iterate over each of the methods that the service provides
         // and create an API call method for each.
-        const adReviewCenterAdServiceStubMethods = ['searchAdReviewCenterAds', 'batchAllowAdReviewCenterAds', 'batchBlockAdReviewCenterAds'];
+        const adReviewCenterAdServiceStubMethods = [
+            'searchAdReviewCenterAds',
+            'batchAllowAdReviewCenterAds',
+            'batchBlockAdReviewCenterAds',
+        ];
         for (const methodName of adReviewCenterAdServiceStubMethods) {
-            const callPromise = this.adReviewCenterAdServiceStub.then(stub => (...args) => {
+            const callPromise = this.adReviewCenterAdServiceStub.then((stub) => (...args) => {
                 if (this._terminated) {
                     return Promise.reject('The client has already been closed.');
                 }
@@ -299,7 +324,8 @@ class AdReviewCenterAdServiceClient {
      * @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 'admanager.googleapis.com';
@@ -310,7 +336,8 @@ class AdReviewCenterAdServiceClient {
      * @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 'admanager.googleapis.com';
@@ -339,7 +366,8 @@ class AdReviewCenterAdServiceClient {
      */
     static get scopes() {
         return [
-            'https://www.googleapis.com/auth/admanager'
+            'https://www.googleapis.com/auth/admanager',
+            'https://www.googleapis.com/auth/admanager.readonly',
         ];
     }
     /**
@@ -366,10 +394,13 @@ class AdReviewCenterAdServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
-            'parent': request.parent ?? '',
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: request.parent ?? '',
+            });
+        this.initialize().catch((err) => {
+            throw err;
         });
-        this.initialize().catch(err => { throw err; });
         const wrappedCallback = callback
             ? (error, response, rawResponse, _) => {
                 this._log.info('batchAllowAdReviewCenterAds response %j', rawResponse);
@@ -377,7 +408,8 @@ class AdReviewCenterAdServiceClient {
             }
             : undefined;
         this._log.info('batchAllowAdReviewCenterAds request %j', request);
-        return this.innerApiCalls.batchAllowAdReviewCenterAds(request, options, wrappedCallback)
+        return this.innerApiCalls
+            .batchAllowAdReviewCenterAds(request, options, wrappedCallback)
             ?.then(([response, rawResponse, _]) => {
             this._log.info('batchAllowAdReviewCenterAds response %j', rawResponse);
             return [response, rawResponse, _];
@@ -414,10 +446,13 @@ class AdReviewCenterAdServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
-            'parent': request.parent ?? '',
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: request.parent ?? '',
+            });
+        this.initialize().catch((err) => {
+            throw err;
         });
-        this.initialize().catch(err => { throw err; });
         const wrappedCallback = callback
             ? (error, response, rawResponse, _) => {
                 this._log.info('batchBlockAdReviewCenterAds response %j', rawResponse);
@@ -425,7 +460,8 @@ class AdReviewCenterAdServiceClient {
             }
             : undefined;
         this._log.info('batchBlockAdReviewCenterAds request %j', request);
-        return this.innerApiCalls.batchBlockAdReviewCenterAds(request, options, wrappedCallback)
+        return this.innerApiCalls
+            .batchBlockAdReviewCenterAds(request, options, wrappedCallback)
             ?.then(([response, rawResponse, _]) => {
             this._log.info('batchBlockAdReviewCenterAds response %j', rawResponse);
             return [response, rawResponse, _];
@@ -462,10 +498,13 @@ class AdReviewCenterAdServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
-            'parent': request.parent ?? '',
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: request.parent ?? '',
+            });
+        this.initialize().catch((err) => {
+            throw err;
         });
-        this.initialize().catch(err => { throw err; });
         const wrappedCallback = callback
             ? (error, values, nextPageRequest, rawResponse) => {
                 this._log.info('searchAdReviewCenterAds values %j', values);
@@ -484,6 +523,13 @@ class AdReviewCenterAdServiceClient {
      * Equivalent to `searchAdReviewCenterAds`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
+     * @param {google.ads.admanager.v1.AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus} [request.status]
+     *   Optional. Only return ads with the given status.
+     * @param {google.ads.admanager.v1.ManualAdReviewCenterAdStatusEnum.ManualAdReviewCenterAdStatus} [request.manualReviewStatus]
+     *   Optional. Only return ads with the given manual review status. Only
+     *   available for networks with Manual Creative Review enabled. For more
+     *   information, see
+     *   https://support.google.com/admanager/answer/2586531#manual-creative-review.
      * @param {string} request.parent
      *   Required. The parent, which owns this collection of AdReviewCenterAds.
      *   Format: networks/{network_code}/webProperties/{web_property_code}
@@ -507,15 +553,14 @@ class AdReviewCenterAdServiceClient {
      * @param {string} [request.pageToken]
      *   Optional. The page token to fetch the next page of AdReviewCenterAds. This
      *   is the value returned from a previous Search request, or empty.
-     * @param {google.ads.admanager.v1.AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus} [request.status]
-     *   Optional. Only return ads with the given status.
      * @param {string[]} [request.adReviewCenterAdId]
      *   Optional. Only return ads with the given AdReviewCenterAd IDs. If provided,
      *   no other filter can be set (other than page size and page token).
      * @param {google.type.Interval} [request.dateTimeRange]
      *   Optional. If provided, only return ads that served within the given date
      *   range (inclusive). The  date range must be within the last 30 days. If not
-     *   provided, the date range will be the last 30 days.
+     *   provided, the date range will be the last 30 days. This filter does not
+     *   apply to the PENDING manual review status.
      * @param {string[]} [request.searchText]
      *   Optional. If provided, restrict the search to AdReviewCenterAds associated
      *   with the text (including any text on the ad or in the destination URL). If
@@ -525,7 +570,7 @@ class AdReviewCenterAdServiceClient {
      * @param {number[]} [request.buyerAccountId]
      *   Optional. If provided, restrict the search to creatives belonging to one of
      *   the given Adx buyer account IDs. Only applicable to RTB creatives. Adx
-     *   buyer account IDs can be found via the ProgrammaticBuyerService.
+     *   buyer account IDs can be found using the `ProgrammaticBuyerService`.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
@@ -542,12 +587,15 @@ class AdReviewCenterAdServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
-            'parent': request.parent ?? '',
-        });
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: request.parent ?? '',
+            });
         const defaultCallSettings = this._defaults['searchAdReviewCenterAds'];
         const callSettings = defaultCallSettings.merge(options);
-        this.initialize().catch(err => { throw err; });
+        this.initialize().catch((err) => {
+            throw err;
+        });
         this._log.info('searchAdReviewCenterAds stream %j', request);
         return this.descriptors.page.searchAdReviewCenterAds.createStream(this.innerApiCalls.searchAdReviewCenterAds, request, callSettings);
     }
@@ -557,6 +605,13 @@ class AdReviewCenterAdServiceClient {
      * `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 {google.ads.admanager.v1.AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus} [request.status]
+     *   Optional. Only return ads with the given status.
+     * @param {google.ads.admanager.v1.ManualAdReviewCenterAdStatusEnum.ManualAdReviewCenterAdStatus} [request.manualReviewStatus]
+     *   Optional. Only return ads with the given manual review status. Only
+     *   available for networks with Manual Creative Review enabled. For more
+     *   information, see
+     *   https://support.google.com/admanager/answer/2586531#manual-creative-review.
      * @param {string} request.parent
      *   Required. The parent, which owns this collection of AdReviewCenterAds.
      *   Format: networks/{network_code}/webProperties/{web_property_code}
@@ -580,15 +635,14 @@ class AdReviewCenterAdServiceClient {
      * @param {string} [request.pageToken]
      *   Optional. The page token to fetch the next page of AdReviewCenterAds. This
      *   is the value returned from a previous Search request, or empty.
-     * @param {google.ads.admanager.v1.AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus} [request.status]
-     *   Optional. Only return ads with the given status.
      * @param {string[]} [request.adReviewCenterAdId]
      *   Optional. Only return ads with the given AdReviewCenterAd IDs. If provided,
      *   no other filter can be set (other than page size and page token).
      * @param {google.type.Interval} [request.dateTimeRange]
      *   Optional. If provided, only return ads that served within the given date
      *   range (inclusive). The  date range must be within the last 30 days. If not
-     *   provided, the date range will be the last 30 days.
+     *   provided, the date range will be the last 30 days. This filter does not
+     *   apply to the PENDING manual review status.
      * @param {string[]} [request.searchText]
      *   Optional. If provided, restrict the search to AdReviewCenterAds associated
      *   with the text (including any text on the ad or in the destination URL). If
@@ -598,7 +652,7 @@ class AdReviewCenterAdServiceClient {
      * @param {number[]} [request.buyerAccountId]
      *   Optional. If provided, restrict the search to creatives belonging to one of
      *   the given Adx buyer account IDs. Only applicable to RTB creatives. Adx
-     *   buyer account IDs can be found via the ProgrammaticBuyerService.
+     *   buyer account IDs can be found using the `ProgrammaticBuyerService`.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}
@@ -616,45 +670,48 @@ class AdReviewCenterAdServiceClient {
         options = options || {};
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
-        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams({
-            'parent': request.parent ?? '',
-        });
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: request.parent ?? '',
+            });
         const defaultCallSettings = this._defaults['searchAdReviewCenterAds'];
         const callSettings = defaultCallSettings.merge(options);
-        this.initialize().catch(err => { throw err; });
+        this.initialize().catch((err) => {
+            throw err;
+        });
         this._log.info('searchAdReviewCenterAds iterate %j', request);
         return this.descriptors.page.searchAdReviewCenterAds.asyncIterate(this.innerApiCalls['searchAdReviewCenterAds'], request, callSettings);
     }
     /**
-       * 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) {
@@ -831,7 +888,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromAdBreakName(adBreakName) {
-        return this.pathTemplates.adBreakPathTemplate.match(adBreakName).network_code;
+        return this.pathTemplates.adBreakPathTemplate.match(adBreakName)
+            .network_code;
     }
     /**
      * Parse the asset_key from AdBreak resource.
@@ -952,7 +1010,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromApplicationName(applicationName) {
-        return this.pathTemplates.applicationPathTemplate.match(applicationName).network_code;
+        return this.pathTemplates.applicationPathTemplate.match(applicationName)
+            .network_code;
     }
     /**
      * Parse the application from Application resource.
@@ -962,7 +1021,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the application.
      */
     matchApplicationFromApplicationName(applicationName) {
-        return this.pathTemplates.applicationPathTemplate.match(applicationName).application;
+        return this.pathTemplates.applicationPathTemplate.match(applicationName)
+            .application;
     }
     /**
      * Return a fully-qualified audienceSegment resource name string.
@@ -1051,7 +1111,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromBrowserName(browserName) {
-        return this.pathTemplates.browserPathTemplate.match(browserName).network_code;
+        return this.pathTemplates.browserPathTemplate.match(browserName)
+            .network_code;
     }
     /**
      * Parse the browser from Browser resource.
@@ -1096,6 +1157,39 @@ class AdReviewCenterAdServiceClient {
     matchBrowserLanguageFromBrowserLanguageName(browserLanguageName) {
         return this.pathTemplates.browserLanguagePathTemplate.match(browserLanguageName).browser_language;
     }
+    /**
+     * Return a fully-qualified childPublisher resource name string.
+     *
+     * @param {string} network_code
+     * @param {string} child_publisher
+     * @returns {string} Resource name string.
+     */
+    childPublisherPath(networkCode, childPublisher) {
+        return this.pathTemplates.childPublisherPathTemplate.render({
+            network_code: networkCode,
+            child_publisher: childPublisher,
+        });
+    }
+    /**
+     * Parse the network_code from ChildPublisher resource.
+     *
+     * @param {string} childPublisherName
+     *   A fully-qualified path representing ChildPublisher resource.
+     * @returns {string} A string representing the network_code.
+     */
+    matchNetworkCodeFromChildPublisherName(childPublisherName) {
+        return this.pathTemplates.childPublisherPathTemplate.match(childPublisherName).network_code;
+    }
+    /**
+     * Parse the child_publisher from ChildPublisher resource.
+     *
+     * @param {string} childPublisherName
+     *   A fully-qualified path representing ChildPublisher resource.
+     * @returns {string} A string representing the child_publisher.
+     */
+    matchChildPublisherFromChildPublisherName(childPublisherName) {
+        return this.pathTemplates.childPublisherPathTemplate.match(childPublisherName).child_publisher;
+    }
     /**
      * Return a fully-qualified cmsMetadataKey resource name string.
      *
@@ -1183,7 +1277,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromCompanyName(companyName) {
-        return this.pathTemplates.companyPathTemplate.match(companyName).network_code;
+        return this.pathTemplates.companyPathTemplate.match(companyName)
+            .network_code;
     }
     /**
      * Parse the company from Company resource.
@@ -1216,7 +1311,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromContactName(contactName) {
-        return this.pathTemplates.contactPathTemplate.match(contactName).network_code;
+        return this.pathTemplates.contactPathTemplate.match(contactName)
+            .network_code;
     }
     /**
      * Parse the contact from Contact resource.
@@ -1249,7 +1345,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromContentName(contentName) {
-        return this.pathTemplates.contentPathTemplate.match(contentName).network_code;
+        return this.pathTemplates.contentPathTemplate.match(contentName)
+            .network_code;
     }
     /**
      * Parse the content from Content resource.
@@ -1282,7 +1379,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromContentBundleName(contentBundleName) {
-        return this.pathTemplates.contentBundlePathTemplate.match(contentBundleName).network_code;
+        return this.pathTemplates.contentBundlePathTemplate.match(contentBundleName)
+            .network_code;
     }
     /**
      * Parse the content_bundle from ContentBundle resource.
@@ -1292,7 +1390,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the content_bundle.
      */
     matchContentBundleFromContentBundleName(contentBundleName) {
-        return this.pathTemplates.contentBundlePathTemplate.match(contentBundleName).content_bundle;
+        return this.pathTemplates.contentBundlePathTemplate.match(contentBundleName)
+            .content_bundle;
     }
     /**
      * Return a fully-qualified contentLabel resource name string.
@@ -1315,7 +1414,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromContentLabelName(contentLabelName) {
-        return this.pathTemplates.contentLabelPathTemplate.match(contentLabelName).network_code;
+        return this.pathTemplates.contentLabelPathTemplate.match(contentLabelName)
+            .network_code;
     }
     /**
      * Parse the content_label from ContentLabel resource.
@@ -1325,7 +1425,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the content_label.
      */
     matchContentLabelFromContentLabelName(contentLabelName) {
-        return this.pathTemplates.contentLabelPathTemplate.match(contentLabelName).content_label;
+        return this.pathTemplates.contentLabelPathTemplate.match(contentLabelName)
+            .content_label;
     }
     /**
      * Return a fully-qualified creativeTemplate resource name string.
@@ -1381,7 +1482,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromCustomFieldName(customFieldName) {
-        return this.pathTemplates.customFieldPathTemplate.match(customFieldName).network_code;
+        return this.pathTemplates.customFieldPathTemplate.match(customFieldName)
+            .network_code;
     }
     /**
      * Parse the custom_field from CustomField resource.
@@ -1391,7 +1493,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the custom_field.
      */
     matchCustomFieldFromCustomFieldName(customFieldName) {
-        return this.pathTemplates.customFieldPathTemplate.match(customFieldName).custom_field;
+        return this.pathTemplates.customFieldPathTemplate.match(customFieldName)
+            .custom_field;
     }
     /**
      * Return a fully-qualified customTargetingKey resource name string.
@@ -1612,7 +1715,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromGeoTargetName(geoTargetName) {
-        return this.pathTemplates.geoTargetPathTemplate.match(geoTargetName).network_code;
+        return this.pathTemplates.geoTargetPathTemplate.match(geoTargetName)
+            .network_code;
     }
     /**
      * Parse the geo_target from GeoTarget resource.
@@ -1622,7 +1726,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the geo_target.
      */
     matchGeoTargetFromGeoTargetName(geoTargetName) {
-        return this.pathTemplates.geoTargetPathTemplate.match(geoTargetName).geo_target;
+        return this.pathTemplates.geoTargetPathTemplate.match(geoTargetName)
+            .geo_target;
     }
     /**
      * Return a fully-qualified label resource name string.
@@ -1678,7 +1783,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromLineItemName(lineItemName) {
-        return this.pathTemplates.lineItemPathTemplate.match(lineItemName).network_code;
+        return this.pathTemplates.lineItemPathTemplate.match(lineItemName)
+            .network_code;
     }
     /**
      * Parse the line_item from LineItem resource.
@@ -1688,7 +1794,43 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the line_item.
      */
     matchLineItemFromLineItemName(lineItemName) {
-        return this.pathTemplates.lineItemPathTemplate.match(lineItemName).line_item;
+        return this.pathTemplates.lineItemPathTemplate.match(lineItemName)
+            .line_item;
+    }
+    /**
+     * Return a fully-qualified linkedDevice resource name string.
+     *
+     * @param {string} network_code
+     * @param {string} linked_device
+     * @returns {string} Resource name string.
+     */
+    linkedDevicePath(networkCode, linkedDevice) {
+        return this.pathTemplates.linkedDevicePathTemplate.render({
+            network_code: networkCode,
+            linked_device: linkedDevice,
+        });
+    }
+    /**
+     * Parse the network_code from LinkedDevice resource.
+     *
+     * @param {string} linkedDeviceName
+     *   A fully-qualified path representing LinkedDevice resource.
+     * @returns {string} A string representing the network_code.
+     */
+    matchNetworkCodeFromLinkedDeviceName(linkedDeviceName) {
+        return this.pathTemplates.linkedDevicePathTemplate.match(linkedDeviceName)
+            .network_code;
+    }
+    /**
+     * Parse the linked_device from LinkedDevice resource.
+     *
+     * @param {string} linkedDeviceName
+     *   A fully-qualified path representing LinkedDevice resource.
+     * @returns {string} A string representing the linked_device.
+     */
+    matchLinkedDeviceFromLinkedDeviceName(linkedDeviceName) {
+        return this.pathTemplates.linkedDevicePathTemplate.match(linkedDeviceName)
+            .linked_device;
     }
     /**
      * Return a fully-qualified liveStreamEvent resource name string.
@@ -1744,7 +1886,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromMobileCarrierName(mobileCarrierName) {
-        return this.pathTemplates.mobileCarrierPathTemplate.match(mobileCarrierName).network_code;
+        return this.pathTemplates.mobileCarrierPathTemplate.match(mobileCarrierName)
+            .network_code;
     }
     /**
      * Parse the mobile_carrier from MobileCarrier resource.
@@ -1754,7 +1897,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the mobile_carrier.
      */
     matchMobileCarrierFromMobileCarrierName(mobileCarrierName) {
-        return this.pathTemplates.mobileCarrierPathTemplate.match(mobileCarrierName).mobile_carrier;
+        return this.pathTemplates.mobileCarrierPathTemplate.match(mobileCarrierName)
+            .mobile_carrier;
     }
     /**
      * Return a fully-qualified mobileDevice resource name string.
@@ -1777,7 +1921,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromMobileDeviceName(mobileDeviceName) {
-        return this.pathTemplates.mobileDevicePathTemplate.match(mobileDeviceName).network_code;
+        return this.pathTemplates.mobileDevicePathTemplate.match(mobileDeviceName)
+            .network_code;
     }
     /**
      * Parse the mobile_device from MobileDevice resource.
@@ -1787,7 +1932,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the mobile_device.
      */
     matchMobileDeviceFromMobileDeviceName(mobileDeviceName) {
-        return this.pathTemplates.mobileDevicePathTemplate.match(mobileDeviceName).mobile_device;
+        return this.pathTemplates.mobileDevicePathTemplate.match(mobileDeviceName)
+            .mobile_device;
     }
     /**
      * Return a fully-qualified mobileDeviceSubmodel resource name string.
@@ -1841,7 +1987,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromNetworkName(networkName) {
-        return this.pathTemplates.networkPathTemplate.match(networkName).network_code;
+        return this.pathTemplates.networkPathTemplate.match(networkName)
+            .network_code;
     }
     /**
      * Return a fully-qualified operatingSystem resource name string.
@@ -1963,7 +2110,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromPlacementName(placementName) {
-        return this.pathTemplates.placementPathTemplate.match(placementName).network_code;
+        return this.pathTemplates.placementPathTemplate.match(placementName)
+            .network_code;
     }
     /**
      * Parse the placement from Placement resource.
@@ -1973,7 +2121,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the placement.
      */
     matchPlacementFromPlacementName(placementName) {
-        return this.pathTemplates.placementPathTemplate.match(placementName).placement;
+        return this.pathTemplates.placementPathTemplate.match(placementName)
+            .placement;
     }
     /**
      * Return a fully-qualified privateAuction resource name string.
@@ -2107,6 +2256,39 @@ class AdReviewCenterAdServiceClient {
     matchReportFromReportName(reportName) {
         return this.pathTemplates.reportPathTemplate.match(reportName).report;
     }
+    /**
+     * Return a fully-qualified richMediaAdsCompany resource name string.
+     *
+     * @param {string} network_code
+     * @param {string} rich_media_ads_company
+     * @returns {string} Resource name string.
+     */
+    richMediaAdsCompanyPath(networkCode, richMediaAdsCompany) {
+        return this.pathTemplates.richMediaAdsCompanyPathTemplate.render({
+            network_code: networkCode,
+            rich_media_ads_company: richMediaAdsCompany,
+        });
+    }
+    /**
+     * Parse the network_code from RichMediaAdsCompany resource.
+     *
+     * @param {string} richMediaAdsCompanyName
+     *   A fully-qualified path representing RichMediaAdsCompany resource.
+     * @returns {string} A string representing the network_code.
+     */
+    matchNetworkCodeFromRichMediaAdsCompanyName(richMediaAdsCompanyName) {
+        return this.pathTemplates.richMediaAdsCompanyPathTemplate.match(richMediaAdsCompanyName).network_code;
+    }
+    /**
+     * Parse the rich_media_ads_company from RichMediaAdsCompany resource.
+     *
+     * @param {string} richMediaAdsCompanyName
+     *   A fully-qualified path representing RichMediaAdsCompany resource.
+     * @returns {string} A string representing the rich_media_ads_company.
+     */
+    matchRichMediaAdsCompanyFromRichMediaAdsCompanyName(richMediaAdsCompanyName) {
+        return this.pathTemplates.richMediaAdsCompanyPathTemplate.match(richMediaAdsCompanyName).rich_media_ads_company;
+    }
     /**
      * Return a fully-qualified role resource name string.
      *
@@ -2293,7 +2475,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the network_code.
      */
     matchNetworkCodeFromWebPropertyName(webPropertyName) {
-        return this.pathTemplates.webPropertyPathTemplate.match(webPropertyName).network_code;
+        return this.pathTemplates.webPropertyPathTemplate.match(webPropertyName)
+            .network_code;
     }
     /**
      * Parse the web_property from WebProperty resource.
@@ -2303,7 +2486,8 @@ class AdReviewCenterAdServiceClient {
      * @returns {string} A string representing the web_property.
      */
     matchWebPropertyFromWebPropertyName(webPropertyName) {
-        return this.pathTemplates.webPropertyPathTemplate.match(webPropertyName).web_property;
+        return this.pathTemplates.webPropertyPathTemplate.match(webPropertyName)
+            .web_property;
     }
     /**
      * Terminate the gRPC channel and close the client.
@@ -2313,7 +2497,7 @@ class AdReviewCenterAdServiceClient {
      */
     close() {
         if (this.adReviewCenterAdServiceStub && !this._terminated) {
-            return this.adReviewCenterAdServiceStub.then(stub => {
+            return this.adReviewCenterAdServiceStub.then((stub) => {
                 this._log.info('ending gRPC channel');
                 this._terminated = true;
                 stub.close();