RubyGems - google-adwords-api - Versions diffs - 0.16.0 → 0.16.1 - Mend

google-adwords-api 0.16.0 → 0.16.1

Files changed (164) hide show

data/examples/v201506/account_management/get_account_changes.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example gets all account changes that happened within the last 24 hours,
 # for all your campaigns.
-#
-# Tags: CustomerSyncService.get
 require 'adwords_api'
 require 'date'
@@ -123,7 +119,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/account_management/get_account_hierarchy.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to retrieve the account hierarchy under an
 # account. This example needs to be run against an MCC account.
-#
-# Tags: ManagedCustomerService.get
 require 'adwords_api'
 require 'adwords_api/utils'
@@ -78,7 +74,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/add_ad_customizers.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.mcloonan@gmail.com (Michael Cloonan)
-#
 # Copyright:: Copyright 2015, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,9 +18,6 @@
 #
 # This example adds an ad customizer feed using Extension Services. Then it adds
 # an ad that uses the feed to populate dynamic data.
-#
-# Tags: AdCustomizerFeedService.mutate, FeedItemService.mutate
-# Tags: AdGroupAdService.mutate
 require 'adwords_api'
 require 'date'
@@ -169,7 +164,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/add_ad_group_bid_modifier.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to add an ad group level mobile bid modifier
 # override for a campaign.
-#
-# Tags: AdGroupBidModifierService.mutate
 require 'adwords_api'
@@ -85,7 +81,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/add_click_to_download_ad.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This code example creates a click-to-download ad, also known as an app
 # promotion ad to a given ad group. To list ad groups, run get_ad_groups.rb.
-#
-# Tags: AdGroupAdService.mutate
 require 'adwords_api'
@@ -117,7 +113,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/add_text_ad_with_upgraded_urls.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.mcloonan@gmail.com (Michael Cloonan)
-#
 # Copyright:: Copyright 2014, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This code example adds a text ad that uses advanced features of upgraded
 # URLs.
-#
-# Tags: AdGroupAdService.mutate
 require 'adwords_api'
@@ -118,7 +114,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/create_and_attach_shared_keyword_set.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2015, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example creates a shared list of negative broad match keywords, it then
 # attaches them to a campaign.
-#
-# Tags: SharedSetService.mutate, CampaignSharedSetService.mutate
 require 'adwords_api'
 require 'date'
@@ -119,6 +115,14 @@ if __FILE__ == $0
     create_and_attach_shared_keyword_set(campaign_id)
+  # Authorization error.
+  rescue AdsCommon::Errors::OAuth2VerificationRequired => e
+    puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
+        "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
+        "to retrieve and store OAuth2 tokens."
+    puts "See this wiki page for more details:\n\n  " +
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e
     puts "HTTP Error: %s" % e

data/examples/v201506/advanced_operations/find_and_remove_criteria_from_shared_set.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2015, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,9 +18,6 @@
 #
 # This example demonstrates how to find shared sets, shared set criterions and
 # how to remove them.
-#
-# Tags: CampaignSharedSetService.get
-# Tags: SharedCriterionService.get, SharedCriterionService.mutate
 require 'adwords_api'
@@ -153,6 +148,14 @@ if __FILE__ == $0
     find_and_remove_criteria_from_shared_set(campaign_id)
+  # Authorization error.
+  rescue AdsCommon::Errors::OAuth2VerificationRequired => e
+    puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
+        "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
+        "to retrieve and store OAuth2 tokens."
+    puts "See this wiki page for more details:\n\n  " +
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e
     puts "HTTP Error: %s" % e

data/examples/v201506/advanced_operations/get_ad_group_bid_modifiers.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to retrieve ad group level bid modifiers for a
 # campaign.
-#
-# Tags: AdGroupBidModifierService.get
 require 'adwords_api'
@@ -86,7 +82,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/upload_offline_conversions.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -21,8 +19,6 @@
 # This code example imports offline conversion values for specific clicks to
 # your account. To get Google Click ID for a click, run
 # CLICK_PERFORMANCE_REPORT.
-#
-# Tags: ConversionTrackerService.mutate, OfflineConversionFeedService.mutate
 require 'adwords_api'
 require 'date'
@@ -97,7 +93,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/advanced_operations/use_shared_bidding_strategy.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,9 +18,6 @@
 #
 # This example adds a Shared Bidding Strategy and uses it to construct a
 # campaign.
-#
-# Tags: BiddingStrategyService.mutate, CampaignService.mutate
-# Tags: BudgetService.mutate
 require 'adwords_api'
 require 'date'
@@ -132,7 +127,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/basic_operations/add_ad_groups.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to create ad groups. To get a list of existing
 # campaigns run get_campaigns.rb.
-#
-# Tags: AdGroupService.mutate
 require 'adwords_api'
@@ -124,7 +120,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/basic_operations/add_campaigns.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -19,8 +17,6 @@
 #           limitations under the License.
 #
 # This example illustrates how to create campaigns.
-#
-# Tags: CampaignService.mutate, BudgetService.mutate
 require 'adwords_api'
 require 'date'
@@ -123,7 +119,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/basic_operations/add_keywords.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to add multiple keywords to a given ad group. To
 # create an ad group, run add_ad_group.rb.
-#
-# Tags: AdGroupCriterionService.mutate
 require 'adwords_api'
@@ -98,7 +94,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/basic_operations/add_text_ads.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to add text ads to a given ad group. To create an
 # ad group, run add_ad_group.rb.
-#
-# Tags: AdGroupAdService.mutate
 require 'adwords_api'
@@ -93,7 +89,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/basic_operations/get_ad_groups.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,8 +18,6 @@
 #
 # This example illustrates how to retrieve all the ad groups for a campaign. To
 # create an ad group, run add_ad_group.rb.
-#
-# Tags: AdGroupService.get
 require 'adwords_api'
@@ -86,7 +82,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e

data/examples/v201506/basic_operations/get_campaigns.rb CHANGED

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # Encoding: utf-8
 #
-# Author:: api.dklimkin@gmail.com (Danial Klimkin)
-#
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 #
 # License:: Licensed under the Apache License, Version 2.0 (the "License");
@@ -19,8 +17,6 @@
 #           limitations under the License.
 #
 # This example illustrates how to retrieve all the campaigns for an account.
-#
-# Tags: CampaignService.get
 require 'adwords_api'
@@ -81,7 +77,7 @@ if __FILE__ == $0
         "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
         "to retrieve and store OAuth2 tokens."
     puts "See this wiki page for more details:\n\n  " +
-        'http://code.google.com/p/google-api-ads-ruby/wiki/OAuth2'
+        'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
   # HTTP errors.
   rescue AdsCommon::Errors::HttpError => e