google-ads-api-types 0.21.0

package/dist/google/ads/googleads/v21/resources/recommendation.d.ts

@@ -0,0 +1,810 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { KeywordInfo } from "../common/criteria.js";
+import { AdStrengthEnum_AdStrength } from "../enums/ad_strength.js";
+import { AppBiddingGoalEnum_AppBiddingGoal } from "../enums/app_bidding_goal.js";
+import { KeywordMatchTypeEnum_KeywordMatchType } from "../enums/keyword_match_type.js";
+import { RecommendationTypeEnum_RecommendationType } from "../enums/recommendation_type.js";
+import { ShoppingAddProductsToCampaignRecommendationEnum_Reason } from "../enums/shopping_add_products_to_campaign_recommendation_enum.js";
+import { TargetCpaOptInRecommendationGoalEnum_TargetCpaOptInRecommendationGoal } from "../enums/target_cpa_opt_in_recommendation_goal.js";
+import { Ad } from "./ad.js";
+import { Asset } from "./asset.js";
+export declare const protobufPackage = "google.ads.googleads.v21.resources";
+/** A recommendation. */
+export interface Recommendation {
+    /**
+     * Immutable. The resource name of the recommendation.
+     *
+     * `customers/{customer_id}/recommendations/{recommendation_id}`
+     */
+    resourceName: string;
+    /** Output only. The type of recommendation. */
+    type: RecommendationTypeEnum_RecommendationType;
+    /**
+     * Output only. The impact on account performance as a result of applying the
+     * recommendation.
+     */
+    impact?: Recommendation_RecommendationImpact | undefined;
+    /**
+     * Output only. The budget targeted by this recommendation. This will be set
+     * only when the recommendation affects a single campaign budget.
+     *
+     * This field will be set for the following recommendation types:
+     * CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET,
+     * MOVE_UNUSED_BUDGET
+     */
+    campaignBudget?: string | undefined;
+    /**
+     * Output only. The campaign targeted by this recommendation.
+     *
+     * This field will be set for the following recommendation types:
+     * CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN,
+     * USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE,
+     * UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN,
+     * MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION,
+     * RESPONSIVE_SEARCH_AD,
+     * RESPONSIVE_SEARCH_AD_ASSET,
+     * SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION,
+     * TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD,
+     * UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX,
+     * RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS,
+     * SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER,
+     * SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS,
+     * SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS,
+     * SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX,
+     * DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS,
+     * FORECASTING_SET_TARGET_CPA,
+     * SET_TARGET_CPA, SET_TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE_OPT_IN,
+     * IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN
+     */
+    campaign?: string | undefined;
+    /**
+     * Output only. The ad group targeted by this recommendation. This will be set
+     * only when the recommendation affects a single ad group.
+     *
+     * This field will be set for the following recommendation types:
+     * KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD,
+     * RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD
+     */
+    adGroup?: string | undefined;
+    /** Output only. Whether the recommendation is dismissed or not. */
+    dismissed?: boolean | undefined;
+    /**
+     * Output only. The campaigns targeted by this recommendation.
+     *
+     * This field will be set for the following recommendation types:
+     * CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET,
+     * MARGINAL_ROI_CAMPAIGN_BUDGET and MOVE_UNUSED_BUDGET
+     */
+    campaigns: string[];
+    /** Output only. The campaign budget recommendation. */
+    campaignBudgetRecommendation?: Recommendation_CampaignBudgetRecommendation | undefined;
+    /** Output only. The forecasting campaign budget recommendation. */
+    forecastingCampaignBudgetRecommendation?: Recommendation_CampaignBudgetRecommendation | undefined;
+    /** Output only. The keyword recommendation. */
+    keywordRecommendation?: Recommendation_KeywordRecommendation | undefined;
+    /** Output only. Add expanded text ad recommendation. */
+    textAdRecommendation?: Recommendation_TextAdRecommendation | undefined;
+    /** Output only. The TargetCPA opt-in recommendation. */
+    targetCpaOptInRecommendation?: Recommendation_TargetCpaOptInRecommendation | undefined;
+    /** Output only. The MaximizeConversions Opt-In recommendation. */
+    maximizeConversionsOptInRecommendation?: Recommendation_MaximizeConversionsOptInRecommendation | undefined;
+    /** Output only. The Enhanced Cost-Per-Click Opt-In recommendation. */
+    enhancedCpcOptInRecommendation?: Recommendation_EnhancedCpcOptInRecommendation | undefined;
+    /** Output only. The Search Partners Opt-In recommendation. */
+    searchPartnersOptInRecommendation?: Recommendation_SearchPartnersOptInRecommendation | undefined;
+    /** Output only. The MaximizeClicks Opt-In recommendation. */
+    maximizeClicksOptInRecommendation?: Recommendation_MaximizeClicksOptInRecommendation | undefined;
+    /** Output only. The Optimize Ad Rotation recommendation. */
+    optimizeAdRotationRecommendation?: Recommendation_OptimizeAdRotationRecommendation | undefined;
+    /** Output only. The keyword match type recommendation. */
+    keywordMatchTypeRecommendation?: Recommendation_KeywordMatchTypeRecommendation | undefined;
+    /** Output only. The move unused budget recommendation. */
+    moveUnusedBudgetRecommendation?: Recommendation_MoveUnusedBudgetRecommendation | undefined;
+    /** Output only. The Target ROAS opt-in recommendation. */
+    targetRoasOptInRecommendation?: Recommendation_TargetRoasOptInRecommendation | undefined;
+    /** Output only. The add responsive search ad recommendation. */
+    responsiveSearchAdRecommendation?: Recommendation_ResponsiveSearchAdRecommendation | undefined;
+    /** Output only. The marginal ROI campaign budget recommendation. */
+    marginalRoiCampaignBudgetRecommendation?: Recommendation_CampaignBudgetRecommendation | undefined;
+    /** Output only. The use broad match keyword recommendation. */
+    useBroadMatchKeywordRecommendation?: Recommendation_UseBroadMatchKeywordRecommendation | undefined;
+    /** Output only. The responsive search ad asset recommendation. */
+    responsiveSearchAdAssetRecommendation?: Recommendation_ResponsiveSearchAdAssetRecommendation | undefined;
+    /**
+     * Output only. The upgrade a Smart Shopping campaign to a Performance Max
+     * campaign recommendation.
+     */
+    upgradeSmartShoppingCampaignToPerformanceMaxRecommendation?: Recommendation_UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation | undefined;
+    /** Output only. The responsive search ad improve ad strength recommendation. */
+    responsiveSearchAdImproveAdStrengthRecommendation?: Recommendation_ResponsiveSearchAdImproveAdStrengthRecommendation | undefined;
+    /** Output only. The Display Expansion opt-in recommendation. */
+    displayExpansionOptInRecommendation?: Recommendation_DisplayExpansionOptInRecommendation | undefined;
+    /**
+     * Output only. The upgrade a Local campaign to a Performance Max campaign
+     * recommendation.
+     */
+    upgradeLocalCampaignToPerformanceMaxRecommendation?: Recommendation_UpgradeLocalCampaignToPerformanceMaxRecommendation | undefined;
+    /** Output only. The raise target CPA bid too low recommendation. */
+    raiseTargetCpaBidTooLowRecommendation?: Recommendation_RaiseTargetCpaBidTooLowRecommendation | undefined;
+    /** Output only. The forecasting set target ROAS recommendation. */
+    forecastingSetTargetRoasRecommendation?: Recommendation_ForecastingSetTargetRoasRecommendation | undefined;
+    /** Output only. The callout asset recommendation. */
+    calloutAssetRecommendation?: Recommendation_CalloutAssetRecommendation | undefined;
+    /** Output only. The sitelink asset recommendation. */
+    sitelinkAssetRecommendation?: Recommendation_SitelinkAssetRecommendation | undefined;
+    /** Output only. The call asset recommendation. */
+    callAssetRecommendation?: Recommendation_CallAssetRecommendation | undefined;
+    /** Output only. The shopping add age group recommendation. */
+    shoppingAddAgeGroupRecommendation?: Recommendation_ShoppingOfferAttributeRecommendation | undefined;
+    /** Output only. The shopping add color recommendation. */
+    shoppingAddColorRecommendation?: Recommendation_ShoppingOfferAttributeRecommendation | undefined;
+    /** Output only. The shopping add gender recommendation. */
+    shoppingAddGenderRecommendation?: Recommendation_ShoppingOfferAttributeRecommendation | undefined;
+    /** Output only. The shopping add GTIN recommendation. */
+    shoppingAddGtinRecommendation?: Recommendation_ShoppingOfferAttributeRecommendation | undefined;
+    /** Output only. The shopping add more identifiers recommendation. */
+    shoppingAddMoreIdentifiersRecommendation?: Recommendation_ShoppingOfferAttributeRecommendation | undefined;
+    /** Output only. The shopping add size recommendation. */
+    shoppingAddSizeRecommendation?: Recommendation_ShoppingOfferAttributeRecommendation | undefined;
+    /** Output only. The shopping add products to campaign recommendation. */
+    shoppingAddProductsToCampaignRecommendation?: Recommendation_ShoppingAddProductsToCampaignRecommendation | undefined;
+    /** Output only. The shopping fix disapproved products recommendation. */
+    shoppingFixDisapprovedProductsRecommendation?: Recommendation_ShoppingFixDisapprovedProductsRecommendation | undefined;
+    /** Output only. The shopping target all offers recommendation. */
+    shoppingTargetAllOffersRecommendation?: Recommendation_ShoppingTargetAllOffersRecommendation | undefined;
+    /**
+     * Output only. The shopping fix suspended Merchant Center account
+     * recommendation.
+     */
+    shoppingFixSuspendedMerchantCenterAccountRecommendation?: Recommendation_ShoppingMerchantCenterAccountSuspensionRecommendation | undefined;
+    /**
+     * Output only. The shopping fix Merchant Center account suspension warning
+     * recommendation.
+     */
+    shoppingFixMerchantCenterAccountSuspensionWarningRecommendation?: Recommendation_ShoppingMerchantCenterAccountSuspensionRecommendation | undefined;
+    /**
+     * Output only. The shopping migrate Regular Shopping Campaign offers to
+     * Performance Max recommendation.
+     */
+    shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation?: Recommendation_ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation | undefined;
+    /**
+     * Output only. Recommendation to enable dynamic image extensions on the
+     * account, allowing Google to find the best images from ad landing pages
+     * and complement text ads.
+     */
+    dynamicImageExtensionOptInRecommendation?: Recommendation_DynamicImageExtensionOptInRecommendation | undefined;
+    /** Output only. Recommendation to raise Target CPA. */
+    raiseTargetCpaRecommendation?: Recommendation_RaiseTargetCpaRecommendation | undefined;
+    /** Output only. Recommendation to lower Target ROAS. */
+    lowerTargetRoasRecommendation?: Recommendation_LowerTargetRoasRecommendation | undefined;
+    /** Output only. The Performance Max Opt In recommendation. */
+    performanceMaxOptInRecommendation?: Recommendation_PerformanceMaxOptInRecommendation | undefined;
+    /** Output only. The improve Performance Max ad strength recommendation. */
+    improvePerformanceMaxAdStrengthRecommendation?: Recommendation_ImprovePerformanceMaxAdStrengthRecommendation | undefined;
+    /**
+     * Output only. The Dynamic Search Ads to Performance Max migration
+     * recommendation.
+     */
+    migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation?: Recommendation_MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation | undefined;
+    /** Output only. The forecasting set target CPA recommendation. */
+    forecastingSetTargetCpaRecommendation?: Recommendation_ForecastingSetTargetCpaRecommendation | undefined;
+    /** Output only. The set target CPA recommendation. */
+    setTargetCpaRecommendation?: Recommendation_ForecastingSetTargetCpaRecommendation | undefined;
+    /** Output only. The set target ROAS recommendation. */
+    setTargetRoasRecommendation?: Recommendation_ForecastingSetTargetRoasRecommendation | undefined;
+    /** Output only. The Maximize Conversion Value opt-in recommendation. */
+    maximizeConversionValueOptInRecommendation?: Recommendation_MaximizeConversionValueOptInRecommendation | undefined;
+    /** Output only. Recommendation to deploy Google Tag on more pages. */
+    improveGoogleTagCoverageRecommendation?: Recommendation_ImproveGoogleTagCoverageRecommendation | undefined;
+    /**
+     * Output only. Recommendation to turn on Final URL expansion for your
+     * Performance Max campaigns.
+     */
+    performanceMaxFinalUrlOptInRecommendation?: Recommendation_PerformanceMaxFinalUrlOptInRecommendation | undefined;
+    /** Output only. The refresh customer list recommendation. */
+    refreshCustomerMatchListRecommendation?: Recommendation_RefreshCustomerMatchListRecommendation | undefined;
+    /** Output only. The custom audience opt in recommendation. */
+    customAudienceOptInRecommendation?: Recommendation_CustomAudienceOptInRecommendation | undefined;
+    /** Output only. The lead form asset recommendation. */
+    leadFormAssetRecommendation?: Recommendation_LeadFormAssetRecommendation | undefined;
+    /** Output only. The improve Demand Gen ad strength recommendation. */
+    improveDemandGenAdStrengthRecommendation?: Recommendation_ImproveDemandGenAdStrengthRecommendation | undefined;
+}
+/** The Merchant Center account details. */
+export interface Recommendation_MerchantInfo {
+    /** Output only. The Merchant Center account ID. */
+    id: number;
+    /** Output only. The name of the Merchant Center account. */
+    name: string;
+    /**
+     * Output only. Whether the Merchant Center account is a Multi-Client
+     * account (MCA).
+     */
+    multiClient: boolean;
+}
+/**
+ * The impact of making the change as described in the recommendation.
+ * Some types of recommendations may not have impact information.
+ */
+export interface Recommendation_RecommendationImpact {
+    /** Output only. Base metrics at the time the recommendation was generated. */
+    baseMetrics?: Recommendation_RecommendationMetrics | undefined;
+    /** Output only. Estimated metrics if the recommendation is applied. */
+    potentialMetrics?: Recommendation_RecommendationMetrics | undefined;
+}
+/**
+ * Weekly account performance metrics. For some recommendation types, these
+ * are averaged over the past 90-day period and hence can be fractional.
+ */
+export interface Recommendation_RecommendationMetrics {
+    /** Output only. Number of ad impressions. */
+    impressions?: number | undefined;
+    /** Output only. Number of ad clicks. */
+    clicks?: number | undefined;
+    /**
+     * Output only. Cost (in micros) for advertising, in the local currency for
+     * the account.
+     */
+    costMicros?: number | undefined;
+    /** Output only. Number of conversions. */
+    conversions?: number | undefined;
+    /** Output only. Sum of the conversion value of the conversions. */
+    conversionsValue?: number | undefined;
+    /** Output only. Number of video views for a video ad campaign. */
+    videoViews?: number | undefined;
+}
+/** The budget recommendation for budget constrained campaigns. */
+export interface Recommendation_CampaignBudgetRecommendation {
+    /** Output only. The current budget amount in micros. */
+    currentBudgetAmountMicros?: number | undefined;
+    /** Output only. The recommended budget amount in micros. */
+    recommendedBudgetAmountMicros?: number | undefined;
+    /**
+     * Output only. The budget amounts and associated impact estimates for some
+     * values of possible budget amounts.
+     */
+    budgetOptions: Recommendation_CampaignBudgetRecommendation_CampaignBudgetRecommendationOption[];
+}
+/** The impact estimates for a given budget amount. */
+export interface Recommendation_CampaignBudgetRecommendation_CampaignBudgetRecommendationOption {
+    /** Output only. The budget amount for this option. */
+    budgetAmountMicros?: number | undefined;
+    /**
+     * Output only. The impact estimate if budget is changed to amount
+     * specified in this option.
+     */
+    impact?: Recommendation_RecommendationImpact | undefined;
+}
+/** The keyword recommendation. */
+export interface Recommendation_KeywordRecommendation {
+    /** Output only. The recommended keyword. */
+    keyword?: KeywordInfo | undefined;
+    /**
+     * Output only. A list of search terms this keyword matches. The same search
+     * term may be repeated for multiple keywords.
+     */
+    searchTerms: Recommendation_KeywordRecommendation_SearchTerm[];
+    /** Output only. The recommended CPC (cost-per-click) bid. */
+    recommendedCpcBidMicros?: number | undefined;
+}
+/** Information about a search term as related to a keyword recommendation. */
+export interface Recommendation_KeywordRecommendation_SearchTerm {
+    /** Output only. The text of the search term. */
+    text: string;
+    /**
+     * Output only. Estimated number of historical weekly searches for this
+     * search term.
+     */
+    estimatedWeeklySearchCount: number;
+}
+/** The text ad recommendation. */
+export interface Recommendation_TextAdRecommendation {
+    /** Output only. Recommended ad. */
+    ad?: Ad | undefined;
+    /**
+     * Output only. Creation date of the recommended ad.
+     * YYYY-MM-DD format, for example, 2018-04-17.
+     */
+    creationDate?: string | undefined;
+    /**
+     * Output only. Date, if present, is the earliest when the recommendation
+     * will be auto applied. YYYY-MM-DD format, for example, 2018-04-17.
+     */
+    autoApplyDate?: string | undefined;
+}
+/** The Target CPA opt-in recommendation. */
+export interface Recommendation_TargetCpaOptInRecommendation {
+    /**
+     * Output only. The available goals and corresponding options for Target CPA
+     * strategy.
+     */
+    options: Recommendation_TargetCpaOptInRecommendation_TargetCpaOptInRecommendationOption[];
+    /**
+     * Output only. The recommended average CPA target. See required budget
+     * amount and impact of using this recommendation in options list.
+     */
+    recommendedTargetCpaMicros?: number | undefined;
+}
+/** The Target CPA opt-in option with impact estimate. */
+export interface Recommendation_TargetCpaOptInRecommendation_TargetCpaOptInRecommendationOption {
+    /** Output only. The goal achieved by this option. */
+    goal: TargetCpaOptInRecommendationGoalEnum_TargetCpaOptInRecommendationGoal;
+    /** Output only. Average CPA target. */
+    targetCpaMicros?: number | undefined;
+    /**
+     * Output only. The minimum campaign budget, in local currency for the
+     * account, required to achieve the target CPA. Amount is specified in
+     * micros, where one million is equivalent to one currency unit.
+     */
+    requiredCampaignBudgetAmountMicros?: number | undefined;
+    /** Output only. The impact estimate if this option is selected. */
+    impact?: Recommendation_RecommendationImpact | undefined;
+}
+/** The Maximize Conversions Opt-In recommendation. */
+export interface Recommendation_MaximizeConversionsOptInRecommendation {
+    /** Output only. The recommended new budget amount. */
+    recommendedBudgetAmountMicros?: number | undefined;
+}
+/** The Enhanced Cost-Per-Click Opt-In recommendation. */
+export interface Recommendation_EnhancedCpcOptInRecommendation {
+}
+/** The Search Partners Opt-In recommendation. */
+export interface Recommendation_SearchPartnersOptInRecommendation {
+}
+/** The Maximize Clicks opt-in recommendation. */
+export interface Recommendation_MaximizeClicksOptInRecommendation {
+    /**
+     * Output only. The recommended new budget amount.
+     * Only set if the current budget is too high.
+     */
+    recommendedBudgetAmountMicros?: number | undefined;
+}
+/** The Optimize Ad Rotation recommendation. */
+export interface Recommendation_OptimizeAdRotationRecommendation {
+}
+/** The callout asset recommendation. */
+export interface Recommendation_CalloutAssetRecommendation {
+    /**
+     * Output only. New callout extension assets recommended at the campaign
+     * level.
+     */
+    recommendedCampaignCalloutAssets: Asset[];
+    /**
+     * Output only. New callout extension assets recommended at the customer
+     * level.
+     */
+    recommendedCustomerCalloutAssets: Asset[];
+}
+/** The sitelink asset recommendation. */
+export interface Recommendation_SitelinkAssetRecommendation {
+    /** Output only. New sitelink assets recommended at the campaign level. */
+    recommendedCampaignSitelinkAssets: Asset[];
+    /** Output only. New sitelink assets recommended at the customer level. */
+    recommendedCustomerSitelinkAssets: Asset[];
+}
+/** The call asset recommendation. */
+export interface Recommendation_CallAssetRecommendation {
+}
+/** The keyword match type recommendation. */
+export interface Recommendation_KeywordMatchTypeRecommendation {
+    /**
+     * Output only. The existing keyword where the match type should be more
+     * broad.
+     */
+    keyword?: KeywordInfo | undefined;
+    /** Output only. The recommended new match type. */
+    recommendedMatchType: KeywordMatchTypeEnum_KeywordMatchType;
+}
+/** The move unused budget recommendation. */
+export interface Recommendation_MoveUnusedBudgetRecommendation {
+    /** Output only. The excess budget's resource_name. */
+    excessCampaignBudget?: string | undefined;
+    /** Output only. The recommendation for the constrained budget to increase. */
+    budgetRecommendation?: Recommendation_CampaignBudgetRecommendation | undefined;
+}
+/** The Target ROAS opt-in recommendation. */
+export interface Recommendation_TargetRoasOptInRecommendation {
+    /**
+     * Output only. The recommended target ROAS (revenue per unit of spend).
+     * The value is between 0.01 and 1000.0, inclusive.
+     */
+    recommendedTargetRoas?: number | undefined;
+    /**
+     * Output only. The minimum campaign budget, in local currency for the
+     * account, required to achieve the target ROAS. Amount is specified in
+     * micros, where one million is equivalent to one currency unit.
+     */
+    requiredCampaignBudgetAmountMicros?: number | undefined;
+}
+/** The add responsive search ad asset recommendation. */
+export interface Recommendation_ResponsiveSearchAdAssetRecommendation {
+    /** Output only. The current ad to be updated. */
+    currentAd?: Ad | undefined;
+    /**
+     * Output only. The recommended assets. This is populated only with the new
+     * headlines and/or descriptions, and is otherwise empty.
+     */
+    recommendedAssets?: Ad | undefined;
+}
+/** The responsive search ad improve ad strength recommendation. */
+export interface Recommendation_ResponsiveSearchAdImproveAdStrengthRecommendation {
+    /** Output only. The current ad to be updated. */
+    currentAd?: Ad | undefined;
+    /** Output only. The updated ad. */
+    recommendedAd?: Ad | undefined;
+}
+/** The add responsive search ad recommendation. */
+export interface Recommendation_ResponsiveSearchAdRecommendation {
+    /** Output only. Recommended ad. */
+    ad?: Ad | undefined;
+}
+/** The use broad match keyword recommendation. */
+export interface Recommendation_UseBroadMatchKeywordRecommendation {
+    /** Output only. Sample of keywords to be expanded to Broad Match. */
+    keyword: KeywordInfo[];
+    /**
+     * Output only. Total number of keywords to be expanded to Broad Match in
+     * the campaign.
+     */
+    suggestedKeywordsCount: number;
+    /** Output only. Total number of keywords in the campaign. */
+    campaignKeywordsCount: number;
+    /** Output only. Whether the associated campaign uses a shared budget. */
+    campaignUsesSharedBudget: boolean;
+    /**
+     * Output only. The budget recommended to avoid becoming budget constrained
+     * after applying the recommendation.
+     */
+    requiredCampaignBudgetAmountMicros: number;
+}
+/**
+ * The upgrade a Smart Shopping campaign to a Performance Max campaign
+ * recommendation.
+ */
+export interface Recommendation_UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation {
+    /** Output only. ID of Merchant Center account. */
+    merchantId: number;
+    /**
+     * Output only. Country whose products from merchant's inventory should be
+     * included.
+     */
+    salesCountryCode: string;
+}
+/** The raise target CPA bid too low recommendation. */
+export interface Recommendation_RaiseTargetCpaBidTooLowRecommendation {
+    /**
+     * Output only. A number greater than 1.0 indicating the factor by which we
+     * recommend the target CPA should be increased.
+     */
+    recommendedTargetMultiplier?: number | undefined;
+    /**
+     * Output only. The current average target CPA of the campaign, in micros of
+     * customer local currency.
+     */
+    averageTargetCpaMicros?: number | undefined;
+}
+/** The Display Expansion opt-in recommendation. */
+export interface Recommendation_DisplayExpansionOptInRecommendation {
+}
+/** The Upgrade Local campaign to Performance Max campaign recommendation. */
+export interface Recommendation_UpgradeLocalCampaignToPerformanceMaxRecommendation {
+}
+/** The forecasting set target ROAS recommendation. */
+export interface Recommendation_ForecastingSetTargetRoasRecommendation {
+    /**
+     * Output only. The recommended target ROAS (revenue per unit of spend).
+     * The value is between 0.01 and 1000.0, inclusive.
+     */
+    recommendedTargetRoas: number;
+    /** Output only. The campaign budget. */
+    campaignBudget?: Recommendation_CampaignBudget | undefined;
+}
+/**
+ * The shopping recommendation to add an attribute to offers that are demoted
+ * because it is missing.
+ */
+export interface Recommendation_ShoppingOfferAttributeRecommendation {
+    /** Output only. The details of the Merchant Center account. */
+    merchant?: Recommendation_MerchantInfo | undefined;
+    /** Output only. The campaign feed label. */
+    feedLabel: string;
+    /** Output only. The number of online, servable offers. */
+    offersCount: number;
+    /**
+     * Output only. The number of online, servable offers that are demoted for
+     * missing attributes. Visit the Merchant Center for more details.
+     */
+    demotedOffersCount: number;
+}
+/**
+ * The shopping recommendation to fix disapproved products in a Shopping
+ * Campaign Inventory.
+ */
+export interface Recommendation_ShoppingFixDisapprovedProductsRecommendation {
+    /** Output only. The details of the Merchant Center account. */
+    merchant?: Recommendation_MerchantInfo | undefined;
+    /** Output only. The feed label for the campaign. */
+    feedLabel: string;
+    /** Output only. The number of products of the campaign. */
+    productsCount: number;
+    /**
+     * Output only. The numbers of products of the campaign that are
+     * disapproved.
+     */
+    disapprovedProductsCount: number;
+}
+/**
+ * The shopping recommendation to create a catch-all campaign that targets all
+ * offers.
+ */
+export interface Recommendation_ShoppingTargetAllOffersRecommendation {
+    /** Output only. The details of the Merchant Center account. */
+    merchant?: Recommendation_MerchantInfo | undefined;
+    /** Output only. The number of untargeted offers. */
+    untargetedOffersCount: number;
+    /** Output only. The offer feed label. */
+    feedLabel: string;
+}
+/**
+ * The shopping recommendation to add products to a Shopping Campaign
+ * Inventory.
+ */
+export interface Recommendation_ShoppingAddProductsToCampaignRecommendation {
+    /** Output only. The details of the Merchant Center account. */
+    merchant?: Recommendation_MerchantInfo | undefined;
+    /** Output only. The feed label for the campaign. */
+    feedLabel: string;
+    /** Output only. The reason why no products are attached to the campaign. */
+    reason: ShoppingAddProductsToCampaignRecommendationEnum_Reason;
+}
+/**
+ * The shopping recommendation to fix Merchant Center account suspension
+ * issues.
+ */
+export interface Recommendation_ShoppingMerchantCenterAccountSuspensionRecommendation {
+    /** Output only. The details of the Merchant Center account. */
+    merchant?: Recommendation_MerchantInfo | undefined;
+    /**
+     * Output only. The feed label of the campaign for which the suspension
+     * happened.
+     */
+    feedLabel: string;
+}
+/**
+ * The shopping recommendation to migrate Regular Shopping Campaign targeted
+ * offers to Performance Max campaigns.
+ */
+export interface Recommendation_ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation {
+    /** Output only. The details of the Merchant Center account. */
+    merchant?: Recommendation_MerchantInfo | undefined;
+    /**
+     * Output only. The feed label of the offers targeted by the campaigns
+     * sharing this suggestion.
+     */
+    feedLabel: string;
+}
+/** Information of a target adjustment recommendation. */
+export interface Recommendation_TargetAdjustmentInfo {
+    /**
+     * Output only. The shared set resource name of the portfolio bidding
+     * strategy where the target is defined. Only populated if the
+     * recommendation is portfolio level.
+     */
+    sharedSet?: string | undefined;
+    /**
+     * Output only. The factor by which we recommend the target to be adjusted
+     * by.
+     */
+    recommendedTargetMultiplier: number;
+    /**
+     * Output only. The current average target of the campaign or portfolio
+     * targeted by this recommendation.
+     */
+    currentAverageTargetMicros: number;
+}
+/** Recommendation to raise Target CPA. */
+export interface Recommendation_RaiseTargetCpaRecommendation {
+    /**
+     * Output only. The relevant information describing the recommended target
+     * adjustment.
+     */
+    targetAdjustment?: Recommendation_TargetAdjustmentInfo | undefined;
+    /**
+     * Output only. Represents the goal towards which the bidding strategy
+     * should optimize. Only populated for App Campaigns.
+     */
+    appBiddingGoal?: AppBiddingGoalEnum_AppBiddingGoal | undefined;
+}
+/** Recommendation to lower Target ROAS. */
+export interface Recommendation_LowerTargetRoasRecommendation {
+    /**
+     * Output only. The relevant information describing the recommended target
+     * adjustment.
+     */
+    targetAdjustment?: Recommendation_TargetAdjustmentInfo | undefined;
+}
+/**
+ * Recommendation to enable dynamic image extensions on the account,
+ * allowing Google to find the best images from ad landing pages and
+ * complement text ads.
+ */
+export interface Recommendation_DynamicImageExtensionOptInRecommendation {
+}
+/** A campaign budget shared amongst various budget recommendation types. */
+export interface Recommendation_CampaignBudget {
+    /** Output only. Current budget amount. */
+    currentAmountMicros: number;
+    /** Output only. Recommended budget amount. */
+    recommendedNewAmountMicros: number;
+    /**
+     * Output only. The date when the new budget would start being used.
+     * This field will be set for the following recommendation types:
+     * FORECASTING_SET_TARGET_ROAS , FORECASTING_SET_TARGET_CPA
+     * YYYY-MM-DD format, for example, 2018-04-17.
+     */
+    newStartDate: string;
+}
+/** The Performance Max Opt In recommendation. */
+export interface Recommendation_PerformanceMaxOptInRecommendation {
+}
+/**
+ * Recommendation to improve the asset group strength of a Performance Max
+ * campaign to an "Excellent" rating.
+ */
+export interface Recommendation_ImprovePerformanceMaxAdStrengthRecommendation {
+    /** Output only. The asset group resource name. */
+    assetGroup: string;
+    /** Output only. The current ad strength score of the asset group. */
+    adStrength: AdStrengthEnum_AdStrength;
+}
+/** The Dynamic Search Ads to Performance Max migration recommendation. */
+export interface Recommendation_MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation {
+    /**
+     * Output only. A link to the Google Ads UI where the customer can manually
+     * apply the recommendation.
+     */
+    applyLink: string;
+}
+/** The set target CPA recommendations. */
+export interface Recommendation_ForecastingSetTargetCpaRecommendation {
+    /** Output only. The recommended target CPA. */
+    recommendedTargetCpaMicros: number;
+    /** Output only. The campaign budget. */
+    campaignBudget?: Recommendation_CampaignBudget | undefined;
+}
+/** Recommendation to opt into Maximize Conversion Value bidding strategy. */
+export interface Recommendation_MaximizeConversionValueOptInRecommendation {
+}
+/** Recommendation to deploy Google Tag on more pages. */
+export interface Recommendation_ImproveGoogleTagCoverageRecommendation {
+}
+/**
+ * Recommendation to turn on Final URL expansion for your Performance Max
+ * campaigns.
+ */
+export interface Recommendation_PerformanceMaxFinalUrlOptInRecommendation {
+}
+/**
+ * The recommendation to update a customer list that hasn't been updated in
+ * the last 90 days. The customer receiving the recommendation is not
+ * necessarily the owner account. The owner account should update the customer
+ * list.
+ */
+export interface Recommendation_RefreshCustomerMatchListRecommendation {
+    /** Output only. The user list ID. */
+    userListId: number;
+    /** Output only. The name of the list. */
+    userListName: string;
+    /** Output only. Days since last refresh. */
+    daysSinceLastRefresh: number;
+    /** Output only. The top spending account. */
+    topSpendingAccount: Recommendation_AccountInfo[];
+    /**
+     * Output only. User lists can be shared with other accounts by the owner.
+     * targeting_accounts_count is the number of those accounts that can use it
+     * for targeting.
+     */
+    targetingAccountsCount: number;
+    /**
+     * Output only. The owner account. This is the account that should update
+     * the customer list.
+     */
+    ownerAccount?: Recommendation_AccountInfo | undefined;
+}
+/** Wrapper for information about a Google Ads account. */
+export interface Recommendation_AccountInfo {
+    /** Output only. The customer ID of the account. */
+    customerId: number;
+    /** Output only. The descriptive name of the account. */
+    descriptiveName: string;
+}
+/** The Custom Audience Opt In recommendation. */
+export interface Recommendation_CustomAudienceOptInRecommendation {
+    /** Output only. The list of keywords to use for custom audience creation. */
+    keywords: KeywordInfo[];
+}
+/** The lead form asset recommendation. */
+export interface Recommendation_LeadFormAssetRecommendation {
+}
+/** The improve Demand Gen ad strength recommendation. */
+export interface Recommendation_ImproveDemandGenAdStrengthRecommendation {
+    /** Output only. The resource name of the ad that can be improved. */
+    ad: string;
+    /** Output only. The current ad strength. */
+    adStrength: AdStrengthEnum_AdStrength;
+    /** Output only. A list of recommendations to improve the ad strength. */
+    demandGenAssetActionItems: string[];
+}
+export declare const Recommendation: MessageFns<Recommendation>;
+export declare const Recommendation_MerchantInfo: MessageFns<Recommendation_MerchantInfo>;
+export declare const Recommendation_RecommendationImpact: MessageFns<Recommendation_RecommendationImpact>;
+export declare const Recommendation_RecommendationMetrics: MessageFns<Recommendation_RecommendationMetrics>;
+export declare const Recommendation_CampaignBudgetRecommendation: MessageFns<Recommendation_CampaignBudgetRecommendation>;
+export declare const Recommendation_CampaignBudgetRecommendation_CampaignBudgetRecommendationOption: MessageFns<Recommendation_CampaignBudgetRecommendation_CampaignBudgetRecommendationOption>;
+export declare const Recommendation_KeywordRecommendation: MessageFns<Recommendation_KeywordRecommendation>;
+export declare const Recommendation_KeywordRecommendation_SearchTerm: MessageFns<Recommendation_KeywordRecommendation_SearchTerm>;
+export declare const Recommendation_TextAdRecommendation: MessageFns<Recommendation_TextAdRecommendation>;
+export declare const Recommendation_TargetCpaOptInRecommendation: MessageFns<Recommendation_TargetCpaOptInRecommendation>;
+export declare const Recommendation_TargetCpaOptInRecommendation_TargetCpaOptInRecommendationOption: MessageFns<Recommendation_TargetCpaOptInRecommendation_TargetCpaOptInRecommendationOption>;
+export declare const Recommendation_MaximizeConversionsOptInRecommendation: MessageFns<Recommendation_MaximizeConversionsOptInRecommendation>;
+export declare const Recommendation_EnhancedCpcOptInRecommendation: MessageFns<Recommendation_EnhancedCpcOptInRecommendation>;
+export declare const Recommendation_SearchPartnersOptInRecommendation: MessageFns<Recommendation_SearchPartnersOptInRecommendation>;
+export declare const Recommendation_MaximizeClicksOptInRecommendation: MessageFns<Recommendation_MaximizeClicksOptInRecommendation>;
+export declare const Recommendation_OptimizeAdRotationRecommendation: MessageFns<Recommendation_OptimizeAdRotationRecommendation>;
+export declare const Recommendation_CalloutAssetRecommendation: MessageFns<Recommendation_CalloutAssetRecommendation>;
+export declare const Recommendation_SitelinkAssetRecommendation: MessageFns<Recommendation_SitelinkAssetRecommendation>;
+export declare const Recommendation_CallAssetRecommendation: MessageFns<Recommendation_CallAssetRecommendation>;
+export declare const Recommendation_KeywordMatchTypeRecommendation: MessageFns<Recommendation_KeywordMatchTypeRecommendation>;
+export declare const Recommendation_MoveUnusedBudgetRecommendation: MessageFns<Recommendation_MoveUnusedBudgetRecommendation>;
+export declare const Recommendation_TargetRoasOptInRecommendation: MessageFns<Recommendation_TargetRoasOptInRecommendation>;
+export declare const Recommendation_ResponsiveSearchAdAssetRecommendation: MessageFns<Recommendation_ResponsiveSearchAdAssetRecommendation>;
+export declare const Recommendation_ResponsiveSearchAdImproveAdStrengthRecommendation: MessageFns<Recommendation_ResponsiveSearchAdImproveAdStrengthRecommendation>;
+export declare const Recommendation_ResponsiveSearchAdRecommendation: MessageFns<Recommendation_ResponsiveSearchAdRecommendation>;
+export declare const Recommendation_UseBroadMatchKeywordRecommendation: MessageFns<Recommendation_UseBroadMatchKeywordRecommendation>;
+export declare const Recommendation_UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation: MessageFns<Recommendation_UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation>;
+export declare const Recommendation_RaiseTargetCpaBidTooLowRecommendation: MessageFns<Recommendation_RaiseTargetCpaBidTooLowRecommendation>;
+export declare const Recommendation_DisplayExpansionOptInRecommendation: MessageFns<Recommendation_DisplayExpansionOptInRecommendation>;
+export declare const Recommendation_UpgradeLocalCampaignToPerformanceMaxRecommendation: MessageFns<Recommendation_UpgradeLocalCampaignToPerformanceMaxRecommendation>;
+export declare const Recommendation_ForecastingSetTargetRoasRecommendation: MessageFns<Recommendation_ForecastingSetTargetRoasRecommendation>;
+export declare const Recommendation_ShoppingOfferAttributeRecommendation: MessageFns<Recommendation_ShoppingOfferAttributeRecommendation>;
+export declare const Recommendation_ShoppingFixDisapprovedProductsRecommendation: MessageFns<Recommendation_ShoppingFixDisapprovedProductsRecommendation>;
+export declare const Recommendation_ShoppingTargetAllOffersRecommendation: MessageFns<Recommendation_ShoppingTargetAllOffersRecommendation>;
+export declare const Recommendation_ShoppingAddProductsToCampaignRecommendation: MessageFns<Recommendation_ShoppingAddProductsToCampaignRecommendation>;
+export declare const Recommendation_ShoppingMerchantCenterAccountSuspensionRecommendation: MessageFns<Recommendation_ShoppingMerchantCenterAccountSuspensionRecommendation>;
+export declare const Recommendation_ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation: MessageFns<Recommendation_ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation>;
+export declare const Recommendation_TargetAdjustmentInfo: MessageFns<Recommendation_TargetAdjustmentInfo>;
+export declare const Recommendation_RaiseTargetCpaRecommendation: MessageFns<Recommendation_RaiseTargetCpaRecommendation>;
+export declare const Recommendation_LowerTargetRoasRecommendation: MessageFns<Recommendation_LowerTargetRoasRecommendation>;
+export declare const Recommendation_DynamicImageExtensionOptInRecommendation: MessageFns<Recommendation_DynamicImageExtensionOptInRecommendation>;
+export declare const Recommendation_CampaignBudget: MessageFns<Recommendation_CampaignBudget>;
+export declare const Recommendation_PerformanceMaxOptInRecommendation: MessageFns<Recommendation_PerformanceMaxOptInRecommendation>;
+export declare const Recommendation_ImprovePerformanceMaxAdStrengthRecommendation: MessageFns<Recommendation_ImprovePerformanceMaxAdStrengthRecommendation>;
+export declare const Recommendation_MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation: MessageFns<Recommendation_MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation>;
+export declare const Recommendation_ForecastingSetTargetCpaRecommendation: MessageFns<Recommendation_ForecastingSetTargetCpaRecommendation>;
+export declare const Recommendation_MaximizeConversionValueOptInRecommendation: MessageFns<Recommendation_MaximizeConversionValueOptInRecommendation>;
+export declare const Recommendation_ImproveGoogleTagCoverageRecommendation: MessageFns<Recommendation_ImproveGoogleTagCoverageRecommendation>;
+export declare const Recommendation_PerformanceMaxFinalUrlOptInRecommendation: MessageFns<Recommendation_PerformanceMaxFinalUrlOptInRecommendation>;
+export declare const Recommendation_RefreshCustomerMatchListRecommendation: MessageFns<Recommendation_RefreshCustomerMatchListRecommendation>;
+export declare const Recommendation_AccountInfo: MessageFns<Recommendation_AccountInfo>;
+export declare const Recommendation_CustomAudienceOptInRecommendation: MessageFns<Recommendation_CustomAudienceOptInRecommendation>;
+export declare const Recommendation_LeadFormAssetRecommendation: MessageFns<Recommendation_LeadFormAssetRecommendation>;
+export declare const Recommendation_ImproveDemandGenAdStrengthRecommendation: MessageFns<Recommendation_ImproveDemandGenAdStrengthRecommendation>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};