sem4r 0.1.1

data/examples_sem4r/06_create_campaigns.rb

@@ -0,0 +1,86 @@
+# -------------------------------------------------------------------
+# 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 "Create example campaigns"
+  client_account = adwords.account.client_accounts.first
+
+  campaign = Campaign.create(client_account) do
+    name "campaign #{Time.now.strftime('%m%d-%H%M%S')}"
+  end
+  puts "created campaign '#{campaign.name}' with id '#{campaign.id}'"
+
+  adgroup = AdGroup.create(campaign) do
+    name "adgroup #{Time.now.strftime('%m%d-%H%M%S')}"
+  end
+  puts "created adgroup '#{adgroup.name}' with id '#{adgroup.id}'"
+
+  adgroup_ad = AdGroupTextAd.new(adgroup) do
+    url           "http://www.sem4r.com"
+    display_url   "www.Sem4R.com"
+    headline      "adwords api library"
+    description1  "adwords made simple"
+    description2  "set up you campaings in a snap"
+  end
+  puts "created ad with id '#{adgroup_ad.id}'"
+
+  CriterionKeyword.new(adgroup) do
+    text       "sem4r"
+    match      "BROAD"
+  end
+
+  CriterionKeyword.new(adgroup) do
+    text       "adwords"
+    match      "BROAD"
+  end
+
+  CriterionKeyword.new(adgroup) do
+    text       "library"
+    match      "BROAD"
+  end
+
+  CriterionPlacement.new(adgroup) do
+    url       "http://www.sem4r.com"
+  end
+
+  #
+  # dsl
+  #
+
+  adgroup_dsl = campaign.ad_group do
+    name "adgroup dsl #{Time.now.strftime('%m%d-%H%M%S')}"
+
+    keyword do
+      text  "adwords client library"
+      match "BROAD"
+    end
+  end
+
+  campaign.p_ad_groups(true)
+  adgroup.p_criterions(true)
+  adgroup_dsl.p_criterions(true)
+
+end

data/examples_sem4r/07_create_campaigns_block.rb

@@ -0,0 +1,99 @@
+# -------------------------------------------------------------------
+# 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 "Create example campaigns"
+  client_account = adwords.account.client_accounts.first
+
+  #
+  # 1. campaign
+  #
+  campaign = client_account.campaign "sem4r web campaign #{Time.now.strftime('%m%d-%H%M%S')}" do
+  
+    bidding_strategy "ManualCPM"
+  
+    ad_group "sem4r search page #{Time.now.strftime('%m%d-%H%M%S')}" do
+  
+      manual_cpm_bids do
+        max_cpm 20000000
+      end
+  
+      text_ad do
+        url           "http://www.sem4r.com"
+        display_url   "www.Sem4R.com"
+        headline      "adwords api library"
+        description1  "adwords made simple"
+        description2  "set up you campaings in a snap!"
+      end
+  
+      keyword   "adwords api",  "BROAD"
+      keyword   "ruby adwords", "BROAD"
+      placement "http://www.sem4r.com"
+  
+      negative_keyword "java api library"
+    end
+  end
+  campaign.p_ad_groups(true)
+
+  #
+  # 2 campaign
+  #
+
+  campaign = client_account.campaign "sem4r mobile campaign #{Time.now.strftime('%m%d-%H%M%S')}" do
+
+    bidding_strategy "ManualCPC"
+
+    ad_group "sem4r on mobile #{Time.now.strftime('%m%d-%H%M%S')}" do
+      manual_cpc_bids do
+        keyword_max_cpc 21000000
+        site_max_cpc    22000000
+      end
+
+      mobile_ad do
+        headline      "sem4r"
+        description   "simply adwords"
+        # markup        "XHTML"
+        # carrier       "Vodafone@IT"
+        carrier  'ALLCARRIERS'
+        business_name "sem4r"
+        country_code  "IT"
+        phone_number  "0612345"
+      end
+
+      keyword "adwords api", "BROAD" do
+        # status "PAUSED"
+        # url  "pippo"
+        #        max_cpc 32423423
+        #        max_cpm 232321
+      end
+
+      keyword "ruby adwords", "BROAD"
+    end
+  end
+
+  campaign.p_ad_groups(true)
+
+end

data/examples_sem4r/07_create_campaigns_simple.rb

@@ -0,0 +1,65 @@
+# -------------------------------------------------------------------
+# 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 "Create example campaigns"
+  client_account = adwords.account.client_accounts.first
+
+  #
+  # 1. campaign
+  #
+  campaign = client_account.campaign "sem4r web campaign #{Time.now.strftime('%m%d-%H%M%S')}" do
+  
+    ad_group "sem4r search page #{Time.now.strftime('%m%d-%H%M%S')}" do
+
+      text_ad do
+        url           "http://www.sem4r.com"
+        display_url   "www.Sem4R.com"
+        headline      "adwords api library"
+        description1  "adwords made simple"
+        description2  "set up you campaings in a snap!"
+      end
+  
+      text_ad do
+        url           "http://www.sem4r.com"
+        display_url   "www.Sem4R.com"
+        headline      "adwords library"
+        description1  "no more headache"
+        description2  "set up you campaings in a snap!"
+      end
+
+      puts      "first keyword"
+      keyword   "adwords api",  "BROAD"
+      puts      "second keyword"
+      keyword   "ruby adwords", "BROAD"
+    end
+  end
+
+  puts "created campaign '#{campaign.name}'"
+  adgroup = campaign.ad_groups.first
+  adgroup.p_ads
+  adgroup.p_criterions
+end

data/examples_sem4r/08_ad_params.rb

@@ -0,0 +1,70 @@
+# -------------------------------------------------------------------
+# 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 "Create an adgroup with adparam"
+
+  client_account = adwords.account.client_accounts[1]
+
+  if client_account.campaigns.length != 0
+    campaign = client_account.campaigns[0]
+  else
+    campaign = client_account.campaign do
+      name "campaign #{Time.now.strftime('%m%d-%H%M%S')}"
+    end
+  end
+
+  campaign.ad_group do
+    name "ad_group #{Time.now.strftime('%m%d-%H%M%S')}"
+
+    text_ad do
+      url           "http://www.pluto.com"
+      display_url   "www.Pluto.com"
+      headline      "Vieni da noi"
+      description1  "vieni da noi"
+      description2  "arivieni da noi"
+    end
+
+    keyword do
+      text       "pippo"
+      match      "BROAD"
+
+      ad_param do
+        index 1
+        text  "$99.99"
+      end
+
+      ad_param do
+        index 2
+        text  "10"
+      end
+    end
+  end
+
+  campaign.ad_groups(true).each do |ad_group|
+    ad_group.p_ad_params
+  end
+
+end

data/examples_sem4r/09_targeting_idea.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.
+# 
+# -------------------------------------------------------------------------
+
+require File.dirname(__FILE__) + "/example_helper"
+
+run_example(__FILE__) do |adwords|
+  account = adwords.account
+
+  ideas = account.targeting_idea  do
+    idea_type    "KEYWORD"
+    request_type "IDEAS"
+
+    excluded_keyword_search_parameter do
+      text       'media player'
+      match_type 'EXACT'
+    end
+
+    keyword_match_type_search_parameter do
+      match_type 'BROAD'
+      match_type 'EXACT'
+    end
+
+    related_to_keyword_search_parameter do
+      text       'dvd player'
+      match_type 'EXACT'
+    end
+
+    country_target_search_parameter do
+      country_code 'US'
+      # country_code 'UK'
+      # country_code 'IT'
+    end
+
+  end
+
+  ideas.each{ |idea| puts idea }
+
+end

data/examples_sem4r/10_get_location.rb

@@ -0,0 +1,28 @@
+# -------------------------------------------------------------------
+# 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.geo_location
+end

data/examples_sem4r/11_submit_bulk_job.rb

@@ -0,0 +1,82 @@
+# -------------------------------------------------------------------
+# 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"
+
+
+def create_bulk_mutate_job(campaign, adgroup)
+  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"
+
+  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"
+
+  bulk_mutate_job = BulkMutateJob.new
+  bulk_mutate_job.campaign_id = campaign.id
+
+  ad_operation1 = AdGroupAdOperation.new
+  ad_operation1.add text_ad1
+
+  ad_operation2 = AdGroupAdOperation.new
+  ad_operation2.add text_ad2
+
+  job = BulkMutateJob.new
+  job.campaign_id = 100
+  job.add_operation ad_operation1
+  job.add_operation ad_operation2
+  job
+end
+
+run_example(__FILE__) do |adwords|
+
+  account = adwords.account
+  client_account = adwords.account.client_accounts.first
+
+  campaign = Campaign.create(client_account) do
+    name "campaign #{Time.now.strftime('%m%d-%H%M%S')}"
+  end
+
+  ad_group = campaign.ad_group do
+    name "adgroup #{Time.now.strftime('%m%d-%H%M%S')}"
+  end
+
+  puts "created campaign '#{campaign.name}' with id '#{campaign.id}'"
+  puts "created adgroup '#{ad_group.name}' with id '#{ad_group.id}'"
+
+  job = create_bulk_mutate_job(campaign, ad_group)
+
+  job_operation = JobOperation.new
+  job_operation.add(job)
+
+  result_job = account.job_mutate(job_operation)
+
+  puts result_job.to_s
+end

data/examples_sem4r/12_list_bulk_job.rb

@@ -0,0 +1,29 @@
+# -------------------------------------------------------------------
+# 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_jobs
+end

data/examples_sem4r/30_prune_empty_adgroup.rb

@@ -0,0 +1,50 @@
+# -------------------------------------------------------------------
+# 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 "Prune empty campaigns and adgroups"
+
+  account = adwords.account
+  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.name}'"
+      campaign.ad_groups.each do |ad_group|
+        if ad_group.empty?
+          puts "delete adgroup '#{ad_group.name}'"
+          ad_group.delete
+        end
+      end
+
+      if campaign.empty?
+        puts "delete campaign '#{campaign.name}'"
+        campaign.delete
+      end
+    end
+  end
+
+end

data/examples_sem4r/31_empty_accounts.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|
+
+  puts "Prune empty campaigns and adgroups"
+
+  account = adwords.account
+  account.client_accounts.each do |client_account|
+    puts "examinate account '#{client_account.credentials.client_email}'"
+    client_account.campaigns.each do |campaign|
+      puts "delete campaign '#{campaign.name}'"
+      campaign.delete
+    end
+  end
+
+end