--- 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. //
/resources/campaign.proto
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[],[],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```"]]