google-adwords-api 0.4.5 → 0.5.0

data/examples/v201101/get_geo_location_info.rb

@@ -1,99 +0,0 @@
-#!/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'
-require 'adwords_api'
-
-API_VERSION = :v201101
-
-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 = {
-    :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
-  begin
-    get_geo_location_info()
-
-  # HTTP errors.
-  rescue AdsCommon::Errors::HttpError => e
-    puts "HTTP Error: %s" % e
-
-  # API errors.
-  rescue AdwordsApi::Errors::ApiException => e
-    puts "Message: %s" % e.message
-    puts 'Errors:'
-    e.errors.each_with_index do |error, index|
-      puts "\tError [%d]:" % (index + 1)
-      error.each do |field, value|
-        puts "\t\t%s: %s" % [field, value]
-      end
-    end
-  end
-end

data/examples/v201101/get_keyword_opportunities.rb

@@ -1,95 +0,0 @@
-#!/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 reads all the keyword opportunities for the customer.
-#
-# Tags: BulkOpportunityService.get
-
-require 'rubygems'
-require 'adwords_api'
-require 'adwords_api/utils'
-
-API_VERSION = :v201101
-PAGE_SIZE = 20
-
-def get_keyword_opportunities()
-  # 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')
-
-  bulk_opportunity_srv = adwords.service(:BulkOpportunityService, API_VERSION)
-
-  # Construct selector object.
-  selector = {
-    :requested_attribute_types => ['KEYWORD', 'IDEA_TYPE'],
-    :paging => {
-      :start_index => 0,
-      :number_results => PAGE_SIZE
-    }
-  }
-
-  # Perform request.
-  ideas = []
-  index = 0
-  begin
-    page = bulk_opportunity_srv.get(selector)
-    if page and page[:entries]
-      page[:entries].each do |entry|
-        ideas += entry[:opportunity_ideas] if entry[:opportunity_ideas]
-      end
-    end
-    break if page[:total_num_entries] <= index
-    index += PAGE_SIZE
-    selector[:paging][:start_index] = index
-  end while page[:total_num_entries] > index
-
-  # Display results.
-  ideas.each do |idea|
-    data = AdwordsApi::Utils.map(idea[:data])
-    keyword = data['KEYWORD'][:value][:text]
-    idea_type = data['IDEA_TYPE'][:value]
-    puts " Found opportunity idea of type \"%s\": \"%s\"" % [idea_type, keyword]
-  end
-  puts "Total opportunity ideas: %d." % [ideas.length]
-end
-
-if __FILE__ == $0
-  begin
-    get_keyword_opportunities()
-
-  # HTTP errors.
-  rescue AdsCommon::Errors::HttpError => e
-    puts "HTTP Error: %s" % e
-
-  # API errors.
-  rescue AdwordsApi::Errors::ApiException => e
-    puts "Message: %s" % e.message
-    puts 'Errors:'
-    e.errors.each_with_index do |error, index|
-      puts "\tError [%d]:" % (index + 1)
-      error.each do |field, value|
-        puts "\t\t%s: %s" % [field, value]
-      end
-    end
-  end
-end

data/examples/v201101/get_method_cost.rb

@@ -1,87 +0,0 @@
-#!/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 the cost, in API units of operation,
-# of the given method, on a specified date.
-#
-# Tags: InfoService.get
-
-require 'rubygems'
-require 'adwords_api'
-
-API_VERSION = :v201101
-
-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
-  service_name = 'AdGroupService'
-  method_name = 'mutate'
-  operator = 'SET'
-
-  selector = {
-    :api_usage_type => 'METHOD_COST',
-    :service_name => service_name,
-    :method_name => method_name,
-    :operator => operator,
-    :date_range => {
-      :min => date.strftime('%Y%m%d'),
-      :max => date.strftime('%Y%m%d')
-    }
-  }
-
-  # Get the unit info.
-  adwords.use_mcc do
-    info = info_srv.get(selector)
-    if info
-      puts 'The cost of the %s.%s %s method during %s is %d.' %
-          [service_name, method_name, operator, selector[:date_range][:min],
-           info[:cost]]
-    end
-  end
-end
-
-if __FILE__ == $0
-  begin
-    get_method_cost()
-
-  # HTTP errors.
-  rescue AdsCommon::Errors::HttpError => e
-    puts "HTTP Error: %s" % e
-
-  # API errors.
-  rescue AdwordsApi::Errors::ApiException => e
-    puts "Message: %s" % e.message
-    puts 'Errors:'
-    e.errors.each_with_index do |error, index|
-      puts "\tError [%d]:" % (index + 1)
-      error.each do |field, value|
-        puts "\t\t%s: %s" % [field, value]
-      end
-    end
-  end
-end

data/examples/v201101/get_operation_count.rb

@@ -1,79 +0,0 @@
-#!/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 the number of operations recorded for
-# the developer token being used to make this call over the given date range.
-#
-# Tags: InfoService.get
-
-require 'rubygems'
-require 'adwords_api'
-
-API_VERSION = :v201101
-
-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 = {
-    :api_usage_type => 'OPERATION_COUNT',
-    :date_range => {
-      :min => Time.now.strftime('%Y%m01'),
-      :max => Time.now.strftime('%Y%m%d')
-    }
-  }
-
-  # Get the operation info.
-  adwords.use_mcc do
-    info = info_srv.get(selector)
-    if info
-      puts 'The total number of operations performed from %s to %s is %d.' %
-          [selector[:date_range][:min], selector[:date_range][:max],
-          info[:cost]]
-    end
-  end
-end
-
-if __FILE__ == $0
-  begin
-    get_operation_count()
-
-  # HTTP errors.
-  rescue AdsCommon::Errors::HttpError => e
-    puts "HTTP Error: %s" % e
-
-  # API errors.
-  rescue AdwordsApi::Errors::ApiException => e
-    puts "Message: %s" % e.message
-    puts 'Errors:'
-    e.errors.each_with_index do |error, index|
-      puts "\tError [%d]:" % (index + 1)
-      error.each do |field, value|
-        puts "\t\t%s: %s" % [field, value]
-      end
-    end
-  end
-end

data/examples/v201101/get_related_keywords.rb

@@ -1,108 +0,0 @@
-#!/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 retrieves keywords that are related to a given keyword.
-#
-# Tags: TargetingIdeaService.get
-
-require 'rubygems'
-require 'adwords_api'
-require 'adwords_api/utils'
-
-API_VERSION = :v201101
-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)
-
-  keyword_text = 'INSERT_KEYWORD_TEXT_HERE'
-
-  # Construct selector object.
-  selector = {
-    :idea_type => 'KEYWORD',
-    :request_type => 'IDEAS',
-    :requested_attribute_types => ['CRITERION'],
-    :search_parameters => [{
-      # 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 => 'RelatedToKeywordSearchParameter',
-      :keywords => [{
-        :text => keyword_text,
-        :match_type => 'EXACT'
-      }]
-    }],
-    :paging => {
-      :start_index => 0,
-      :number_results => PAGE_SIZE
-    }
-  }
-
-  # Define initial values.
-  offset = 0
-  results = []
-
-  begin
-    # Perform request.
-    page = targeting_idea_srv.get(selector)
-    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['CRITERION'][:value]
-    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
-  begin
-    get_related_keywords()
-
-  # HTTP errors.
-  rescue AdsCommon::Errors::HttpError => e
-    puts "HTTP Error: %s" % e
-
-  # API errors.
-  rescue AdwordsApi::Errors::ApiException => e
-    puts "Message: %s" % e.message
-    puts 'Errors:'
-    e.errors.each_with_index do |error, index|
-      puts "\tError [%d]:" % (index + 1)
-      error.each do |field, value|
-        puts "\t\t%s: %s" % [field, value]
-      end
-    end
-  end
-end