google-adwords-api 0.1.0

data/examples/v201003/get_all_report_definitions.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/ruby
+#
+# Author:: api.sgomes@gmail.com (Sérgio Gomes)
+#
+# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
+#
+# License:: Licensed under the Apache License, Version 2.0 (the "License");
+#           you may not use this file except in compliance with the License.
+#           You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#           Unless required by applicable law or agreed to in writing, software
+#           distributed under the License is distributed on an "AS IS" BASIS,
+#           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+#           implied.
+#           See the License for the specific language governing permissions and
+#           limitations under the License.
+#
+# This example gets all report definitions. To add a report definition, run
+# add_keywords_performance_report.rb.
+#
+# Tags: ReportDefinitionService.get
+
+require 'rubygems'
+gem 'google-adwords-api'
+require 'adwords_api'
+
+API_VERSION = :v201003
+
+def get_all_report_definitions()
+  # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
+  # when called without parameters.
+  adwords = AdwordsApi::Api.new
+  report_def_srv = adwords.service(:ReportDefinitionService, API_VERSION)
+
+  # Get all the report definitions.
+  selector = {}
+  response = report_def_srv.get(selector)
+  if response and response[:entries]
+    entries = response[:entries]
+    puts "#{entries.length} report definition(s) found."
+    entries.each do |entry|
+      puts "  Report definition id is #{entry[:id]} and name is " +
+          "\"#{entry[:report_name]}\"."
+    end
+  else
+    puts "No report definitions found."
+  end
+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_report_definitions()
+
+  # Connection error. Likely transitory.
+  rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
+    puts 'Connection Error: %s' % e
+    puts 'Source: %s' % e.backtrace.first
+
+  # API Error.
+  rescue AdwordsApi::Errors::ApiException => e
+    puts 'API Exception caught.'
+    puts 'Message: %s' % e.message
+    puts 'Code: %d' % e.code if e.code
+    puts 'Trigger: %s' % e.trigger if e.trigger
+    puts 'Errors:'
+    if e.errors
+      e.errors.each_with_index do |error, index|
+        puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
+        error.each_pair do |field, value|
+          if field != :xsi_type
+            puts '     %s: %s' % [field, value]
+          end
+        end
+      end
+    end
+  end
+end

data/examples/v201003/get_all_videos.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/ruby
+#
+# Author:: api.sgomes@gmail.com (Sérgio Gomes)
+#
+# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
+#
+# License:: Licensed under the Apache License, Version 2.0 (the "License");
+#           you may not use this file except in compliance with the License.
+#           You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#           Unless required by applicable law or agreed to in writing, software
+#           distributed under the License is distributed on an "AS IS" BASIS,
+#           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+#           implied.
+#           See the License for the specific language governing permissions and
+#           limitations under the License.
+#
+# This example illustrates how to retrieve all videos. To upload video, see
+# http://adwords.google.com/support/aw/bin/answer.py?hl=en&answer=39454
+#
+# Tags: MediaService.get
+
+require 'rubygems'
+gem 'google-adwords-api'
+require 'adwords_api'
+
+API_VERSION = :v201003
+
+def get_all_videos()
+  # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
+  # when called without parameters.
+  adwords = AdwordsApi::Api.new
+  media_srv = adwords.service(:MediaService, API_VERSION)
+
+  # Get all the videos.
+  selector = {
+    :media_type => 'VIDEO'
+  }
+  response = media_srv.get(selector)
+  if response and response[:entries]
+    videos = response[:entries]
+    puts "#{videos.length} video(s) found."
+    videos.each do |video|
+      puts "  Video id is #{video[:media_id]} and name is \"#{video[:name]}\"."
+    end
+  else
+    puts "No videos found."
+  end
+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_videos()
+
+  # Connection error. Likely transitory.
+  rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
+    puts 'Connection Error: %s' % e
+    puts 'Source: %s' % e.backtrace.first
+
+  # API Error.
+  rescue AdwordsApi::Errors::ApiException => e
+    puts 'API Exception caught.'
+    puts 'Message: %s' % e.message
+    puts 'Code: %d' % e.code if e.code
+    puts 'Trigger: %s' % e.trigger if e.trigger
+    puts 'Errors:'
+    if e.errors
+      e.errors.each_with_index do |error, index|
+        puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
+        error.each_pair do |field, value|
+          if field != :xsi_type
+            puts '     %s: %s' % [field, value]
+          end
+        end
+      end
+    end
+  end
+end

data/examples/v201003/get_conversion_optimizer_eligibility.rb

@@ -0,0 +1,112 @@
+#!/usr/bin/ruby
+#
+# Author:: api.sgomes@gmail.com (Sérgio Gomes)
+#
+# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
+#
+# License:: Licensed under the Apache License, Version 2.0 (the "License");
+#           you may not use this file except in compliance with the License.
+#           You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#           Unless required by applicable law or agreed to in writing, software
+#           distributed under the License is distributed on an "AS IS" BASIS,
+#           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+#           implied.
+#           See the License for the specific language governing permissions and
+#           limitations under the License.
+#
+# This example shows how to check for conversion optimizer eligibility by
+# attempting to set the bidding transition with the validate only header set to
+# true.
+#
+# Tags: CampaignService.mutate
+
+require 'rubygems'
+gem 'google-adwords-api'
+require 'adwords_api'
+
+API_VERSION = :v201003
+
+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
+  campaign_srv = adwords.service(:CampaignService, API_VERSION)
+
+  campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
+
+  # Enable 'validate only'
+  adwords.validate_only = true
+
+  # Prepare for "updating" campaign.
+  operation = {
+    :operator => 'SET',
+    :operand => {
+      :id => campaign_id
+    },
+    # Bidding transition.
+    :bidding_transition => {
+      :xsi_type => 'ConversionOptimizerBiddingTransition',
+      :target_bidding_strategy => {
+        :xsi_type => 'ConversionOptimizer',
+        :pricing_model => 'CONVERSIONS'
+      },
+      # Ad group bids.
+      :explicit_ad_group_bids => {
+        :xsi_type => 'ConversionOptimizerAdGroupBids'
+      }
+    }
+  }
+
+  # Check that campaign is eligible for conversion optimization.
+  begin
+    response = campaign_srv.mutate([operation])
+    puts 'Campaign id %d is eligible to use conversion optimizer.' %
+        campaign[:id]
+  rescue AdwordsApi::Errors::ApiException => e
+    errors = e.errors
+    error = errors.find { |err| err[:xsi_type] == 'BiddingTransitionError'}
+    if error
+      puts "Campaign id #{campaign_id} is not eligible to use conversion " +
+          "optimizer due to reason: #{error[:reason]}"
+    else
+      raise e
+    end
+  end
+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()
+
+  # Connection error. Likely transitory.
+  rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
+    puts 'Connection Error: %s' % e
+    puts 'Source: %s' % e.backtrace.first
+
+  # API Error.
+  rescue AdwordsApi::Errors::ApiException => e
+    puts 'API Exception caught.'
+    puts 'Message: %s' % e.message
+    puts 'Code: %d' % e.code if e.code
+    puts 'Trigger: %s' % e.trigger if e.trigger
+    puts 'Errors:'
+    if e.errors
+      e.errors.each_with_index do |error, index|
+        puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
+        error.each_pair do |field, value|
+          if field != :xsi_type
+            puts '     %s: %s' % [field, value]
+          end
+        end
+      end
+    end
+  end
+end

data/examples/v201003/get_criterion_bid_landscape.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/ruby
+#
+# Author:: api.sgomes@gmail.com (Sérgio Gomes)
+#
+# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
+#
+# License:: Licensed under the Apache License, Version 2.0 (the "License");
+#           you may not use this file except in compliance with the License.
+#           You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#           Unless required by applicable law or agreed to in writing, software
+#           distributed under the License is distributed on an "AS IS" BASIS,
+#           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+#           implied.
+#           See the License for the specific language governing permissions and
+#           limitations under the License.
+#
+# This example gets a bid landscape for an ad group and a criterion. To get ad
+# groups, run get_all_ad_groups.rb. To get criteria, run
+# get_all_ad_group_criteria.rb.
+#
+# Tags: BidLandscapeService.getBidLandscape
+
+require 'rubygems'
+gem 'google-adwords-api'
+require 'adwords_api'
+
+API_VERSION = :v201003
+
+def get_criterion_bid_landscapes()
+  # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
+  # when called without parameters.
+  adwords = AdwordsApi::Api.new
+  bid_landscape_srv = adwords.service(:BidLandscapeService, API_VERSION)
+
+  ad_group_id = 'INSERT_ADGROUP_ID_HERE'.to_i
+  criterion_id = 'INSERT_CRITERION_ID_HERE'.to_i
+
+  # Get criterion bid landscape.
+  selector = {
+    # The 'xsi_type' field allows you to specify the xsi:type of the object
+    # being created. It's only necessary when you must provide an explicit
+    # type that the client library can't infer.
+    :xsi_type => 'CriterionBidLandscapeSelector',
+    :id_filters => [{
+      :ad_group_id => ad_group_id,
+      :criterion_id => criterion_id
+    }]
+  }
+  bid_landscapes = bid_landscape_srv.get_bid_landscape(selector)
+  if bid_landscapes
+    puts "#{bid_landscapes.length} bid landscape(s) retrieved."
+    bid_landscapes.each do |bid_landscape|
+      puts "Retrieved criterion bid landscape with ad group id " +
+          "'#{bid_landscape[:ad_group_id]}', criterion id " +
+          "'#{bid_landscape[:criterion_id]}', start date " +
+          "'#{bid_landscape[:start_date]}', end date "+
+          "'#{bid_landscape[:end_date]}', with landscape points:"
+      bid_landscape[:landscape_points].each do |point|
+        puts "  #{point[:bid][:micro_amount]} => clicks: #{point.clicks}, " +
+            "cost: #{point[:cost][:micro_amount]}, marginalCpc: " +
+            "#{point[:marginal_cpc][:micro_amount]}, impressions: " +
+            "#{point[:impressions]}"
+      end
+    end
+  else
+    puts "No bid landscapes retrieved."
+  end
+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_criterion_bid_landscapes()
+
+  # Connection error. Likely transitory.
+  rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
+    puts 'Connection Error: %s' % e
+    puts 'Source: %s' % e.backtrace.first
+
+  # API Error.
+  rescue AdwordsApi::Errors::ApiException => e
+    puts 'API Exception caught.'
+    puts 'Message: %s' % e.message
+    puts 'Code: %d' % e.code if e.code
+    puts 'Trigger: %s' % e.trigger if e.trigger
+    puts 'Errors:'
+    if e.errors
+      e.errors.each_with_index do |error, index|
+        puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
+        error.each_pair do |field, value|
+          if field != :xsi_type
+            puts '     %s: %s' % [field, value]
+          end
+        end
+      end
+    end
+  end
+end

data/examples/v201003/get_geo_location_info.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/ruby
+#
+# Author:: api.sgomes@gmail.com (Sérgio Gomes)
+#
+# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
+#
+# License:: Licensed under the Apache License, Version 2.0 (the "License");
+#           you may not use this file except in compliance with the License.
+#           You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#           Unless required by applicable law or agreed to in writing, software
+#           distributed under the License is distributed on an "AS IS" BASIS,
+#           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+#           implied.
+#           See the License for the specific language governing permissions and
+#           limitations under the License.
+#
+# This example illustrates how to retrieve geo location information for
+# addresses.
+#
+# Tags: GeoLocationService.get
+
+require 'rubygems'
+gem 'google-adwords-api'
+require 'adwords_api'
+
+API_VERSION = :v201003
+
+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
+  geo_location_srv = adwords.service(:GeoLocationService, API_VERSION)
+
+  selector = {
+    :addresses => [
+      {
+        :street_address => '1600 Amphitheatre Parkway',
+        :city_name => 'Mountain View',
+        :province_code => 'US-CA',
+        :province_name => 'California',
+        :postal_code => '94043',
+        :country_code => 'US'
+      },
+      {
+        :street_address => '76 Ninth Avenue',
+        :city_name => 'New York',
+        :province_code => 'US-NY',
+        :province_name => 'New York',
+        :postal_code => '10011',
+        :country_code => 'US'
+      },
+      {
+        :street_address => '五四大街1号, Beijing东城区',
+        :country_code => 'CN'
+      }
+    ]
+  }
+
+  # Get the geo location info for the various addresses.
+  locations = geo_location_srv.get(selector)
+
+  if locations
+    locations.each do |location|
+      puts "Address \"#{location[:address][:street_address]}\" has latitude " +
+          "#{location[:geo_point][:latitude_in_micro_degrees]} and " +
+          "longitude #{location[:geo_point][:longitude_in_micro_degrees]}."
+    end
+  else
+    puts "No geo locations were returned."
+  end
+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()
+
+  # Connection error. Likely transitory.
+  rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
+    puts 'Connection Error: %s' % e
+    puts 'Source: %s' % e.backtrace.first
+
+  # API Error.
+  rescue AdwordsApi::Errors::ApiException => e
+    puts 'API Exception caught.'
+    puts 'Message: %s' % e.message
+    puts 'Code: %d' % e.code if e.code
+    puts 'Trigger: %s' % e.trigger if e.trigger
+    puts 'Errors:'
+    if e.errors
+      e.errors.each_with_index do |error, index|
+        puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
+        error.each_pair do |field, value|
+          if field != :xsi_type
+            puts '     %s: %s' % [field, value]
+          end
+        end
+      end
+    end
+  end
+end