google-adwords-api 0.1.2 → 0.2.0

data/examples/v200909/get_all_ad_group_criteria.rb

@@ -32,6 +32,11 @@ def get_all_ad_group_criteria()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   ad_group_criterion_srv =
       adwords.service(:AdGroupCriterionService, API_VERSION)
 
@@ -57,11 +62,6 @@ def get_all_ad_group_criteria()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_ad_group_criteria()
 

data/examples/v200909/get_all_ad_groups.rb

@@ -32,6 +32,11 @@ def get_all_ad_groups()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   ad_group_srv = adwords.service(:AdGroupService, API_VERSION)
 
   campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
@@ -54,11 +59,6 @@ def get_all_ad_groups()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_ad_groups()
 

data/examples/v200909/get_all_ad_params.rb

@@ -32,6 +32,11 @@ def get_all_ad_params()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   ad_param_srv = adwords.service(:AdParamService, API_VERSION)
 
   ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
@@ -55,11 +60,6 @@ def get_all_ad_params()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_ad_params()
 

data/examples/v200909/get_all_ads.rb

@@ -32,6 +32,11 @@ def get_all_ads()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
 
   ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
@@ -54,11 +59,6 @@ def get_all_ads()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_ads()
 

data/examples/v200909/get_all_campaign_ad_extensions.rb

@@ -32,6 +32,11 @@ def get_all_campaign_ad_extensions()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   campaign_ad_ext_srv =
       adwords.service(:CampaignAdExtensionService, API_VERSION)
 
@@ -56,11 +61,6 @@ def get_all_campaign_ad_extensions()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_campaign_ad_extensions()
 

data/examples/v200909/get_all_campaign_targets.rb

@@ -32,6 +32,11 @@ def get_all_campaign_targets()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   campaign_target_srv = adwords.service(:CampaignTargetService, API_VERSION)
 
   # Get all the campaign targets for this account.
@@ -49,11 +54,6 @@ def get_all_campaign_targets()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_campaign_targets()
 

data/examples/v200909/get_all_campaigns.rb

@@ -31,6 +31,11 @@ def get_all_campaigns()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   campaign_srv = adwords.service(:CampaignService, API_VERSION)
 
   # Get all the campaigns for this account; empty selector.
@@ -49,11 +54,6 @@ def get_all_campaigns()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_campaigns()
 

data/examples/v200909/get_all_disapproved_ads.rb

@@ -32,6 +32,11 @@ def get_all_disapproved_ads()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
 
   campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
@@ -60,11 +65,6 @@ def get_all_disapproved_ads()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_disapproved_ads()
 

data/examples/v200909/get_all_paused_campaigns.rb

@@ -32,6 +32,11 @@ def get_all_paused_campaigns()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   campaign_srv = adwords.service(:CampaignService, API_VERSION)
 
   # Get all the paused campaigns for this account.
@@ -52,11 +57,6 @@ def get_all_paused_campaigns()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_all_paused_campaigns()
 

data/examples/v200909/get_conversion_optimizer_eligibility.rb

@@ -33,6 +33,11 @@ def get_conversion_optimizer_eligibility()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   campaign_srv = adwords.service(:CampaignService, API_VERSION)
 
   campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
@@ -78,11 +83,6 @@ def get_conversion_optimizer_eligibility()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_conversion_optimizer_eligibility()
 

data/examples/v200909/get_geo_location_info.rb

@@ -32,6 +32,11 @@ def get_geo_location_info()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   geo_location_srv = adwords.service(:GeoLocationService, API_VERSION)
 
   selector = {
@@ -74,11 +79,6 @@ def get_geo_location_info()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_geo_location_info()
 

data/examples/v200909/get_method_cost.rb

@@ -32,6 +32,11 @@ def get_method_cost()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   info_srv = adwords.service(:InfoService, API_VERSION)
 
   date = Time.now
@@ -62,11 +67,6 @@ def get_method_cost()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_method_cost()
 

data/examples/v200909/get_operation_count.rb

@@ -32,6 +32,11 @@ def get_operation_count()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   info_srv = adwords.service(:InfoService, API_VERSION)
 
   selector = {
@@ -54,11 +59,6 @@ def get_operation_count()
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_operation_count()
 

data/examples/v200909/get_related_keywords.rb

@@ -26,15 +26,20 @@ gem 'google-adwords-api'
 require 'adwords_api'
 
 API_VERSION = :v200909
+PAGE_SIZE = 100
 
 def get_related_keywords()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   targeting_idea_srv = adwords.service(:TargetingIdeaService, API_VERSION)
 
-  results_per_page = 10
-  keyword_text = 'space cruise'
+  keyword_text = 'INSERT_KEYWORD_TEXT_HERE'
 
   # Construct selector object.
   selector = {
@@ -53,39 +58,35 @@ def get_related_keywords()
     }],
     :paging => {
       :start_index => 0,
-      :number_results => results_per_page
+      :number_results => PAGE_SIZE
     }
   }
 
-  # Perform request.
+  # Define initial values.
+  offset = 0
   results = []
-  index = 0
-  while true
+
+  begin
+    # Perform request.
     page = targeting_idea_srv.get(selector)
-    if page and page[:entries]
-      results += page[:entries]
-    end
-    break if page[:total_num_entries] <= index
-    index += results_per_page
-    selector[:paging][:start_index] = index
-  end
+    results += page[:entries] if page and page[:entries]
+
+    # Prepare next page request.
+    offset += PAGE_SIZE
+    selector[:paging][:start_index] = offset
+  end while offset < page[:total_num_entries]
 
   # Display results.
   results.each do |result|
     data = AdwordsApi::Utils.map(result[:data])
     keyword = data['KEYWORD'][:value]
-    puts " Found keyword with text \"%s\" and match type \"%s\"" %
+    puts "Found keyword with text \"%s\" and match type \"%s\"" %
         [keyword[:text], keyword[:match_type]]
   end
   puts "Total keywords related to \"%s\": %d." % [keyword_text, results.length]
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_related_keywords()
 

data/examples/v200909/get_related_placements.rb

@@ -27,15 +27,20 @@ gem 'google-adwords-api'
 require 'adwords_api'
 
 API_VERSION = :v200909
+PAGE_SIZE = 100
 
 def get_related_placements()
   # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
   # when called without parameters.
   adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
   targeting_idea_srv = adwords.service(:TargetingIdeaService, API_VERSION)
 
-  results_per_page = 10
-  url = 'mars.google.com'
+  url = 'INSERT_PLACEMENT_URL_HERE'
 
   # Construct selector.
   selector = {
@@ -52,39 +57,35 @@ def get_related_placements()
     }],
     :paging => {
       :start_index => 0,
-      :number_results => results_per_page
+      :number_results => PAGE_SIZE
     }
   }
 
-  # Perform request.
+  # Define initial values.
+  offset = 0
   results = []
-  index = 0
-  while true
+
+  begin
+    # Perform request.
     page = targeting_idea_srv.get(selector)
-    if page and page[:entries]
-      results += page[:entries]
-    end
-    break if page[:total_num_entries] <= index
-    index += results_per_page
-    selector[:paging][:start_index] = index
-  end
+    results += page[:entries] if page and page[:entries]
+
+    # Prepare next page request.
+    offset += PAGE_SIZE
+    selector[:paging][:start_index] = offset
+  end while offset < page[:total_num_entries]
 
   # Display results.
   results.each do |result|
     data = AdwordsApi::Utils.map(result[:data])
     placement = data['PLACEMENT'][:value]
-    puts " Related content keywords found at URL \"%s\"" % placement[:url]
+    puts "Related content keywords found at URL [%s]" % placement[:url]
   end
-  puts "Total urls found with content keywords related to keywords at " +
-      " \"#{url}\": #{results.length}."
+  puts "Total URLs found with keywords related to keywords at [%s]: %d." %
+      [url, results.length]
 end
 
 if __FILE__ == $0
-  # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
-  # variable to 'true'. This can be done either from your operating system
-  # environment or via code, as done below.
-  ENV['ADWORDSAPI_DEBUG'] = 'false'
-
   begin
     get_related_placements()