google-ads-api 19.0.4-rest-beta → 19.1.0-beta.1

package/build/src/client.d.ts

@@ -7,7 +7,6 @@ export interface ClientOptions {
     client_secret: string;
     developer_token: string;
     disable_parsing?: boolean;
-    max_reporting_rows?: number;
 }
 export declare class Client {
     private readonly options;

package/build/src/client.js

@@ -4,7 +4,6 @@ exports.Client = void 0;
 const customer_1 = require("./customer");
 const service_1 = require("./service");
 class Client {
-    options;
     constructor(options) {
         this.options = options;
     }

package/build/src/customer.d.ts

@@ -52,10 +52,8 @@ export declare class Customer extends ServiceFactory {
     reportStreamRaw(reportOptions: Readonly<ReportOptions>): Promise<CancellableStream | void>;
     private search;
     private paginatedSearch;
-    private useStreamToImitateRegularSearch;
     private querier;
     private streamer;
-    private handleStreamError;
     /**
      * @description Creates, updates, or removes resources. This method supports atomic transactions
      * with multiple types of resources. For example, you can atomically create a campaign and a
@@ -64,8 +62,4 @@ export declare class Customer extends ServiceFactory {
      */
     mutateResources<T>(mutations: MutateOperation<T>[], mutateOptions?: MutateOptions): Promise<services.MutateGoogleAdsResponse>;
     private get googleAdsFields();
-    private prepareGoogleAdsServicePostRequestArgs;
-    private decamelizeKeysIfNeeded;
-    private gaqlQueryStringIncludesLimit;
-    private generateTooManyRowsError;
 }

package/build/src/customer.js

@@ -4,19 +4,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Customer = void 0;
-const axios_1 = __importDefault(require("axios"));
-const stream_chain_1 = require("stream-chain");
-const stream_json_1 = require("stream-json");
-const StreamArray_1 = require("stream-json/streamers/StreamArray");
-const parserRest_1 = require("./parserRest");
-const protos_1 = require("./protos");
+const parser_1 = require("./parser");
 const serviceFactory_1 = __importDefault(require("./protos/autogen/serviceFactory"));
 const query_1 = require("./query");
-const version_1 = require("./version");
-const ROWS_PER_STREAMED_CHUNK = 10_000; // From experience, this is what can be expected from the API.
+const utils_1 = require("./utils");
 class Customer extends serviceFactory_1.default {
     constructor(clientOptions, customerOptions, hooks) {
-        super(clientOptions, customerOptions, hooks ?? {});
+        super(clientOptions, customerOptions, hooks !== null && hooks !== void 0 ? hooks : {});
     }
     /**
       @description Single query using a raw GAQL string.
@@ -118,124 +112,39 @@ class Customer extends serviceFactory_1.default {
         });
     }
     async search(gaqlQuery, requestOptions) {
-        const accessToken = await this.getAccessToken();
-        try {
-            const rawResponse = await (0, axios_1.default)(this.prepareGoogleAdsServicePostRequestArgs("search", accessToken, {
-                data: {
-                    query: gaqlQuery,
-                    ...requestOptions,
-                },
-            }));
-            const searchResponse = rawResponse.data;
-            const results = searchResponse.results ?? [];
-            const response = results.map((row) => this.decamelizeKeysIfNeeded(row));
-            const summaryRow = this.decamelizeKeysIfNeeded(searchResponse.summaryRow);
-            const nextPageToken = searchResponse.nextPageToken;
-            const totalResultsCount = searchResponse.totalResultsCount
-                ? +searchResponse.totalResultsCount
-                : undefined;
-            return { response, nextPageToken, totalResultsCount, summaryRow };
-        }
-        catch (e) {
-            if (e.response?.data.error.details[0]) {
-                throw new protos_1.errors.GoogleAdsFailure(this.decamelizeKeysIfNeeded(e.response.data.error.details[0]));
-            }
-            throw e;
+        const { service, request } = this.buildSearchRequestAndService(gaqlQuery, requestOptions);
+        const searchResponse = await service.search(request, {
+            otherArgs: { headers: this.callHeaders },
+            autoPaginate: false, // autoPaginate doesn't work
+        });
+        const response = searchResponse[0];
+        const summaryRow = searchResponse[2].summary_row;
+        const nextPageToken = searchResponse[2].next_page_token;
+        const totalResultsCount = searchResponse[2].total_results_count
+            ? +searchResponse[2].total_results_count
+            : undefined;
+        if (summaryRow) {
+            response.unshift(summaryRow);
         }
+        return { response, nextPageToken, totalResultsCount };
     }
-    async paginatedSearch(gaqlQuery, requestOptions) {
-        /*
-          When possible, use the searchStream method to avoid the overhead of pagination.
-        */
-        if (requestOptions.page_size === undefined &&
-            requestOptions.search_settings === undefined // If search_settings is set, we can't use searchStream.
-        ) {
-            // If no pagination or summary options are set, we can use the non-paginated search method.
-            const { response } = await this.useStreamToImitateRegularSearch(gaqlQuery, requestOptions);
-            return { response };
-        }
+    async paginatedSearch(gaqlQuery, requestOptions, parser) {
         const response = [];
         let nextPageToken = undefined;
         const initialSearch = await this.search(gaqlQuery, requestOptions);
-        let totalResultsCount = initialSearch.totalResultsCount;
-        // Sometimes (when no results?) the totalResultsCount field is not included in the response.
-        // In this case, we set it to 0.
-        if (requestOptions.search_settings?.return_total_results_count &&
-            initialSearch.totalResultsCount === undefined) {
-            totalResultsCount = 0;
-        }
-        let summaryRow = initialSearch.summaryRow;
-        response.push(...initialSearch.response);
+        const totalResultsCount = initialSearch.totalResultsCount;
+        response.push(...parser(initialSearch.response));
         nextPageToken = initialSearch.nextPageToken;
         while (nextPageToken) {
             const nextSearch = await this.search(gaqlQuery, {
                 ...requestOptions,
                 page_token: nextPageToken,
             });
-            response.push(...nextSearch.response);
+            response.push(...parser(nextSearch.response));
             nextPageToken = nextSearch.nextPageToken;
-            if (nextSearch.summaryRow) {
-                summaryRow = nextSearch.summaryRow;
-            }
-        }
-        if (summaryRow) {
-            response.unshift(summaryRow);
         }
         return { response, totalResultsCount };
     }
-    // Google's searchStream method is faster than search, but it does not support all features.
-    // When report() is called, we use searchStream if possible, otherwise we use paginatedSearch.
-    // Note that just like `paginatedSearch`, this method accumulates results in memory. Use
-    // `reportStream` for a more memory-efficient alternative (at the cost of more CPU usage).
-    async useStreamToImitateRegularSearch(gaqlQuery, requestOptions) {
-        const accessToken = await this.getAccessToken();
-        try {
-            const args = this.prepareGoogleAdsServicePostRequestArgs("searchStream", accessToken, {
-                responseType: "stream",
-                data: {
-                    query: gaqlQuery,
-                    ...requestOptions,
-                },
-            });
-            const response = await (0, axios_1.default)(args);
-            const stream = response.data;
-            const buffers = [];
-            let rowCount = -ROWS_PER_STREAMED_CHUNK;
-            for await (const data of stream) {
-                if (this.clientOptions.max_reporting_rows &&
-                    !this.gaqlQueryStringIncludesLimit(gaqlQuery)) {
-                    // This is a quick-and-dirty way to count rows, but it's good enough for our purposes.
-                    // We want to avoid using a proper JSON streamer here for performance reasons.
-                    if (data.toString("utf-8").includes(`results":`)) {
-                        rowCount += ROWS_PER_STREAMED_CHUNK;
-                    }
-                    if (rowCount > this.clientOptions.max_reporting_rows) {
-                        throw this.generateTooManyRowsError();
-                    }
-                }
-                buffers.push(data);
-            }
-            const asString = Buffer.concat(buffers).toString("utf-8");
-            const accumulator = [];
-            let foundSummaryRow;
-            for (const { results, summaryRow } of JSON.parse(asString)) {
-                if (summaryRow) {
-                    foundSummaryRow = this.decamelizeKeysIfNeeded(summaryRow);
-                }
-                accumulator.push(...(results ?? []).map((row) => {
-                    return this.decamelizeKeysIfNeeded(row);
-                }));
-                if (foundSummaryRow) {
-                    accumulator.unshift(foundSummaryRow);
-                }
-            }
-            return { response: accumulator };
-        }
-        catch (e) {
-            await this.handleStreamError(e);
-            throw e; // The line above should always throw.
-        }
-    }
     async querier(gaqlQuery, requestOptions = {}, reportOptions, useHooks = true) {
         const baseHookArguments = {
             credentials: this.credentials,
@@ -262,7 +171,14 @@ class Customer extends serviceFactory_1.default {
             }
         }
         try {
-            const { response, totalResultsCount } = await this.paginatedSearch(gaqlQuery, requestOptions);
+            const parsingWapper = (rows) => {
+                return this.clientOptions.disable_parsing
+                    ? rows
+                    : reportOptions
+                        ? (0, parser_1.parse)({ results: rows, reportOptions })
+                        : (0, parser_1.parse)({ results: rows, gaqlString: gaqlQuery });
+            };
+            const { response, totalResultsCount } = await this.paginatedSearch(gaqlQuery, requestOptions, parsingWapper);
             if (this.hooks.onQueryEnd && useHooks) {
                 const queryResolution = { resolved: false };
                 await this.hooks.onQueryEnd({
@@ -314,81 +230,58 @@ class Customer extends serviceFactory_1.default {
                 return;
             }
         }
+        const { service, request } = this.buildSearchStreamRequestAndService(gaqlQuery, requestOptions);
+        const stream = service.searchStream(request, {
+            otherArgs: { headers: this.callHeaders },
+        });
+        let streamFinished = false;
+        const accumulator = [];
+        let nextChunk = (0, utils_1.createNextChunkArrivedPromise)();
+        stream.on("data", (chunk) => {
+            const results = chunk.summary_row ? [chunk.summary_row] : chunk.results;
+            const parsedResponse = this.clientOptions.disable_parsing
+                ? results
+                : reportOptions
+                    ? (0, parser_1.parse)({ results, reportOptions })
+                    : (0, parser_1.parse)({ results, gaqlString: gaqlQuery });
+            accumulator.push(...parsedResponse);
+            nextChunk.resolve();
+            nextChunk = (0, utils_1.createNextChunkArrivedPromise)();
+        });
+        stream.on("error", (searchError) => {
+            nextChunk.reject(searchError);
+        });
+        stream.on("end", () => {
+            streamFinished = true;
+            nextChunk.resolve();
+        });
         try {
-            const accessToken = await this.getAccessToken();
-            const args = this.prepareGoogleAdsServicePostRequestArgs("searchStream", accessToken, {
-                responseType: "stream",
-                data: {
-                    query: gaqlQuery,
-                    ...requestOptions,
-                },
-            });
-            const response = await (0, axios_1.default)(args);
-            const stream = response.data;
-            // The options below help to make the stream less CPU intensive.
-            const parser = new stream_json_1.Parser({
-                streamValues: false,
-                streamKeys: false,
-                packValues: true,
-                packKeys: true,
-            });
-            const pipeline = (0, stream_chain_1.chain)([stream, parser, (0, StreamArray_1.streamArray)()]);
-            let count = 0;
-            for await (const data of pipeline) {
-                const results = data.value.results ??
-                    (data.value.summaryRow ? [data.value.summaryRow] : undefined) ??
-                    [];
-                count += results.length;
-                if (this.clientOptions.max_reporting_rows &&
-                    count > this.clientOptions.max_reporting_rows &&
-                    !this.gaqlQueryStringIncludesLimit(gaqlQuery)) {
-                    throw this.generateTooManyRowsError();
+            while (!streamFinished || accumulator.length) {
+                if (accumulator.length > 0) {
+                    const item = accumulator.shift();
+                    if (item === undefined) {
+                        throw new Error("UNDEFINED_STREAM_ERROR");
+                    }
+                    yield item;
                 }
-                for (const row of results) {
-                    const parsed = this.decamelizeKeysIfNeeded(row);
-                    yield parsed;
+                else {
+                    await nextChunk.newPromise;
                 }
             }
-            return;
         }
-        catch (e) {
-            try {
-                await this.handleStreamError(e);
-            }
-            catch (_e) {
-                if (this.hooks.onStreamError) {
-                    await this.hooks.onStreamError({
-                        ...baseHookArguments,
-                        error: _e,
-                    });
-                }
-                throw _e;
+        catch (searchError) {
+            const googleAdsError = this.getGoogleAdsError(searchError);
+            if (this.hooks.onStreamError) {
+                await this.hooks.onStreamError({
+                    ...baseHookArguments,
+                    error: googleAdsError,
+                });
             }
+            throw googleAdsError;
         }
-    }
-    async handleStreamError(e) {
-        if (!e?.response?.data) {
-            throw e;
+        finally {
+            stream.destroy();
         }
-        // The error is a stream, so some effort is required to parse it.
-        const stream = e.response.data;
-        const pipeline = (0, stream_chain_1.chain)([stream, (0, stream_json_1.parser)(), (0, StreamArray_1.streamArray)()]);
-        const defaultErrorMessage = "Unknown GoogleAdsFailure";
-        let googleAdsFailure = new Error(defaultErrorMessage);
-        // Only throw the first error.
-        pipeline.once("data", (data) => {
-            if (data?.value?.error?.details?.[0]) {
-                googleAdsFailure = new protos_1.errors.GoogleAdsFailure(this.decamelizeKeysIfNeeded(data.value.error.details[0]));
-            }
-            else {
-                googleAdsFailure = new Error(data?.value?.error?.message ?? defaultErrorMessage, { cause: data?.value?.error ?? data?.value });
-            }
-        });
-        // Must always reject.
-        await new Promise((_, reject) => {
-            pipeline.on("end", () => reject(googleAdsFailure));
-            pipeline.on("error", (err) => reject(err));
-        });
     }
     /**
      * @description Creates, updates, or removes resources. This method supports atomic transactions
@@ -468,28 +361,5 @@ class Customer extends serviceFactory_1.default {
             },
         };
     }
-    prepareGoogleAdsServicePostRequestArgs(functionName, accessToken, extra) {
-        return {
-            method: "POST",
-            url: `https://googleads.googleapis.com/${version_1.googleAdsVersion}/customers/${this.customerOptions.customer_id}/googleAds:${functionName}`,
-            headers: {
-                Authorization: `Bearer ${accessToken}`,
-                ...this.callHeaders,
-            },
-            ...extra,
-        };
-    }
-    decamelizeKeysIfNeeded(input) {
-        if (this.clientOptions.disable_parsing) {
-            return input;
-        }
-        return (0, parserRest_1.decamelizeKeys)(input);
-    }
-    gaqlQueryStringIncludesLimit(gaqlQuery) {
-        return gaqlQuery.toLowerCase().includes("limit ");
-    }
-    generateTooManyRowsError() {
-        return new Error(`Exceeded the maximum number of rows set by "max_reporting_rows" (${this.clientOptions.max_reporting_rows}).`);
-    }
 }
 exports.Customer = Customer;

package/build/src/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Customer = exports.ResourceNames = exports.parse = exports.toMicros = exports.fromMicros = exports.protobuf = exports.longrunning = exports.services = exports.resources = exports.errors = exports.fields = exports.enums = exports.common = exports.GoogleAdsApi = void 0;
 // Core library client

package/build/src/protos/autogen/enums.d.ts

@@ -973,7 +973,8 @@ export declare namespace enums {
     enum TargetFrequencyTimeUnit {
         UNSPECIFIED = 0,// UNSPECIFIED
         UNKNOWN = 1,// UNKNOWN
-        WEEKLY = 2
+        WEEKLY = 2,// WEEKLY
+        MONTHLY = 3
     }
     /**
      * @name TargetImpressionShareLocationEnum.TargetImpressionShareLocation
@@ -1020,7 +1021,8 @@ export declare namespace enums {
         VIDEO_SEQUENCE = 17,// VIDEO_SEQUENCE
         APP_CAMPAIGN_FOR_PRE_REGISTRATION = 18,// APP_CAMPAIGN_FOR_PRE_REGISTRATION
         VIDEO_REACH_TARGET_FREQUENCY = 19,// VIDEO_REACH_TARGET_FREQUENCY
-        TRAVEL_ACTIVITIES = 20
+        TRAVEL_ACTIVITIES = 20,// TRAVEL_ACTIVITIES
+        YOUTUBE_AUDIO = 22
     }
     /**
      * @name AdvertisingChannelTypeEnum.AdvertisingChannelType
@@ -2155,7 +2157,8 @@ export declare namespace enums {
         VIDEO_RESPONSIVE = 16,// VIDEO_RESPONSIVE
         VIDEO_EFFICIENT_REACH = 17,// VIDEO_EFFICIENT_REACH
         SMART_CAMPAIGN_ADS = 18,// SMART_CAMPAIGN_ADS
-        TRAVEL_ADS = 19
+        TRAVEL_ADS = 19,// TRAVEL_ADS
+        YOUTUBE_AUDIO = 20
     }
     /**
      * @name AdServingOptimizationStatusEnum.AdServingOptimizationStatus
@@ -2184,6 +2187,15 @@ export declare namespace enums {
         GOOD = 6,// GOOD
         EXCELLENT = 7
     }
+    /**
+     * @name AdStrengthActionItemTypeEnum.AdStrengthActionItemType
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/AdStrengthActionItemTypeEnum.AdStrengthActionItemType
+     */
+    enum AdStrengthActionItemType {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        ADD_ASSET = 2
+    }
     /**
      * @name AdTypeEnum.AdType
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/AdTypeEnum.AdType
@@ -2221,7 +2233,8 @@ export declare namespace enums {
         DEMAND_GEN_CAROUSEL_AD = 41,// DEMAND_GEN_CAROUSEL_AD
         TRAVEL_AD = 37,// TRAVEL_AD
         DEMAND_GEN_VIDEO_RESPONSIVE_AD = 42,// DEMAND_GEN_VIDEO_RESPONSIVE_AD
-        DEMAND_GEN_PRODUCT_AD = 39
+        DEMAND_GEN_PRODUCT_AD = 39,// DEMAND_GEN_PRODUCT_AD
+        YOUTUBE_AUDIO_AD = 44
     }
     /**
      * @name AndroidPrivacyInteractionTypeEnum.AndroidPrivacyInteractionType
@@ -2307,6 +2320,17 @@ export declare namespace enums {
         GENERATE_LANDING_PAGE_PREVIEW = 5,// GENERATE_LANDING_PAGE_PREVIEW
         GENERATE_ENHANCED_YOUTUBE_VIDEOS = 6
     }
+    /**
+     * @name AssetCoverageVideoAspectRatioRequirementEnum.AssetCoverageVideoAspectRatioRequirement
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/AssetCoverageVideoAspectRatioRequirementEnum.AssetCoverageVideoAspectRatioRequirement
+     */
+    enum AssetCoverageVideoAspectRatioRequirement {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        HORIZONTAL = 2,// HORIZONTAL
+        SQUARE = 3,// SQUARE
+        VERTICAL = 4
+    }
     /**
      * @name AssetFieldTypeEnum.AssetFieldType
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/AssetFieldTypeEnum.AssetFieldType
@@ -2342,7 +2366,8 @@ export declare namespace enums {
         BUSINESS_LOGO = 27,// BUSINESS_LOGO
         HOTEL_PROPERTY = 28,// HOTEL_PROPERTY
         DEMAND_GEN_CAROUSEL_CARD = 30,// DEMAND_GEN_CAROUSEL_CARD
-        BUSINESS_MESSAGE = 31
+        BUSINESS_MESSAGE = 31,// BUSINESS_MESSAGE
+        TALL_PORTRAIT_MARKETING_IMAGE = 32
     }
     /**
      * @name AssetGroupPrimaryStatusEnum.AssetGroupPrimaryStatus
@@ -2976,6 +3001,7 @@ export declare namespace enums {
         AD_GROUP_CRITERION = 5,// AD_GROUP_CRITERION
         CAMPAIGN = 6,// CAMPAIGN
         CAMPAIGN_CRITERION = 7,// CAMPAIGN_CRITERION
+        CAMPAIGN_BUDGET = 8,// CAMPAIGN_BUDGET
         FEED = 9,// FEED
         FEED_ITEM = 10,// FEED_ITEM
         AD_GROUP_FEED = 11,// AD_GROUP_FEED
@@ -2988,7 +3014,9 @@ export declare namespace enums {
         CAMPAIGN_ASSET = 18,// CAMPAIGN_ASSET
         AD_GROUP_ASSET = 19,// AD_GROUP_ASSET
         COMBINED_AUDIENCE = 20,// COMBINED_AUDIENCE
-        ASSET_GROUP = 21
+        ASSET_GROUP = 21,// ASSET_GROUP
+        ASSET_SET = 22,// ASSET_SET
+        CAMPAIGN_ASSET_SET = 23
     }
     /**
      * @name CombinedAudienceStatusEnum.CombinedAudienceStatus
@@ -3091,6 +3119,16 @@ export declare namespace enums {
         ENABLED = 3,// ENABLED
         PAUSED = 4
     }
+    /**
+     * @name ConversionCustomerTypeEnum.ConversionCustomerType
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/ConversionCustomerTypeEnum.ConversionCustomerType
+     */
+    enum ConversionCustomerType {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        NEW = 2,// NEW
+        RETURNING = 3
+    }
     /**
      * @name ConversionEnvironmentEnum.ConversionEnvironment
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/ConversionEnvironmentEnum.ConversionEnvironment
@@ -3374,6 +3412,26 @@ export declare namespace enums {
         UNKNOWN = 1,// UNKNOWN
         VIDEO = 2
     }
+    /**
+     * @name DemandGenChannelConfigEnum.DemandGenChannelConfig
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/DemandGenChannelConfigEnum.DemandGenChannelConfig
+     */
+    enum DemandGenChannelConfig {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        CHANNEL_STRATEGY = 2,// CHANNEL_STRATEGY
+        SELECTED_CHANNELS = 3
+    }
+    /**
+     * @name DemandGenChannelStrategyEnum.DemandGenChannelStrategy
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/DemandGenChannelStrategyEnum.DemandGenChannelStrategy
+     */
+    enum DemandGenChannelStrategy {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        ALL_CHANNELS = 2,// ALL_CHANNELS
+        ALL_OWNED_AND_OPERATED_CHANNELS = 3
+    }
     /**
      * @name DistanceBucketEnum.DistanceBucket
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/DistanceBucketEnum.DistanceBucket
@@ -3815,6 +3873,18 @@ export declare namespace enums {
         NON_FINAL = 14,// NON_FINAL
         OTHER = 15
     }
+    /**
+     * @name LocalServicesLeadCreditIssuanceDecisionEnum.LocalServicesLeadCreditIssuanceDecision
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/LocalServicesLeadCreditIssuanceDecisionEnum.LocalServicesLeadCreditIssuanceDecision
+     */
+    enum LocalServicesLeadCreditIssuanceDecision {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        SUCCESS_NOT_REACHED_THRESHOLD = 2,// SUCCESS_NOT_REACHED_THRESHOLD
+        SUCCESS_REACHED_THRESHOLD = 3,// SUCCESS_REACHED_THRESHOLD
+        FAIL_OVER_THRESHOLD = 4,// FAIL_OVER_THRESHOLD
+        FAIL_NOT_ELIGIBLE = 5
+    }
     /**
      * @name LocalServicesCreditStateEnum.LocalServicesCreditState
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/LocalServicesCreditStateEnum.LocalServicesCreditState
@@ -3841,6 +3911,47 @@ export declare namespace enums {
         CONSUMER_DECLINED = 8,// CONSUMER_DECLINED
         WIPED_OUT = 9
     }
+    /**
+     * @name LocalServicesLeadSurveyAnswerEnum.LocalServicesLeadSurveyAnswer
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/LocalServicesLeadSurveyAnswerEnum.LocalServicesLeadSurveyAnswer
+     */
+    enum LocalServicesLeadSurveyAnswer {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        VERY_SATISFIED = 2,// VERY_SATISFIED
+        SATISFIED = 3,// SATISFIED
+        NEUTRAL = 4,// NEUTRAL
+        DISSATISFIED = 5,// DISSATISFIED
+        VERY_DISSATISFIED = 6
+    }
+    /**
+     * @name LocalServicesLeadSurveyDissatisfiedReasonEnum.LocalServicesLeadSurveyDissatisfiedReason
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/LocalServicesLeadSurveyDissatisfiedReasonEnum.LocalServicesLeadSurveyDissatisfiedReason
+     */
+    enum LocalServicesLeadSurveyDissatisfiedReason {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        OTHER_DISSATISFIED_REASON = 2,// OTHER_DISSATISFIED_REASON
+        GEO_MISMATCH = 3,// GEO_MISMATCH
+        JOB_TYPE_MISMATCH = 4,// JOB_TYPE_MISMATCH
+        NOT_READY_TO_BOOK = 5,// NOT_READY_TO_BOOK
+        SPAM = 6,// SPAM
+        DUPLICATE = 7,// DUPLICATE
+        SOLICITATION = 8
+    }
+    /**
+     * @name LocalServicesLeadSurveySatisfiedReasonEnum.LocalServicesLeadSurveySatisfiedReason
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/LocalServicesLeadSurveySatisfiedReasonEnum.LocalServicesLeadSurveySatisfiedReason
+     */
+    enum LocalServicesLeadSurveySatisfiedReason {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        OTHER_SATISFIED_REASON = 2,// OTHER_SATISFIED_REASON
+        BOOKED_CUSTOMER = 3,// BOOKED_CUSTOMER
+        LIKELY_BOOKED_CUSTOMER = 4,// LIKELY_BOOKED_CUSTOMER
+        SERVICE_RELATED = 5,// SERVICE_RELATED
+        HIGH_VALUE_SERVICE = 6
+    }
     /**
      * @name LocalServicesLeadTypeEnum.LocalServicesLeadType
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/LocalServicesLeadTypeEnum.LocalServicesLeadType
@@ -4211,6 +4322,18 @@ export declare namespace enums {
         AGE_RANGE_55_65_UP = 21,// AGE_RANGE_55_65_UP
         AGE_RANGE_65_UP = 503006
     }
+    /**
+     * @name ReachPlanConversionRateModelEnum.ReachPlanConversionRateModel
+     * @link https://developers.google.com/google-ads/api/reference/rpc/v19/ReachPlanConversionRateModelEnum.ReachPlanConversionRateModel
+     */
+    enum ReachPlanConversionRateModel {
+        UNSPECIFIED = 0,// UNSPECIFIED
+        UNKNOWN = 1,// UNKNOWN
+        CUSTOMER_HISTORY = 2,// CUSTOMER_HISTORY
+        INVENTORY_AGGRESSIVE = 3,// INVENTORY_AGGRESSIVE
+        INVENTORY_CONSERVATIVE = 4,// INVENTORY_CONSERVATIVE
+        INVENTORY_MEDIAN = 5
+    }
     /**
      * @name ReachPlanNetworkEnum.ReachPlanNetwork
      * @link https://developers.google.com/google-ads/api/reference/rpc/v19/ReachPlanNetworkEnum.ReachPlanNetwork
@@ -4229,6 +4352,8 @@ export declare namespace enums {
     enum ReachPlanSurface {
         UNSPECIFIED = 0,// UNSPECIFIED
         UNKNOWN = 1,// UNKNOWN
+        DISCOVER_FEED = 7,// DISCOVER_FEED
+        GMAIL = 8,// GMAIL
         IN_FEED = 2,// IN_FEED
         IN_STREAM_BUMPER = 3,// IN_STREAM_BUMPER
         IN_STREAM_NON_SKIPPABLE = 4,// IN_STREAM_NON_SKIPPABLE