Stay organized with collections
Save and categorize content based on your preferences.
--- v18/resources/campaign.proto 2025-08-05 14:36:05.000000000 +0000+++ v19/resources/campaign.proto 2025-08-05 14:36:20.000000000 +0000@@ -139,12 +140,6 @@ // Whether the campaign uses advertiser supplied URLs exclusively.
optional bool use_supplied_urls_only = 8;
-- // The list of resource names of page feed assets associated with the- // campaign.- repeated string feeds = 9 [(google.api.resource_reference) = {- type: "googleads.googleapis.com/Feed"- }]; }
// The setting for Shopping campaigns. Defines the universe of products that
@@ -330,10 +328,22 @@ optional bool allow_shorts = 3;
}
- // Inventory control for responsive ad containers in reach campaigns.+ // Inventory control for video responsive ads in reach campaigns. VideoAdInventoryControl video_ad_inventory_control = 1;
}
+ // Settings for Performance Max campaigns.+ message PmaxCampaignSettings {+ // Overrides of brand targeting for various ad types.+ message BrandTargetingOverrides {+ // If true, brand exclusions are ignored for Shopping ads.+ optional bool ignore_exclusions_for_shopping_ads = 1;+ }++ // Overrides of brand targeting for various ad types.+ BrandTargetingOverrides brand_targeting_overrides = 1;+ }+ // Asset automation setting contains pair of AssetAutomationType and the
// asset automation opt-in/out status
message AssetAutomationSetting {
@@ -342,10 +352,28 @@ .AssetAutomationType asset_automation_type = 1;
// The opt-in/out status of asset automation type.
- optional google.ads.googleads.v18.enums.AssetAutomationStatusEnum+ optional google.ads.googleads.v19.enums.AssetAutomationStatusEnum .AssetAutomationStatus asset_automation_status = 2;
}
+ // Settings that control the visual appearance of your brand in a campaign's+ // automatically generated assets and formats. Only applicable to Performance+ // Max campaigns.+ message BrandGuidelines {+ // The main brand color, entered as a hex code (e.g., #00ff00). You must+ // provide the main_color if you provide an accent_color.+ string main_color = 1;++ // The accent brand color, entered as a hex code (e.g., #00ff00). You must+ // provide the accent_color if you provide a main_color.+ string accent_color = 2;++ // The brand's font family. Must be one of the following Google Fonts (case+ // sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald,+ // Playfair Display, Roboto Slab.+ string predefined_font_family = 3;+ }+ // Immutable. The resource name of the campaign.
// Campaign resource names have the form:
//
@@ -445,9 +473,12 @@ // Settings for Video campaign.
VideoCampaignSettings video_campaign_settings = 94;
+ // Settings for Performance Max campaign.+ PmaxCampaignSettings pmax_campaign_settings = 97;+ // Settings for Real-Time Bidding, a feature only available for campaigns
// targeting the Ad Exchange network.
- google.ads.googleads.v18.common.RealTimeBiddingSetting+ google.ads.googleads.v19.common.RealTimeBiddingSetting real_time_bidding_setting = 39;
// The network settings for the campaign.
@@ -655,8 +686,33 @@ // Only applicable to Performance Max campaigns. If enabled, business name
// and logo assets must be linked as CampaignAssets instead of
// AssetGroupAssets.
+ //+ // Writable only at campaign creation. Set to true to enable Brand+ // Guidelines when creating a new Performance Max campaign.+ //+ // Immutable after creation. This field cannot be modified using standard+ // update operations after the campaign has been created.+ //+ // For existing campaigns: To enable Brand Guidelines on a campaign after it+ // has been created, use the CampaignService.EnablePMaxBrandGuidelines method,+ // which is a separate operation. It is not possible to disable Brand+ // Guidelines for an existing campaign.+ //+ // Incompatible with Travel Goals: This feature is not supported for+ // Performance Max campaigns with Travel Goals. Attempting to set this field+ // to true for a Travel Goals campaign will result in an error. optional bool brand_guidelines_enabled = 96
- [(google.api.field_behavior) = OUTPUT_ONLY];+ [(google.api.field_behavior) = IMMUTABLE];++ // These settings control how your brand appears in automatically generated+ // assets and formats within this campaign. Note: These settings can only be+ // used for Performance Max campaigns that have Brand Guidelines enabled.+ BrandGuidelines brand_guidelines = 98;++ // The advertiser should self-declare whether this campaign contains+ // political advertising content targeted towards the European Union.+ google.ads.googleads.v19.enums.EuPoliticalAdvertisingStatusEnum+ .EuPoliticalAdvertisingStatus contains_eu_political_advertising = 102; // The bidding strategy for the campaign.
//
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# /resources/campaign.proto\n\n```diff\n--- v18/resources/campaign.proto 2025-08-05 14:36:05.000000000 +0000\n+++ v19/resources/campaign.proto 2025-08-05 14:36:20.000000000 +0000\n@@ -139,12 +140,6 @@\n\n // Whether the campaign uses advertiser supplied URLs exclusively.\n optional bool use_supplied_urls_only = 8;\n-\n- // The list of resource names of page feed assets associated with the\n- // campaign.\n- repeated string feeds = 9 [(google.api.resource_reference) = {\n- type: \"googleads.googleapis.com/Feed\"\n- }];\n }\n\n // The setting for Shopping campaigns. Defines the universe of products that\n@@ -330,10 +328,22 @@\n optional bool allow_shorts = 3;\n }\n\n- // Inventory control for responsive ad containers in reach campaigns.\n+ // Inventory control for video responsive ads in reach campaigns.\n VideoAdInventoryControl video_ad_inventory_control = 1;\n }\n\n+ // Settings for Performance Max campaigns.\n+ message PmaxCampaignSettings {\n+ // Overrides of brand targeting for various ad types.\n+ message BrandTargetingOverrides {\n+ // If true, brand exclusions are ignored for Shopping ads.\n+ optional bool ignore_exclusions_for_shopping_ads = 1;\n+ }\n+\n+ // Overrides of brand targeting for various ad types.\n+ BrandTargetingOverrides brand_targeting_overrides = 1;\n+ }\n+\n // Asset automation setting contains pair of AssetAutomationType and the\n // asset automation opt-in/out status\n message AssetAutomationSetting {\n@@ -342,10 +352,28 @@\n .AssetAutomationType asset_automation_type = 1;\n\n // The opt-in/out status of asset automation type.\n- optional google.ads.googleads.v18.enums.AssetAutomationStatusEnum\n+ optional google.ads.googleads.v19.enums.AssetAutomationStatusEnum\n .AssetAutomationStatus asset_automation_status = 2;\n }\n\n+ // Settings that control the visual appearance of your brand in a campaign's\n+ // automatically generated assets and formats. Only applicable to Performance\n+ // Max campaigns.\n+ message BrandGuidelines {\n+ // The main brand color, entered as a hex code (e.g., #00ff00). You must\n+ // provide the main_color if you provide an accent_color.\n+ string main_color = 1;\n+\n+ // The accent brand color, entered as a hex code (e.g., #00ff00). You must\n+ // provide the accent_color if you provide a main_color.\n+ string accent_color = 2;\n+\n+ // The brand's font family. Must be one of the following Google Fonts (case\n+ // sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald,\n+ // Playfair Display, Roboto Slab.\n+ string predefined_font_family = 3;\n+ }\n+\n // Immutable. The resource name of the campaign.\n // Campaign resource names have the form:\n //\n@@ -445,9 +473,12 @@\n // Settings for Video campaign.\n VideoCampaignSettings video_campaign_settings = 94;\n\n+ // Settings for Performance Max campaign.\n+ PmaxCampaignSettings pmax_campaign_settings = 97;\n+\n // Settings for Real-Time Bidding, a feature only available for campaigns\n // targeting the Ad Exchange network.\n- google.ads.googleads.v18.common.RealTimeBiddingSetting\n+ google.ads.googleads.v19.common.RealTimeBiddingSetting\n real_time_bidding_setting = 39;\n\n // The network settings for the campaign.\n@@ -655,8 +686,33 @@\n // Only applicable to Performance Max campaigns. If enabled, business name\n // and logo assets must be linked as CampaignAssets instead of\n // AssetGroupAssets.\n+ //\n+ // Writable only at campaign creation. Set to true to enable Brand\n+ // Guidelines when creating a new Performance Max campaign.\n+ //\n+ // Immutable after creation. This field cannot be modified using standard\n+ // update operations after the campaign has been created.\n+ //\n+ // For existing campaigns: To enable Brand Guidelines on a campaign after it\n+ // has been created, use the CampaignService.EnablePMaxBrandGuidelines method,\n+ // which is a separate operation. It is not possible to disable Brand\n+ // Guidelines for an existing campaign.\n+ //\n+ // Incompatible with Travel Goals: This feature is not supported for\n+ // Performance Max campaigns with Travel Goals. Attempting to set this field\n+ // to true for a Travel Goals campaign will result in an error.\n optional bool brand_guidelines_enabled = 96\n- [(google.api.field_behavior) = OUTPUT_ONLY];\n+ [(google.api.field_behavior) = IMMUTABLE];\n+\n+ // These settings control how your brand appears in automatically generated\n+ // assets and formats within this campaign. Note: These settings can only be\n+ // used for Performance Max campaigns that have Brand Guidelines enabled.\n+ BrandGuidelines brand_guidelines = 98;\n+\n+ // The advertiser should self-declare whether this campaign contains\n+ // political advertising content targeted towards the European Union.\n+ google.ads.googleads.v19.enums.EuPoliticalAdvertisingStatusEnum\n+ .EuPoliticalAdvertisingStatus contains_eu_political_advertising = 102;\n\n // The bidding strategy for the campaign.\n //\n```"]]
