google-ads-api-types 0.21.0

package/dist/google/ads/googleads/v21/services/recommendation_service.d.ts

@@ -0,0 +1,891 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { Status } from "../../../../rpc/status.js";
+import { KeywordInfo } from "../common/criteria.js";
+import { CallFeedItem, CalloutFeedItem, SitelinkFeedItem } from "../common/extensions.js";
+import { AdGroupTypeEnum_AdGroupType } from "../enums/ad_group_type.js";
+import { AdvertisingChannelTypeEnum_AdvertisingChannelType } from "../enums/advertising_channel_type.js";
+import { BiddingStrategyTypeEnum_BiddingStrategyType } from "../enums/bidding_strategy_type.js";
+import { ConversionTrackingStatusEnum_ConversionTrackingStatus } from "../enums/conversion_tracking_status_enum.js";
+import { KeywordMatchTypeEnum_KeywordMatchType } from "../enums/keyword_match_type.js";
+import { RecommendationTypeEnum_RecommendationType } from "../enums/recommendation_type.js";
+import { TargetImpressionShareLocationEnum_TargetImpressionShareLocation } from "../enums/target_impression_share_location.js";
+import { Ad } from "../resources/ad.js";
+import { Asset } from "../resources/asset.js";
+import { Recommendation } from "../resources/recommendation.js";
+export declare const protobufPackage = "google.ads.googleads.v21.services";
+/**
+ * Request message for
+ * [RecommendationService.ApplyRecommendation][google.ads.googleads.v21.services.RecommendationService.ApplyRecommendation].
+ */
+export interface ApplyRecommendationRequest {
+    /** Required. The ID of the customer with the recommendation. */
+    customerId: string;
+    /**
+     * Required. The list of operations to apply recommendations.
+     * If partial_failure=false all recommendations should be of the same type
+     * There is a limit of 100 operations per request.
+     */
+    operations: ApplyRecommendationOperation[];
+    /**
+     * If true, successful operations will be carried out and invalid
+     * operations will return errors. If false, operations will be carried
+     * out as a transaction if and only if they are all valid.
+     * Default is false.
+     */
+    partialFailure: boolean;
+}
+/**
+ * Information about the operation to apply a recommendation and any parameters
+ * to customize it.
+ */
+export interface ApplyRecommendationOperation {
+    /** The resource name of the recommendation to apply. */
+    resourceName: string;
+    /**
+     * Optional parameters to use when applying a campaign budget
+     * recommendation.
+     */
+    campaignBudget?: ApplyRecommendationOperation_CampaignBudgetParameters | undefined;
+    /** Optional parameters to use when applying a text ad recommendation. */
+    textAd?: ApplyRecommendationOperation_TextAdParameters | undefined;
+    /** Optional parameters to use when applying keyword recommendation. */
+    keyword?: ApplyRecommendationOperation_KeywordParameters | undefined;
+    /**
+     * Optional parameters to use when applying target CPA opt-in
+     * recommendation.
+     */
+    targetCpaOptIn?: ApplyRecommendationOperation_TargetCpaOptInParameters | undefined;
+    /**
+     * Optional parameters to use when applying target ROAS opt-in
+     * recommendation.
+     */
+    targetRoasOptIn?: ApplyRecommendationOperation_TargetRoasOptInParameters | undefined;
+    /** Parameters to use when applying callout extension recommendation. */
+    calloutExtension?: ApplyRecommendationOperation_CalloutExtensionParameters | undefined;
+    /** Parameters to use when applying call extension recommendation. */
+    callExtension?: ApplyRecommendationOperation_CallExtensionParameters | undefined;
+    /** Parameters to use when applying sitelink recommendation. */
+    sitelinkExtension?: ApplyRecommendationOperation_SitelinkExtensionParameters | undefined;
+    /** Parameters to use when applying move unused budget recommendation. */
+    moveUnusedBudget?: ApplyRecommendationOperation_MoveUnusedBudgetParameters | undefined;
+    /** Parameters to use when applying a responsive search ad recommendation. */
+    responsiveSearchAd?: ApplyRecommendationOperation_ResponsiveSearchAdParameters | undefined;
+    /** Parameters to use when applying a use broad match keyword recommendation. */
+    useBroadMatchKeyword?: ApplyRecommendationOperation_UseBroadMatchKeywordParameters | undefined;
+    /**
+     * Parameters to use when applying a responsive search ad asset
+     * recommendation.
+     */
+    responsiveSearchAdAsset?: ApplyRecommendationOperation_ResponsiveSearchAdAssetParameters | undefined;
+    /**
+     * Parameters to use when applying a responsive search ad improve ad
+     * strength recommendation.
+     */
+    responsiveSearchAdImproveAdStrength?: ApplyRecommendationOperation_ResponsiveSearchAdImproveAdStrengthParameters | undefined;
+    /**
+     * Parameters to use when applying a raise target CPA bid too low
+     * recommendation. The apply is asynchronous and can take minutes depending
+     * on the number of ad groups there is in the related campaign.
+     */
+    raiseTargetCpaBidTooLow?: ApplyRecommendationOperation_RaiseTargetCpaBidTooLowParameters | undefined;
+    /**
+     * Parameters to use when applying a forecasting set target ROAS
+     * recommendation.
+     */
+    forecastingSetTargetRoas?: ApplyRecommendationOperation_ForecastingSetTargetRoasParameters | undefined;
+    /** Parameters to use when applying callout asset recommendation. */
+    calloutAsset?: ApplyRecommendationOperation_CalloutAssetParameters | undefined;
+    /** Parameters to use when applying call asset recommendation. */
+    callAsset?: ApplyRecommendationOperation_CallAssetParameters | undefined;
+    /** Parameters to use when applying sitelink asset recommendation. */
+    sitelinkAsset?: ApplyRecommendationOperation_SitelinkAssetParameters | undefined;
+    /** Parameters to use when applying raise Target CPA recommendation. */
+    raiseTargetCpa?: ApplyRecommendationOperation_RaiseTargetCpaParameters | undefined;
+    /** Parameters to use when applying lower Target ROAS recommendation. */
+    lowerTargetRoas?: ApplyRecommendationOperation_LowerTargetRoasParameters | undefined;
+    /**
+     * Parameters to use when applying forecasting set target CPA
+     * recommendation.
+     */
+    forecastingSetTargetCpa?: ApplyRecommendationOperation_ForecastingSetTargetCpaParameters | undefined;
+    /**
+     * Parameters to use when applying set target CPA
+     * recommendation.
+     */
+    setTargetCpa?: ApplyRecommendationOperation_ForecastingSetTargetCpaParameters | undefined;
+    /**
+     * Parameters to use when applying set target ROAS
+     * recommendation.
+     */
+    setTargetRoas?: ApplyRecommendationOperation_ForecastingSetTargetRoasParameters | undefined;
+    /** Parameters to use when applying lead form asset recommendation. */
+    leadFormAsset?: ApplyRecommendationOperation_LeadFormAssetParameters | undefined;
+}
+/** Parameters to use when applying a campaign budget recommendation. */
+export interface ApplyRecommendationOperation_CampaignBudgetParameters {
+    /**
+     * New budget amount to set for target budget resource. This is a required
+     * field.
+     */
+    newBudgetAmountMicros?: number | undefined;
+}
+/**
+ * Parameters to use when applying a forecasting set target roas
+ * recommendation.
+ */
+export interface ApplyRecommendationOperation_ForecastingSetTargetRoasParameters {
+    /**
+     * New target ROAS (revenue per unit of spend) to set for a campaign
+     * resource.
+     * The value is between 0.01 and 1000.0, inclusive.
+     */
+    targetRoas?: number | undefined;
+    /** New campaign budget amount to set for a campaign resource. */
+    campaignBudgetAmountMicros?: number | undefined;
+}
+/** Parameters to use when applying a text ad recommendation. */
+export interface ApplyRecommendationOperation_TextAdParameters {
+    /**
+     * New ad to add to recommended ad group. All necessary fields need to be
+     * set in this message. This is a required field.
+     */
+    ad?: Ad | undefined;
+}
+/** Parameters to use when applying keyword recommendation. */
+export interface ApplyRecommendationOperation_KeywordParameters {
+    /** The ad group resource to add keyword to. This is a required field. */
+    adGroup?: string | undefined;
+    /** The match type of the keyword. This is a required field. */
+    matchType: KeywordMatchTypeEnum_KeywordMatchType;
+    /**
+     * Optional, CPC bid to set for the keyword. If not set, keyword will use
+     * bid based on bidding strategy used by target ad group.
+     */
+    cpcBidMicros?: number | undefined;
+}
+/** Parameters to use when applying Target CPA recommendation. */
+export interface ApplyRecommendationOperation_TargetCpaOptInParameters {
+    /**
+     * Average CPA to use for Target CPA bidding strategy. This is a required
+     * field.
+     */
+    targetCpaMicros?: number | undefined;
+    /** Optional, budget amount to set for the campaign. */
+    newCampaignBudgetAmountMicros?: number | undefined;
+}
+/** Parameters to use when applying a Target ROAS opt-in recommendation. */
+export interface ApplyRecommendationOperation_TargetRoasOptInParameters {
+    /**
+     * Average ROAS (revenue per unit of spend) to use for Target ROAS bidding
+     * strategy. The value is between 0.01 and 1000.0, inclusive. This is a
+     * required field, unless new_campaign_budget_amount_micros is set.
+     */
+    targetRoas?: number | undefined;
+    /** Optional, budget amount to set for the campaign. */
+    newCampaignBudgetAmountMicros?: number | undefined;
+}
+/** Parameters to use when applying callout extension recommendation. */
+export interface ApplyRecommendationOperation_CalloutExtensionParameters {
+    /** Callout extensions to be added. This is a required field. */
+    calloutExtensions: CalloutFeedItem[];
+}
+/** Parameters to use when applying call extension recommendation. */
+export interface ApplyRecommendationOperation_CallExtensionParameters {
+    /** Call extensions to be added. This is a required field. */
+    callExtensions: CallFeedItem[];
+}
+/** Parameters to use when applying sitelink recommendation. */
+export interface ApplyRecommendationOperation_SitelinkExtensionParameters {
+    /** Sitelinks to be added. This is a required field. */
+    sitelinkExtensions: SitelinkFeedItem[];
+}
+/** Parameters to use when applying callout asset recommendations. */
+export interface ApplyRecommendationOperation_CalloutAssetParameters {
+    /** Required. Callout assets to be added. This is a required field. */
+    adAssetApplyParameters?: ApplyRecommendationOperation_AdAssetApplyParameters | undefined;
+}
+/** Parameters to use when applying call asset recommendations. */
+export interface ApplyRecommendationOperation_CallAssetParameters {
+    /** Required. Call assets to be added. This is a required field. */
+    adAssetApplyParameters?: ApplyRecommendationOperation_AdAssetApplyParameters | undefined;
+}
+/** Parameters to use when applying sitelink asset recommendations. */
+export interface ApplyRecommendationOperation_SitelinkAssetParameters {
+    /** Required. Sitelink assets to be added. This is a required field. */
+    adAssetApplyParameters?: ApplyRecommendationOperation_AdAssetApplyParameters | undefined;
+}
+/** Parameters to use when applying raise Target CPA recommendations. */
+export interface ApplyRecommendationOperation_RaiseTargetCpaParameters {
+    /** Required. Target to set CPA multiplier to. This is a required field. */
+    targetCpaMultiplier: number;
+}
+/** Parameters to use when applying lower Target ROAS recommendations. */
+export interface ApplyRecommendationOperation_LowerTargetRoasParameters {
+    /** Required. Target to set ROAS multiplier to. This is a required field. */
+    targetRoasMultiplier: number;
+}
+/** Common parameters used when applying ad asset recommendations. */
+export interface ApplyRecommendationOperation_AdAssetApplyParameters {
+    /**
+     * The assets to create and attach to a scope. This may be combined with
+     * existing_assets in the same call.
+     */
+    newAssets: Asset[];
+    /**
+     * The resource names of existing assets to attach to a scope. This may be
+     * combined with new_assets in the same call.
+     */
+    existingAssets: string[];
+    /**
+     * Required. The scope at which to apply the assets. Assets at the campaign
+     * scope level will be applied to the campaign associated with the
+     * recommendation. Assets at the customer scope will apply to the entire
+     * account. Assets at the campaign scope will override any attached at the
+     * customer scope.
+     */
+    scope: ApplyRecommendationOperation_AdAssetApplyParameters_ApplyScope;
+}
+/** Scope to apply the assets to. */
+export declare enum ApplyRecommendationOperation_AdAssetApplyParameters_ApplyScope {
+    /** UNSPECIFIED - The apply scope has not been specified. */
+    UNSPECIFIED = 0,
+    /** UNKNOWN - Unknown. */
+    UNKNOWN = 1,
+    /** CUSTOMER - Apply at the customer scope. */
+    CUSTOMER = 2,
+    /** CAMPAIGN - Apply at the campaign scope. */
+    CAMPAIGN = 3,
+    UNRECOGNIZED = -1
+}
+export declare function applyRecommendationOperation_AdAssetApplyParameters_ApplyScopeFromJSON(object: any): ApplyRecommendationOperation_AdAssetApplyParameters_ApplyScope;
+export declare function applyRecommendationOperation_AdAssetApplyParameters_ApplyScopeToJSON(object: ApplyRecommendationOperation_AdAssetApplyParameters_ApplyScope): string;
+/** Parameters to use when applying move unused budget recommendation. */
+export interface ApplyRecommendationOperation_MoveUnusedBudgetParameters {
+    /**
+     * Budget amount to move from excess budget to constrained budget. This is
+     * a required field.
+     */
+    budgetMicrosToMove?: number | undefined;
+}
+/**
+ * Parameters to use when applying a responsive search ad asset
+ * recommendation.
+ */
+export interface ApplyRecommendationOperation_ResponsiveSearchAdAssetParameters {
+    /** Updated ad. The current ad's content will be replaced. */
+    updatedAd?: Ad | undefined;
+}
+/**
+ * Parameters to use when applying a responsive search ad improve ad strength
+ * recommendation.
+ */
+export interface ApplyRecommendationOperation_ResponsiveSearchAdImproveAdStrengthParameters {
+    /** Updated ad. The current ad's content will be replaced. */
+    updatedAd?: Ad | undefined;
+}
+/** Parameters to use when applying a responsive search ad recommendation. */
+export interface ApplyRecommendationOperation_ResponsiveSearchAdParameters {
+    /** Required. New ad to add to recommended ad group. */
+    ad?: Ad | undefined;
+}
+/**
+ * Parameters to use when applying a raise target CPA bid too low
+ * recommendation. The apply is asynchronous and can take minutes depending on
+ * the number of ad groups there is in the related campaign..
+ */
+export interface ApplyRecommendationOperation_RaiseTargetCpaBidTooLowParameters {
+    /**
+     * Required. A number greater than 1.0 indicating the factor by which to
+     * increase the target CPA. This is a required field.
+     */
+    targetMultiplier: number;
+}
+/** Parameters to use when applying a use broad match keyword recommendation. */
+export interface ApplyRecommendationOperation_UseBroadMatchKeywordParameters {
+    /** New budget amount to set for target budget resource. */
+    newBudgetAmountMicros?: number | undefined;
+}
+/** Parameters to use when applying a set target CPA recommendation. */
+export interface ApplyRecommendationOperation_ForecastingSetTargetCpaParameters {
+    /** Average CPA to use for Target CPA bidding strategy. */
+    targetCpaMicros?: number | undefined;
+    /** New campaign budget amount to set for a campaign resource. */
+    campaignBudgetAmountMicros?: number | undefined;
+}
+/** Parameters to use when applying a lead form asset recommendation. */
+export interface ApplyRecommendationOperation_LeadFormAssetParameters {
+    /** Required. Lead form assets to be added. This is a required field. */
+    adAssetApplyParameters?: ApplyRecommendationOperation_AdAssetApplyParameters | undefined;
+    /**
+     * If true, the "Submit Lead Form" goal will be set on the target campaign.
+     * As a result, ads will be shown as lead form creative ads. If false,
+     * the "Submit Lead Form" goal will not be set on the campaign and ads will
+     * contain lead form assets.
+     */
+    setSubmitLeadFormAssetCampaignGoal?: boolean | undefined;
+}
+/**
+ * Response message for
+ * [RecommendationService.ApplyRecommendation][google.ads.googleads.v21.services.RecommendationService.ApplyRecommendation].
+ */
+export interface ApplyRecommendationResponse {
+    /** Results of operations to apply recommendations. */
+    results: ApplyRecommendationResult[];
+    /**
+     * Errors that pertain to operation failures in the partial failure mode.
+     * Returned only when partial_failure = true and all errors occur inside the
+     * operations. If any errors occur outside the operations (for example, auth
+     * errors) we return the RPC level error.
+     */
+    partialFailureError?: Status | undefined;
+}
+/** The result of applying a recommendation. */
+export interface ApplyRecommendationResult {
+    /** Returned for successful applies. */
+    resourceName: string;
+}
+/**
+ * Request message for
+ * [RecommendationService.DismissRecommendation][google.ads.googleads.v21.services.RecommendationService.DismissRecommendation].
+ */
+export interface DismissRecommendationRequest {
+    /** Required. The ID of the customer with the recommendation. */
+    customerId: string;
+    /**
+     * Required. The list of operations to dismiss recommendations.
+     * If partial_failure=false all recommendations should be of the same type
+     * There is a limit of 100 operations per request.
+     */
+    operations: DismissRecommendationRequest_DismissRecommendationOperation[];
+    /**
+     * If true, successful operations will be carried out and invalid
+     * operations will return errors. If false, operations will be carried in a
+     * single transaction if and only if they are all valid.
+     * Default is false.
+     */
+    partialFailure: boolean;
+}
+/** Operation to dismiss a single recommendation identified by resource_name. */
+export interface DismissRecommendationRequest_DismissRecommendationOperation {
+    /** The resource name of the recommendation to dismiss. */
+    resourceName: string;
+}
+/**
+ * Response message for
+ * [RecommendationService.DismissRecommendation][google.ads.googleads.v21.services.RecommendationService.DismissRecommendation].
+ */
+export interface DismissRecommendationResponse {
+    /** Results of operations to dismiss recommendations. */
+    results: DismissRecommendationResponse_DismissRecommendationResult[];
+    /**
+     * Errors that pertain to operation failures in the partial failure mode.
+     * Returned only when partial_failure = true and all errors occur inside the
+     * operations. If any errors occur outside the operations (for example, auth
+     * errors) we return the RPC level error.
+     */
+    partialFailureError?: Status | undefined;
+}
+/** The result of dismissing a recommendation. */
+export interface DismissRecommendationResponse_DismissRecommendationResult {
+    /** Returned for successful dismissals. */
+    resourceName: string;
+}
+/**
+ * Request message for
+ * [RecommendationService.GenerateRecommendations][google.ads.googleads.v21.services.RecommendationService.GenerateRecommendations].
+ */
+export interface GenerateRecommendationsRequest {
+    /** Required. The ID of the customer generating recommendations. */
+    customerId: string;
+    /**
+     * Required. List of eligible recommendation_types to generate. If the
+     * uploaded criteria isn't sufficient to make a recommendation, or the
+     * campaign is already in the recommended state, no recommendation will be
+     * returned for that type. Generally, a recommendation is returned if all
+     * required fields for that recommendation_type are uploaded, but there are
+     * cases where this is still not sufficient.
+     *
+     * The following recommendation_types are supported for recommendation
+     * generation:
+     * CAMPAIGN_BUDGET, KEYWORD, MAXIMIZE_CLICKS_OPT_IN,
+     * MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN,
+     * SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN,
+     * TARGET_ROAS_OPT_IN
+     */
+    recommendationTypes: RecommendationTypeEnum_RecommendationType[];
+    /**
+     * Required. Advertising channel type of the campaign.
+     * The following advertising_channel_types are supported for recommendation
+     * generation:
+     * PERFORMANCE_MAX and SEARCH
+     */
+    advertisingChannelType: AdvertisingChannelTypeEnum_AdvertisingChannelType;
+    /**
+     * Optional. Number of sitelinks on the campaign.
+     * This field is necessary for the following recommendation_types:
+     * SITELINK_ASSET
+     */
+    campaignSitelinkCount?: number | undefined;
+    /**
+     * Optional. Current conversion tracking status.
+     * This field is necessary for the following recommendation_types:
+     * MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN,
+     * MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS,
+     * TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
+     */
+    conversionTrackingStatus?: ConversionTrackingStatusEnum_ConversionTrackingStatus | undefined;
+    /**
+     * Optional. Current bidding information of the campaign.
+     * This field is necessary for the following recommendation_types:
+     * CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN,
+     * MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS,
+     * TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
+     */
+    biddingInfo?: GenerateRecommendationsRequest_BiddingInfo | undefined;
+    /**
+     * Optional. Current AdGroup Information.
+     * Supports information from a single AdGroup.
+     * This field is optional for the following recommendation_types:
+     * KEYWORD
+     * This field is required for the following recommendation_types:
+     * CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH
+     */
+    adGroupInfo: GenerateRecommendationsRequest_AdGroupInfo[];
+    /**
+     * Optional. Seed information for Keywords.
+     * This field is necessary for the following recommendation_types:
+     * KEYWORD
+     */
+    seedInfo?: GenerateRecommendationsRequest_SeedInfo | undefined;
+    /**
+     * Optional. Current budget information.
+     * This field is optional for the following recommendation_types:
+     * CAMPAIGN_BUDGET
+     */
+    budgetInfo?: GenerateRecommendationsRequest_BudgetInfo | undefined;
+    /**
+     * Optional. Current campaign image asset count.
+     * This field is optional for the following recommendation_types:
+     * CAMPAIGN_BUDGET
+     */
+    campaignImageAssetCount?: number | undefined;
+    /**
+     * Optional. Current campaign call asset count.
+     * This field is optional for the following recommendation_types:
+     * CAMPAIGN_BUDGET
+     */
+    campaignCallAssetCount?: number | undefined;
+    /**
+     * Optional. Current campaign country codes.
+     * This field is required for the following recommendation_types:
+     * CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH
+     */
+    countryCodes: string[];
+    /**
+     * Optional. Current campaign language codes.
+     * This field is required for the following recommendation_types:
+     * CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH
+     */
+    languageCodes: string[];
+    /**
+     * Optional. Current campaign positive location ids.
+     * One of this field OR negative_location_ids is required for the following
+     * recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH
+     */
+    positiveLocationsIds: number[];
+    /**
+     * Optional. Current campaign negative location ids.
+     * One of this field OR positive_location_ids is required for the following
+     * recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH
+     */
+    negativeLocationsIds: number[];
+    /**
+     * Optional. Current AssetGroup Information.
+     * This field is required for the following recommendation_types:
+     * CAMPAIGN_BUDGET
+     */
+    assetGroupInfo: GenerateRecommendationsRequest_AssetGroupInfo[];
+    /**
+     * Optional. If true, the campaign is opted into serving ads on the Google
+     * Partner Network. This field is optional for the following
+     * recommendation_types: CAMPAIGN_BUDGET
+     */
+    targetPartnerSearchNetwork?: boolean | undefined;
+    /**
+     * Optional. If true, the campaign is opted into serving ads on specified
+     * placements in the Google Display Network. This field is optional for the
+     * following recommendation_types: CAMPAIGN_BUDGET
+     */
+    targetContentNetwork?: boolean | undefined;
+    /**
+     * Optional. Merchant Center account ID.
+     * This field should only be set when advertising_channel_type is
+     * PERFORMANCE_MAX. Setting this field causes RecommendationService
+     * to generate recommendations for Performance Max for retail
+     * instead of standard Performance Max.
+     * This field is optional for the following recommendation_types:
+     * CAMPAIGN_BUDGET
+     */
+    merchantCenterAccountId?: number | undefined;
+}
+/**
+ * Current bidding information of the campaign. Provides a wrapper for
+ * bidding-related signals that inform recommendations.
+ */
+export interface GenerateRecommendationsRequest_BiddingInfo {
+    /**
+     * Current bidding strategy.
+     * This field is necessary for the following recommendation_types:
+     * CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN,
+     * MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS,
+     * TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
+     */
+    biddingStrategyType?: BiddingStrategyTypeEnum_BiddingStrategyType | undefined;
+    /**
+     * Current target_cpa in micros.
+     * This can be populated for campaigns with a bidding strategy type of
+     * TARGET_CPA or MAXIMIZE_CONVERSIONS.
+     */
+    targetCpaMicros?: number | undefined;
+    /**
+     * Current target_roas.
+     * This can be populated for campaigns with a bidding strategy type of
+     * TARGET_ROAS or MAXIMIZE_CONVERSION_VALUE.
+     */
+    targetRoas?: number | undefined;
+    /**
+     * Optional. Current Target Impression Share information of the campaign.
+     * This field is necessary for the following recommendation_types:
+     * CAMPAIGN_BUDGET
+     */
+    targetImpressionShareInfo?: GenerateRecommendationsRequest_TargetImpressionShareInfo | undefined;
+}
+/** Current AdGroup Information of the campaign. */
+export interface GenerateRecommendationsRequest_AdGroupInfo {
+    /**
+     * Optional. AdGroup Type of the AdGroup.
+     * This field is necessary for the following recommendation_types if
+     * ad_group_info is set:
+     * KEYWORD
+     */
+    adGroupType?: AdGroupTypeEnum_AdGroupType | undefined;
+    /**
+     * Optional. Current keywords.
+     * This field is optional for the following recommendation_types if
+     * ad_group_info is set:
+     * KEYWORD
+     * This field is required for the following recommendation_types:
+     * CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH
+     */
+    keywords: KeywordInfo[];
+}
+/** A keyword seed and a specific url to generate keywords from. */
+export interface GenerateRecommendationsRequest_SeedInfo {
+    /** A specific url to generate ideas from, for example: www.example.com/cars. */
+    urlSeed?: string | undefined;
+    /**
+     * Optional. Keywords or phrases to generate ideas from, for example: cars
+     * or "car dealership near me".
+     */
+    keywordSeeds: string[];
+}
+/** Current budget information of the campaign. */
+export interface GenerateRecommendationsRequest_BudgetInfo {
+    /**
+     * Required. Current budget amount in micros.
+     * This field is necessary for the following recommendation_types if
+     * budget_info is set:
+     * CAMPAIGN_BUDGET
+     */
+    currentBudget?: number | undefined;
+}
+/** Current AssetGroup information of the campaign. */
+export interface GenerateRecommendationsRequest_AssetGroupInfo {
+    /**
+     * Required. Current url of the asset group.
+     * This field is necessary for the following recommendation_types if
+     * asset_group_info is set:
+     * CAMPAIGN_BUDGET
+     */
+    finalUrl?: string | undefined;
+    /**
+     * Optional. Current headlines of the asset group.
+     * This field is optional for the following recommendation_types if
+     * asset_group_info is set:
+     * CAMPAIGN_BUDGET
+     */
+    headline: string[];
+    /**
+     * Optional. Current descriptions of the asset group.
+     * This field is optional for the following recommendation_types if
+     * asset_group_info is set:
+     * CAMPAIGN_BUDGET
+     */
+    description: string[];
+}
+/** Current Target Impression Share information of the campaign. */
+export interface GenerateRecommendationsRequest_TargetImpressionShareInfo {
+    /**
+     * Required. The targeted location on the search results page.
+     * This is required for campaigns where the AdvertisingChannelType is SEARCH
+     * and the bidding strategy type is TARGET_IMPRESSION_SHARE.
+     */
+    location?: TargetImpressionShareLocationEnum_TargetImpressionShareLocation | undefined;
+    /**
+     * Required. The chosen fraction of targeted impression share in micros. For
+     * example, 1% equals 10,000. It must be a value between 1 and 1,000,000.
+     * This is required for campaigns with an AdvertisingChannelType of SEARCH
+     * and a bidding strategy type of TARGET_IMPRESSION_SHARE.
+     */
+    targetImpressionShareMicros?: number | undefined;
+    /**
+     * Optional. Ceiling of max CPC bids in micros set by automated bidders.
+     * This is optional for campaigns with an AdvertisingChannelType of SEARCH
+     * and a bidding strategy type of TARGET_IMPRESSION_SHARE.
+     */
+    maxCpcBidCeiling?: number | undefined;
+}
+/**
+ * Response message for
+ * [RecommendationService.GenerateRecommendations][google.ads.googleads.v21.services.RecommendationService.GenerateRecommendations].
+ */
+export interface GenerateRecommendationsResponse {
+    /**
+     * List of generated recommendations from the passed in set of requested
+     * recommendation_types. If there isn't sufficient data to generate a
+     * recommendation for the requested recommendation_types, the result set won't
+     * contain a recommendation for that type.
+     */
+    recommendations: Recommendation[];
+}
+export declare const ApplyRecommendationRequest: MessageFns<ApplyRecommendationRequest>;
+export declare const ApplyRecommendationOperation: MessageFns<ApplyRecommendationOperation>;
+export declare const ApplyRecommendationOperation_CampaignBudgetParameters: MessageFns<ApplyRecommendationOperation_CampaignBudgetParameters>;
+export declare const ApplyRecommendationOperation_ForecastingSetTargetRoasParameters: MessageFns<ApplyRecommendationOperation_ForecastingSetTargetRoasParameters>;
+export declare const ApplyRecommendationOperation_TextAdParameters: MessageFns<ApplyRecommendationOperation_TextAdParameters>;
+export declare const ApplyRecommendationOperation_KeywordParameters: MessageFns<ApplyRecommendationOperation_KeywordParameters>;
+export declare const ApplyRecommendationOperation_TargetCpaOptInParameters: MessageFns<ApplyRecommendationOperation_TargetCpaOptInParameters>;
+export declare const ApplyRecommendationOperation_TargetRoasOptInParameters: MessageFns<ApplyRecommendationOperation_TargetRoasOptInParameters>;
+export declare const ApplyRecommendationOperation_CalloutExtensionParameters: MessageFns<ApplyRecommendationOperation_CalloutExtensionParameters>;
+export declare const ApplyRecommendationOperation_CallExtensionParameters: MessageFns<ApplyRecommendationOperation_CallExtensionParameters>;
+export declare const ApplyRecommendationOperation_SitelinkExtensionParameters: MessageFns<ApplyRecommendationOperation_SitelinkExtensionParameters>;
+export declare const ApplyRecommendationOperation_CalloutAssetParameters: MessageFns<ApplyRecommendationOperation_CalloutAssetParameters>;
+export declare const ApplyRecommendationOperation_CallAssetParameters: MessageFns<ApplyRecommendationOperation_CallAssetParameters>;
+export declare const ApplyRecommendationOperation_SitelinkAssetParameters: MessageFns<ApplyRecommendationOperation_SitelinkAssetParameters>;
+export declare const ApplyRecommendationOperation_RaiseTargetCpaParameters: MessageFns<ApplyRecommendationOperation_RaiseTargetCpaParameters>;
+export declare const ApplyRecommendationOperation_LowerTargetRoasParameters: MessageFns<ApplyRecommendationOperation_LowerTargetRoasParameters>;
+export declare const ApplyRecommendationOperation_AdAssetApplyParameters: MessageFns<ApplyRecommendationOperation_AdAssetApplyParameters>;
+export declare const ApplyRecommendationOperation_MoveUnusedBudgetParameters: MessageFns<ApplyRecommendationOperation_MoveUnusedBudgetParameters>;
+export declare const ApplyRecommendationOperation_ResponsiveSearchAdAssetParameters: MessageFns<ApplyRecommendationOperation_ResponsiveSearchAdAssetParameters>;
+export declare const ApplyRecommendationOperation_ResponsiveSearchAdImproveAdStrengthParameters: MessageFns<ApplyRecommendationOperation_ResponsiveSearchAdImproveAdStrengthParameters>;
+export declare const ApplyRecommendationOperation_ResponsiveSearchAdParameters: MessageFns<ApplyRecommendationOperation_ResponsiveSearchAdParameters>;
+export declare const ApplyRecommendationOperation_RaiseTargetCpaBidTooLowParameters: MessageFns<ApplyRecommendationOperation_RaiseTargetCpaBidTooLowParameters>;
+export declare const ApplyRecommendationOperation_UseBroadMatchKeywordParameters: MessageFns<ApplyRecommendationOperation_UseBroadMatchKeywordParameters>;
+export declare const ApplyRecommendationOperation_ForecastingSetTargetCpaParameters: MessageFns<ApplyRecommendationOperation_ForecastingSetTargetCpaParameters>;
+export declare const ApplyRecommendationOperation_LeadFormAssetParameters: MessageFns<ApplyRecommendationOperation_LeadFormAssetParameters>;
+export declare const ApplyRecommendationResponse: MessageFns<ApplyRecommendationResponse>;
+export declare const ApplyRecommendationResult: MessageFns<ApplyRecommendationResult>;
+export declare const DismissRecommendationRequest: MessageFns<DismissRecommendationRequest>;
+export declare const DismissRecommendationRequest_DismissRecommendationOperation: MessageFns<DismissRecommendationRequest_DismissRecommendationOperation>;
+export declare const DismissRecommendationResponse: MessageFns<DismissRecommendationResponse>;
+export declare const DismissRecommendationResponse_DismissRecommendationResult: MessageFns<DismissRecommendationResponse_DismissRecommendationResult>;
+export declare const GenerateRecommendationsRequest: MessageFns<GenerateRecommendationsRequest>;
+export declare const GenerateRecommendationsRequest_BiddingInfo: MessageFns<GenerateRecommendationsRequest_BiddingInfo>;
+export declare const GenerateRecommendationsRequest_AdGroupInfo: MessageFns<GenerateRecommendationsRequest_AdGroupInfo>;
+export declare const GenerateRecommendationsRequest_SeedInfo: MessageFns<GenerateRecommendationsRequest_SeedInfo>;
+export declare const GenerateRecommendationsRequest_BudgetInfo: MessageFns<GenerateRecommendationsRequest_BudgetInfo>;
+export declare const GenerateRecommendationsRequest_AssetGroupInfo: MessageFns<GenerateRecommendationsRequest_AssetGroupInfo>;
+export declare const GenerateRecommendationsRequest_TargetImpressionShareInfo: MessageFns<GenerateRecommendationsRequest_TargetImpressionShareInfo>;
+export declare const GenerateRecommendationsResponse: MessageFns<GenerateRecommendationsResponse>;
+/** Service to manage recommendations. */
+export type RecommendationServiceService = typeof RecommendationServiceService;
+export declare const RecommendationServiceService: {
+    /**
+     * Applies given recommendations with corresponding apply parameters.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [DatabaseError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [MutateError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     *   [UrlFieldError]()
+     */
+    readonly applyRecommendation: {
+        readonly path: "/google.ads.googleads.v21.services.RecommendationService/ApplyRecommendation";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ApplyRecommendationRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ApplyRecommendationRequest;
+        readonly responseSerialize: (value: ApplyRecommendationResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ApplyRecommendationResponse;
+    };
+    /**
+     * Dismisses given recommendations.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     */
+    readonly dismissRecommendation: {
+        readonly path: "/google.ads.googleads.v21.services.RecommendationService/DismissRecommendation";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DismissRecommendationRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DismissRecommendationRequest;
+        readonly responseSerialize: (value: DismissRecommendationResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => DismissRecommendationResponse;
+    };
+    /**
+     * Generates Recommendations based off the requested recommendation_types.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     */
+    readonly generateRecommendations: {
+        readonly path: "/google.ads.googleads.v21.services.RecommendationService/GenerateRecommendations";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GenerateRecommendationsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GenerateRecommendationsRequest;
+        readonly responseSerialize: (value: GenerateRecommendationsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GenerateRecommendationsResponse;
+    };
+};
+export interface RecommendationServiceServer extends UntypedServiceImplementation {
+    /**
+     * Applies given recommendations with corresponding apply parameters.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [DatabaseError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [MutateError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     *   [UrlFieldError]()
+     */
+    applyRecommendation: handleUnaryCall<ApplyRecommendationRequest, ApplyRecommendationResponse>;
+    /**
+     * Dismisses given recommendations.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     */
+    dismissRecommendation: handleUnaryCall<DismissRecommendationRequest, DismissRecommendationResponse>;
+    /**
+     * Generates Recommendations based off the requested recommendation_types.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     */
+    generateRecommendations: handleUnaryCall<GenerateRecommendationsRequest, GenerateRecommendationsResponse>;
+}
+export interface RecommendationServiceClient extends Client {
+    /**
+     * Applies given recommendations with corresponding apply parameters.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [DatabaseError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [MutateError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     *   [UrlFieldError]()
+     */
+    applyRecommendation(request: ApplyRecommendationRequest, callback: (error: ServiceError | null, response: ApplyRecommendationResponse) => void): ClientUnaryCall;
+    applyRecommendation(request: ApplyRecommendationRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ApplyRecommendationResponse) => void): ClientUnaryCall;
+    applyRecommendation(request: ApplyRecommendationRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ApplyRecommendationResponse) => void): ClientUnaryCall;
+    /**
+     * Dismisses given recommendations.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     */
+    dismissRecommendation(request: DismissRecommendationRequest, callback: (error: ServiceError | null, response: DismissRecommendationResponse) => void): ClientUnaryCall;
+    dismissRecommendation(request: DismissRecommendationRequest, metadata: Metadata, callback: (error: ServiceError | null, response: DismissRecommendationResponse) => void): ClientUnaryCall;
+    dismissRecommendation(request: DismissRecommendationRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: DismissRecommendationResponse) => void): ClientUnaryCall;
+    /**
+     * Generates Recommendations based off the requested recommendation_types.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RecommendationError]()
+     *   [RequestError]()
+     */
+    generateRecommendations(request: GenerateRecommendationsRequest, callback: (error: ServiceError | null, response: GenerateRecommendationsResponse) => void): ClientUnaryCall;
+    generateRecommendations(request: GenerateRecommendationsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: GenerateRecommendationsResponse) => void): ClientUnaryCall;
+    generateRecommendations(request: GenerateRecommendationsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GenerateRecommendationsResponse) => void): ClientUnaryCall;
+}
+export declare const RecommendationServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): RecommendationServiceClient;
+    service: typeof RecommendationServiceService;
+    serviceName: string;
+};
+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 {};