sem4r 0.1.1

data/lib/sem4r/ad_group_ad/ad_group_ad.rb

@@ -0,0 +1,98 @@
+# -------------------------------------------------------------------
+# 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 AdGroupAd < Base
+
+    #
+    # Ad.type
+    #
+    enum :Types, [
+      :DeprecatedAd,
+      :MobileAd,
+      :TextAd,
+      :MobileImageAd,
+      :ImageAd,
+      :LocalBusinessAd,
+      :TemplateAd
+    ]
+
+    #
+    # AdGroupAd.Status
+    #
+    enum :Statuses, [
+      :ENABLED,
+      :PAUSED,
+      :DISABLED
+    ]
+
+    #
+    # Ad.ApprovalStatus
+    #
+    enum :ApprovalStatus, [
+      :APPROVED,
+      :FAMILY_SAFE,
+      :NON_FAMILY_SAFE,
+      :PORN,
+      :UNCHECKED, # Pending review
+      :DISAPPROVED
+    ]
+
+    attr_reader   :ad_group
+    attr_accessor :type
+
+    # g_reader :type
+    g_accessor :url
+    g_accessor :display_url
+    g_accessor :status, {:default => "ENABLED"}
+
+    def initialize(ad_group, &block)
+      super( ad_group.adwords, ad_group.credentials )
+      @ad_group = ad_group
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def saved?
+      !@id.nil?
+    end
+    
+    # try to save when accessing id
+    def id
+      save unless @id
+      @id
+    end
+
+    def self.from_element( ad_group, el )
+      xml_type =       el.elements["Ad.Type"].text.strip
+      case xml_type
+      when TextAd
+        AdGroupTextAd.from_element(ad_group, el)
+      when MobileAd
+        AdGroupMobileAd.from_element(ad_group, el)
+      end
+    end
+
+  end
+end

data/lib/sem4r/ad_group_ad/ad_group_ad_operations.rb

@@ -0,0 +1,38 @@
+# -------------------------------------------------------------------------
+# 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 AdGroupAdOperation < Operation
+
+    def initialize(&block)
+      @operation_type = "AdGroupAdOperation"
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+  end
+
+end

data/lib/sem4r/ad_group_ad/ad_group_ad_service.rb

@@ -0,0 +1,56 @@
+# -------------------------------------------------------------------
+# 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 AdGroupAdService
+    include SoapCall
+
+    def initialize(connector)
+      @connector = connector
+      @service_namespace = "https://adwords.google.com/api/adwords/cm/v201003"
+      @header_namespace = @service_namespace
+      
+      @sandbox_service_url = "https://adwords-sandbox.google.com/api/adwords/cm/v201003/AdGroupAdService"
+    end
+
+    soap_call_v2009 :all,   :mutate => false
+    soap_call_v2009 :mutate
+
+    private
+
+    def _all(ad_group_id)
+      <<-EOFS
+      <get xmlns="#{@service_namespace}">
+        <selector>
+          <adGroupIds>#{ad_group_id}</adGroupIds>
+        </selector>
+      </get>
+      EOFS
+    end
+
+    def _mutate(xml)
+      "<mutate xmlns=\"#{@service_namespace}\">#{xml}</mutate>"
+    end
+
+  end
+end

data/lib/sem4r/ad_group_ad/ad_group_mobile_ad.rb

@@ -0,0 +1,137 @@
+# -------------------------------------------------------------------------
+# 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
+
+  # From: http://code.google.com/apis/adwords/v2009/docs/reference/AdGroupAdService.MobileAd.html
+  #   A mobile ad can contain a click-to-call phone number, a link to a website, or both.
+  #   You specify which features you want by setting certain fields, as shown in the following table.
+  #   For example, to create a click-to-call mobile ad, set the fields in the Click-to-call column.
+  #   A hyphen means don't set the corresponding field.
+  class AdGroupMobileAd < AdGroupAd
+
+    enum :Markups, [
+      :CHTML,
+      :HTML,
+      :WML,
+      :XHTML
+    ]
+
+    def initialize(ad_group, &block)
+      @carriers = []
+      self.type = MobileAd
+      super
+    end
+
+    # MobileAd
+    g_accessor     :headline
+    g_accessor     :description
+    g_set_accessor :markup, {:values_in => :Markups}
+    g_set_accessor :carrier         # default carrier  'ALLCARRIERS'
+    g_accessor     :business_name   # 20 caratteri 10 per il giappone
+    g_accessor     :country_code
+    g_accessor     :phone_number
+
+    def image
+      @image
+    end
+
+    def image(&block)
+      @image = MobileAdImage.new(self, &block)
+    end
+
+    def xml(t)
+      t.adGroupId   ad_group.id
+      t.ad("xsi:type" => "MobileAd") do |ad|
+        ad.headline        headline
+        ad.description     description
+        unless markups.empty?
+          markups.each do |m|
+            ad.markupLanguages m
+          end
+        end
+        unless carriers.empty?
+          carriers.each do |carrier|
+            ad.mobileCarriers carrier
+          end
+        end
+        ad.businessName    business_name
+        ad.countryCode     country_code
+        ad.phoneNumber     phone_number
+      end
+      t.status status
+    end
+
+    def to_xml(tag)
+      builder = Builder::XmlMarkup.new
+      builder.tag!(tag, "xsi:type" => "AdGroupAd") do |t|
+        xml(t)
+        #      t.adGroupId   ad_group.id
+        #      t.ad("xsi:type" => "MobileAd") do |ad|
+        #        ad.headline        headline
+        #        ad.description     description
+        #        unless markups.empty?
+        #          markups.each do |m|
+        #            ad.markupLanguages m
+        #          end
+        #        end
+        #        unless carriers.empty?
+        #          carriers.each do |carrier|
+        #            ad.mobileCarriers carrier
+        #          end
+        #        end
+        #        ad.businessName    business_name
+        #        ad.countryCode     country_code
+        #        ad.phoneNumber     phone_number
+        #      end
+        #      t.status status
+      end
+    end
+
+    def self.from_element(ad_group, el)
+      new(ad_group) do
+        @id         = el.elements["id"].text.strip.to_i
+        # type          el.elements["Ad.Type"].text
+        headline       el.elements["headline"].text.strip
+        description    el.elements["description"].text.strip
+        business_name  el.elements["businessName"].text.strip
+        country_code   el.elements["countryCode"].text.strip
+        phone_number   el.elements["phoneNumber"].text.strip
+        # TODO: estrarre le carriers
+      end
+    end
+
+    def save
+      unless @id
+        soap_message = service.ad_group_ad.create(credentials, to_xml("operand"))
+        add_counters( soap_message.counters )
+        rval = REXML::XPath.first( soap_message.response, "//mutateResponse/rval")
+        id = REXML::XPath.match( rval, "value/ad/id" ).first
+        @id = id.text.strip.to_i
+      end
+      self
+    end
+
+  end
+end

data/lib/sem4r/ad_group_ad/ad_group_text_ad.rb

@@ -0,0 +1,98 @@
+# -------------------------------------------------------------------------
+# 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 AdGroupTextAd < AdGroupAd
+
+    g_accessor :headline
+    g_accessor :description1
+    g_accessor :description2
+
+    def initialize(ad_group, &block)
+      self.type = TextAd
+      super
+    end
+
+    def to_s
+      "#{@id} textad '#{headline}' #{url}"
+    end
+
+    def xml(t)
+      t.adGroupId   ad_group.id
+      t.ad("xsi:type" => "TextAd") do |ad|
+        ad.url              url
+        ad.displayUrl       display_url
+        ad.headline         headline
+        ad.description1     description1
+        ad.description2     description2
+      end
+      t.status status
+    end
+
+    def to_xml(tag)
+      builder = Builder::XmlMarkup.new
+      builder.tag!(tag, "xsi:type" => "AdGroupAd") do |t|
+        xml(t)
+        #        t.adGroupId   ad_group.id
+        #        t.ad("xsi:type" => "TextAd") do |ad|
+        #          ad.url              url
+        #          ad.displayUrl       display_url
+        #          ad.headline         headline
+        #          ad.description1     description1
+        #          ad.description2     description2
+        #        end
+        #        t.status status
+      end
+    end
+
+    def self.from_element(ad_group, el)
+      new(ad_group) do
+        @id         = el.elements["id"].text.strip.to_i
+        # type          el.elements["Ad.Type"].text
+        url           el.elements["url"].text.strip
+        display_url   el.elements["displayUrl"].text.strip
+        headline      el.elements["headline"].text.strip
+        description1  el.elements["description1"].text.strip
+        description2  el.elements["description2"].text.strip
+      end
+    end
+
+    def self.create(ad_group, &block)
+      new(ad_group, &block).save
+    end
+
+    def save
+      unless @id
+        ad_operation = AdGroupAdOperation.new.add self
+        soap_message = service.ad_group_ad.mutate(credentials, ad_operation.to_xml("operations"))
+        add_counters( soap_message.counters )
+        rval = REXML::XPath.first( soap_message.response, "//mutateResponse/rval")
+        id = REXML::XPath.match( rval, "value/ad/id" ).first
+        @id = id.text.strip.to_i
+      end
+      self
+    end
+
+  end
+end

data/lib/sem4r/ad_group_criterion/ad_group_criterion.rb

@@ -0,0 +1,144 @@
+# -------------------------------------------------------------------
+# 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
+
+  #
+  # http://code.google.com/apis/adwords/v2009/docs/reference/AdGroupCriterionService.AdGroupCriterion.html
+  #
+  class AdGroupCriterion
+    include SoapAttributes
+    
+    g_accessor :criterion
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def self.from_element(ad_group, el)
+      type =  el.elements["AdGroupCriterion.Type"].text.strip
+      klass = Module::const_get(type)
+      klass.from_element(ad_group, el)
+    end
+
+    def saved?
+      criterion.saved?
+    end
+
+    def save
+      unless criterion.saved?
+        o = AdGroupCriterionOperation.new.add(self)
+        soap_message =
+          criterion.service.ad_group_criterion.mutate(criterion.credentials, o.to_xml("operations"))
+        criterion.add_counters( soap_message.counters )
+        rval = REXML::XPath.first( soap_message.response, "//mutateResponse/rval")
+        id = REXML::XPath.match( rval, "value/criterion/id" ).first
+        criterion.instance_eval{ @id = id.text.strip.to_i }
+      end
+      self
+    end
+
+  end
+
+  class BiddableAdGroupCriterion < AdGroupCriterion
+
+    g_accessor :bids
+
+    def initialize(ad_group, &block)
+      @ad_group = ad_group
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_s
+      "biddable " + criterion.to_s
+    end
+
+    def self.from_element(ad_group, el)
+      new(ad_group) do
+        criterion Criterion.from_element(ad_group, el.elements["criterion"])
+        bids      AdGroupCriterionBids.from_element(el.elements["bids"])
+      end
+    end
+
+    def xml(t)
+      t.adGroupId   @ad_group.id
+      # t.status "ENABLED"
+      criterion.xml(t)
+      @bids.xml(t) if @bids
+    end
+
+    def to_xml(tag)
+      builder = Builder::XmlMarkup.new
+      builder.tag!(tag, "xsi:type" => "BiddableAdGroupCriterion") do |t|
+        xml(t)
+        #        t.adGroupId   @ad_group.id
+        #        # t.status "ENABLED"
+        #        criterion.to_xml(t)
+        #        @bids.to_xml(t) if @bids
+      end
+    end
+
+  end
+
+  class NegativeAdGroupCriterion < AdGroupCriterion
+
+    def initialize(ad_group, &block)
+      @ad_group = ad_group
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_s
+      "negative " + criterion.to_s
+    end
+
+    def self.from_element(ad_group, el)
+      new(ad_group) do
+        criterion Criterion.from_element(ad_group, el.elements["criterion"])
+      end
+    end
+
+    def xml(t)
+      t.adGroupId   criterion.ad_group.id
+      # t.status "ENABLED"
+      criterion.xml(t)
+    end
+
+    def to_xml(tag)
+      builder = Builder::XmlMarkup.new
+      builder.tag!(tag, "xsi:type" => "NegativeAdGroupCriterion") do |t|
+        xml(t)
+        #        t.adGroupId   criterion.ad_group.id
+        #        # t.status "ENABLED"
+        #        criterion.to_xml(t)
+      end
+    end
+
+  end
+
+end

data/lib/sem4r/ad_group_criterion/ad_group_criterion_bids.rb

@@ -0,0 +1,115 @@
+# -------------------------------------------------------------------------
+# 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 AdGroupCriterionBids
+    include SoapAttributes
+
+    enum :Types, [
+      :BudgetOptimizerAdGroupCriterionBids,
+      :ConversionOptimizerAdGroupCriterionBids,
+      :ManualCPCAdGroupCriterionBids,
+      :ManualCPMAdGroupCriterionBids
+    ]
+
+    def self.from_element(el)
+      type =  el.elements["AdGroupCriterionBids.Type"].text.strip
+      klass = Module::const_get(type)
+      klass.from_element(el)
+    end
+  end
+
+  class BudgetOptimizerAdGroupCriterionBids < AdGroupCriterionBids
+  end
+
+  class ConversionOptimizerAdGroupCriterionBids < AdGroupCriterionBids
+  end
+
+  #
+  # http://code.google.com/apis/adwords/v2009/docs/reference/AdGroupCriterionService.ManualCPCAdGroupCriterionBids.html
+  #
+  class ManualCPCAdGroupCriterionBids < AdGroupCriterionBids
+
+    g_accessor :bid_source
+    g_accessor :max_cpc
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def self.from_element(el)
+      new do
+        bid_source       el.elements["bidSource"].text.strip
+
+        el_maxCpc = el.elements["maxCpc"]
+        el_amount = el_maxCpc.elements["amount"]
+        max_cpc     el_amount.elements["microAmount"].text.strip.to_i
+
+        # TODO: it is possible something like:
+        #        el.elements["maxCpc"] do |el|
+        #          el.elements["amount"] do el
+        #            max_cpc el["microAmount"]
+        #          end
+        #        end
+      end
+    end
+
+    def xml(t)
+      t.tag!('bids', 'xsi:type' => 'ManualCPCAdGroupCriterionBids') {
+        t.tag!('AdGroupCriterionBids.Type') { t.text! 'ManualCPCAdGroupCriterionBids' }
+        t.maxCpc {
+          t.amount {
+            t.tag!('ComparableValue.Type') { t.text! 'Money' }
+            t.microAmount max_cpc
+          }
+        }
+      }
+    end
+
+    def to_xml(tag = 'bids')
+      builder = Builder::XmlMarkup.new
+      xml = builder.tag!(tag, 'xsi:type' => 'ManualCPCAdGroupCriterionBids') { |xml|
+        xml.tag!('AdGroupCriterionBids.Type') { xml.text! 'ManualCPCAdGroupCriterionBids' }
+        xml.maxCpc {
+          xml.amount {
+            xml.tag!('ComparableValue.Type') { xml.text! 'Money' }
+            xml.microAmount max_cpc
+          }
+        }
+      }
+    end
+
+    def to_s
+      "#{@maxcpc / 10000} cents"
+    end
+
+  end
+
+  class ManualCPMAdGroupCriterionBids < AdGroupCriterionBids
+  end
+
+end