diff --git a/google/ads/googleads/v4/common/ad_type_infos.proto b/google/ads/googleads/v4/common/ad_type_infos.proto index d2d8d9fb3..0628baeb9 100644 --- a/google/ads/googleads/v4/common/ad_type_infos.proto +++ b/google/ads/googleads/v4/common/ad_type_infos.proto @@ -444,8 +444,7 @@ message LegacyResponsiveDisplayAdInfo { // An app ad. message AppAdInfo { - // An optional text asset that, if specified, must always be displayed when - // the ad is served. + // Mandatory ad text. AdTextAsset mandatory_ad_text = 1; // List of text assets for headlines. When the ad serves the headlines will diff --git a/google/ads/googleads/v4/common/bidding.proto b/google/ads/googleads/v4/common/bidding.proto index ff1c6d7fa..0d4456de1 100644 --- a/google/ads/googleads/v4/common/bidding.proto +++ b/google/ads/googleads/v4/common/bidding.proto @@ -64,14 +64,14 @@ message ManualCpv { } -// An automated bidding strategy that sets bids to help get the most conversions -// for your campaign while spending your budget. +// An automated bidding strategy to help get the most conversions for your +// campaigns while spending your budget. message MaximizeConversions { } -// An automated bidding strategy which tries to maximize conversion value -// given a daily budget. +// An automated bidding strategy to help get the most conversion value for your +// campaigns while spending your budget. message MaximizeConversionValue { // The target return on ad spend (ROAS) option. If set, the bid strategy will // maximize revenue while averaging the target return on ad spend. If the @@ -144,7 +144,10 @@ message TargetSpend { // A TargetSpend bidder will attempt to spend the smaller of this value // or the natural throttling spend amount. // If not specified, the budget is used as the spend target. - google.protobuf.Int64Value target_spend_micros = 1; + // This field is deprecated and should no longer be used. See + // https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html + // for details. + google.protobuf.Int64Value target_spend_micros = 1 [deprecated = true]; // Maximum bid limit that can be set by the bid strategy. // The limit applies to all keywords managed by the strategy. diff --git a/google/ads/googleads/v4/common/criteria.proto b/google/ads/googleads/v4/common/criteria.proto index 7fa375c6e..bd1bdfcf5 100644 --- a/google/ads/googleads/v4/common/criteria.proto +++ b/google/ads/googleads/v4/common/criteria.proto @@ -587,7 +587,8 @@ message LocationGroupInfo { // This is required and must be set in CREATE operations. google.protobuf.Int64Value radius = 3; - // Unit of the radius, miles and meters supported currently. + // Unit of the radius. Miles and meters are supported for geo target + // constants. Milli miles and meters are supported for feed item sets. // This is required and must be set in CREATE operations. google.ads.googleads.v4.enums.LocationGroupRadiusUnitsEnum.LocationGroupRadiusUnits radius_units = 4; } diff --git a/google/ads/googleads/v4/enums/positive_geo_target_type.proto b/google/ads/googleads/v4/enums/positive_geo_target_type.proto index d1ce48a12..8e1a88c5a 100644 --- a/google/ads/googleads/v4/enums/positive_geo_target_type.proto +++ b/google/ads/googleads/v4/enums/positive_geo_target_type.proto @@ -45,6 +45,8 @@ message PositiveGeoTargetTypeEnum { // Specifies that an ad is triggered if the user // searches for advertiser's targeted locations. + // This can only be used with Search and standard + // Shopping campaigns. SEARCH_INTEREST = 6; // Specifies that an ad is triggered if the user is in diff --git a/google/ads/googleads/v4/errors/bidding_error.proto b/google/ads/googleads/v4/errors/bidding_error.proto index c2d3d9a05..8663c1a17 100644 --- a/google/ads/googleads/v4/errors/bidding_error.proto +++ b/google/ads/googleads/v4/errors/bidding_error.proto @@ -57,11 +57,11 @@ message BiddingErrorEnum { // Bidding strategy is not available for the account type. BIDDING_STRATEGY_NOT_AVAILABLE_FOR_ACCOUNT_TYPE = 18; - // Conversion tracking is not enabled in the campaign that has YouTube - // Video Builder transitions. + // Conversion tracking is not enabled in the campaign that has value-based + // bidding transitions. CONVERSION_TRACKING_NOT_ENABLED = 19; - // Not enough conversions tracked for YouTube Video Builder transitions. + // Not enough conversions tracked for value-based bidding transitions. NOT_ENOUGH_CONVERSIONS = 20; // Campaign can not be created with given bidding strategy. It can be diff --git a/google/ads/googleads/v4/errors/offline_user_data_job_error.proto b/google/ads/googleads/v4/errors/offline_user_data_job_error.proto index dd081a4b9..8e4839643 100644 --- a/google/ads/googleads/v4/errors/offline_user_data_job_error.proto +++ b/google/ads/googleads/v4/errors/offline_user_data_job_error.proto @@ -109,7 +109,7 @@ message OfflineUserDataJobErrorEnum { // Remove operation is not allowed for store sales direct updates. REMOVE_NOT_SUPPORTED = 23; - // Remove-all is not supported for store sales direct updates. + // Remove-all is not supported for certain offline user data job types. REMOVE_ALL_NOT_SUPPORTED = 24; // The SHA256 encoded value is malformed. @@ -125,7 +125,7 @@ message OfflineUserDataJobErrorEnum { // The custom key specified is not set in the upload. CUSTOM_KEY_NOT_SET = 29; - // The customer has not accpeted the customer data terms in the conversion + // The customer has not accepted the customer data terms in the conversion // settings page. CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS = 30; } diff --git a/google/ads/googleads/v4/resources/ad_group_ad_asset_view.proto b/google/ads/googleads/v4/resources/ad_group_ad_asset_view.proto index fdb112670..97225e586 100644 --- a/google/ads/googleads/v4/resources/ad_group_ad_asset_view.proto +++ b/google/ads/googleads/v4/resources/ad_group_ad_asset_view.proto @@ -38,6 +38,7 @@ option ruby_package = "Google::Ads::GoogleAds::V4::Resources"; // Proto file describing the ad group ad asset view resource. // A link between an AdGroupAd and an Asset. +// Currently we only support AdGroupAdAssetView for AppAds. message AdGroupAdAssetView { option (google.api.resource) = { type: "googleads.googleapis.com/AdGroupAdAssetView" diff --git a/google/ads/googleads/v4/resources/ad_group_criterion_simulation.proto b/google/ads/googleads/v4/resources/ad_group_criterion_simulation.proto index 6100babc9..5dc0b5c0e 100644 --- a/google/ads/googleads/v4/resources/ad_group_criterion_simulation.proto +++ b/google/ads/googleads/v4/resources/ad_group_criterion_simulation.proto @@ -37,11 +37,14 @@ option ruby_package = "Google::Ads::GoogleAds::V4::Resources"; // An ad group criterion simulation. Supported combinations of advertising // channel type, criterion type, simulation type, and simulation modification -// method are detailed below respectively. +// method are detailed below respectively. Hotel AdGroupCriterion simulation +// operations starting in V5. // // 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM // 2. SEARCH - KEYWORD - CPC_BID - UNIFORM // 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM +// 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM +// 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM message AdGroupCriterionSimulation { option (google.api.resource) = { type: "googleads.googleapis.com/AdGroupCriterionSimulation" diff --git a/google/ads/googleads/v4/resources/campaign.proto b/google/ads/googleads/v4/resources/campaign.proto index d24d4cfff..6d14c3ee0 100644 --- a/google/ads/googleads/v4/resources/campaign.proto +++ b/google/ads/googleads/v4/resources/campaign.proto @@ -106,35 +106,6 @@ message Campaign { ]; } - // Represents a collection of settings related to ads geotargeting. - message GeoTargetTypeSetting { - // The setting used for positive geotargeting in this particular campaign. - google.ads.googleads.v4.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType positive_geo_target_type = 1; - - // The setting used for negative geotargeting in this particular campaign. - google.ads.googleads.v4.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType negative_geo_target_type = 2; - } - - // Campaign-level settings for App Campaigns. - message AppCampaignSetting { - // Represents the goal which the bidding strategy of this app campaign - // should optimize towards. - google.ads.googleads.v4.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; - - // Immutable. A string that uniquely identifies a mobile application. - google.protobuf.StringValue app_id = 2 [(google.api.field_behavior) = IMMUTABLE]; - - // Immutable. The application store that distributes this specific app. - google.ads.googleads.v4.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3 [(google.api.field_behavior) = IMMUTABLE]; - } - - // Optimization goal setting for this campaign, which includes a set of - // optimization goal types. - message OptimizationGoalSetting { - // The list of optimization goal types. - repeated google.ads.googleads.v4.enums.OptimizationGoalTypeEnum.OptimizationGoalType optimization_goal_types = 1; - } - // The setting for Shopping campaigns. Defines the universe of products that // can be advertised by the campaign, and how this campaign interacts with // other Shopping campaigns. @@ -162,18 +133,49 @@ message Campaign { google.protobuf.BoolValue enable_local = 4; } + // Selective optimization setting for this campaign, which includes a set of + // conversion actions to optimize this campaign towards. + message SelectiveOptimization { + // The selected set of conversion actions for optimizing this campaign. + repeated google.protobuf.StringValue conversion_actions = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; + } + // Campaign-level settings for tracking information. message TrackingSetting { // Output only. The url used for dynamic tracking. google.protobuf.StringValue tracking_url = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } + // Represents a collection of settings related to ads geotargeting. + message GeoTargetTypeSetting { + // The setting used for positive geotargeting in this particular campaign. + google.ads.googleads.v4.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType positive_geo_target_type = 1; + + // The setting used for negative geotargeting in this particular campaign. + google.ads.googleads.v4.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType negative_geo_target_type = 2; + } + // Campaign setting for local campaigns. message LocalCampaignSetting { // The location source type for this local campaign. google.ads.googleads.v4.enums.LocationSourceTypeEnum.LocationSourceType location_source_type = 1; } + // Campaign-level settings for App Campaigns. + message AppCampaignSetting { + // Represents the goal which the bidding strategy of this app campaign + // should optimize towards. + google.ads.googleads.v4.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; + + // Immutable. A string that uniquely identifies a mobile application. + google.protobuf.StringValue app_id = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The application store that distributes this specific app. + google.ads.googleads.v4.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3 [(google.api.field_behavior) = IMMUTABLE]; + } + // Describes how unbranded pharma ads will be displayed. message VanityPharma { // The display mode for vanity pharma URLs. @@ -184,13 +186,11 @@ message Campaign { google.ads.googleads.v4.enums.VanityPharmaTextEnum.VanityPharmaText vanity_pharma_text = 2; } - // Selective optimization setting for this campaign, which includes a set of - // conversion actions to optimize this campaign towards. - message SelectiveOptimization { - // The selected set of conversion actions for optimizing this campaign. - repeated google.protobuf.StringValue conversion_actions = 1 [(google.api.resource_reference) = { - type: "googleads.googleapis.com/ConversionAction" - }]; + // Optimization goal setting for this campaign, which includes a set of + // optimization goal types. + message OptimizationGoalSetting { + // The list of optimization goal types. + repeated google.ads.googleads.v4.enums.OptimizationGoalTypeEnum.OptimizationGoalType optimization_goal_types = 1; } // Immutable. The resource name of the campaign. @@ -354,7 +354,8 @@ message Campaign { // // Optimization score is an estimate of how well a campaign is set to perform. // It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the - // campaign is performing at full potential. + // campaign is performing at full potential. This field is null for unscored + // campaigns. // // See "About optimization score" at // https://support.google.com/google-ads/answer/9061546. @@ -389,7 +390,7 @@ message Campaign { google.ads.googleads.v4.common.ManualCpv manual_cpv = 37 [(google.api.field_behavior) = OUTPUT_ONLY]; // Standard Maximize Conversions bidding strategy that automatically - // maximizes number of conversions given a daily budget. + // maximizes number of conversions while spending your budget. google.ads.googleads.v4.common.MaximizeConversions maximize_conversions = 30; // Standard Maximize Conversion Value bidding strategy that automatically diff --git a/google/ads/googleads/v4/resources/campaign_budget.proto b/google/ads/googleads/v4/resources/campaign_budget.proto index add7c88c0..ceb454c0d 100644 --- a/google/ads/googleads/v4/resources/campaign_budget.proto +++ b/google/ads/googleads/v4/resources/campaign_budget.proto @@ -46,7 +46,7 @@ message CampaignBudget { // Immutable. The resource name of the campaign budget. // Campaign budget resource names have the form: // - // `customers/{customer_id}/campaignBudgets/{budget_id}` + // `customers/{customer_id}/campaignBudgets/{campaign_budget_id}` string resource_name = 1 [ (google.api.field_behavior) = IMMUTABLE, (google.api.resource_reference) = { diff --git a/google/ads/googleads/v4/resources/currency_constant.proto b/google/ads/googleads/v4/resources/currency_constant.proto index 6bbea6dd3..e80e4022c 100644 --- a/google/ads/googleads/v4/resources/currency_constant.proto +++ b/google/ads/googleads/v4/resources/currency_constant.proto @@ -42,7 +42,7 @@ message CurrencyConstant { // Output only. The resource name of the currency constant. // Currency constant resource names have the form: // - // `currencyConstants/{currency_code}` + // `currencyConstants/{code}` string resource_name = 1 [ (google.api.field_behavior) = OUTPUT_ONLY, (google.api.resource_reference) = { diff --git a/google/ads/googleads/v4/resources/customer.proto b/google/ads/googleads/v4/resources/customer.proto index 2de4d5ab3..1bc65e986 100644 --- a/google/ads/googleads/v4/resources/customer.proto +++ b/google/ads/googleads/v4/resources/customer.proto @@ -101,7 +101,8 @@ message Customer { // Output only. Optimization score of the customer. // // Optimization score is an estimate of how well a customer's campaigns are - // set to perform. It ranges from 0% (0.0) to 100% (1.0). + // set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null + // for all manager customers, and for unscored non-manager customers. // // See "About optimization score" at // https://support.google.com/google-ads/answer/9061546. diff --git a/google/ads/googleads/v4/resources/dynamic_search_ads_search_term_view.proto b/google/ads/googleads/v4/resources/dynamic_search_ads_search_term_view.proto index 492070c93..11da4b5d0 100644 --- a/google/ads/googleads/v4/resources/dynamic_search_ads_search_term_view.proto +++ b/google/ads/googleads/v4/resources/dynamic_search_ads_search_term_view.proto @@ -42,7 +42,7 @@ message DynamicSearchAdsSearchTermView { // Output only. The resource name of the dynamic search ads search term view. // Dynamic search ads search term view resource names have the form: // - // `customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fp}~{headline_fp}~{landing_page_fp}~{page_url_fp}` + // `customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}` string resource_name = 1 [ (google.api.field_behavior) = OUTPUT_ONLY, (google.api.resource_reference) = { diff --git a/google/ads/googleads/v4/resources/invoice.proto b/google/ads/googleads/v4/resources/invoice.proto index 33fef4e59..79d1e43b9 100644 --- a/google/ads/googleads/v4/resources/invoice.proto +++ b/google/ads/googleads/v4/resources/invoice.proto @@ -142,8 +142,12 @@ message Invoice { // on the invoice, not on a specific account budget. google.protobuf.Int64Value invoice_level_adjustments_micros = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The pretax subtotal amount, in micros. This equals the sum of the - // AccountBudgetSummary subtotal amounts, plus the invoice level adjustments. + // Output only. The pretax subtotal amount, in micros. This equals the + // sum of the AccountBudgetSummary subtotal amounts, + // Invoice.adjustments_subtotal_amount_micros, and + // Invoice.regulatory_costs_subtotal_amount_micros. + // Starting with v6, the Invoice.regulatory_costs_subtotal_amount_micros is no + // longer included. google.protobuf.Int64Value subtotal_amount_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The sum of all taxes on the invoice, in micros. This equals the sum of the @@ -151,8 +155,11 @@ message Invoice { // account budget. google.protobuf.Int64Value tax_amount_micros = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The total amount, in micros. This equals the sum of the invoice subtotal - // amount and the invoice tax amount. + // Output only. The total amount, in micros. This equals the sum of + // Invoice.subtotal_amount_micros and Invoice.tax_amount_micros. + // Starting with v6, Invoice.regulatory_costs_subtotal_amount_micros is + // also added as it is no longer already included in + // Invoice.tax_amount_micros. google.protobuf.Int64Value total_amount_micros = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The resource name of the original invoice corrected, wrote off, or canceled diff --git a/google/ads/googleads/v4/resources/recommendation.proto b/google/ads/googleads/v4/resources/recommendation.proto index 195c22fd0..8dd115333 100644 --- a/google/ads/googleads/v4/resources/recommendation.proto +++ b/google/ads/googleads/v4/resources/recommendation.proto @@ -106,10 +106,10 @@ message Recommendation { google.protobuf.Int64Value recommended_cpc_bid_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The Call extension recommendation. - message CallExtensionRecommendation { - // Output only. Call extensions recommended to be added. - repeated google.ads.googleads.v4.common.CallFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + // The Callout extension recommendation. + message CalloutExtensionRecommendation { + // Output only. Callout extensions recommended to be added. + repeated google.ads.googleads.v4.common.CalloutFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The text ad recommendation. @@ -127,15 +127,6 @@ message Recommendation { google.protobuf.StringValue auto_apply_date = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The keyword match type recommendation. - message KeywordMatchTypeRecommendation { - // Output only. The existing keyword where the match type should be more broad. - google.ads.googleads.v4.common.KeywordInfo keyword = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - - // Output only. The recommended new match type. - google.ads.googleads.v4.enums.KeywordMatchTypeEnum.KeywordMatchType recommended_match_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - } - // The Target CPA opt-in recommendation. message TargetCpaOptInRecommendation { // The Target CPA opt-in option with impact estimate. @@ -164,25 +155,39 @@ message Recommendation { google.protobuf.Int64Value recommended_target_cpa_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } + // The Optimize Ad Rotation recommendation. + message OptimizeAdRotationRecommendation { + + } + + // The move unused budget recommendation. + message MoveUnusedBudgetRecommendation { + // Output only. The excess budget's resource_name. + google.protobuf.StringValue excess_campaign_budget = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommendation for the constrained budget to increase. + CampaignBudgetRecommendation budget_recommendation = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + // The Maximize Conversions Opt-In recommendation. message MaximizeConversionsOptInRecommendation { // Output only. The recommended new budget amount. google.protobuf.Int64Value recommended_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The Sitelink extension recommendation. - message SitelinkExtensionRecommendation { - // Output only. Sitelink extensions recommended to be added. - repeated google.ads.googleads.v4.common.SitelinkFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - } + // The Search Partners Opt-In recommendation. + message SearchPartnersOptInRecommendation { - // The Enhanced Cost-Per-Click Opt-In recommendation. - message EnhancedCpcOptInRecommendation { + } + // The Call extension recommendation. + message CallExtensionRecommendation { + // Output only. Call extensions recommended to be added. + repeated google.ads.googleads.v4.common.CallFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The Search Partners Opt-In recommendation. - message SearchPartnersOptInRecommendation { + // The Enhanced Cost-Per-Click Opt-In recommendation. + message EnhancedCpcOptInRecommendation { } @@ -193,24 +198,19 @@ message Recommendation { google.protobuf.Int64Value recommended_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The Optimize Ad Rotation recommendation. - message OptimizeAdRotationRecommendation { - - } - - // The Callout extension recommendation. - message CalloutExtensionRecommendation { - // Output only. Callout extensions recommended to be added. - repeated google.ads.googleads.v4.common.CalloutFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + // The Sitelink extension recommendation. + message SitelinkExtensionRecommendation { + // Output only. Sitelink extensions recommended to be added. + repeated google.ads.googleads.v4.common.SitelinkFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The move unused budget recommendation. - message MoveUnusedBudgetRecommendation { - // Output only. The excess budget's resource_name. - google.protobuf.StringValue excess_campaign_budget = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + // The keyword match type recommendation. + message KeywordMatchTypeRecommendation { + // Output only. The existing keyword where the match type should be more broad. + google.ads.googleads.v4.common.KeywordInfo keyword = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The recommendation for the constrained budget to increase. - CampaignBudgetRecommendation budget_recommendation = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + // Output only. The recommended new match type. + google.ads.googleads.v4.enums.KeywordMatchTypeEnum.KeywordMatchType recommended_match_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Immutable. The resource name of the recommendation. diff --git a/google/ads/googleads/v4/services/keyword_plan_ad_group_keyword_service.proto b/google/ads/googleads/v4/services/keyword_plan_ad_group_keyword_service.proto index a28fc337e..285f8cce1 100644 --- a/google/ads/googleads/v4/services/keyword_plan_ad_group_keyword_service.proto +++ b/google/ads/googleads/v4/services/keyword_plan_ad_group_keyword_service.proto @@ -117,7 +117,9 @@ message KeywordPlanAdGroupKeywordOperation { // keyword is expected, in this format: // // `customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}` - string remove = 3; + string remove = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroupKeyword" + }]; } } diff --git a/google/ads/googleads/v4/services/keyword_plan_ad_group_service.proto b/google/ads/googleads/v4/services/keyword_plan_ad_group_service.proto index 71a62b008..8179d8a89 100644 --- a/google/ads/googleads/v4/services/keyword_plan_ad_group_service.proto +++ b/google/ads/googleads/v4/services/keyword_plan_ad_group_service.proto @@ -108,7 +108,9 @@ message KeywordPlanAdGroupOperation { // is expected, in this format: // // `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}` - string remove = 3; + string remove = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + }]; } } diff --git a/google/ads/googleads/v4/services/keyword_plan_campaign_keyword_service.proto b/google/ads/googleads/v4/services/keyword_plan_campaign_keyword_service.proto index ff57ee34c..ed7ef08a7 100644 --- a/google/ads/googleads/v4/services/keyword_plan_campaign_keyword_service.proto +++ b/google/ads/googleads/v4/services/keyword_plan_campaign_keyword_service.proto @@ -115,7 +115,9 @@ message KeywordPlanCampaignKeywordOperation { // keywords expected in this format: // // `customers/{customer_id}/keywordPlanCampaignKeywords/{kp_campaign_keyword_id}` - string remove = 3; + string remove = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaignKeyword" + }]; } } diff --git a/google/ads/googleads/v4/services/keyword_plan_campaign_service.proto b/google/ads/googleads/v4/services/keyword_plan_campaign_service.proto index 5841a7ef7..d7262d2b9 100644 --- a/google/ads/googleads/v4/services/keyword_plan_campaign_service.proto +++ b/google/ads/googleads/v4/services/keyword_plan_campaign_service.proto @@ -109,7 +109,9 @@ message KeywordPlanCampaignOperation { // is expected, in this format: // // `customers/{customer_id}/keywordPlanCampaigns/{keywordPlan_campaign_id}` - string remove = 3; + string remove = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; } } diff --git a/google/ads/googleads/v4/services/keyword_plan_service.proto b/google/ads/googleads/v4/services/keyword_plan_service.proto index 499dbac4f..606d9943b 100644 --- a/google/ads/googleads/v4/services/keyword_plan_service.proto +++ b/google/ads/googleads/v4/services/keyword_plan_service.proto @@ -141,7 +141,9 @@ message KeywordPlanOperation { // expected in this format: // // `customers/{customer_id}/keywordPlans/{keyword_plan_id}` - string remove = 3; + string remove = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + }]; } } @@ -166,7 +168,12 @@ message MutateKeywordPlansResult { // Request message for [KeywordPlanService.GenerateForecastCurve][google.ads.googleads.v4.services.KeywordPlanService.GenerateForecastCurve]. message GenerateForecastCurveRequest { // Required. The resource name of the keyword plan to be forecasted. - string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; + string keyword_plan = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; } // Response message for [KeywordPlanService.GenerateForecastCurve][google.ads.googleads.v4.services.KeywordPlanService.GenerateForecastCurve]. @@ -179,7 +186,12 @@ message GenerateForecastCurveResponse { // Request message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v4.services.KeywordPlanService.GenerateForecastMetrics]. message GenerateForecastMetricsRequest { // Required. The resource name of the keyword plan to be forecasted. - string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; + string keyword_plan = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; } // Response message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v4.services.KeywordPlanService.GenerateForecastMetrics]. @@ -276,7 +288,12 @@ message ForecastMetrics { message GenerateHistoricalMetricsRequest { // Required. The resource name of the keyword plan of which historical metrics are // requested. - string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; + string keyword_plan = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; } // Response message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v4.services.KeywordPlanService.GenerateHistoricalMetrics]. diff --git a/google/ads/googleads/v4/services/reach_plan_service.proto b/google/ads/googleads/v4/services/reach_plan_service.proto index 99e302b32..d52b8d8d6 100644 --- a/google/ads/googleads/v4/services/reach_plan_service.proto +++ b/google/ads/googleads/v4/services/reach_plan_service.proto @@ -130,7 +130,7 @@ message ListPlannableProductsResponse { // The metadata associated with an available plannable product. message ProductMetadata { - // The code associated with the ad product. E.g. Trueview, Bumper + // The code associated with the ad product. E.g. BUMPER, TRUEVIEW_IN_STREAM // To list the available plannable product codes use ListPlannableProducts. google.protobuf.StringValue plannable_product_code = 1; @@ -317,7 +317,8 @@ message CampaignDuration { // A product being planned for reach. message PlannedProduct { // Required. Selected product for planning. - // Plannable products codes can be obtained from ListPlannableProducts. + // The code associated with the ad product. E.g. Trueview, Bumper + // To list the available plannable product codes use ListPlannableProducts. google.protobuf.StringValue plannable_product_code = 1; // Required. Maximum budget allocation in micros for the selected product.