sem4r 0.1.1

data/lib/sem4r/v13_traffic_estimator/traffic_estimator_service.rb

@@ -0,0 +1,30 @@
+# -------------------------------------------------------------------
+# Copyright (c) 2009-2010 Sem4r sem4ruby@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# -------------------------------------------------------------------
+
+module Sem4r
+  class TrafficEstimatorService
+    def initialize
+    
+    end
+  end
+end

data/lib/sem4r.rb

@@ -0,0 +1,142 @@
+# -------------------------------------------------------------------
+# Copyright (c) 2009-2010 Sem4r sem4ruby@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# -------------------------------------------------------------------
+
+require 'yaml'
+require 'pathname'
+require 'rubygems'
+require 'builder'
+require 'rexml/document'
+require 'uri'
+require 'pp'
+require 'logger'
+require 'fileutils'
+
+module Sem4r #:nodoc:
+  def self.version
+    cwd = Pathname(__FILE__).dirname.expand_path.to_s
+    yaml = YAML.load_file(cwd + '/../VERSION.yml')
+    major = (yaml['major'] || yaml[:major]).to_i
+    minor = (yaml['minor'] || yaml[:minor]).to_i
+    patch = (yaml['patch'] || yaml[:patch]).to_i
+    "#{major}.#{minor}.#{patch}"
+  end
+end
+
+cwd = Pathname(__FILE__).dirname
+$:.unshift(cwd.to_s) unless $:.include?(cwd.to_s) || $:.include?(cwd.expand_path.to_s)
+
+require 'sem4r/extensions.rb'
+
+require 'sem4r/adwords'
+require 'sem4r/credentials'
+require 'sem4r/sem4r_error'
+require 'sem4r/soap_attributes'
+
+require 'sem4r/base'
+require 'sem4r/account'
+
+
+#
+# soap connection layer
+#
+require 'sem4r/services/soap_error'
+require 'sem4r/services/soap_connector'
+require 'sem4r/services/soap_message_v13'
+require 'sem4r/services/soap_message_v2009'
+require 'sem4r/services/soap_call'
+require 'sem4r/services/service'
+
+#
+# common
+#
+require 'sem4r/common/operation'
+
+#
+# adgroup
+#
+require 'sem4r/ad_group/ad_group_bids'
+require 'sem4r/ad_group/mobile_ad_image'
+require 'sem4r/ad_group/ad_group'
+
+#
+# adgroup_ad
+#
+require 'sem4r/ad_group_ad/ad_group_ad_operations'
+require 'sem4r/ad_group_ad/ad_group_ad'
+require 'sem4r/ad_group_ad/ad_group_text_ad'
+require 'sem4r/ad_group_ad/ad_group_mobile_ad'
+
+#
+# adgroup_criterion
+#
+require 'sem4r/ad_group_criterion/ad_group_criterion_bids'
+require 'sem4r/ad_group_criterion/ad_group_criterion_operations'
+require 'sem4r/ad_group_criterion/criterion'
+require 'sem4r/ad_group_criterion/criterion_keyword'
+require 'sem4r/ad_group_criterion/criterion_placement'
+require 'sem4r/ad_group_criterion/ad_group_criterion'
+
+#
+# ad_param
+#
+require 'sem4r/ad_param/ad_param'
+require 'sem4r/ad_param/ad_param_operation'
+
+#
+# bulk_mutate_job
+#
+require 'sem4r/bulk_mutate_job/job_operations'
+require 'sem4r/bulk_mutate_job/bulk_mutate_job_selector'
+require 'sem4r/bulk_mutate_job/bulk_mutate_job'
+
+#
+# campaign
+#
+require 'sem4r/campaign/campaign'
+
+
+#
+# targeting_idea
+#
+require 'sem4r/targeting_idea/targeting_idea'
+require 'sem4r/targeting_idea/targeting_idea_selector'
+
+#
+# v13_account
+#
+require 'sem4r/v13_account/billing_address'
+
+#
+# v13_report
+#
+require 'sem4r/v13_report/report'
+require 'sem4r/v13_report/report_job'
+
+
+#
+# report_definition
+#
+require 'sem4r/report_definition/report_definition'
+require 'sem4r/report_definition/report_definition_selector'
+require 'sem4r/report_definition/report_definition_operation'
+

data/lib/sem4r_cli.rb

@@ -0,0 +1,40 @@
+# -------------------------------------------------------------------
+# Copyright (c) 2009-2010 Sem4r sem4ruby@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# -------------------------------------------------------------------
+
+require 'optparse'
+require 'ostruct'
+# require "highline/import" # to ask password on command line
+
+require 'sem4r'
+require 'sem4r/cli/cli_sem'
+require 'sem4r/cli/cli_common_args'
+require 'sem4r/cli/cli_command'
+require 'sem4r/cli/cli_helpers'
+
+# commands
+require 'sem4r/cli/cli_commands'
+require 'sem4r/cli/cli_download_report'
+require 'sem4r/cli/cli_ideas'
+require 'sem4r/cli/cli_list_ads'
+require 'sem4r/cli/cli_list_keywords'
+require 'sem4r/cli/cli_request_report'

data/sem4r.gemspec

@@ -0,0 +1,247 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{sem4r}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Sem4r"]
+  s.date = %q{2010-06-19}
+  s.default_executable = %q{sem}
+  s.description = %q{
+       Sem4r is a library to access google adwords api.
+       It will works with ruby 1.9 and ruby 1.8 without soap4r.
+       It uses a high level model instead of a low level api.
+       You think about clients, campaigns, keywords and not about operations, operands, selectors, service calls.
+
+       This is a ALPHA version don't use in production.
+       If you are interested in this project let me now: install it and update periodically, so the gemcutter
+       download counter go up. Or subscribe to my feed at sem4r.com. Or watch the project on github.
+       Or simply drop me a line in email. However I will know there is someone out of here.
+    }
+  s.email = %q{sem4ruby@gmail.com}
+  s.executables = ["sem"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "config/sem4r.example.yml",
+     "examples_blog/2009-11-29-hello-world.rb",
+     "examples_blog/2009-12-12-create-campaign.rb",
+     "examples_blog/2010-02-06-constants-scope.rb",
+     "examples_blog/2010-02-07-ad-parameters.rb",
+     "examples_sem4r/01_get_account.rb",
+     "examples_sem4r/02_get_info.rb",
+     "examples_sem4r/03_list_ad.rb",
+     "examples_sem4r/04_list_keywords.rb",
+     "examples_sem4r/05_request_report.rb",
+     "examples_sem4r/06_create_campaigns.rb",
+     "examples_sem4r/07_create_campaigns_block.rb",
+     "examples_sem4r/07_create_campaigns_simple.rb",
+     "examples_sem4r/08_ad_params.rb",
+     "examples_sem4r/09_targeting_idea.rb",
+     "examples_sem4r/10_get_location.rb",
+     "examples_sem4r/11_submit_bulk_job.rb",
+     "examples_sem4r/12_list_bulk_job.rb",
+     "examples_sem4r/30_prune_empty_adgroup.rb",
+     "examples_sem4r/31_empty_accounts.rb",
+     "examples_sem4r/example_helper.rb",
+     "lib/sem4r.rb",
+     "lib/sem4r/account.rb",
+     "lib/sem4r/ad_extension_override/ad_extension_override_service.rb",
+     "lib/sem4r/ad_group/ad_group.rb",
+     "lib/sem4r/ad_group/ad_group_bids.rb",
+     "lib/sem4r/ad_group/ad_group_service.rb",
+     "lib/sem4r/ad_group/mobile_ad_image.rb",
+     "lib/sem4r/ad_group_ad/ad_group_ad.rb",
+     "lib/sem4r/ad_group_ad/ad_group_ad_operations.rb",
+     "lib/sem4r/ad_group_ad/ad_group_ad_service.rb",
+     "lib/sem4r/ad_group_ad/ad_group_mobile_ad.rb",
+     "lib/sem4r/ad_group_ad/ad_group_text_ad.rb",
+     "lib/sem4r/ad_group_criterion/ad_group_criterion.rb",
+     "lib/sem4r/ad_group_criterion/ad_group_criterion_bids.rb",
+     "lib/sem4r/ad_group_criterion/ad_group_criterion_operations.rb",
+     "lib/sem4r/ad_group_criterion/ad_group_criterion_service.rb",
+     "lib/sem4r/ad_group_criterion/criterion.rb",
+     "lib/sem4r/ad_group_criterion/criterion_keyword.rb",
+     "lib/sem4r/ad_group_criterion/criterion_placement.rb",
+     "lib/sem4r/ad_param/ad_param.rb",
+     "lib/sem4r/ad_param/ad_param_operation.rb",
+     "lib/sem4r/ad_param/ad_param_service.rb",
+     "lib/sem4r/adwords.rb",
+     "lib/sem4r/api_counters.rb",
+     "lib/sem4r/base.rb",
+     "lib/sem4r/bulk_mutate_job/bulk_mutate_job.rb",
+     "lib/sem4r/bulk_mutate_job/bulk_mutate_job_selector.rb",
+     "lib/sem4r/bulk_mutate_job/bulk_mutate_job_service.rb",
+     "lib/sem4r/bulk_mutate_job/job_operations.rb",
+     "lib/sem4r/campaign/campaign.rb",
+     "lib/sem4r/campaign/campaign_service.rb",
+     "lib/sem4r/campaign_criterion/campaign_criterion_service.rb",
+     "lib/sem4r/campaign_target/campaign_target_service.rb",
+     "lib/sem4r/cli/cli_command.rb",
+     "lib/sem4r/cli/cli_commands.rb",
+     "lib/sem4r/cli/cli_common_args.rb",
+     "lib/sem4r/cli/cli_download_report.rb",
+     "lib/sem4r/cli/cli_helpers.rb",
+     "lib/sem4r/cli/cli_ideas.rb",
+     "lib/sem4r/cli/cli_list_ads.rb",
+     "lib/sem4r/cli/cli_list_keywords.rb",
+     "lib/sem4r/cli/cli_request_report.rb",
+     "lib/sem4r/cli/cli_sem.rb",
+     "lib/sem4r/common/operation.rb",
+     "lib/sem4r/credentials.rb",
+     "lib/sem4r/extensions.rb",
+     "lib/sem4r/geo_location/geo_location_service.rb",
+     "lib/sem4r/info/info_service.rb",
+     "lib/sem4r/sem4r_error.rb",
+     "lib/sem4r/services/service.rb",
+     "lib/sem4r/services/soap_call.rb",
+     "lib/sem4r/services/soap_connector.rb",
+     "lib/sem4r/services/soap_error.rb",
+     "lib/sem4r/services/soap_message_v13.rb",
+     "lib/sem4r/services/soap_message_v2009.rb",
+     "lib/sem4r/soap_attributes.rb",
+     "lib/sem4r/targeting_idea/targeting_idea.rb",
+     "lib/sem4r/targeting_idea/targeting_idea_selector.rb",
+     "lib/sem4r/targeting_idea/targeting_idea_service.rb",
+     "lib/sem4r/v13_account/account_service.rb",
+     "lib/sem4r/v13_account/billing_address.rb",
+     "lib/sem4r/v13_report/report.rb",
+     "lib/sem4r/v13_report/report_job.rb",
+     "lib/sem4r/v13_report/report_service.rb",
+     "lib/sem4r/v13_traffic_estimator/traffic_estimator_service.rb",
+     "lib/sem4r_cli.rb",
+     "sem4r.gemspec"
+  ]
+  s.homepage = %q{http://www.sem4r.com}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Library to access google adwords api. Works with ruby 1.9 and ruby 1.8}
+  s.test_files = [
+    "spec/sem4r/services/soap_message_v13_spec.rb",
+     "spec/sem4r/services/soap_call_spec.rb",
+     "spec/sem4r/services/service_spec.rb",
+     "spec/sem4r/v13_report/report_spec.rb",
+     "spec/sem4r/v13_report/report_service_spec.rb",
+     "spec/sem4r/credentials_spec.rb",
+     "spec/sem4r/adwords_spec.rb",
+     "spec/sem4r/soap_attributes_spec.rb",
+     "spec/sem4r/rexml_parsing_spec.rb",
+     "spec/sem4r/cli/cli_spec.rb",
+     "spec/sem4r/ad_group_criterion/ad_group_criterion_bids_spec.rb",
+     "spec/sem4r/ad_group_criterion/ad_group_criterion_spec.rb",
+     "spec/sem4r/ad_group_criterion/criterion_spec.rb",
+     "spec/sem4r/ad_group_criterion/ad_group_criterion_service_spec.rb",
+     "spec/sem4r/ad_group/ad_group_bids_spec.rb",
+     "spec/sem4r/ad_group/ad_group_spec.rb",
+     "spec/sem4r/ad_group/ad_group_service_spec.rb",
+     "spec/sem4r/ad_group_ad/ad_group_ad_spec.rb",
+     "spec/sem4r/ad_group_ad/ad_group_ad_operation_spec.rb",
+     "spec/sem4r/ad_group_ad/ad_group_ad_service_spec.rb",
+     "spec/sem4r/account_spec.rb",
+     "spec/sem4r/ad_param/ad_param_spec.rb",
+     "spec/sem4r/ad_param/ad_param_service_spec.rb",
+     "spec/sem4r/bulk_mutate_job/bulk_mutate_job_spec.rb",
+     "spec/sem4r/bulk_mutate_job/job_operation_spec.rb",
+     "spec/sem4r/bulk_mutate_job/bulk_mutate_job_service_spec.rb",
+     "spec/sem4r/campaign/campaign_spec.rb",
+     "spec/sem4r/campaign/campaign_service_spec.rb",
+     "spec/sem4r/targeting_idea/targeting_idea_selector_spec.rb",
+     "spec/sem4r/targeting_idea/targeting_idea_spec.rb",
+     "spec/sem4r/targeting_idea/targeting_idea_service_spec.rb",
+     "spec/sem4r/v13_account/account_service_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/sem4r_spec_helper.rb",
+     "spec/aggregates_spec_helper.rb",
+     "spec/fixtures/sem4r.example.yml",
+     "spec/fixtures/services",
+     "spec/fixtures/services/ad_group",
+     "spec/fixtures/services/ad_group/mutate_add-req.xml",
+     "spec/fixtures/services/ad_group/get-first-req.xml",
+     "spec/fixtures/services/ad_group/mutate_add-res.xml",
+     "spec/fixtures/services/ad_group/get-first-res.xml",
+     "spec/fixtures/services/ad_group/get-manual-cpm-bids-res.xml",
+     "spec/fixtures/services/ad_group/get-manual-cpm-bids-req.xml",
+     "spec/fixtures/services/v13_report",
+     "spec/fixtures/services/v13_report/get_all_jobs-req.xml",
+     "spec/fixtures/services/v13_report/get_all_jobs-res.xml",
+     "spec/fixtures/services/v13_report/schedule_report_job-req.xml",
+     "spec/fixtures/services/v13_report/schedule_report_job-res.xml",
+     "spec/fixtures/services/bulk_mutate_job",
+     "spec/fixtures/services/bulk_mutate_job/get-res.xml",
+     "spec/fixtures/services/bulk_mutate_job/get-req.xml",
+     "spec/fixtures/services/bulk_mutate_job/mutate-res.xml",
+     "spec/fixtures/services/bulk_mutate_job/mutate-req.xml",
+     "spec/fixtures/services/ad_param",
+     "spec/fixtures/services/ad_param/mutate_set-res.xml",
+     "spec/fixtures/services/ad_param/mutate_set-req.xml",
+     "spec/fixtures/services/campaign",
+     "spec/fixtures/services/campaign/get-res.xml",
+     "spec/fixtures/services/campaign/mutate_add-req.xml",
+     "spec/fixtures/services/campaign/mutate_add-res.xml",
+     "spec/fixtures/services/campaign/get-req.xml",
+     "spec/fixtures/services/info",
+     "spec/fixtures/services/info/get_unit_count-req.xml",
+     "spec/fixtures/services/info/get_unit_count-res.xml",
+     "spec/fixtures/services/error.xml",
+     "spec/fixtures/services/ad_group_ad",
+     "spec/fixtures/services/ad_group_ad/get_text_ad-res.xml",
+     "spec/fixtures/services/ad_group_ad/mutate_add_text_ad-res.xml",
+     "spec/fixtures/services/ad_group_ad/get_mobile_ad-req.xml",
+     "spec/fixtures/services/ad_group_ad/mutate_add_text_ad-req.xml",
+     "spec/fixtures/services/ad_group_ad/mutate_add_mobile_ad-res.xml",
+     "spec/fixtures/services/ad_group_ad/mutate_add_mobile_ad-req.xml",
+     "spec/fixtures/services/ad_group_ad/get_text_ad-req.xml",
+     "spec/fixtures/services/ad_group_ad/get_mobile_ad-res.xml",
+     "spec/fixtures/services/ad_group_ad/mutate_add_two_criterions-req.xml",
+     "spec/fixtures/services/ad_group_ad/mutate_add_two_criterions-res.xml",
+     "spec/fixtures/services/v13_account",
+     "spec/fixtures/services/v13_account/get_account_info-req.xml",
+     "spec/fixtures/services/v13_account/get_account_info-res.xml",
+     "spec/fixtures/services/v13_account/get_client_accounts-res.xml",
+     "spec/fixtures/services/v13_account/get_client_accounts-req.xml",
+     "spec/fixtures/services/ad_group_criterion",
+     "spec/fixtures/services/ad_group_criterion/mutate_add_criterion_placement-res.xml",
+     "spec/fixtures/services/ad_group_criterion/mutate_add_criterion_placement-req.xml",
+     "spec/fixtures/services/ad_group_criterion/get-res.xml",
+     "spec/fixtures/services/ad_group_criterion/mutate_add_criterion_keyword-res.xml",
+     "spec/fixtures/services/ad_group_criterion/get-req.xml",
+     "spec/fixtures/services/ad_group_criterion/mutate_add_criterion_keyword-req.xml",
+     "spec/fixtures/services/ad_group_criterion/mutate_add_negative_keyword-res.xml",
+     "spec/fixtures/services/ad_group_criterion/mutate_add_negative_keyword-req.xml",
+     "spec/fixtures/services/targeting_idea",
+     "spec/fixtures/services/targeting_idea/get-req.xml",
+     "spec/fixtures/services/targeting_idea/get-res.xml",
+     "spec/fixtures/services/targeting_idea/get-req-all-options.xml"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<differ>, [">= 0"])
+    else
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<differ>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<differ>, [">= 0"])
+  end
+end
+

data/spec/aggregates_spec_helper.rb

@@ -0,0 +1,59 @@
+# -------------------------------------------------------------------------
+# Copyright (c) 2009-2010 Sem4r sem4ruby@gmail.com
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# 
+# -------------------------------------------------------------------------
+
+module AggregatesSpecHelper
+  def create_bulk_mutate_job(campaign, adgroup)
+    # TextAd
+    text_ad1 = AdGroupTextAd.new(adgroup)
+    text_ad1.headline     = "Cruise to Mars Sector 1"
+    text_ad1.description1 = "Visit the Red Planet in style."
+    text_ad1.description2 = "Low-gravity fun for everyone!"
+    text_ad1.url          = "http://www.example.com"
+    text_ad1.display_url  = "www.example.com"
+
+    # TextAd
+    text_ad2 = AdGroupTextAd.new(adgroup)
+    text_ad2.headline     = "Cruise to Mars Sector 2"
+    text_ad2.description1 = "Visit the Red Planet in style."
+    text_ad2.description2 = "Low-gravity fun for everyone!"
+    text_ad2.url          = "http://www.example.com"
+    text_ad2.display_url  = "www.example.com"
+
+    # adgroupad_operation
+    ad_operation1 = AdGroupAdOperation.new
+    ad_operation1.add text_ad1
+
+    # adgroupad_operation
+    ad_operation2 = AdGroupAdOperation.new
+    ad_operation2.add text_ad2
+
+    bulk_mutate_job = BulkMutateJob.new
+    bulk_mutate_job.campaign_id = campaign.id
+    bulk_mutate_job.add_operation ad_operation1
+    bulk_mutate_job.add_operation ad_operation2
+
+    bulk_mutate_job
+  end
+
+end

data/spec/fixtures/sem4r.example.yml

@@ -0,0 +1,26 @@
+#
+# Example config file
+#
+google_adwords:
+
+  sandbox:
+    email:             example@gmail.com
+    password:          password
+    developer_token:   example@gmail.com++EUR
+
+  sandbox1:
+    environment:       sandbox
+    email:             example@gmail.com
+    password:          password
+    developer_token:   example@gmail.com++EUR
+
+  production:
+    email:             production@mysite.com
+    password:          password
+    developer_token:   productiondevelopertoken
+
+  production1:
+    environment:       production
+    email:             production@anothersite.com
+    password:          password
+    developer_token:   productiondevelopertoken

data/spec/fixtures/services/ad_group/get-first-req.xml

@@ -0,0 +1,28 @@
+<?xml version='1.0' encoding='UTF-8'?> 
+<env:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:env='http://schemas.xmlsoap.org/soap/envelope/' xmlns='https://adwords.google.com/api/adwords/cm/v200909' xmlns:s='https://adwords.google.com/api/adwords/cm/v200909'>
+  <env:Header>
+    <s:RequestHeader env:mustUnderstand='0'>
+      <authToken>
+        ***censured***
+      </authToken>
+      <userAgent>
+        Sem4r Adwords Ruby Client Library (http://github.com/sem4r/sem4r)
+      </userAgent>
+      <developerToken>
+        ***censured***
+      </developerToken>
+      <clientEmail>
+        client_1+sem4ruby@gmail.com
+      </clientEmail>
+    </s:RequestHeader>
+  </env:Header>
+  <env:Body>
+    <get xmlns='https://adwords.google.com/api/adwords/cm/v200909'>
+      <selector>
+        <campaignId>
+          62746
+        </campaignId>
+      </selector>
+    </get>
+  </env:Body>
+</env:Envelope>

data/spec/fixtures/services/ad_group/get-first-res.xml

@@ -0,0 +1,91 @@
+<soap:Envelope xmlns:soap='http://schemas.xmlsoap.org/soap/envelope/'>
+  <soap:Header>
+    <ResponseHeader xmlns='https://adwords.google.com/api/adwords/cm/v200909'>
+      <requestId>3e97cd7f748479213cf0f78b356fd290</requestId>
+      <operations>2</operations>
+      <responseTime>170</responseTime>
+      <units>2</units>
+    </ResponseHeader>
+  </soap:Header>
+
+  <soap:Body>
+    <getResponse xmlns='https://adwords.google.com/api/adwords/cm/v200909'>
+      <rval>
+
+        <totalNumEntries>2</totalNumEntries>
+        <Page.Type>AdGroupPage</Page.Type>
+        <entries>
+
+          <id>3060217923</id>
+          <campaignId>62746</campaignId>
+          <campaignName>campaign 2010-02-13 09:38:39 +0100</campaignName>
+          <name>test adgroup</name>
+          <status>ENABLED</status>
+
+          <bids xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='ManualCPCAdGroupBids'>
+            <AdGroupBids.Type>ManualCPCAdGroupBids</AdGroupBids.Type>
+            <keywordMaxCpc>
+              <amount>
+                <ComparableValue.Type>Money</ComparableValue.Type>
+                <microAmount>20000000</microAmount>
+              </amount>
+            </keywordMaxCpc>
+            <siteMaxCpc>
+              <amount>
+                <ComparableValue.Type>Money</ComparableValue.Type>
+                <microAmount>30000000</microAmount>
+              </amount>
+            </siteMaxCpc>
+          </bids>
+
+          <stats>
+            <network>ALL</network>
+            <Stats.Type>Stats</Stats.Type>
+          </stats>
+        </entries>
+
+        <entries>
+          <id>
+            3060217924
+          </id>
+          <campaignId>
+            62746
+          </campaignId>
+          <campaignName>
+            campaign 2010-02-13 09:38:39 +0100
+          </campaignName>
+          <name>
+            adgroup dsl 2010-02-13 09:38:56 +0100
+          </name>
+          <status>
+            ENABLED
+          </status>
+          <bids xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='ManualCPCAdGroupBids'>
+            <AdGroupBids.Type>
+              ManualCPCAdGroupBids
+            </AdGroupBids.Type>
+            <keywordMaxCpc>
+              <amount>
+                <ComparableValue.Type>
+                  Money
+                </ComparableValue.Type>
+                <microAmount>
+                  10000000
+                </microAmount>
+              </amount>
+            </keywordMaxCpc>
+          </bids>
+          <stats>
+            <network>
+              ALL
+            </network>
+            <Stats.Type>
+              Stats
+            </Stats.Type>
+          </stats>
+        </entries>
+      </rval>
+    </getResponse>
+  </soap:Body>
+</soap:Envelope>
+<!-- end -->