--- v22/resources/ad_group.proto 2026-01-23 15:31:38.000000000 +0000 +++ v23/resources/ad_group.proto 2026-01-22 20:49:25.000000000 +0000 @@ -1,366 +1,385 @@ // Copyright 2026 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. syntax = "proto3"; -package google.ads.googleads.v22.resources; +package google.ads.googleads.v23.resources; -import "google/ads/googleads/v22/common/custom_parameter.proto"; -import "google/ads/googleads/v22/common/targeting_setting.proto"; -import "google/ads/googleads/v22/enums/ad_group_ad_rotation_mode.proto"; -import "google/ads/googleads/v22/enums/ad_group_primary_status.proto"; -import "google/ads/googleads/v22/enums/ad_group_primary_status_reason.proto"; -import "google/ads/googleads/v22/enums/ad_group_status.proto"; -import "google/ads/googleads/v22/enums/ad_group_type.proto"; -import "google/ads/googleads/v22/enums/asset_field_type.proto"; -import "google/ads/googleads/v22/enums/asset_set_type.proto"; -import "google/ads/googleads/v22/enums/bidding_source.proto"; -import "google/ads/googleads/v22/enums/demand_gen_channel_config.proto"; -import "google/ads/googleads/v22/enums/demand_gen_channel_strategy.proto"; -import "google/ads/googleads/v22/enums/targeting_dimension.proto"; +import "google/ads/googleads/v23/common/custom_parameter.proto"; +import "google/ads/googleads/v23/common/targeting_setting.proto"; +import "google/ads/googleads/v23/enums/ad_group_ad_rotation_mode.proto"; +import "google/ads/googleads/v23/enums/ad_group_primary_status.proto"; +import "google/ads/googleads/v23/enums/ad_group_primary_status_reason.proto"; +import "google/ads/googleads/v23/enums/ad_group_status.proto"; +import "google/ads/googleads/v23/enums/ad_group_type.proto"; +import "google/ads/googleads/v23/enums/asset_field_type.proto"; +import "google/ads/googleads/v23/enums/asset_set_type.proto"; +import "google/ads/googleads/v23/enums/bidding_source.proto"; +import "google/ads/googleads/v23/enums/demand_gen_channel_config.proto"; +import "google/ads/googleads/v23/enums/demand_gen_channel_strategy.proto"; +import "google/ads/googleads/v23/enums/targeting_dimension.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; -option csharp_namespace = "Google.Ads.GoogleAds.V22.Resources"; -option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v22/resources;resources"; +option csharp_namespace = "Google.Ads.GoogleAds.V23.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v23/resources;resources"; option java_multiple_files = true; option java_outer_classname = "AdGroupProto"; -option java_package = "com.google.ads.googleads.v22.resources"; +option java_package = "com.google.ads.googleads.v23.resources"; option objc_class_prefix = "GAA"; -option php_namespace = "Google\\Ads\\GoogleAds\\V22\\Resources"; -option ruby_package = "Google::Ads::GoogleAds::V22::Resources"; +option php_namespace = "Google\\Ads\\GoogleAds\\V23\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V23::Resources"; // Proto file describing the ad group resource. // An ad group. message AdGroup { option (google.api.resource) = { type: "googleads.googleapis.com/AdGroup" pattern: "customers/{customer_id}/adGroups/{ad_group_id}" }; // Settings for the audience targeting. message AudienceSetting { // Immutable. If true, this ad group uses an Audience resource for audience // targeting. If false, this ad group may use audience segment criteria // instead. bool use_audience_grouped = 1 [(google.api.field_behavior) = IMMUTABLE]; } // Settings for Demand Gen ad groups. message DemandGenAdGroupSettings { // Channel controls for Demand Gen ad groups. message DemandGenChannelControls { // Explicitly selected channels for channel controls in Demand Gen ad // groups. message DemandGenSelectedChannels { // Whether to enable ads on the YouTube In-Stream channel. bool youtube_in_stream = 1; // Whether to enable ads on the YouTube In-Feed channel. bool youtube_in_feed = 2; // Whether to enable ads on the YouTube Shorts channel. bool youtube_shorts = 3; // Whether to enable ads on the Discover channel. bool discover = 4; // Whether to enable ads on the Gmail channel. bool gmail = 5; // Whether to enable ads on the Display channel. bool display = 6; } // Output only. Channel configuration reflecting which field in the oneof // is populated. - google.ads.googleads.v22.enums.DemandGenChannelConfigEnum + google.ads.googleads.v23.enums.DemandGenChannelConfigEnum .DemandGenChannelConfig channel_config = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Oneof between the different channel control configuration options. oneof channel_configuration { // High level channel strategy. - google.ads.googleads.v22.enums.DemandGenChannelStrategyEnum + google.ads.googleads.v23.enums.DemandGenChannelStrategyEnum .DemandGenChannelStrategy channel_strategy = 2; // Explicitly selected channels. This field should be set with at // least one true value when present. DemandGenSelectedChannels selected_channels = 3; } } // Channel controls for Demand Gen ad groups. DemandGenChannelControls channel_controls = 1; } // Settings for video ad groups. message VideoAdGroupSettings { // The video ads sequence step settings containing step ID. message VideoAdSequenceStepSetting { // The ID of this sequence step from an existing // `campaign.video_campaign_settings.video_ad_sequence` definition. Only // one Ad Group can point to a given `step_id`. int64 step_id = 1; } // The video ads sequence step settings containing step ID. VideoAdSequenceStepSetting video_ad_sequence = 1; } // Settings for AI Max feature in standard search adgroups. message AiMaxAdGroupSetting { // Disable search term matching for this adgroup when AI Max is enabled. // Search term matching uses broad match, asset-based, and landing // page-based technology to improve reach. optional bool disable_search_term_matching = 1; } + // Vertical ads setting feature to enable/disable ad group format controls in + // search campaigns. + message VerticalAdsFormatSetting { + // If true, text ads will be disabled for this ad group. + optional bool disable_text_ads = 1; + + // If true, booking links will be enabled for this ad group. + optional bool enable_booking_links = 2; + + // If true, vertical promotion ads will be enabled for this ad group. + optional bool enable_vertical_promotion_ads = 3; + } + // Immutable. The resource name of the ad group. // Ad group resource names have the form: // // `customers/{customer_id}/adGroups/{ad_group_id}` string resource_name = 1 [ (google.api.field_behavior) = IMMUTABLE, (google.api.resource_reference) = { type: "googleads.googleapis.com/AdGroup" } ]; // Output only. The ID of the ad group. optional int64 id = 34 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the ad group. // // This field is required and should not be empty when creating new ad // groups. // // It must contain fewer than 255 UTF-8 full-width characters. // // It must not contain any null (code point 0x0), NL line feed // (code point 0xA) or carriage return (code point 0xD) characters. optional string name = 35; // The status of the ad group. - google.ads.googleads.v22.enums.AdGroupStatusEnum.AdGroupStatus status = 5; + google.ads.googleads.v23.enums.AdGroupStatusEnum.AdGroupStatus status = 5; // Immutable. The type of the ad group. - google.ads.googleads.v22.enums.AdGroupTypeEnum.AdGroupType type = 12 + google.ads.googleads.v23.enums.AdGroupTypeEnum.AdGroupType type = 12 [(google.api.field_behavior) = IMMUTABLE]; // The ad rotation mode of the ad group. - google.ads.googleads.v22.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode + google.ads.googleads.v23.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode ad_rotation_mode = 22; // Output only. For draft or experiment ad groups, this field is the resource // name of the base ad group from which this ad group was created. If a draft // or experiment ad group does not have a base ad group, then this field is // null. // // For base ad groups, this field equals the ad group resource name. // // This field is read-only. optional string base_ad_group = 36 [ (google.api.field_behavior) = OUTPUT_ONLY, (google.api.resource_reference) = { type: "googleads.googleapis.com/AdGroup" } ]; // The URL template for constructing a tracking URL. optional string tracking_url_template = 37; // The list of mappings used to substitute custom parameter tags in a // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - repeated google.ads.googleads.v22.common.CustomParameter + repeated google.ads.googleads.v23.common.CustomParameter url_custom_parameters = 6; // Immutable. The campaign to which the ad group belongs. optional string campaign = 38 [ (google.api.field_behavior) = IMMUTABLE, (google.api.resource_reference) = { type: "googleads.googleapis.com/Campaign" } ]; // The maximum CPC (cost-per-click) bid. This field is used when the // ad group's effective bidding strategy is Manual CPC. This field is not // applicable and will be ignored if the ad group's campaign is using a // portfolio bidding strategy. optional int64 cpc_bid_micros = 39; // Output only. Value will be same as that of the CPC (cost-per-click) bid // value when the bidding strategy is one of manual cpc, enhanced cpc, page // one promoted or target outrank share, otherwise the value will be null. optional int64 effective_cpc_bid_micros = 57 [(google.api.field_behavior) = OUTPUT_ONLY]; // The maximum CPM (cost-per-thousand viewable impressions) bid. optional int64 cpm_bid_micros = 40; // The target CPA (cost-per-acquisition). If the ad group's campaign // bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa // field set), then this field overrides the target CPA specified in the // campaign's bidding strategy. // Otherwise, this value is ignored. optional int64 target_cpa_micros = 41; // The CPV (cost-per-view) bid. optional int64 cpv_bid_micros = 42; // Average amount in micros that the advertiser is willing to pay for every // thousand times the ad is shown. optional int64 target_cpm_micros = 43; // The target ROAS (return-on-ad-spend) for this ad group. // // This field lets you override the target ROAS specified in the // campaign's bidding strategy, but only if the campaign is using a // standard (not portfolio) `TargetRoas` strategy or a standard // `MaximizeConversionValue` strategy with its `target_roas` field set. // // If the campaign is using a portfolio bidding strategy, this field // cannot be set and attempting to do so will result in an error. // // For any other bidding strategies, this value is ignored. // // To see the actual target ROAS being used by the ad group, considering // potential overrides, query the `effective_target_roas` and // `effective_target_roas_source` fields. optional double target_roas = 44; // The percent cpc bid amount, expressed as a fraction of the advertised price // for some good or service. The valid range for the fraction is [0,1) and the // value stored here is 1,000,000 * [fraction]. optional int64 percent_cpc_bid_micros = 45; // The fixed amount in micros that the advertiser pays for every thousand // impressions of the ad. optional int64 fixed_cpm_micros = 64; // Average amount in micros that the advertiser is willing to pay for every ad // view. optional int64 target_cpv_micros = 65; // Average amount in micros that the advertiser is willing to pay for every ad // click. Overrides the target CPC configured at the campaign level. optional int64 target_cpc_micros = 68; // True if optimized targeting is enabled. Optimized Targeting is the // replacement for Audience Expansion. bool optimized_targeting_enabled = 59; // When this value is true, demographics will be excluded from the types of // targeting which are expanded when optimized_targeting_enabled is true. // When optimized_targeting_enabled is false, this field is ignored. Default // is false. bool exclude_demographic_expansion = 67; // Lets advertisers specify a targeting dimension on which to place // absolute bids. This is only applicable for campaigns that target only the // display network and not search. - google.ads.googleads.v22.enums.TargetingDimensionEnum.TargetingDimension + google.ads.googleads.v23.enums.TargetingDimensionEnum.TargetingDimension display_custom_bid_dimension = 23; // URL template for appending params to Final URL. optional string final_url_suffix = 46; // Setting for targeting related features. - google.ads.googleads.v22.common.TargetingSetting targeting_setting = 25; + google.ads.googleads.v23.common.TargetingSetting targeting_setting = 25; // Immutable. Setting for audience related features. AudienceSetting audience_setting = 56 [(google.api.field_behavior) = IMMUTABLE]; // Output only. The effective target CPA (cost-per-acquisition). // This field is read-only. optional int64 effective_target_cpa_micros = 47 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Source of the effective target CPA. // This field is read-only. - google.ads.googleads.v22.enums.BiddingSourceEnum.BiddingSource + google.ads.googleads.v23.enums.BiddingSourceEnum.BiddingSource effective_target_cpa_source = 29 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The effective target ROAS (return-on-ad-spend). // This field is read-only. optional double effective_target_roas = 48 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Source of the effective target ROAS. // This field is read-only. - google.ads.googleads.v22.enums.BiddingSourceEnum.BiddingSource + google.ads.googleads.v23.enums.BiddingSourceEnum.BiddingSource effective_target_roas_source = 32 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The effective target CPC (cost-per-click). // This field is read-only. optional int64 effective_target_cpc = 69 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Source of the effective target CPC. // This field is read-only. - google.ads.googleads.v22.enums.BiddingSourceEnum.BiddingSource + google.ads.googleads.v23.enums.BiddingSourceEnum.BiddingSource effective_target_cpc_source = 70 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The resource names of labels attached to this ad group. repeated string labels = 49 [ (google.api.field_behavior) = OUTPUT_ONLY, (google.api.resource_reference) = { type: "googleads.googleapis.com/AdGroupLabel" } ]; // The asset field types that should be excluded from this ad group. Asset // links with these field types will not be inherited by this ad group from // the upper levels. - repeated google.ads.googleads.v22.enums.AssetFieldTypeEnum.AssetFieldType + repeated google.ads.googleads.v23.enums.AssetFieldTypeEnum.AssetFieldType excluded_parent_asset_field_types = 54; // The asset set types that should be excluded from this ad group. Asset set // links with these types will not be inherited by this ad group from the // upper levels. // Location group types (GMB_DYNAMIC_LOCATION_GROUP, // CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of // LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all // location group asset sets are not allowed to be linked to this ad group, // and all Location Extension (LE) and Affiliate Location Extensions (ALE) // will not be served under this ad group. // Only LOCATION_SYNC is currently supported. - repeated google.ads.googleads.v22.enums.AssetSetTypeEnum.AssetSetType + repeated google.ads.googleads.v23.enums.AssetSetTypeEnum.AssetSetType excluded_parent_asset_set_types = 58; // Output only. Provides aggregated view into why an ad group is not serving // or not serving optimally. - google.ads.googleads.v22.enums.AdGroupPrimaryStatusEnum.AdGroupPrimaryStatus + google.ads.googleads.v23.enums.AdGroupPrimaryStatusEnum.AdGroupPrimaryStatus primary_status = 62 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Provides reasons for why an ad group is not serving or not // serving optimally. - repeated google.ads.googleads.v22.enums.AdGroupPrimaryStatusReasonEnum + repeated google.ads.googleads.v23.enums.AdGroupPrimaryStatusReasonEnum .AdGroupPrimaryStatusReason primary_status_reasons = 63 [(google.api.field_behavior) = OUTPUT_ONLY]; // Settings for Demand Gen ad groups. DemandGenAdGroupSettings demand_gen_ad_group_settings = 91; // Settings for video ad groups. VideoAdGroupSettings video_ad_group_settings = 92; // Settings for AI Max feature in standard search adgroups. AiMaxAdGroupSetting ai_max_ad_group_setting = 71; + + // Vertical ads setting feature to enable/disable ad group format controls in + // search campaigns. + // This setting requires AiMaxAdGroupSetting to be enabled and a travel feed + // to be attached to the campaign. + VerticalAdsFormatSetting vertical_ads_format_setting = 72; }
/resources/ad_group.proto
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-23 UTC.