sem4r 0.1.1

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+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.

data/README.rdoc

@@ -0,0 +1,74 @@
+= Sem4r
+
+Sem4r is a ruby library to access google adwords api, that works with ruby 1.9 and 1.8.
+
+The Google AdWords Api (http://code.google.com/apis/adwords/) is a
+webservice soap protocol. From the official site:
+
+  The Google AdWords API lets developers build applications that interact directly
+  with the AdWords platform. With these applications, advertisers and third
+  parties can more efficiently and creatively manage their large or complex
+  AdWords accounts and campaigns.
+
+The official google adwords ruby library adwords4r doesn't work with ruby 1.9,
+because uses soap4r. The soap4r is not supported by ruby 1.9.
+Sem4r don't uses soap4r.
+
+Main idea is to use a high level model instead of a low level api.
+You think about clients, campaigns, keywords and not about operations, operands, service calls.
+In the future, the library might decide which api use (sync or async) and when call it!
+
+== Usage
+
+To access adwords api you need:
+  - email account  (for sandbox environment a gmail account <myaccount>@gmail.com)
+  - password       
+  - developer token (for sandbox environment is like <myaccount>@gmail.com++EUR)
+
+To access the sandbox environment
+
+  adwords = Adwords.sandbox( :email => "<myaccount>@gmail.com", :password => "secret", :developer_token => "<myaccount>@gmail.com++EUR")
+
+To print details about the current account:
+
+adwords.account.p_info
+
+You can list all client accounts:
+
+  adwords.account.p_clients
+
+See directory examples_sem4r[http://github.com/sem4r/sem4r/tree/master/examples_sem4r/examples_sem4r] for more examples.
+Follow the sem4r.com[http://www.sem4r.com] feed for announcements of new releases.
+
+== Install
+
+  sudo gem install sem4r
+
+== Contributors
+
+* Glenn Gillen {http://github.com/rubypond}
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2009 - 2010 {Sem4r}[http://www.sem4r.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.

data/Rakefile

@@ -0,0 +1,126 @@
+require 'rubygems'
+require 'rake'
+
+#
+# jeweler
+#
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    gem.name = "sem4r"
+    gem.summary = %Q{Library to access google adwords api. Works with ruby 1.9 and ruby 1.8}
+    gem.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.
+    }
+
+    gem.authors = ["Sem4r"]
+    gem.email = "sem4ruby@gmail.com"
+    gem.homepage = "http://www.sem4r.com"
+
+    #
+    # dependecies
+    #
+    # gem.add_dependency 'patron'
+    gem.add_dependency 'builder'
+    gem.add_development_dependency 'rspec'
+    gem.add_development_dependency 'differ'
+
+    #
+    # files
+    #
+    gem.files  = %w{LICENSE README.rdoc Rakefile VERSION.yml sem4r.gemspec}
+    gem.files << 'config/sem4r.example.yml'
+    gem.files.concat Dir['examples_sem4r/*.rb']
+    gem.files.concat Dir['examples_blog/*.rb']
+    gem.files.concat Dir['lib/**/*.rb']
+
+    #
+    # test files
+    #
+    gem.test_files = Dir['spec/**/*.rb']
+    gem.test_files.concat Dir['spec/fixtures/**/*']
+
+    #
+    # rubyforge
+    #
+    # gem.rubyforge_project = 'sem'
+  end
+
+  # Jeweler::RubyforgeTasks.new do |rubyforge|
+  #   rubyforge.doc_task = "rdoc"
+  # end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+#
+# rdoc
+#
+require 'rake/rdoctask'
+
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "sem4r #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+#
+# spec
+#
+
+#require 'spec/rake/spectask'
+#
+#desc "Run all examples"
+#Spec::Rake::SpecTask.new('spec') do |t|
+#  t.spec_files = FileList['spec/**/*_spec.rb']
+#end
+#
+#desc "Generate HTML report for failing examples"
+#Spec::Rake::SpecTask.new('failing_examples_with_html') do |t|
+#  t.spec_files = FileList['failing_examples/**/*.rb']
+#  t.spec_opts = ["--format", "html:doc/reports/tools/failing_examples.html", "--diff"]
+#  t.fail_on_error = false
+#end
+
+task :test => :check_dependencies
+task :default => :spec
+
+###############################################################################
+# Sem4r
+
+namespace :sem4r do
+  #
+  # examples
+  #
+  desc 'run all sem4r example'
+  task :examples do
+
+    Dir['examples_sem4r/*.rb'].sort.each do |filename|
+      next unless filename =~ /\d\d.+\.rb$/
+      unless system "ruby #{filename}"
+        exit
+      end
+    end
+    puts "All examples run successfull"
+
+  end
+
+  desc "Start an IRB shell"
+  task :shell do
+    sh 'IRBRC=`pwd`/config/irbrc.rb irb'
+  end
+end

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:major: 0
+:minor: 1
+:patch: 1
+:build: 

data/bin/sem

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby 
+
+# -------------------------------------------------------------------------
+# 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 'rubygems'
+
+cwd = File.expand_path( File.join( File.dirname(__FILE__), "..", "lib" ) )
+$:.unshift(cwd) unless $:.include?(cwd)
+require 'sem4r_cli'
+
+include Sem4r
+exit CliSem.run

data/config/sem4r.example.yml

@@ -0,0 +1,51 @@
+#
+# Example config file
+# Adwords profiles
+#
+google_adwords:
+
+  sandbox:
+    # default environment is sandbox (cannot be changed)
+    email:             example@gmail.com
+    password:          password
+    developer_token:   example@gmail.com++EUR
+    mutable:           true
+
+  production:
+    # default environment is production (cannot be changed)
+    email:             production@mysite.com
+    password:          password
+    developer_token:   productiondevelopertoken
+    mutable:           true
+
+  # immutable profile
+  # cannot be called service that modify account
+  # as adding keyword, disable adgroup, ...
+  sandbox_read_only:
+    environment:       sandbox
+    email:             example@gmail.com
+    password:          password
+    developer_token:   example@gmail.com++EUR
+    mutable:           false
+
+  production_read_only:
+    environment:       production
+    email:             production@mysite.com
+    password:          password
+    developer_token:   productiondevelopertoken
+    mutable:           false
+
+  myclient_sandbox:
+    environment:       sandbox
+    email:             example@gmail.com
+    password:          password
+    developer_token:   example@gmail.com++EUR
+    mutable:           true
+
+  myclient_production:
+    environment:       production
+    email:             production@anothersite.com
+    password:          password
+    developer_token:   productiondevelopertoken
+    mutable:           true
+    

data/examples_blog/2009-11-29-hello-world.rb

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'sem4r'
+include Sem4r
+
+adwords = Adwords.sandbox
+
+#adwords = Adwords.sandbox(
+#  :email => "<myaccount>@gmail.com",
+#  :password => "secret",
+#  :developer_token => "<myaccount>@gmail.com++EUR")
+adwords.account.p_client_accounts
+

data/examples_blog/2009-12-12-create-campaign.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'sem4r'
+include Sem4r
+
+adwords = Adwords.sandbox
+
+#adwords = Adwords.sandbox(
+#  :email => "<myaccount>@gmail.com",
+#  :password => "secret",
+#  :developer_token => "<myaccount>@gmail.com++EUR")
+
+account = adwords.account.client_accounts[1]
+
+campaign = account.create_campaign do
+  name "new campaign #{Time.now.strftime('%m%d-%H%M%S')}"
+
+  adgroup do
+    name "new adgroup #{Time.now.strftime('%m%d-%H%M%S')}"
+    keyword do
+      text       "keyword"
+      match      "BROAD"
+    end
+    placement do
+      url "www.example.com"
+    end
+  end
+end
+
+campaign.p_adgroups(true)

data/examples_blog/2010-02-06-constants-scope.rb

@@ -0,0 +1,8 @@
+class A
+  C = "c"
+end
+
+puts RUBY_VERSION
+A.new.instance_eval do
+  puts C
+end

data/examples_blog/2010-02-07-ad-parameters.rb

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'sem4r'
+include Sem4r
+
+adwords = Adwords.sandbox
+
+#adwords = Adwords.sandbox(
+#  :email => "<myaccount>@gmail.com",
+#  :password => "secret",
+#  :developer_token => "<myaccount>@gmail.com++EUR")
+
+client_account = adwords.account.client_accounts.first
+
+campaign = client_account.campaign do
+  name "Skis"
+
+  adgroup do
+    name "Skis for sales"
+
+    text_ad do
+      headline      "Save on Rossignol skis"
+      description1  "Great deal on Rissignol starting at"
+      description2  "{param1:lowprices}! Save {param2: big time}!"
+      url           "http://skideals.com"
+      display_url   "www.SkiDeals.com"
+    end
+
+    keyword do
+      text       "ski deal rossignol"
+      match      "BROAD"
+
+      ad_param do
+        index 1
+        text  "$279"
+      end
+
+      ad_param do
+        index 2
+        text  "20%"
+      end
+    end
+  end
+end
+
+campaign.adgroups(true).each do |adgroup|
+  adgroup.p_ad_params
+end

data/examples_sem4r/01_get_account.rb

@@ -0,0 +1,37 @@
+# -------------------------------------------------------------------
+# 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 File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+  account = adwords.account
+  account.p_client_accounts
+
+  client_account = account.client_accounts.first
+  client_account.p_campaigns
+
+  unless client_account.campaigns.empty?
+    campaign = client_account.campaigns.first
+    campaign.p_ad_groups
+  end
+end

data/examples_sem4r/02_get_info.rb

@@ -0,0 +1,32 @@
+# -------------------------------------------------------------------
+# 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 File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+  adwords.account.p_info
+  (Account::UsageTypes - [Account::METHOD_COST]).each do |usage_type|
+    n = adwords.account.year_unit_cost(usage_type)
+    puts "#{usage_type} -> #{n}"
+  end
+end

data/examples_sem4r/03_list_ad.rb

@@ -0,0 +1,47 @@
+# -------------------------------------------------------------------
+# 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 File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+  puts "List AdGroup Advertising"
+
+  adwords.account.client_accounts.each do |client_account|
+    puts "examinate account '#{client_account.credentials.client_email}'"
+    client_account.campaigns.each do |campaign|
+      puts "examinate campaign '#{campaign}'"
+      campaign.ad_groups.each do |ad_group|
+        puts "examinate adgroup '#{ad_group}'"
+        ad_group.ads.each do |ad|
+          row = []
+          row << client_account.credentials.client_email
+          row << campaign.name
+          row << ad_group.name
+          row << ad.url
+          row << ad.display_url
+          puts row.join(",")
+        end
+      end
+    end
+  end
+end

data/examples_sem4r/04_list_keywords.rb

@@ -0,0 +1,54 @@
+# -------------------------------------------------------------------
+# 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 File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+  puts "List AdGroup Keywords"
+
+  adwords.account.client_accounts.each do |client_account|
+    puts "examinate account '#{client_account.credentials.client_email}'"
+    client_account.campaigns.each do |campaign|
+      puts "examinate campaign '#{campaign}'"
+      campaign.ad_groups.each do |ad_group|
+        ad_group.criterions.each do |criterion|
+          row = []
+          row << client_account.credentials.client_email
+          row << campaign.name
+          row << ad_group.name
+            
+          row << criterion.type
+          case criterion.type
+          when Criterion::Keyword
+            row << criterion.text
+            row << criterion.match
+          when Criterion::Placement
+            row << criterion.url
+          end
+
+          puts row.join(",")
+        end
+      end
+    end
+  end
+end

data/examples_sem4r/05_request_report.rb

@@ -0,0 +1,51 @@
+# -------------------------------------------------------------------
+# 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 File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+  account = adwords.account
+  account.p_reports
+
+  report = account.report do
+    name                 "Test Report"
+    type                 "Structure"
+    start_day            "2009-01-01"
+    end_day              "2009-01-31"
+    aggregation          "Keyword"
+    column               "Campaign"
+    column               "AdGroup"
+    column               "Keyword"
+    column               "KeywordTypeDisplay"
+  end
+
+  report.validate
+  job = report.schedule
+  job.wait(5) { |r, s| puts "status #{s}" }
+  report.download(tmp_dirname + "/05_request_report.xml")
+
+  account.p_reports(true)
+  report = account.reports.first
+  puts report.status(true)
+end

data/examples_sem4r/05_request_report_2010.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 File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+
+  account = adwords.account
+
+  # account.p_report_definitions
+
+  rd = account.report_definition do
+    name "report"
+  end
+  rd.save
+
+  puts rd.to_s
+
+end