Merge pull request pardot#8 from dcunning/add-email-api

Add email API endpoint

Author: Stephen

README.rdoc

@@ -54,6 +54,15 @@ http://developer.pardot.com/kb/api-version-3/using-prospects
     puts "#{key} is #{value}"
   end
 
+=== Emails
+
+See each individual call's [API reference page](http://developer.pardot.com/kb/api-version-3/introduction-table-of-contents).
+
+  # Sample usage
+  @pardot.emails.read_by_id(email_id)
+  @pardot.emails.send_to_list(:email_template_id => template_id, 'list_ids[]' => list_id, :campaign_id => campaign_id)
+  @pardot.emails.send_to_prospect(prospect_id, :campaign_id => campaign_id, :email_template_id => template_id)
+  
 === Output formats
 
   client.format = "simple" # default

lib/pardot/client.rb

@@ -9,6 +9,7 @@ class Client
     include Authentication
     include Http
 
+    include Objects::Emails
     include Objects::Lists
     include Objects::Opportunities
     include Objects::Prospects

lib/pardot/objects/emails.rb

@@ -0,0 +1,44 @@
+module Pardot
+  module Objects
+
+    module Emails
+
+      def emails
+        @emails ||= Emails.new self
+      end
+
+      class Emails
+
+        def initialize client
+          @client = client
+        end
+
+        def read_by_id id
+          get "/do/read/id/#{id}"
+        end
+
+        def send_to_prospect prospect_id, params
+          post "/do/send/prospect_id/#{prospect_id}", params
+        end
+
+        def send_to_list params
+          post "/do/send", params
+        end
+
+        protected
+
+        def get path, params = {}, result = "email"
+          response = @client.get "email", path, params
+          result ? response[result] : response
+        end
+
+        def post path, params = {}, result = "email"
+          response = @client.post "email", path, params
+          result ? response[result] : response
+        end
+
+      end
+
+    end
+  end
+end

lib/ruby-pardot.rb

@@ -6,6 +6,7 @@
 require 'pardot/error'
 require 'pardot/authentication'
 
+require 'pardot/objects/emails'
 require 'pardot/objects/lists'
 require 'pardot/objects/opportunities'
 require 'pardot/objects/prospects'

spec/pardot/objects/emails_spec.rb

@@ -0,0 +1,36 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe Pardot::Objects::Emails do
+
+  before do
+    @client = create_client
+  end
+
+  def sample_response
+    %(<?xml version="1.0" encoding="UTF-8"?>\n<rsp stat="ok" version="1.0">
+      <email>
+        <name>My Email</name>
+      </email>
+    </rsp>)
+  end
+
+  before do
+    @client = create_client
+  end
+
+  it "should take in the email ID" do
+    fake_get "/api/email/version/3/do/read/id/12?user_key=bar&api_key=my_api_key&format=simple", sample_response
+    @client.emails.read_by_id(12).should == {"name" => "My Email"}
+  end
+
+  it 'should send to a prospect' do
+    fake_post '/api/email/version/3/do/send/prospect_id/42?campaign_id=765&email_template_id=86&user_key=bar&api_key=my_api_key&format=simple', sample_response
+    @client.emails.send_to_prospect(42, :campaign_id => 765, :email_template_id => 86).should == {"name" => "My Email"}
+  end
+
+  it 'should send to a list' do
+    fake_post '/api/email/version/3/do/send?email_template_id=200&list_ids[]=235&campaign_id=654&user_key=bar&api_key=my_api_key&format=simple', sample_response
+    @client.emails.send_to_list(:email_template_id => 200, 'list_ids[]' => 235, :campaign_id => 654).should == {"name" => "My Email"}
+  end
+
+end