Changes for release v21_0. (#522)

Author: dorasun

CHANGELOG.md

@@ -1,13 +1,19 @@
+35.0.0
+-----
+ - Compatibility with v21, v20.1, v19.2 of the API: https://developers.google.com/google-ads/api/docs/release-notes
+ - Removed support for v18.
+ - Updated examples to include the `containsEuPoliticalAdvertising` field on campaign creation.
+
 34.2.0
 -----
- - Add a minimum version for standard
- - Remove allocation_tracer
- - Update gapic-common to 1.0.1
+ - Added a minimum version for standard
+ - Removed allocation_tracer
+ - Updated gapic-common to 1.0.1
 
 34.1.0
 -----
- - Update activesupport version to 7.1
- - Increase upper bound for google-protobuf and gapic-common dependencies
+ - Updated activesupport version to 7.1
+ - Increased upper bound for google-protobuf and gapic-common dependencies
 
 34.0.0
 -----
@@ -17,7 +23,7 @@
 33.1.0
 -----
  - Improved the logging format to include more information and increase human readability.
- - Update Ruby version in .gemspec file to require a minimum version of 3.0.0
+ - Updated Ruby version in .gemspec file to require a minimum version of 3.0.0
 
 33.0.0
 ------

examples/advanced_operations/add_app_campaign.rb

@@ -73,15 +73,18 @@ def create_campaign(client, customer_id, budget_resource_name)
   campaign = client.resource.campaign do |c|
     c.name = "Interplanetary Cruise App #{(Time.now.to_f * 1000).to_i}"
     c.campaign_budget = budget_resource_name
+
     # Recommendation: Set the campaign to PAUSED when creating it to
     # prevent the ads from immediately serving. Set to ENABLED once you've
     # added targeting and the ads are ready to serve.
     c.status = :PAUSED
+
     # All App campaigns have an advertising_channel_type of
     # MULTI_CHANNEL to reflect the fact that ads from these campaigns are
     # eligible to appear on multiple channels.
     c.advertising_channel_type = :MULTI_CHANNEL
     c.advertising_channel_sub_type = :APP_CAMPAIGN
+
     # Sets the target CPA to $1 / app install.
     #
     # campaign_bidding_strategy is a 'oneof' message so setting target_cpa
@@ -92,13 +95,20 @@ def create_campaign(client, customer_id, budget_resource_name)
     c.target_cpa = client.resource.target_cpa do |tcpa|
       tcpa.target_cpa_micros = 1_000_000
     end
+
     # Sets the App Campaign Settings.
     c.app_campaign_setting = client.resource.app_campaign_setting do |acs|
       acs.app_id = 'com.google.android.apps.adwords'
       acs.app_store = :GOOGLE_APP_STORE
       # Optimize this campaign for getting new users for your app.
       acs.bidding_strategy_goal_type = :OPTIMIZE_INSTALLS_TARGET_INSTALL_COST
     end
+
+    # Declare whether or not this campaign serves political ads targeting the EU.
+    # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+    # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+    c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
+
     # Optional fields
     c.start_date = DateTime.parse((Date.today + 1).to_s).strftime('%Y%m%d')
     c.end_date = DateTime.parse(Date.today.next_year.to_s).strftime('%Y%m%d')

examples/advanced_operations/add_dynamic_search_ads.rb

@@ -77,6 +77,11 @@ def create_campaign(client, customer_id, budget_resource_name)
       s.language_code =  "en"
     end
 
+    # Declare whether or not this campaign serves political ads targeting the EU.
+    # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+    # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+    c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
+
     c.start_date = DateTime.parse((Date.today + 1).to_s).strftime('%Y%m%d')
     c.end_date = DateTime.parse(Date.today.next_year.to_s).strftime('%Y%m%d')
   end

examples/advanced_operations/add_performance_max_campaign.rb

@@ -211,6 +211,11 @@ def create_performance_max_campaign_operation(
       # Set the budget using the given budget resource name.
       c.campaign_budget = client.path.campaign_budget(customer_id, BUDGET_TEMPORARY_ID)
 
+      # Declare whether or not this campaign serves political ads targeting the EU.
+      # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+      # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+      c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
+
       # Optional fields
       c.start_date = DateTime.parse((Date.today + 1).to_s).strftime('%Y%m%d')
       c.end_date = DateTime.parse(Date.today.next_year.to_s).strftime('%Y%m%d')

examples/advanced_operations/add_smart_campaign.rb

@@ -408,6 +408,10 @@ def create_smart_campaign_operation(
       # Assigns the resource name with a temporary ID.
       c.resource_name = client.path.campaign(customer_id, SMART_CAMPAIGN_TEMPORARY_ID)
       c.campaign_budget = client.path.campaign_budget(customer_id, BUDGET_TEMPORARY_ID)
+      # Declare whether or not this campaign serves political ads targeting the EU.
+      # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+      # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+      c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
     end
   end
 

examples/advanced_operations/use_portfolio_bidding_strategy.rb

@@ -81,6 +81,7 @@ def use_portfolio_bidding_strategy(customer_id)
         ns.target_search_network = true
         ns.target_content_network = false
         ns.target_partner_search_network = false
+      c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
       end
     end
   end

examples/basic_operations/add_campaigns.rb

@@ -68,6 +68,11 @@ def add_campaigns(customer_id)
       ns.target_partner_search_network = false
     end
 
+    # Declare whether or not this campaign serves political ads targeting the EU.
+    # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+    # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+    c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
+
     # Optional: Set the start date.
     c.start_date = DateTime.parse((Date.today + 1).to_s).strftime('%Y%m%d')
 

examples/basic_operations/update_campaign.rb

@@ -25,7 +25,6 @@ def update_campaign(customer_id, campaign_id)
   # ENV['HOME']/google_ads_config.rb when called without parameters
   client = Google::Ads::GoogleAds::GoogleAdsClient.new
 
-
   resource_name = client.path.campaign(customer_id, campaign_id)
 
   operation = client.operation.update_resource.campaign(resource_name) do |c|

examples/campaign_management/add_complete_campaigns_using_batch_job.rb

@@ -230,6 +230,10 @@ def build_campaign_operations(client, customer_id, campaign_budget_resource_name
       # Sets the bidding strategy and budget.
       c.manual_cpc = client.resource.manual_cpc
       c.campaign_budget = campaign_budget_resource_name
+      # Declare whether or not this campaign serves political ads targeting the EU.
+      # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+      # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+      c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
     end
   end
 

examples/factories/various_factories_usage.rb

@@ -61,6 +61,11 @@ def add_campaigns(customer_id)
     ns.target_partner_search_network = false
   end
 
+  # Declare whether or not this campaign serves political ads targeting the EU.
+  # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
+  # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+  campaign.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
+
   # Alternate non-block style, where we pass the campaign object we built
   # up
   campaign_operation = client.operation.create_resource.campaign(campaign)