sem4r 0.1.1

data/lib/sem4r/targeting_idea/targeting_idea_selector.rb

@@ -0,0 +1,200 @@
+# -------------------------------------------------------------------------
+# 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 RelatedToKeywordSearchParameter
+    include SoapAttributes
+
+    g_accessor :text
+    g_accessor :match_type
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_xml
+      <<-EOS
+          <s:searchParameters xsi:type="s:RelatedToKeywordSearchParameter">
+            <s:keywords xsi:type="Keyword">
+              <Criterion.Type>Keyword</Criterion.Type>
+              <text>#{text}</text>
+              <matchType>#{match_type}</matchType>
+            </s:keywords>
+          </s:searchParameters>
+      EOS
+    end
+  end
+
+  class ExcludedKeywordSearchParameter
+    include SoapAttributes
+
+    g_accessor :text
+    g_accessor :match_type
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_xml
+      <<-EOS
+          <s:searchParameters xsi:type="s:ExcludedKeywordSearchParameter">
+            <s:keywords xsi:type="Keyword">
+              <Criterion.Type>Keyword</Criterion.Type>
+              <text>#{text}</text>
+              <matchType>#{match_type}</matchType>
+            </s:keywords>
+          </s:searchParameters>
+      EOS
+    end
+  end
+
+  class KeywordMatchTypeSearchParameter
+    include SoapAttributes
+
+    g_set_accessor :match_type
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_xml
+      xml = ""
+      xml << '<s:searchParameters xsi:type="s:KeywordMatchTypeSearchParameter">'
+      match_types.each do |t|
+        xml << "<s:keywordMatchTypes>#{t}</s:keywordMatchTypes>"
+      end
+      xml << '</s:searchParameters>'
+    end
+  end
+
+  class CountryTargetSearchParameter
+    include SoapAttributes
+
+    g_set_accessor :country_code
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_xml
+      xml = ""
+      xml << '<s:searchParameters xsi:type="s:CountryTargetSearchParameter">'
+      country_codes.each do |t|
+        # tag contryCode is into the cm namespace (sem4r main namespace)
+        # tag contryTarget is into o namespace (sem4r service namespace)
+        xml << "<s:countryTargets><countryCode>#{t}</countryCode></s:countryTargets>"
+      end
+      xml << '</s:searchParameters>'
+    end
+  end
+  
+  class TargetingIdeaSelector
+    include SoapAttributes
+
+    enum :IdeaTypes, [:KEYWORD, :PLACEMENT]
+    enum :RequestTypes, [:IDEAS, :STATS]
+
+    g_accessor :idea_type, { :values_in => :IdeaTypes }
+    g_accessor :request_type
+    g_accessor :requested_attributes
+    g_accessor :start_index
+    g_accessor :number_results
+
+    def initialize(&block)
+      @search_parameters = []
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    # TODO: synthetize following methods with metaprogramming
+    def related_to_keyword_search_parameter(&block)
+      @search_parameters << RelatedToKeywordSearchParameter.new(&block)
+    end
+
+    def excluded_keyword_search_parameter(&block)
+      @search_parameters << ExcludedKeywordSearchParameter.new(&block)
+    end
+
+    def keyword_match_type_search_parameter(&block)
+      @search_parameters << KeywordMatchTypeSearchParameter.new(&block)
+    end
+
+    def country_target_search_parameter(&block)
+      @search_parameters << CountryTargetSearchParameter.new(&block)
+    end
+
+    def to_xml
+      xml=<<-EOFS
+       <s:selector>
+          <s:ideaType>#{@idea_type}</s:ideaType>
+          <s:requestType>#{@request_type}</s:requestType>
+      EOFS
+      xml += @search_parameters.collect{ |sp| sp.to_xml }.join()
+      if requested_attributes
+        requested_attributes.each do |requested_attribute|
+          xml += <<-EOS
+            <s:requestedAttributeTypes>#{requested_attribute.to_s.upcase}</s:requestedAttributeTypes>
+          EOS
+        end
+      end
+      xml+=<<-EOFS
+        <s:paging>
+          <startIndex>#{start_index || 0}</startIndex>
+          <numberResults>#{number_results || 100}</numberResults>
+        </s:paging>
+        </s:selector>
+      EOFS
+      xml
+
+    end
+    #      <n3:selector>
+    #
+    #        <n3:ideaType>KEYWORD</n3:ideaType>
+    #        <n3:requestType>IDEAS</n3:requestType>
+    #
+    #
+    #
+    #
+    #        <n3:paging xmlns:n6="https://adwords.google.com/api/adwords/cm/v200909">
+    #          <n6:startIndex>0</n6:startIndex>
+    #          <n6:numberResults>100</n6:numberResults>
+    #        </n3:paging>
+    #
+    #      </n3:selector>
+    #
+
+    ##########################################################################
+
+  end
+end

data/lib/sem4r/targeting_idea/targeting_idea_service.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.
+# -------------------------------------------------------------------
+
+module Sem4r
+  class TargetingIdeaService
+    include SoapCall
+
+    def initialize(connector)
+      @connector = connector
+
+      @header_namespace  = "https://adwords.google.com/api/adwords/cm/v201003"
+      @service_namespace = "https://adwords.google.com/api/adwords/o/v201003"
+
+      @sandbox_service_url    = "https://adwords-sandbox.google.com/api/adwords/o/v201003/TargetingIdeaService"
+      @production_service_url = "https://adwords.google.com/api/adwords/o/v201003/TargetingIdeaService"
+    end
+
+    soap_call_v2009 :get, :mutate => false
+
+    ################
+
+    private
+
+    def _get(xml)
+      <<-EOFS
+      <s:get>#{xml}</s:get>
+      EOFS
+    end
+
+  end
+end

data/lib/sem4r/v13_account/account_service.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.
+# -------------------------------------------------------------------
+
+module Sem4r
+  class AccountService
+    include SoapCall
+
+    def initialize(connector)
+      @connector = connector
+      @sandbox_service_url    = "https://sandbox.google.com/api/adwords/v13/AccountService"
+      @production_service_url = "https://adwords.google.com/api/adwords/v13/AccountService"
+    end
+
+    soap_call_v13 :account_info,    :mutate => false
+    soap_call_v13 :client_accounts, :mutate => false
+
+    private
+
+    def _account_info
+      <<-EOFS
+      <getAccountInfo xmlns="https://adwords.google.com/api/adwords/v13">
+      </getAccountInfo>
+      EOFS
+    end
+
+    def _client_accounts
+      <<-EOFS
+      <getClientAccounts xmlns="https://adwords.google.com/api/adwords/v13">
+      </getClientAccounts>
+      EOFS
+    end
+
+  end
+end

data/lib/sem4r/v13_account/billing_address.rb

@@ -0,0 +1,67 @@
+# -------------------------------------------------------------------------
+# 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 BillingAddress
+    include SoapAttributes
+
+    g_accessor :company_name
+    g_accessor :address_line1
+    g_accessor :address_line2
+    g_accessor :city
+
+    def initialize(&block)
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    # <billingAddress>
+    #   <addressLine1>1600 Amphitheatre Parkway</addressLine1>
+    #   <addressLine2>Building #42</addressLine2>
+    #   <city>Mountain View</city>
+    #   <companyName>Some Company</companyName>
+    #   <countryCode>US</countryCode>
+    #   <emailAddress>Some@email</emailAddress>
+    #   <faxNumber>4085551213</faxNumber>
+    #   <name>Some contact</name>
+    #   <phoneNumber>4085551212</phoneNumber>
+    #   <postalCode>94043</postalCode>
+    #   <state>CA</state>
+    # </billingAddress>
+    def self.from_element(el)
+      new do
+        company_name          el.elements["companyName"].text.strip
+        address_line1         el.elements["addressLine1"].text.strip
+        address_line2         el.elements["addressLine2"].text.strip
+        city                  el.elements["city"].text.strip
+      end
+    end
+
+    def to_s
+      "#{@company_name} #{@address_line1} #{@address_line2} #{@city}"
+    end
+
+  end
+end

data/lib/sem4r/v13_report/report.rb

@@ -0,0 +1,185 @@
+# -------------------------------------------------------------------
+# 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 Report < Base
+
+    enum :AggregationTypes, [ 
+      :Summary,
+      :Daily,     :Weekly,  :Monthly,  :Quarterly,  :Yearly,
+      :DayOfWeek,
+      :HourlyByDate, :HourlyRegardlessDate,
+      :Campaign, :AdGroup, :Keyword,
+      :Creative
+    ]
+
+    enum :Columns, [
+      :Campaign,
+      :AdGroup,
+      :Keyword,
+      :KeywordTypeDisplay]
+
+    enum :ReportTypes, [
+      :Account,           # Account Performance
+      :AdGroup,           # Ad Group Performance
+      :Campaign,          # Campaign Performance
+      :Demographic,       # Demographic Performance
+      :ContentPlacement,  # Placement Performance
+      :Creative,          # Ad Performance
+      :Geographic,        # Geographic Performance
+      :Keyword,           # Placement / Keyword Performance
+      :Query,             # Search Query Performance
+      :ReachAndFrequency, # Reach and Frequency Performance
+      :Structure,         # Account Structure
+      :Url                # URL Performance
+    ]
+
+    enum :Statuses, [ :Pending, :InProgress, :Completed, :Failed ]
+
+    ###########################################################################
+
+    attr_reader :id
+    attr_reader :account
+
+    g_accessor :name
+
+    g_accessor :start_day
+    g_accessor :end_day
+
+    def days(start_day, end_day)
+      self.start_day start_day
+      self.end_day end_day
+    end
+
+    g_accessor :aggregation
+    g_accessor :type
+    g_accessor :cross_client,    {:default => false}
+    g_accessor :zero_impression, {:default => false}
+
+    g_reader   :status
+
+    g_set_accessor :column
+
+    ###########################################################################
+
+    def initialize(account, &block)
+      super( account.adwords, account.credentials )
+      @account = account
+      if block_given?
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def to_s
+      "#{id} '#{name}' #{status}"
+    end
+
+    def xml(t)
+      t.name                name
+      t.selectedReportType  type
+      t.startDay            start_day
+      t.endDay              end_day
+      t.aggregationTypes    aggregation
+
+      t.crossClient           cross_client
+      t.includeZeroImpression zero_impression
+
+      columns.each do |column|
+        t.selectedColumns column
+      end
+    end
+
+    def to_xml
+      builder = Builder::XmlMarkup.new
+      builder.job("xsi:type" => "DefinedReportJob") do |t|
+        xml(t)
+        #        job.name                name
+        #        job.selectedReportType  type
+        #        job.startDay            start_day
+        #        job.endDay              end_day
+        #        job.aggregationTypes    aggregation
+        #
+        #        job.crossClient           cross_client
+        #        job.includeZeroImpression zero_impression
+        #
+        #        columns.each do |column|
+        #          job.selectedColumns column
+        #        end
+      end
+    end
+
+    def self.from_element(account, el)
+      new(account) do
+        @id       = el.elements["id"].text.strip.to_i         # id is read only
+        name        el.elements["name"].text.strip
+        start_day   el.elements["startDay"].text.strip
+        end_day     el.elements["endDay"].text.strip
+        @status   = el.elements["status"].text.strip     # status is read only
+      end
+    end
+
+    ############################################################################
+
+    def status(refresh = false)
+      return @status unless refresh
+      soap_message = service.report.status(credentials, @id)
+      add_counters( soap_message.counters )
+      el = REXML::XPath.first( soap_message.response, "//getReportJobStatusResponse/getReportJobStatusReturn")
+      @status = el.text
+    end
+
+    # Validate the report definition to make sure it is valid.
+    # If it is not, an AdWords::Error::ApiError will be thrown.
+    def validate
+      begin
+        service.report.validate(credentials, to_xml)
+        return true
+      rescue SoapError => e
+        puts e
+      end
+      return false
+    end
+
+    def schedule
+      soap_message = service.report.schedule(credentials, to_xml)
+      add_counters( soap_message.counters )
+      el = REXML::XPath.first( soap_message.response, "//scheduleReportJobResponse/scheduleReportJobReturn")
+      @id = el.text
+      # puts "requested report assigned job nr. #{@job_id}"
+      ReportJob.new(self, @id)
+    end
+
+    def url
+      soap_message = service.report.url(credentials, @id)
+      add_counters( soap_message.counters )
+      el = REXML::XPath.first( soap_message.response, "//getReportDownloadUrlResponse/getReportDownloadUrlReturn")
+      url = el.text
+      url
+    end
+
+    def download(path_name)
+      service.report.download(url, path_name)
+    end
+    
+  end
+end

data/lib/sem4r/v13_report/report_job.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.
+# -------------------------------------------------------------------
+
+module Sem4r
+  class ReportJob < Base
+
+    def initialize(report, job_id)
+      super( report.adwords, report.credentials )
+      @job_id = job_id
+    end
+
+    def wait(sleep_interval = 10, &block)
+      status = nil
+      while status != "Completed" && status != 'Failed'
+        sleep(sleep_interval)
+        status = self.status
+        block.call(self, status) if block
+      end
+      raise Sem4Error, "Report failed" if status == 'Failed'
+    end
+
+    def status
+      soap_message = service.report.status(credentials, @job_id)
+      add_counters( soap_message.counters )
+      el = REXML::XPath.first( soap_message.response, "//getReportJobStatusResponse/getReportJobStatusReturn")
+      status = el.text
+      status
+    end
+
+  end
+end

data/lib/sem4r/v13_report/report_service.rb

@@ -0,0 +1,89 @@
+# -------------------------------------------------------------------
+# 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 ReportService
+
+    include SoapCall
+
+    def initialize(connector)
+      @connector = connector
+      @namespace = "https://adwords.google.com/api/adwords/v13"
+
+      @sandbox_service_url    = "https://sandbox.google.com/api/adwords/v13/ReportService"
+      @production_service_url = "https://adwords.google.com/api/adwords/v13/ReportService"
+    end
+
+    soap_call_v13 :all,      :mutate => false 
+    soap_call_v13 :validate, :mutate => false 
+    soap_call_v13 :schedule, :mutate => false 
+    soap_call_v13 :status,   :mutate => false 
+    soap_call_v13 :url,      :mutate => false 
+
+    ################
+
+    def download(url, path_name)
+      @connector.download(url, path_name)
+    end
+
+    private
+
+    def _all
+      <<-EOFS
+      <getAllJobs xmlns:n1="#{@namespace}">
+      </getAllJobs>
+      EOFS
+    end
+
+    def _validate(job_xml)
+      soap_body_content = "<validateReportJob xmlns=\"#{@namespace}\">"
+      soap_body_content += job_xml
+      soap_body_content += "</validateReportJob>"
+      soap_body_content      
+    end
+
+    def _schedule(job_xml)
+      soap_body_content = "<scheduleReportJob xmlns=\"#{@namespace}\">"
+      soap_body_content += job_xml
+      soap_body_content += "</scheduleReportJob>"
+      soap_body_content
+    end
+
+    def _status(job_id)
+      <<-EOFS
+        <getReportJobStatus xmlns:n1="#{@namespace}">
+          <reportJobId>#{job_id}</reportJobId>
+        </getReportJobStatus>
+      EOFS
+    end
+
+    def _url(job_id)
+      <<-EOFS
+      <getReportDownloadUrl xmlns="#{@namespace}">
+        <reportJobId>#{job_id}</reportJobId>
+      </getReportDownloadUrl>
+      EOFS
+    end
+
+  end
+end