google-adwords-api 0.6.1 → 0.6.2

data/ChangeLog

@@ -1,3 +1,7 @@
+0.6.2:
+  - Require google-ads-common 0.7.3 or later from now on.
+  - Support for OAuth2.0 authentication method.
+
 0.6.1:
   - Require google-ads-common 0.7.1 or later from now on.
   - Updated User-Agent to a single standard.

data/adwords_api.yml

@@ -2,10 +2,24 @@
 # This is an example configuration file for the AdWords API client library.
 # Please fill in the required fields, and copy it over to your home directory.
 :authentication:
-  # Authentication method, methods currently supported: OAuth, ClientLogin.
+  # Authentication method, methods currently supported:
+  # OAuth2, OAuth, ClientLogin.
   :method: ClientLogin
 
-  # Auth parameters for OAuth method.
+  # Auth parameters for OAuth2.0 method.
+  # Set the OAuth2 client id and secret. Register your application here to
+  # obtain these values:
+  #   https://code.google.com/apis/console#access
+  #:oauth2_client_id: INSERT_OAUTH2_CLIENT_ID_HERE
+  #:oauth2_client_secret: INSERT_OAUTH2_CLIENT_SECRET_HERE
+  # Optional, see: https://developers.google.com/accounts/docs/OAuth2WebServer
+  #:oauth2_callback: INSERT_OAUTH2_CALLBACK_URL_HERE
+  #:oauth2_state: INSERT_OAUTH2_STATE_HERE
+  #:oauth2_access_type: INSERT_OAUTH2_ACCESS_TYPE_HERE
+  #:oauth2_approval_prompt: INSERT_OAUTH2_APPROVAL_PROMPT_HERE
+
+  # Auth parameters for OAuth1.0a method.
+  # NOTE: OAuth1.0a method is deprecated, use OAuth2.0 instead.
   # Set the OAuth consumer key and secret. Anonymous values can be used for
   # testing, and real values can be obtained by registering your application:
   # http://code.google.com/apis/accounts/docs/RegistrationForWebAppsAuto.html
@@ -19,6 +33,7 @@
   #:oauth_token_secret: INSERT_OAUTH_TOKEN_SECRET_HERE
 
   # Auth parameters for ClientLogin method.
+  # NOTE: ClientLogin method is deprecated, use OAuth2.0 instead.
   :password: INSERT_YOUR_PASSWORD_HERE
   :email: INSERT_YOUR_LOGIN_EMAIL_HERE
   # To manage your auth tokens manually, use the 'auth_token' property.

data/examples/v201109/misc/use_oauth.rb

@@ -18,7 +18,10 @@
 #           See the License for the specific language governing permissions and
 #           limitations under the License.
 #
-# This example illustrates how to use OAuth authentication method.
+# This example illustrates how to use OAuth1.0a authentication method.
+#
+# NOTE: OAuth1.0a authorization method is deprecated, use OAuth2.0 instead.
+#       See use_oauth2.rb for an example.
 #
 # Tags: CampaignService.get
 

data/examples/v201109/misc/use_oauth2.rb

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+# Encoding: utf-8
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2012, 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 use OAuth2.0 authentication method.
+#
+# Tags: CampaignService.get
+
+require 'adwords_api'
+
+def use_oauth2()
+  # 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.
+  selector = {
+    :fields => ['Id', 'Name', 'Status'],
+    :ordering => [
+      {:field => 'Name', :sort_order => 'ASCENDING'}
+    ]
+  }
+
+  retry_count = 0
+
+  begin
+    response = campaign_srv.get(selector)
+  rescue AdsCommon::Errors::OAuth2VerificationRequired => e
+    if retry_count < MAX_RETRIES
+      puts "Hit Auth error, please navigate to URL:\n\t%s" % e.oauth_url
+      print 'log in and type the verification code: '
+      verification_code = gets.chomp
+      adwords.credential_handler.set_credential(
+          :oauth2_verification_code, verification_code)
+      retry_count += 1
+      retry
+    else
+      raise AdsCommon::Errors::AuthError, 'Failed to authenticate.'
+    end
+  end
+
+  if response and response[:entries]
+    campaigns = response[:entries]
+    campaigns.each do |campaign|
+      puts "Campaign ID %d, name '%s' and status '%s'" %
+          [campaign[:id], campaign[:name], campaign[:status]]
+    end
+  else
+    puts 'No campaigns were found.'
+  end
+end
+
+if __FILE__ == $0
+  API_VERSION = :v201109
+  MAX_RETRIES = 3
+
+  begin
+    use_oauth2()
+
+  # 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/v201109_1/misc/use_oauth.rb

@@ -18,7 +18,10 @@
 #           See the License for the specific language governing permissions and
 #           limitations under the License.
 #
-# This example illustrates how to use OAuth authentication method.
+# This example illustrates how to use OAuth1.0a authentication method.
+#
+# NOTE: OAuth1.0a authorization method is deprecated, use OAuth2.0 instead.
+#       See use_oauth2.rb for an example.
 #
 # Tags: CampaignService.get
 

data/examples/v201109_1/misc/use_oauth2.rb

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+# Encoding: utf-8
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2012, 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 use OAuth2.0 authentication method.
+#
+# Tags: CampaignService.get
+
+require 'adwords_api'
+
+def use_oauth2()
+  # 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.
+  selector = {
+    :fields => ['Id', 'Name', 'Status'],
+    :ordering => [
+      {:field => 'Name', :sort_order => 'ASCENDING'}
+    ]
+  }
+
+  retry_count = 0
+
+  begin
+    response = campaign_srv.get(selector)
+  rescue AdsCommon::Errors::OAuth2VerificationRequired => e
+    if retry_count < MAX_RETRIES
+      puts "Hit Auth error, please navigate to URL:\n\t%s" % e.oauth_url
+      print 'log in and type the verification code: '
+      verification_code = gets.chomp
+      adwords.credential_handler.set_credential(
+          :oauth2_verification_code, verification_code)
+      retry_count += 1
+      retry
+    else
+      raise AdsCommon::Errors::AuthError, 'Failed to authenticate.'
+    end
+  end
+
+  if response and response[:entries]
+    campaigns = response[:entries]
+    campaigns.each do |campaign|
+      puts "Campaign ID %d, name '%s' and status '%s'" %
+          [campaign[:id], campaign[:name], campaign[:status]]
+    end
+  else
+    puts 'No campaigns were found.'
+  end
+end
+
+if __FILE__ == $0
+  API_VERSION = :v201109_1
+  MAX_RETRIES = 3
+
+  begin
+    use_oauth2()
+
+  # 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/lib/adwords_api.rb

@@ -67,7 +67,7 @@ module AdwordsApi
               version.to_s
           AdwordsApi::ClientLoginHeaderHandler.new(
               @credential_handler, auth_handler, namespace, auth_ns, version)
-        when :OAUTH
+        when :OAUTH, :OAUTH2
           AdsCommon::SavonHeaders::OAuthHeaderHandler.new(
               @credential_handler, auth_handler, namespace, version)
       end

data/lib/adwords_api/api_config.rb

@@ -20,8 +20,6 @@
 # Helper methods for loading and managing the available services in the AdWords
 # API.
 
-require 'savon'
-
 require 'ads_common/api_config'
 
 require 'adwords_api/version'

data/lib/adwords_api/client_login_header_handler.rb

@@ -34,7 +34,7 @@ module AdwordsApi
     #  - version: services version
     #
     def initialize(credential_handler, auth_handler, namespace, auth_namespace,
-        version)
+                   version)
       super(credential_handler, auth_handler, namespace, version)
       @auth_namespace = auth_namespace
     end
@@ -46,10 +46,9 @@ module AdwordsApi
     # Args:
     #  - request: a HTTPI Request for extra configuration (unused)
     #  - soap: a Savon soap object to fill fields in
-    #  - args: request parameters to adjust for namespaces
     #
     # Returns:
-    #  - Modified soap structure
+    #  - modified soap structure
     #
     def prepare_request(request, soap)
       super(request, soap)
@@ -57,6 +56,7 @@ module AdwordsApi
       header_name = prepend_namespace(get_header_element_name())
       soap.header[:attributes!][header_name] ||= {}
       soap.header[:attributes!][header_name]['xmlns'] = @auth_namespace
+      return soap
     end
 
     private

data/lib/adwords_api/credential_handler.rb

@@ -74,7 +74,7 @@ module AdwordsApi
     # Returns agent name and data for user-agent string generation.
     def get_user_agent_data(extra_ids)
       agent_app = @config.read('authentication.user_agent')
-      extra_ids << ["AwApi-Ruby/%s" % AdwordsApi::ApiConfig::CLIENT_LIB_VERSION]
+      extra_ids << ['AwApi-Ruby/%s' % AdwordsApi::ApiConfig::CLIENT_LIB_VERSION]
       return [extra_ids, agent_app]
     end
 

data/lib/adwords_api/errors.rb

@@ -31,7 +31,7 @@ module AdwordsApi
 
       def initialize(exception_fault)
         @array_fields ||= []
-        exception_fault.each {|key, value| set_field(key, value)}
+        exception_fault.each { |key, value| set_field(key, value) }
       end
 
       private

data/lib/adwords_api/report_header_handler.rb

@@ -52,7 +52,7 @@ module AdwordsApi
           'Authorization' =>
               @auth_handler.auth_string(credentials, HTTPI::Request.new(url)),
           'User-Agent' => @credential_handler.generate_http_user_agent(),
-          'clientCustomerId' => credentials[:client_customer_id],
+          'clientCustomerId' => credentials[:client_customer_id].to_s,
           'developerToken' => credentials[:developer_token]
       }
       money_in_micros = @config.read('library.return_money_in_micros')

data/lib/adwords_api/report_utils.rb

@@ -97,7 +97,7 @@ module AdwordsApi
     # Send POST request for a report and returns Response object.
     def get_report_response(report_definition, cid)
       definition_text = get_report_definition_text(report_definition)
-      data = "__rdxml=%s" % CGI.escape(definition_text)
+      data = '__rdxml=%s' % CGI.escape(definition_text)
       url = @api.api_config.adhoc_report_download_url(
           @api.config.read('service.environment'), @version)
       headers = get_report_request_headers(url, cid)
@@ -115,7 +115,7 @@ module AdwordsApi
         when Hash then report_definition_to_xml(report_definition)
         else
           raise AdwordsApi::Errors::InvalidReportDefinitionError,
-              "Unknown object for report definition: %s" %
+              'Unknown object for report definition: %s' %
               report_definition.class
       end
     end
@@ -136,8 +136,8 @@ module AdwordsApi
     def log_request(url, headers, body)
       logger = @api.logger
       logger.debug("Report request to: '%s'" % url)
-      logger.debug("HTTP headers: [%s]" %
-          (headers.map {|k, v| [k, v].join(': ')}.join(', ')))
+      logger.debug('HTTP headers: [%s]' %
+          (headers.map { |k, v| [k, v].join(': ') }.join(', ')))
       logger.debug(body)
     end
 
@@ -154,13 +154,13 @@ module AdwordsApi
         if matches
           message = (matches[3].nil?) ? data : matches[3]
           raise AdwordsApi::Errors::ReportError.new(response.code,
-              "Report download error occured: %s" % message)
+              'Report download error occured: %s' % message)
         end
       end
       # Check for error code.
       unless response.code == 200
         raise AdwordsApi::Errors::ReportError.new(response.code,
-            "Report download error occured, http code: %d, body: %s" %
+            'Report download error occured, http code: %d, body: %s' %
             [response.code, response.body])
       end
       return nil
@@ -202,7 +202,7 @@ module AdwordsApi
     # Adds fields order hint to generator based on specification.
     def add_report_definition_hash_order(node, name = :root)
       def_order = REPORT_DEFINITION_ORDER[name]
-      var_order = def_order.reject {|field| !node.include?(field)}
+      var_order = def_order.reject { |field| !node.include?(field) }
       node.keys.each do |key|
         if REPORT_DEFINITION_ORDER.include?(key)
           case node[key]

data/lib/adwords_api/utils.rb

@@ -21,8 +21,9 @@
 
 module AdwordsApi
   module Utils
+
     # Gets a map from an array of map entries. A map entry is any object that
-    # has a key and value field.
+    # has a key and value hash fields.
     #
     # Args:
     # - entries: list of map entries

data/lib/adwords_api/version.rb

@@ -21,6 +21,6 @@
 
 module AdwordsApi
   module ApiConfig
-    CLIENT_LIB_VERSION = '0.6.1'
+    CLIENT_LIB_VERSION = '0.6.2'
   end
 end

data/test/adwords_api/test_report_utils.rb

@@ -57,13 +57,13 @@ GZIPPED_REPORT = "\x1F\x8B\b\x00\x00\x00\x00\x00\x00\x00Sr.-.\xC9\xCFUptq\x0F\xF
 
 class TestReportUtils < Test::Unit::TestCase
   # Initialize tests.
-  def setup
+  def setup()
     @api = AdwordsApi::Api.new
     @report_utils = @api.report_utils(API_VERSION)
   end
 
   # Testing HTTP code 400.
-  def test_check_for_errors_400
+  def test_check_for_errors_400()
     REPLY_TYPES.each do |reply_type|
       begin
         response = ResponseStub.new(400, reply_type[:reply])
@@ -77,7 +77,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Testing HTTP code 500.
-  def test_check_for_errors_500
+  def test_check_for_errors_500()
     REPLY_TYPES.each do |reply_type|
       begin
         response = ResponseStub.new(500, nil)
@@ -90,7 +90,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Testing HTTP code 200 with success.
-  def test_check_for_errors_200_success
+  def test_check_for_errors_200_success()
     response = ResponseStub.new(200, VALID_REPORT)
     assert_nothing_raised do
       @report_utils.check_for_errors(response)
@@ -98,7 +98,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Testing HTTP code 200 with failure.
-  def test_check_for_errors_200_success
+  def test_check_for_errors_200_success()
     REPLY_TYPES.each do |reply_type|
       begin
         response = ResponseStub.new(200, reply_type[:reply])
@@ -112,7 +112,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Testing correct gzipped reply.
-  def test_gzipped_data
+  def test_gzipped_data()
     report = (RUBY_VERSION >= '1.9.1') ?
         GZIPPED_REPORT.force_encoding('UTF-8') : GZIPPED_REPORT
     response = ResponseStub.new(200, report)
@@ -122,7 +122,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Tests generated hash order for root (complete set).
-  def test_add_report_definition_hash_order_root1
+  def test_add_report_definition_hash_order_root1()
     node = {
       :include_zero_impressions => false,
       :download_format => 'CSV',
@@ -139,7 +139,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Tests generated hash order for root (incomplete set).
-  def test_add_report_definition_hash_order_root2
+  def test_add_report_definition_hash_order_root2()
     node = {
       :download_format => 'CSV',
       :report_type => 'CRITERIA_PERFORMANCE_REPORT',
@@ -155,7 +155,7 @@ class TestReportUtils < Test::Unit::TestCase
   end
 
   # Tests generated hash order for whole structure.
-  def test_add_report_definition_hash_order_deep
+  def test_add_report_definition_hash_order_deep()
     node = {
       :report_name => 'report_name',
       :report_type => 'CRITERIA_PERFORMANCE_REPORT',

data/test/adwords_api/test_utils.rb

@@ -25,7 +25,8 @@ require 'test/unit'
 require 'adwords_api/utils'
 
 class TestUtils < Test::Unit::TestCase
-  def test_map
+
+  def test_map()
     param1 = [
       {:key => 'foo', :value => 'bar'},
       {:key => 'baz', :value => 'zar'},
@@ -38,7 +39,7 @@ class TestUtils < Test::Unit::TestCase
     assert_equal(result2, AdwordsApi::Utils::map(param2))
   end
 
-  def test_operation_index_for_error
+  def test_operation_index_for_error()
     error1 = {:field_path => 'operations[0].operand.adGroupId'}
     assert_equal(0, AdwordsApi::Utils::operation_index_for_error(error1))
 
@@ -49,7 +50,7 @@ class TestUtils < Test::Unit::TestCase
     assert_equal(nil, AdwordsApi::Utils::operation_index_for_error(error3))
   end
 
-  def test_format_id
+  def test_format_id()
     assert_equal('123-456-7890', AdwordsApi::Utils::format_id(1234567890))
     assert_equal('234-567-8901', AdwordsApi::Utils::format_id('2345678901'))
     assert_equal('345-678-9012', AdwordsApi::Utils::format_id('345-678-9012'))

data/test/bugs/test_issue_00000031.rb

@@ -28,8 +28,9 @@ require 'adwords_api'
 require 'adwords_api/v201109/targeting_idea_service_registry'
 
 class TestIssue31 < Test::Unit::TestCase
-  def setup
-    @registry = AdwordsApi::V201109::TargetingIdeaService::TargetingIdeaServiceRegistry
+  def setup()
+    @registry =
+        AdwordsApi::V201109::TargetingIdeaService::TargetingIdeaServiceRegistry
   end
 
   def run_test(selector)
@@ -38,7 +39,7 @@ class TestIssue31 < Test::Unit::TestCase
     return Gyoku.xml(result_hash)
   end
 
-  def test_issue_31_single_xsi_type
+  def test_issue_31_single_xsi_type()
     selector = {
         :search_parameters => [
             {:xsi_type => 'KeywordMatchTypeSearchParameter',
@@ -52,7 +53,7 @@ class TestIssue31 < Test::Unit::TestCase
         'KeywordMatchTypeSearchParameter')
   end
 
-  def test_issue_31_multiple_xsi_types
+  def test_issue_31_multiple_xsi_types()
     selector = {
         :search_parameters => [
             {:xsi_type => 'AverageTargetedMonthlySearchesSearchParameter',

data/test/bugs/test_issue_00000063.rb

@@ -29,7 +29,7 @@ require 'adwords_api'
 require 'adwords_api/v201109_1/mutate_job_service_registry'
 
 class TestIssue63 < Test::Unit::TestCase
-  def setup
+  def setup()
     @registry =
         AdwordsApi::V201109_1::MutateJobService::MutateJobServiceRegistry
   end
@@ -40,21 +40,21 @@ class TestIssue63 < Test::Unit::TestCase
     return extractor.extract_result(data, :get_result)
   end
 
-  def test_issue_63_single_mutate_error
+  def test_issue_63_single_mutate_error()
     result = run_test(single_error_xml)
     errors = result[:simple_mutate_result][:errors]
     assert_kind_of(Array, errors)
     assert_equal(1, errors.size)
   end
 
-  def test_issue_63_multiple_mutate_errors
+  def test_issue_63_multiple_mutate_errors()
     result = run_test(multiple_errors_xml)
     errors = result[:simple_mutate_result][:errors]
     assert_kind_of(Array, errors)
     assert_equal(2, errors.size)
   end
 
-  def single_error_xml
+  def single_error_xml()
     return <<EOT
 <?xml version="1.0"?>
 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

data/test/suite_unittests.rb

@@ -27,8 +27,8 @@ $:.unshift File.expand_path('../../', __FILE__)
 
 # AdWords API units tests.
 adwords_mask = File.join(File.dirname(__FILE__), 'adwords_api', 'test_*.rb')
-Dir.glob(adwords_mask).each {|file| require file}
+Dir.glob(adwords_mask).each { |file| require file }
 
 # Reported bugs tests.
 bugs_mask = File.join(File.dirname(__FILE__), 'bugs', 'test_*.rb')
-Dir.glob(bugs_mask).each {|file| require file}
+Dir.glob(bugs_mask).each { |file| require file }

metadata

@@ -1,159 +1,48 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: google-adwords-api
-version: !ruby/object:Gem::Version
-  version: 0.6.1
+version: !ruby/object:Gem::Version 
+  hash: 3
   prerelease: 
+  segments: 
+  - 0
+  - 6
+  - 2
+  version: 0.6.2
 platform: ruby
-authors:
+authors: 
 - Danial Klimkin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-06 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: savon
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.9.9
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.9.9
-- !ruby/object:Gem::Dependency
+
+date: 2012-06-21 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: google-ads-common
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.7.1
-  type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.7.1
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 0
+        - 7
+        - 3
+        version: 0.7.3
+  type: :runtime
+  version_requirements: *id001
 description: google-adwords-api is a AdWords API client library for Ruby
-email:
+email: 
 - api.dklimkin@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
-- examples/v201109_1/reporting/download_criteria_report.rb
-- examples/v201109_1/reporting/get_defined_reports.rb
-- examples/v201109_1/reporting/get_campaign_stats.rb
-- examples/v201109_1/reporting/parallel_report_download.rb
-- examples/v201109_1/reporting/get_report_fields.rb
-- examples/v201109_1/error_handling/handle_policy_violation_error.rb
-- examples/v201109_1/error_handling/handle_two_factor_authorization_error.rb
-- examples/v201109_1/error_handling/handle_captcha_challenge.rb
-- examples/v201109_1/error_handling/handle_partial_failures.rb
-- examples/v201109_1/targeting/lookup_location.rb
-- examples/v201109_1/targeting/get_targetable_languages_and_carriers.rb
-- examples/v201109_1/targeting/add_campaign_targeting_criteria.rb
-- examples/v201109_1/targeting/get_campaign_targeting_criteria.rb
-- examples/v201109_1/campaign_management/validate_text_ad.rb
-- examples/v201109_1/campaign_management/add_experiment.rb
-- examples/v201109_1/campaign_management/set_ad_parameters.rb
-- examples/v201109_1/campaign_management/add_location_extension.rb
-- examples/v201109_1/campaign_management/add_keywords_in_bulk.rb
-- examples/v201109_1/campaign_management/promote_experiment.rb
-- examples/v201109_1/campaign_management/get_all_disapproved_ads.rb
-- examples/v201109_1/campaign_management/add_location_extension_override.rb
-- examples/v201109_1/account_management/get_account_hierarchy.rb
-- examples/v201109_1/account_management/get_account_changes.rb
-- examples/v201109_1/account_management/get_client_unit_usage.rb
-- examples/v201109_1/account_management/get_client_customer_id.rb
-- examples/v201109_1/account_management/get_account_alerts.rb
-- examples/v201109_1/account_management/create_account.rb
-- examples/v201109_1/optimization/estimate_keyword_traffic.rb
-- examples/v201109_1/optimization/get_keyword_bid_simulations.rb
-- examples/v201109_1/optimization/get_keyword_ideas.rb
-- examples/v201109_1/optimization/get_placement_ideas.rb
-- examples/v201109_1/basic_operations/update_campaign.rb
-- examples/v201109_1/basic_operations/get_campaigns.rb
-- examples/v201109_1/basic_operations/get_ad_groups.rb
-- examples/v201109_1/basic_operations/add_campaigns.rb
-- examples/v201109_1/basic_operations/delete_ad_group.rb
-- examples/v201109_1/basic_operations/delete_keyword.rb
-- examples/v201109_1/basic_operations/delete_ad.rb
-- examples/v201109_1/basic_operations/add_ad_groups.rb
-- examples/v201109_1/basic_operations/update_ad_group.rb
-- examples/v201109_1/basic_operations/get_keywords.rb
-- examples/v201109_1/basic_operations/delete_campaign.rb
-- examples/v201109_1/basic_operations/get_text_ads.rb
-- examples/v201109_1/basic_operations/add_keywords.rb
-- examples/v201109_1/basic_operations/add_text_ads.rb
-- examples/v201109_1/basic_operations/pause_ad.rb
-- examples/v201109_1/basic_operations/update_keyword.rb
-- examples/v201109_1/misc/upload_image.rb
-- examples/v201109_1/misc/get_all_images_and_videos.rb
-- examples/v201109_1/misc/use_oauth.rb
-- examples/v201109_1/remarketing/add_conversion_tracker.rb
-- examples/v201109_1/remarketing/add_audience.rb
-- examples/v201109/reporting/download_criteria_report.rb
-- examples/v201109/reporting/get_defined_reports.rb
-- examples/v201109/reporting/get_campaign_stats.rb
-- examples/v201109/reporting/parallel_report_download.rb
-- examples/v201109/reporting/get_report_fields.rb
-- examples/v201109/error_handling/handle_policy_violation_error.rb
-- examples/v201109/error_handling/handle_two_factor_authorization_error.rb
-- examples/v201109/error_handling/handle_captcha_challenge.rb
-- examples/v201109/error_handling/handle_partial_failures.rb
-- examples/v201109/targeting/lookup_location.rb
-- examples/v201109/targeting/get_targetable_languages_and_carriers.rb
-- examples/v201109/targeting/add_campaign_targeting_criteria.rb
-- examples/v201109/targeting/get_campaign_targeting_criteria.rb
-- examples/v201109/campaign_management/validate_text_ad.rb
-- examples/v201109/campaign_management/add_experiment.rb
-- examples/v201109/campaign_management/set_ad_parameters.rb
-- examples/v201109/campaign_management/add_location_extension.rb
-- examples/v201109/campaign_management/add_keywords_in_bulk.rb
-- examples/v201109/campaign_management/promote_experiment.rb
-- examples/v201109/campaign_management/get_all_disapproved_ads.rb
-- examples/v201109/campaign_management/add_location_extension_override.rb
-- examples/v201109/account_management/get_account_hierarchy.rb
-- examples/v201109/account_management/get_account_changes.rb
-- examples/v201109/account_management/get_client_unit_usage.rb
-- examples/v201109/account_management/get_client_customer_id.rb
-- examples/v201109/account_management/get_account_alerts.rb
-- examples/v201109/account_management/create_account.rb
-- examples/v201109/optimization/estimate_keyword_traffic.rb
-- examples/v201109/optimization/get_keyword_bid_simulations.rb
-- examples/v201109/optimization/get_keyword_ideas.rb
-- examples/v201109/optimization/get_placement_ideas.rb
-- examples/v201109/basic_operations/update_campaign.rb
-- examples/v201109/basic_operations/get_campaigns.rb
-- examples/v201109/basic_operations/get_ad_groups.rb
-- examples/v201109/basic_operations/add_campaigns.rb
-- examples/v201109/basic_operations/delete_ad_group.rb
-- examples/v201109/basic_operations/delete_keyword.rb
-- examples/v201109/basic_operations/delete_ad.rb
-- examples/v201109/basic_operations/add_ad_groups.rb
-- examples/v201109/basic_operations/update_ad_group.rb
-- examples/v201109/basic_operations/get_keywords.rb
-- examples/v201109/basic_operations/delete_campaign.rb
-- examples/v201109/basic_operations/get_text_ads.rb
-- examples/v201109/basic_operations/add_keywords.rb
-- examples/v201109/basic_operations/add_text_ads.rb
-- examples/v201109/basic_operations/pause_ad.rb
-- examples/v201109/basic_operations/update_keyword.rb
-- examples/v201109/misc/upload_image.rb
-- examples/v201109/misc/get_all_images_and_videos.rb
-- examples/v201109/misc/use_oauth.rb
-- examples/v201109/remarketing/add_conversion_tracker.rb
-- examples/v201109/remarketing/add_audience.rb
+
+files: 
 - lib/adwords_api/utils.rb
 - lib/adwords_api/version.rb
 - lib/adwords_api/report_utils.rb
@@ -306,33 +195,150 @@ files:
 - test/adwords_api/test_credential_handler.rb
 - test/adwords_api/test_api_config.rb
 - test/adwords_api/test_utils.rb
+- examples/v201109_1/reporting/download_criteria_report.rb
+- examples/v201109_1/reporting/get_defined_reports.rb
+- examples/v201109_1/reporting/get_campaign_stats.rb
+- examples/v201109_1/reporting/parallel_report_download.rb
+- examples/v201109_1/reporting/get_report_fields.rb
+- examples/v201109_1/error_handling/handle_policy_violation_error.rb
+- examples/v201109_1/error_handling/handle_two_factor_authorization_error.rb
+- examples/v201109_1/error_handling/handle_captcha_challenge.rb
+- examples/v201109_1/error_handling/handle_partial_failures.rb
+- examples/v201109_1/targeting/lookup_location.rb
+- examples/v201109_1/targeting/get_targetable_languages_and_carriers.rb
+- examples/v201109_1/targeting/add_campaign_targeting_criteria.rb
+- examples/v201109_1/targeting/get_campaign_targeting_criteria.rb
+- examples/v201109_1/campaign_management/validate_text_ad.rb
+- examples/v201109_1/campaign_management/add_experiment.rb
+- examples/v201109_1/campaign_management/set_ad_parameters.rb
+- examples/v201109_1/campaign_management/add_location_extension.rb
+- examples/v201109_1/campaign_management/add_keywords_in_bulk.rb
+- examples/v201109_1/campaign_management/promote_experiment.rb
+- examples/v201109_1/campaign_management/get_all_disapproved_ads.rb
+- examples/v201109_1/campaign_management/add_location_extension_override.rb
+- examples/v201109_1/account_management/get_account_hierarchy.rb
+- examples/v201109_1/account_management/get_account_changes.rb
+- examples/v201109_1/account_management/get_client_unit_usage.rb
+- examples/v201109_1/account_management/get_client_customer_id.rb
+- examples/v201109_1/account_management/get_account_alerts.rb
+- examples/v201109_1/account_management/create_account.rb
+- examples/v201109_1/optimization/estimate_keyword_traffic.rb
+- examples/v201109_1/optimization/get_keyword_bid_simulations.rb
+- examples/v201109_1/optimization/get_keyword_ideas.rb
+- examples/v201109_1/optimization/get_placement_ideas.rb
+- examples/v201109_1/basic_operations/update_campaign.rb
+- examples/v201109_1/basic_operations/get_campaigns.rb
+- examples/v201109_1/basic_operations/get_ad_groups.rb
+- examples/v201109_1/basic_operations/add_campaigns.rb
+- examples/v201109_1/basic_operations/delete_ad_group.rb
+- examples/v201109_1/basic_operations/delete_keyword.rb
+- examples/v201109_1/basic_operations/delete_ad.rb
+- examples/v201109_1/basic_operations/add_ad_groups.rb
+- examples/v201109_1/basic_operations/update_ad_group.rb
+- examples/v201109_1/basic_operations/get_keywords.rb
+- examples/v201109_1/basic_operations/delete_campaign.rb
+- examples/v201109_1/basic_operations/get_text_ads.rb
+- examples/v201109_1/basic_operations/add_keywords.rb
+- examples/v201109_1/basic_operations/add_text_ads.rb
+- examples/v201109_1/basic_operations/pause_ad.rb
+- examples/v201109_1/basic_operations/update_keyword.rb
+- examples/v201109_1/misc/upload_image.rb
+- examples/v201109_1/misc/get_all_images_and_videos.rb
+- examples/v201109_1/misc/use_oauth.rb
+- examples/v201109_1/misc/use_oauth2.rb
+- examples/v201109_1/remarketing/add_conversion_tracker.rb
+- examples/v201109_1/remarketing/add_audience.rb
+- examples/v201109/reporting/download_criteria_report.rb
+- examples/v201109/reporting/get_defined_reports.rb
+- examples/v201109/reporting/get_campaign_stats.rb
+- examples/v201109/reporting/parallel_report_download.rb
+- examples/v201109/reporting/get_report_fields.rb
+- examples/v201109/error_handling/handle_policy_violation_error.rb
+- examples/v201109/error_handling/handle_two_factor_authorization_error.rb
+- examples/v201109/error_handling/handle_captcha_challenge.rb
+- examples/v201109/error_handling/handle_partial_failures.rb
+- examples/v201109/targeting/lookup_location.rb
+- examples/v201109/targeting/get_targetable_languages_and_carriers.rb
+- examples/v201109/targeting/add_campaign_targeting_criteria.rb
+- examples/v201109/targeting/get_campaign_targeting_criteria.rb
+- examples/v201109/campaign_management/validate_text_ad.rb
+- examples/v201109/campaign_management/add_experiment.rb
+- examples/v201109/campaign_management/set_ad_parameters.rb
+- examples/v201109/campaign_management/add_location_extension.rb
+- examples/v201109/campaign_management/add_keywords_in_bulk.rb
+- examples/v201109/campaign_management/promote_experiment.rb
+- examples/v201109/campaign_management/get_all_disapproved_ads.rb
+- examples/v201109/campaign_management/add_location_extension_override.rb
+- examples/v201109/account_management/get_account_hierarchy.rb
+- examples/v201109/account_management/get_account_changes.rb
+- examples/v201109/account_management/get_client_unit_usage.rb
+- examples/v201109/account_management/get_client_customer_id.rb
+- examples/v201109/account_management/get_account_alerts.rb
+- examples/v201109/account_management/create_account.rb
+- examples/v201109/optimization/estimate_keyword_traffic.rb
+- examples/v201109/optimization/get_keyword_bid_simulations.rb
+- examples/v201109/optimization/get_keyword_ideas.rb
+- examples/v201109/optimization/get_placement_ideas.rb
+- examples/v201109/basic_operations/update_campaign.rb
+- examples/v201109/basic_operations/get_campaigns.rb
+- examples/v201109/basic_operations/get_ad_groups.rb
+- examples/v201109/basic_operations/add_campaigns.rb
+- examples/v201109/basic_operations/delete_ad_group.rb
+- examples/v201109/basic_operations/delete_keyword.rb
+- examples/v201109/basic_operations/delete_ad.rb
+- examples/v201109/basic_operations/add_ad_groups.rb
+- examples/v201109/basic_operations/update_ad_group.rb
+- examples/v201109/basic_operations/get_keywords.rb
+- examples/v201109/basic_operations/delete_campaign.rb
+- examples/v201109/basic_operations/get_text_ads.rb
+- examples/v201109/basic_operations/add_keywords.rb
+- examples/v201109/basic_operations/add_text_ads.rb
+- examples/v201109/basic_operations/pause_ad.rb
+- examples/v201109/basic_operations/update_keyword.rb
+- examples/v201109/misc/upload_image.rb
+- examples/v201109/misc/get_all_images_and_videos.rb
+- examples/v201109/misc/use_oauth.rb
+- examples/v201109/misc/use_oauth2.rb
+- examples/v201109/remarketing/add_conversion_tracker.rb
+- examples/v201109/remarketing/add_audience.rb
 - COPYING
 - README
 - ChangeLog
 - adwords_api.yml
 homepage: http://code.google.com/p/google-api-ads-ruby/
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
       version: 1.3.6
 requirements: []
+
 rubyforge_project: google-adwords-api
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Ruby Client libraries for AdWords API
-test_files:
+test_files: 
 - test/suite_unittests.rb