constantcontact 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fbe3bbdd27400b7cabb1f7d057ddcf4cbce8af1f
-  data.tar.gz: 5e590cbd2085adbbc074f66963f244d2b9ccf29d
+  metadata.gz: 0c4cc9d1ea9b203b5ca089c9da4b644f42c8ee9f
+  data.tar.gz: 8f618777d2131ad9e2bd55f5a97016e6d7b25849
 SHA512:
-  metadata.gz: 90c879d3fe95da598a0f2f4b9df5e6e8066e21a919a9fdfa029bff1e0fc9beaed0ffaade52e7a000a55a57285caf4d741a1d0209d5d9adb425f724cee3e99d3c
-  data.tar.gz: aa192ef3d3440c8f4bff332df802b63b290af8eedd21847d522243a5c779e3e3e6735e27f5cb36b5f8490c084535d3f3e0092f57ec6ecdb53a385d00d9205b50
+  metadata.gz: 048e7ffe96661bf3941f9fa76287ad9463cf93b7eb92cbfadc00bdc526b7905c4f5ccf08615b0d4d5461e78c719fdb26468706746ebf64b1e8de89c2aac7da80
+  data.tar.gz: c1671514b610d40ee3cec33bad16652665ccd87a4b0b4610deb370187492ffb9c39140725297af8fbed716b6ab37c9c76ba925c46d4419620007df87a8d767e7

data/README.md

@@ -1,139 +1,130 @@
-Constant Contact Ruby SDK
-=========================
-
-In order to use the Constant Contact SDK you have to follow these steps:
-
-A. Rails example :
-
-1. Install the gem :
-
-        gem install constantcontact
-
-2. Configure Rails to load the gem :
-
-        Rails::Initializer.run do |config|
-            ...
-            config.gem "constantcontact"
-            ...
-        end
-        
-or add the following in your .Gemfile :
-
-        gem 'constantcontact'
-
-3. Create a new action and add the following code:
-
-        @oauth = ConstantContact::Auth::OAuth2.new(
-            :api_key => 'your api key',
-            :api_secret => 'your secret key',
-            :redirect_url => 'your redirect url'
-        )
-
-        @error = params[:error]
-        @user = params[:username]
-        @code = params[:code]
-
-        if @code
-            response = @oauth.get_access_token(@code)
-            if response
-                token = response['access_token']
-                cc = ConstantContact::Api.new('your api key')
-                @contacts = cc.get_contacts(token)
-            end
-        end
-
-
-    Note: 'your redirect url' is the URL of the action you just created.
-
-4. Create a view for the above mentioned action with the following code:
-
-        <% if @error %>
-            <p>
-                <%=@error%>
-            </p>
-        <% end %>
-
-        <% if @code %>
-            <% if @contacts %>
-                <% for contact in @contacts %>
-                    <p>
-                        Contact name: <%= contact.first_name + contact.last_name %>
-                    </p>
-                <% end %>
-            <% end %>
-        <% else %>
-            <a href="<%=@oauth.get_authorization_url%>">Click to authorize</a>
-        <% end %>
-
-5. The first time you access the action in browser you should see the "Click to authorize" link.
-Follow the link, go through all the Constant Contact steps required 
-and then you will be redirected back to your action and you should see the list of contacts.
-
-
-6. Add config initializer (optional)
-````ruby
-    ConstantContact::Util::Config.configure do |config|
-      config[:auth][:api_key] = 'foobar'
-      config[:auth][:api_secret] = 'foobar'
+Constant Contact Ruby SDK for AppConnect
+====
+
+The Ruby SDK for AppConnect allows you to leverage the AppConnect v2 APIs.
+
+[![Build Status](https://travis-ci.org/constantcontact/ruby-sdk.png)](https://travis-ci.org/constantcontact/ruby-sdk)
+
+Installation
+====
+Via bundler:
+```ruby
+gem 'constantcontact', '~> 1.1.0'
+```
+Otherwise:
+```bash
+[sudo|rvm] gem install constantcontact
+```
+
+Configuration
+====
+The AppConnect SDK can be configured with some options globally or they can be specified when creating the API client:
+```ruby
+ConstantContact::Util::Config.configure do |config|
+  config[:auth][:api_key] = 'your-access-key'
+  config[:auth][:api_secret] = 'your-access-secret'
+  config[:auth][:redirect_uri] = 'https://example.com/auth/constantcontact'
+end
+```        
+
+Getting Started
+====
+AppConnect requires an OAuth access token which will give your app access to Constant Contact data and services for the accout that granted that access token.
+
+Rails
+=====
+Create a new controller action.  The redirect_url should be the same as the one given when registering the app with Mashery. Use the following code snippet to get an access token:
+```ruby
+@oauth = ConstantContact::Auth::OAuth2.new(
+  :api_key => 'your api key',
+  :api_secret => 'your secret key',
+  :redirect_url => 'your redirect url' # the URL given when registering your app with Mashery.
+)
+
+@error = params[:error]
+@user = params[:username]
+@code = params[:code]
+
+if @code.present?
+  response = @oauth.get_access_token(@code)
+  if response.present?
+    token = response['access_token']
+    cc = ConstantContact::Api.new('your api key')
+    @contacts = cc.get_contacts(token)
+  end
+else
+  # if not code param is provided redirect into the OAuth flow
+  redirect_to @oauth.get_authorization_url and return
+end
+```
+
+Create a view for the above mentioned action with the following code:
+```erb
+
+<% if @error %>
+  <p><%= @error %></p>
+<% end %>
+
+<% if @contacts.present? %>
+  <% @contacts.each do |contact| %>
+    <p>Contact name: <%= "#{contact.first_name} #{contact.last_name}" %></p>
+  <% end %>
+<% end %>
+```
+
+The first time you access the action you will be redirected into the Constant Contact OAuth flow.
+Then you will be redirected back to your action and you should see the list of contacts.
+
+Sinatra
+=====
+Require AppConnect:
+```ruby
+require 'constantcontact'
+```
+
+Add the following route.  The redirect_url should be the same given when registering the app with Mashery.
+```ruby
+get '/my_url' do
+  @oauth = ConstantContact::Auth::OAuth2.new(
+    :api_key => 'your api key',
+    :api_secret => 'your secret key',
+    :redirect_url => 'your redirect url'
+  )
+
+  @error = params[:error]
+  @user = params[:username]
+  @code = params[:code]
+
+  if @code
+    response = @oauth.get_access_token(@code)
+    if response
+      token = response['access_token']
+      cc = ConstantContact::Api.new('your api key')
+      @contacts = cc.get_contacts(token)
     end
-
-B. Sinatra example :
-
-
-1. Install the gem :
-
-        gem install constantcontact
-
-2. Add the following code in myapp.rb (just an example):
-        require 'active_support'
-        require 'constantcontact'
-
-        get '/my_url' do
-            @oauth = ConstantContact::Auth::OAuth2.new(
-                :api_key => 'your api key',
-                :api_secret => 'your secret key',
-                :redirect_url => 'your redirect url'
-            )
-
-            @error = params[:error]
-            @user = params[:username]
-            @code = params[:code]
-
-            if @code
-                response = @oauth.get_access_token(@code)
-                if response
-                    token = response['access_token']
-                    cc = ConstantContact::Api.new('your api key')
-                    @contacts = cc.get_contacts(token)
-                end
-            end
-
-            erb :my_view
-        end
-
-
-    Note: 'your redirect url' is the URL of the route you just created ( get '/my_url' ).
-
-4. Create a my_view.rhtml (or my_view.erb) with the following code:
-
-        <% if @error %>
-            <p>
-                <%=@error%>
-            </p>
-        <% end %>
-
-        <% if @code %>
-            <% if @contacts %>
-                <% for contact in @contacts %>
-                    <p>
-                        Contact name: <%= contact.first_name + contact.last_name %>
-                    </p>
-                <% end %>
-            <% end %>
-        <% else %>
-            <a href="<%=@oauth.get_authorization_url%>">Click to authorize</a>
-        <% end %>
-
-5. The first time you access the action in browser you should see the "Click to authorize" link.
+  end
+
+  erb :my_view
+end
+```
+
+Create a my_view.erb with the following code:
+```ruby
+<% if @error %>
+  <p><%=@error%></p>
+<% end %>
+
+<% if @code %>
+  <% if @contacts %>
+    <% @contacts.each do |contact| %>
+      <p>\Contact name: <%= "#{contact.first_name} #{contact.last_name}" %></p>
+    <% end %>
+  <% end %>
+<% else %>
+  <a href="<%=@oauth.get_authorization_url%>">Click to authorize</a>
+<% end %>
+```
+
+The first time you access the action in browser you should see the "Click to authorize" link.
 Follow the link, go through all the Constant Contact steps required 
 and then you will be redirected back to your action and you should see the list of contacts.

data/constantcontact.gemspec

@@ -21,11 +21,12 @@ Gem::Specification.new do |s|
     'README.md'
   ]
   s.files += Dir['lib/**/*.rb']
-  s.files += Dir['spec/**/*.rb']
   s.executables = []
-  s.require_paths = [ "lib", "spec" ]
-
+  s.require_paths = [ "lib" ]
+  s.test_files = Dir['spec/**/*.rb']
+  
   s.add_dependency("rest-client")
   s.add_dependency("json")
+  s.add_dependency('mime-types', ['1.25.1'])
   s.add_development_dependency("rspec")
 end

data/lib/constantcontact.rb

@@ -13,63 +13,82 @@ require 'cgi/session/pstore'
 
 
 module ConstantContact
-  autoload :Api, "constantcontact/api"
+  autoload :Api, 'constantcontact/api'
 
   module Auth
-    autoload :OAuth2, "constantcontact/auth/oauth2"
-    autoload :Session, "constantcontact/auth/session_data_store"
+    autoload :OAuth2, 'constantcontact/auth/oauth2'
+    autoload :Session, 'constantcontact/auth/session_data_store'
   end
 
   module Components
-    autoload :Component, "constantcontact/components/component"
-    autoload :ResultSet, "constantcontact/components/result_set"
-    autoload :Activity, "constantcontact/components/activities/activity"
-    autoload :ActivityError, "constantcontact/components/activities/activity_error"
-    autoload :AddContacts, "constantcontact/components/activities/add_contacts"
-    autoload :AddContactsImportData, "constantcontact/components/activities/add_contacts_import_data"
-    autoload :ExportContacts, "constantcontact/components/activities/export_contacts"
-    autoload :Address, "constantcontact/components/contacts/address"
-    autoload :Contact, "constantcontact/components/contacts/contact"
-    autoload :ContactList, "constantcontact/components/contacts/contact_list"
-    autoload :CustomField, "constantcontact/components/contacts/custom_field"
-    autoload :EmailAddress, "constantcontact/components/contacts/email_address"
-    autoload :Note, "constantcontact/components/contacts/note"
-    autoload :ClickThroughDetails, "constantcontact/components/email_marketing/click_through_details"
-    autoload :Campaign, "constantcontact/components/email_marketing/campaign"
-    autoload :MessageFooter, "constantcontact/components/email_marketing/message_footer"
-    autoload :Schedule, "constantcontact/components/email_marketing/schedule"
-    autoload :TestSend, "constantcontact/components/email_marketing/test_send"
-    autoload :BounceActivity, "constantcontact/components/tracking/bounce_activity"
-    autoload :ClickActivity, "constantcontact/components/tracking/click_activity"
-    autoload :ForwardActivity, "constantcontact/components/tracking/forward_activity"
-    autoload :OpenActivity, "constantcontact/components/tracking/open_activity"
-    autoload :OptOutActivity, "constantcontact/components/tracking/opt_out_activity"
-    autoload :SendActivity, "constantcontact/components/tracking/send_activity"
-    autoload :TrackingActivity, "constantcontact/components/tracking/tracking_activity"
-    autoload :TrackingSummary, "constantcontact/components/tracking/tracking_summary"
-    autoload :VerifiedEmailAddress, "constantcontact/components/account/verified_email_address"
+    autoload :Component, 'constantcontact/components/component'
+    autoload :ResultSet, 'constantcontact/components/result_set'
+    autoload :Activity, 'constantcontact/components/activities/activity'
+    autoload :ActivityError, 'constantcontact/components/activities/activity_error'
+    autoload :AddContacts, 'constantcontact/components/activities/add_contacts'
+    autoload :AddContactsImportData, 'constantcontact/components/activities/add_contacts_import_data'
+    autoload :ExportContacts, 'constantcontact/components/activities/export_contacts'
+    autoload :Address, 'constantcontact/components/contacts/address'
+    autoload :Contact, 'constantcontact/components/contacts/contact'
+    autoload :ContactList, 'constantcontact/components/contacts/contact_list'
+    autoload :CustomField, 'constantcontact/components/contacts/custom_field'
+    autoload :EmailAddress, 'constantcontact/components/contacts/email_address'
+    autoload :Note, 'constantcontact/components/contacts/note'
+    autoload :ClickThroughDetails, 'constantcontact/components/email_marketing/click_through_details'
+    autoload :Campaign, 'constantcontact/components/email_marketing/campaign'
+    autoload :MessageFooter, 'constantcontact/components/email_marketing/message_footer'
+    autoload :Schedule, 'constantcontact/components/email_marketing/schedule'
+    autoload :TestSend, 'constantcontact/components/email_marketing/test_send'
+    autoload :BounceActivity, 'constantcontact/components/tracking/bounce_activity'
+    autoload :ClickActivity, 'constantcontact/components/tracking/click_activity'
+    autoload :ForwardActivity, 'constantcontact/components/tracking/forward_activity'
+    autoload :OpenActivity, 'constantcontact/components/tracking/open_activity'
+    autoload :UnsubscribeActivity, 'constantcontact/components/tracking/unsubscribe_activity'
+    autoload :SendActivity, 'constantcontact/components/tracking/send_activity'
+    autoload :TrackingActivity, 'constantcontact/components/tracking/tracking_activity'
+    autoload :TrackingSummary, 'constantcontact/components/tracking/tracking_summary'
+    autoload :VerifiedEmailAddress, 'constantcontact/components/account/verified_email_address'
+    autoload :Event, 'constantcontact/components/event_spot/event'
+    autoload :Fee, 'constantcontact/components/event_spot/fee'
+    autoload :Registrant, 'constantcontact/components/event_spot/registrant'
+    autoload :LibrarySummary, 'constantcontact/components/library/info/library_summary'
+    autoload :UploadStatus, 'constantcontact/components/library/info/upload_status'
+    autoload :MoveResults, 'constantcontact/components/library/info/move_results'
+    autoload :LibraryFolder, 'constantcontact/components/library/folder/library_folder'
+    autoload :LibraryFile, 'constantcontact/components/library/file/library_file'
+
+    module EventSpot
+      autoload :Contact, 'constantcontact/components/event_spot/contact'
+      autoload :NotificationOption, 'constantcontact/components/event_spot/notification_option'
+      autoload :Guest, 'constantcontact/components/event_spot/guest'
+      autoload :EventTrack, 'constantcontact/components/event_spot/event_track'
+      autoload :RegistrantSection, 'constantcontact/components/event_spot/registrant_section'
+      autoload :RegistrantField, 'constantcontact/components/event_spot/registrant_field'
+    end
   end
 
   module Exceptions
-    autoload :CtctException, "constantcontact/exceptions/ctct_exception"
-    autoload :IllegalArgumentException, "constantcontact/exceptions/illegal_argument_exception"
-    autoload :OAuth2Exception, "constantcontact/exceptions/oauth2_exception"
+    autoload :CtctException, 'constantcontact/exceptions/ctct_exception'
+    autoload :IllegalArgumentException, 'constantcontact/exceptions/illegal_argument_exception'
+    autoload :OAuth2Exception, 'constantcontact/exceptions/oauth2_exception'
   end
 
   module Services
-    autoload :BaseService, "constantcontact/services/base_service"
-    autoload :ActivityService, "constantcontact/services/activity_service"
-    autoload :CampaignScheduleService, "constantcontact/services/campaign_schedule_service"
-    autoload :CampaignTrackingService, "constantcontact/services/campaign_tracking_service"
-    autoload :ContactService, "constantcontact/services/contact_service"
-    autoload :ContactTrackingService, "constantcontact/services/contact_tracking_service"
-    autoload :EmailMarketingService, "constantcontact/services/email_marketing_service"
-    autoload :ListService, "constantcontact/services/list_service"
-    autoload :AccountService, "constantcontact/services/account_service"
+    autoload :BaseService, 'constantcontact/services/base_service'
+    autoload :ActivityService, 'constantcontact/services/activity_service'
+    autoload :CampaignScheduleService, 'constantcontact/services/campaign_schedule_service'
+    autoload :CampaignTrackingService, 'constantcontact/services/campaign_tracking_service'
+    autoload :ContactService, 'constantcontact/services/contact_service'
+    autoload :ContactTrackingService, 'constantcontact/services/contact_tracking_service'
+    autoload :EmailMarketingService, 'constantcontact/services/email_marketing_service'
+    autoload :ListService, 'constantcontact/services/list_service'
+    autoload :AccountService, 'constantcontact/services/account_service'
+    autoload :EventSpotService, 'constantcontact/services/event_spot_service'
+    autoload :LibraryService, 'constantcontact/services/library_service'
   end
 
   module Util
-    autoload :Config, "constantcontact/util/config"
-    autoload :Helpers, "constantcontact/util/helpers"
+    autoload :Config, 'constantcontact/util/config'
+    autoload :Helpers, 'constantcontact/util/helpers'
   end
 end

data/lib/constantcontact/api.rb

@@ -5,539 +5,936 @@
 # Copyright (c) 2013 Constant Contact. All rights reserved.
 
 module ConstantContact
-	class Api
-		# Class constructor
-		# @param [String] api_key - Constant Contact API Key
-		# @return
-		def initialize(api_key = nil)
-			Services::BaseService.api_key = api_key || Util::Config.get('auth.api_key')
-			if Services::BaseService.api_key.nil? || Services::BaseService.api_key == ''
-				raise ArgumentError.new("api_key required either explicitly or in configuration.")
-			end
-		end
-
-
-		# Get verified addresses for the account
-		# @param [String] access_token - Valid access token
-		# @return [Array<VerifiedEmailAddress>] an array of email addresses
-		def get_verified_email_addresses(access_token)
-			Services::AccountService.get_verified_email_addresses(access_token)
-		end
-
-
-		# Get a set of contacts
-		# @param [String] access_token - Valid access token
-		# @param [Integer] param - denotes the number of results per set, limited to 50, 
-		# or a next parameter provided from a previous call
-		# @return [ResultSet<Contact>] a ResultSet of Contacts
-		def get_contacts(access_token, param = nil)
-			param = determine_param(param)
-			Services::ContactService.get_contacts(access_token, param)
-		end
-
-
-		# Get an individual contact
-		# @param [String] access_token - Valid access token
-		# @param [Integer] contact_id - Id of the contact to retrieve
-		# @return [Contact]
-		def get_contact(access_token, contact_id)
-			Services::ContactService.get_contact(access_token, contact_id)
-		end
-
-
-		# Get contacts with a specified email eaddress
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [String] email - contact email address to search for
-		# @return [ResultSet<Contact>] a ResultSet of Contacts
-		def get_contact_by_email(access_token, email)
-			Services::ContactService.get_contacts(access_token, {'email' => email})
-		end
-
-
-		# Add a new contact to an account
-		# @param [String] access_token - Valid access token
-		# @param [Contact] contact - Contact to add
-		# @param [Boolean] action_by_visitor - if the action is being taken by the visitor
-		# @return [Contact]
-		def add_contact(access_token, contact, action_by_visitor = false)
-			Services::ContactService.add_contact(access_token, contact, action_by_visitor)
-		end
-
-
-		# Sets an individual contact to 'REMOVED' status
-		# @param [String] access_token - Valid access token
-		# @param [Mixed] contact - Either a Contact id or the Contact itself
-		# @raise [IllegalArgumentException] If contact is not an integer or a Contact object
-		# @return [Boolean]
-		def delete_contact(access_token, contact)
-			contact_id = get_argument_id(contact, 'Contact')
-			Services::ContactService.delete_contact(access_token, contact_id)
-		end
-
-
-		# Delete a contact from all contact lists
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or the Contact object itself
-		# @raise [IllegalArgumentException] If contact is not an integer or a Contact object
-		# @return [Boolean]
-		def delete_contact_from_lists(access_token, contact)
-			contact_id = get_argument_id(contact, 'Contact')
-			Services::ContactService.delete_contact_from_lists(access_token, contact_id)
-		end
-
-
-		# Delete a contact from all contact lists
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or a Contact object
-		# @param [Mixed] list - ContactList id or a ContactList object
-		# @raise [IllegalArgumentException] If contact is not an integer or a Contact object
-		# @return [Boolean]
-		def delete_contact_from_list(access_token, contact, list)
-			contact_id = get_argument_id(contact, 'Contact')
-			list_id = get_argument_id(list, 'ContactList')
-			Services::ContactService.delete_contact_from_list(access_token, contact_id, list_id)
-		end
-
-
-		# Update an individual contact
-		# @param [String] access_token - Valid access token
-		# @param [Contact] contact - Contact to update
-		# @param [Boolean] action_by_visitor - if the action is being taken by the visitor
-		# @return [Contact]
-		def update_contact(access_token, contact, action_by_visitor = false)
-			Services::ContactService.update_contact(access_token, contact, action_by_visitor)
-		end
-
-
-		# Get lists
-		# @param [String] access_token - Valid access token
-		# @return [Array<ContactList>] Array of ContactList objects
-		def get_lists(access_token)
-			Services::ListService.get_lists(access_token)
-		end
-
-
-		# Get an individual list
-		# @param [String] access_token - Valid access token
-		# @param [Integer] list_id - Id of the list to retrieve
-		# @return [ContactList]
-		def get_list(access_token, list_id)
-			Services::ListService.get_list(access_token, list_id)
-		end
-
-
-		# Add a new list to an account
-		# @param [String] access_token - Valid access token
-		# @param [ContactList] list - List to add
-		# @return [ContactList]
-		def add_list(access_token, list)
-			Services::ListService.add_list(access_token, list)
-		end
-
-
-		# Update a contact list
-		# @param [String] access_token - Valid access token
-		# @param [ContactList] list - ContactList to update
-		# @return [ContactList]
-		def update_list(access_token, list)
-			Services::ListService.update_list(access_token, list)
-		end
-
-
-		# Get contact that belong to a specific list
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] list - Integer id of the list or ContactList object
-		# @raise [IllegalArgumentException] If contact is not an integer or contact
-		# @return [Array<Contact>] An array of contacts
-		def get_contacts_from_list(access_token, list)
-			list_id = get_argument_id(list, 'ContactList')
-			Services::ListService.get_contacts_from_list(access_token, list_id)
-		end
-
-
-		# Get a set of campaigns
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [String] param - denotes the number of results per set, limited to 50, or a next parameter provided
-		# from a previous call
-		# @return [ResultSet<Campaign>]
-		def get_email_campaigns(access_token, param = nil)
-			param = determine_param(param)
-			Services::EmailMarketingService.get_campaigns(access_token, param)
-		end
-
-
-		# Get an individual campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Integer] campaign_id - Valid campaign id
-		# @return [Campaign]
-		def get_email_campaign(access_token, campaign_id)
-			Services::EmailMarketingService.get_campaign(access_token, campaign_id)
-		end
-
-
-		# Delete an individual campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Id of a campaign or a Campaign object
-		# @raise IllegalArgumentException - if a Campaign object or campaign id is not passed
-		# @return [Boolean]
-		def delete_email_campaign(access_token, campaign)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			Services::EmailMarketingService.delete_campaign(access_token, campaign_id)
-		end
-
-
-		# Create a new campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Campaign] campaign - Campaign to be created
-		# @return [Campaign] - created campaign
-		def add_email_campaign(access_token, campaign)
-			Services::EmailMarketingService.add_campaign(access_token, campaign)
-		end
-
-
-		# Update a specific campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Campaign] campaign - Campaign to be updated
-		# @return [Campaign] - updated campaign
-		def update_email_campaign(access_token, campaign)
-			Services::EmailMarketingService.update_campaign(access_token, campaign)
-		end
-
-
-		# Schedule a campaign to be sent
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Id of a campaign or a Campaign object
-		# @param [Schedule] schedule - Schedule to be associated with the provided campaign
-		# @return [Campaign] - updated campaign
-		def add_email_campaign_schedule(access_token, campaign, schedule)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			Services::CampaignScheduleService.add_schedule(access_token, campaign_id, schedule)
-		end
-
-
-		# Get an array of schedules associated with a given campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @return [Array<Schedule>]
-		def get_email_campaign_schedules(access_token, campaign)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			Services::CampaignScheduleService.get_schedules(access_token, campaign_id)
-		end
-
-
-		# Get a specific schedule associated with a given campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [Mixed] schedule - Schedule id or Schedule object itself
-		# @raise IllegalArgumentException
-		# @return [Schedule]
-		def get_email_campaign_schedule(access_token, campaign, schedule)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			schedule_id = get_argument_id(schedule, 'Schedule')
-			Services::CampaignScheduleService.get_schedule(access_token, campaign_id, schedule_id)
-		end
-
-
-		# Update a specific schedule associated with a given campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [Schedule] schedule - Schedule to be updated
-		# @return [Schedule]
-		def update_email_campaign_schedule(access_token, campaign, schedule)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			Services::CampaignScheduleService.update_schedule(access_token, campaign_id, schedule)
-		end
-
-
-		# Delete a specific schedule associated with a given campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [Mixed] schedule - Schedule id or Schedule object itself
-		# @raise IllegalArgumentException
-		# @return [Boolean]
-		def delete_email_campaign_schedule(access_token, campaign, schedule)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			schedule_id = get_argument_id(schedule, 'Schedule')
-			Services::CampaignScheduleService.delete_schedule(access_token, campaign_id, schedule_id)
-		end
-
-
-		# Send a test send of a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [TestSend] test_send - test send details
-		# @return [TestSend]
-		def send_email_campaign_test(access_token, campaign, test_send)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			Services::CampaignScheduleService.send_test(access_token, campaign_id, test_send)
-		end
-
-
-		# Get sends for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [String] param - next value returned from a previous request (used in pagination)
-		# @return [ResultSet<SendActivity>]
-		def get_email_campaign_sends(access_token, campaign, param = nil)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			param = determine_param(param)
-			Services::CampaignTrackingService.get_sends(access_token, campaign_id, param)
-		end
-
-
-		# Get bounces for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign  - Campaign id or Campaign object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<BounceActivity>]
-		def get_email_campaign_bounces(access_token, campaign, param = nil)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			param = determine_param(param)
-			Services::CampaignTrackingService.get_bounces(access_token, campaign_id, param)
-		end
-
-
-		# Get clicks for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<ClickActivity>]
-		def get_email_campaign_clicks(access_token, campaign, param = nil)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			param = determine_param(param)
-			Services::CampaignTrackingService.get_clicks(access_token, campaign_id, param)
-		end
-
-
-		# Get opens for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign  - Campaign id or Campaign object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<OpenActivity>]
-		def get_email_campaign_opens(access_token, campaign, param = nil)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			param = determine_param(param)
-			Services::CampaignTrackingService.get_opens(access_token, campaign_id, param)
-		end
-
-
-		# Get forwards for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<ForwardActivity>]
-		def get_email_campaign_forwards(access_token, campaign, param = nil)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			param = determine_param(param)
-			Services::CampaignTrackingService.get_forwards(access_token, campaign_id, param)
-		end
-
-
-		# Get unsubscribes for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign - Campaign id or Campaign object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<UnsubscribeActivity>] - Containing a results array of UnsubscribeActivity
-		def get_email_campaign_unsubscribes(access_token, campaign, param = nil)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			param = determine_param(param)
-			Services::CampaignTrackingService.get_unsubscribes(access_token, campaign_id, param)
-		end
-
-
-		# Get a reporting summary for a campaign
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] campaign  - Campaign id or Campaign object itself
-		# @return [TrackingSummary]
-		def get_email_campaign_summary_report(access_token, campaign)
-			campaign_id = get_argument_id(campaign, 'Campaign')
-			Services::CampaignTrackingService.get_summary(access_token, campaign_id)
-		end
-
-
-		# Get sends for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or Contact object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<SendActivity>]
-		def get_contact_sends(access_token, contact, param = nil)
-			contact_id = get_argument_id(contact, 'Contact')
-			Services::ContactTrackingService.get_sends(access_token, contact_id, param)
-		end
-
-
-		# Get bounces for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or Contact object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<BounceActivity>]
-		def get_contact_bounces(access_token, contact, param = nil)
-			contact_id = get_argument_id(contact, 'Contact')
-			Services::ContactTrackingService.get_bounces(access_token, contact_id, param)
-		end
-
-
-		# Get clicks for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or Contact object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<ClickActivity>]
-		def get_contact_clicks(access_token, contact, param = nil)
-			contact_id = get_argument_id(contact, 'Contact')
-			param = determine_param(param)
-			Services::ContactTrackingService.get_clicks(access_token, contact_id, param)
-		end
-
-
-		# Get opens for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact  - Contact id or Contact object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<OpenActivity>]
-		def get_contact_opens(access_token, contact, param = nil)
-			contact_id = get_argument_id(contact, 'Contact')
-			param = determine_param(param)
-			Services::ContactTrackingService.get_opens(access_token, contact_id, param)
-		end
-
-
-		# Get forwards for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact  - Contact id or Contact object itself
-		# @param [Mixed] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [ResultSet<ForwardActivity>]
-		def get_contact_forwards(access_token, contact, param = nil)
-			contact_id = get_argument_id(contact, 'Contact')
-			param = determine_param(param)
-			Services::ContactTrackingService.get_forwards(access_token, contact_id, param)
-		end
-
-
-		# Get unsubscribes for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or Contact object itself
-		# @param [Hash] param - either the next link from a previous request, or a limit or restrict the page size of
-		# an initial request
-		# @return [UnsubscribeActivity] - Containing a results array of UnsubscribeActivity
-		def get_contact_unsubscribes(access_token, contact, param = nil)
-			contact_id = get_argument_id(contact, 'Contact')
-			param = determine_param(param)
-			Services::ContactTrackingService.get_unsubscribes(access_token, contact_id, param)
-		end
-
-
-		# Get a reporting summary for a Contact
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Mixed] contact - Contact id or Contact object itself
-		# @return [TrackingSummary]
-		def get_contact_summary_report(access_token, contact)
-			contact_id = get_argument_id(contact, 'Contact')
-			Services::ContactTrackingService.get_summary(access_token, contact_id)
-		end
-
-
-		# Get an array of activities
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @return [Array<Activity>]
-		def get_activities(access_token)
-			Services::ActivityService.get_activities(access_token)
-		end
-
-
-		# Get a single activity by id
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [String] activity_id - Activity id
-		# @return [Activity]
-		def get_activity(access_token, activity_id)
-			Services::ActivityService.get_activity(access_token, activity_id)
-		end
-
-
-		# Add an AddContacts activity to add contacts in bulk
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [AddContacts] add_contacts - Add Contacts
-		# @return [Activity]
-		def add_add_contacts_activity(access_token, add_contacts)
-			Services::ActivityService.create_add_contacts_activity(access_token, add_contacts)
-		end
-
-
-		# Add a ClearLists Activity to remove all contacts from the provided lists
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Array<Lists>] lists - Add Contacts Activity
-		# @return [Activity]
-		def add_clear_lists_activity(access_token, lists)
-			Services::ActivityService.add_clear_lists_activity(access_token, lists)
-		end
-
-
-		# Add a Remove Contacts From Lists Activity
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [Array<EmailAddress>] email_addresses - email addresses to be removed
-		# @param [Array<Lists>] lists - lists to remove the provided email addresses from
-		# @return [Activity]
-		def add_remove_contacts_from_lists_activity(access_token, email_addresses, lists)
-			Services::ActivityService.add_remove_contacts_from_lists_activity(access_token, email_addresses, lists)
-		end
-
-
-		# Create an Export Contacts Activity
-		# @param [String] access_token - Constant Contact OAuth2 access token
-		# @param [<Array>Contacts] export_contacts - Contacts to be exported
-		# @return [Activity]
-		def add_export_contacts_activity(access_token, export_contacts)
-			Services::ActivityService.add_export_contacts_activity(access_token, export_contacts)
-		end
-
-
-		private
-
-
-		# Get the id of object, or attempt to convert the argument to an int
-		# @param [Mixed] item - object or a numeric value
-		# @param [String] class_name - class name to test the given object against
-		# @raise IllegalArgumentException - if the item is not an instance of the class name given, or cannot be
-		# converted to a numeric value
-		# @return [Integer]
-		def get_argument_id(item, class_name)
-			item_id = nil
-			if item.is_a?(Integer)
-				item_id = item
-			elsif item.class.to_s.split('::').last == class_name
-				item_id = item.id
-			else
-				raise Exceptions::IllegalArgumentException.new(sprintf(Util::Config.get('errors.id_or_object'), class_name))
-			end
-			item_id
-		end
-
-
-		# Append the limit parameter, if the value is an integer
-		# @param [String] param - parameter value
-		# @return [Hash] the parameters as a hash object
-		def determine_param(param)
-			params = {}
-			if param
-				param = param.to_s
-				if param[0, 1] == '?'
-					hash_params = CGI::parse(param[1..-1])
-					params = Hash[*hash_params.collect {|key, value| [key, value.first] }.flatten]
-				else
-					params['limit'] = param
-				end
-			end
-			params
-		end
-
-	end
+  class Api
+    # Class constructor
+    # @param [String] api_key - Constant Contact API Key
+    # @return
+    def initialize(api_key = nil)
+      Services::BaseService.api_key = api_key || Util::Config.get('auth.api_key')
+      if Services::BaseService.api_key.nil? || Services::BaseService.api_key == ''
+        raise ArgumentError.new("api_key required either explicitly or in configuration.")
+      end
+    end
+
+
+    # Get verified addresses for the account
+    # @param [String] access_token - Valid access token
+    # @param [String] status - status to filter query results by
+    # @return [Array<VerifiedEmailAddress>] an array of email addresses
+    def get_verified_email_addresses(access_token, status = nil)
+      params = {}
+      params['status'] = status if status
+      Services::AccountService.get_verified_email_addresses(access_token, params)
+    end
+
+
+    # Get a set of contacts
+    # @param [String] access_token - Valid access token
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    # Allowed parameters include:
+    #    limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #    modified_since - ISO-8601 formatted timestamp.
+    #    next - the next link returned from a previous paginated call. May only be used by itself.
+    #    email - the contact by email address to retrieve information for.
+    #    status - a contact status to filter results by. Must be one of ACTIVE, OPTOUT, REMOVED, UNCONFIRMED.
+    # @return [ResultSet<Contact>] a ResultSet of Contacts
+    def get_contacts(access_token, params = {})
+      Services::ContactService.get_contacts(access_token, params)
+    end
+
+
+    # Get an individual contact
+    # @param [String] access_token - Valid access token
+    # @param [Integer] contact_id - Id of the contact to retrieve
+    # @return [Contact]
+    def get_contact(access_token, contact_id)
+      Services::ContactService.get_contact(access_token, contact_id)
+    end
+
+
+    # Get contacts with a specified email eaddress
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] email - contact email address to search for
+    # @return [ResultSet<Contact>] a ResultSet of Contacts
+    def get_contact_by_email(access_token, email)
+      Services::ContactService.get_contacts(access_token, {'email' => email})
+    end
+
+
+    # Add a new contact to an account
+    # @param [String] access_token - Valid access token
+    # @param [Contact] contact - Contact to add
+    # @param [Boolean] action_by_visitor - if the action is being taken by the visitor
+    # @return [Contact]
+    def add_contact(access_token, contact, action_by_visitor = false)
+      params = {}
+      params['action_by'] = 'ACTION_BY_VISITOR' if action_by_visitor
+      Services::ContactService.add_contact(access_token, contact, params)
+    end
+
+
+    # Sets an individual contact to 'REMOVED' status
+    # @param [String] access_token - Valid access token
+    # @param [Mixed] contact - Either a Contact id or the Contact itself
+    # @raise [IllegalArgumentException] If contact is not an integer or a Contact object
+    # @return [Boolean]
+    def delete_contact(access_token, contact)
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactService.delete_contact(access_token, contact_id)
+    end
+
+
+    # Delete a contact from all contact lists
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or the Contact object itself
+    # @raise [IllegalArgumentException] If contact is not an integer or a Contact object
+    # @return [Boolean]
+    def delete_contact_from_lists(access_token, contact)
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactService.delete_contact_from_lists(access_token, contact_id)
+    end
+
+
+    # Delete a contact from all contact lists
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or a Contact object
+    # @param [Mixed] list - ContactList id or a ContactList object
+    # @raise [IllegalArgumentException] If contact is not an integer or a Contact object
+    # @return [Boolean]
+    def delete_contact_from_list(access_token, contact, list)
+      contact_id = get_argument_id(contact, 'Contact')
+      list_id = get_argument_id(list, 'ContactList')
+      Services::ContactService.delete_contact_from_list(access_token, contact_id, list_id)
+    end
+
+
+    # Update an individual contact
+    # @param [String] access_token - Valid access token
+    # @param [Contact] contact - Contact to update
+    # @param [Boolean] action_by_visitor - if the action is being taken by the visitor
+    # @return [Contact]
+    def update_contact(access_token, contact, action_by_visitor = false)
+      params = {}
+      params['action_by'] = 'ACTION_BY_VISITOR' if action_by_visitor
+      Services::ContactService.update_contact(access_token, contact, params)
+    end
+
+
+    # Get lists
+    # @param [String] access_token - Valid access token
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     - modified_since - ISO-8601 formatted timestamp.
+    # @return [Array<ContactList>] Array of ContactList objects
+    def get_lists(access_token, params = {})
+      Services::ListService.get_lists(access_token, params)
+    end
+
+
+    # Get an individual list
+    # @param [String] access_token - Valid access token
+    # @param [Integer] list_id - Id of the list to retrieve
+    # @return [ContactList]
+    def get_list(access_token, list_id)
+      Services::ListService.get_list(access_token, list_id)
+    end
+
+
+    # Add a new list to an account
+    # @param [String] access_token - Valid access token
+    # @param [ContactList] list - List to add
+    # @return [ContactList]
+    def add_list(access_token, list)
+      Services::ListService.add_list(access_token, list)
+    end
+
+
+    # Update a contact list
+    # @param [String] access_token - Valid access token
+    # @param [ContactList] list - ContactList to update
+    # @return [ContactList]
+    def update_list(access_token, list)
+      Services::ListService.update_list(access_token, list)
+    end
+
+
+    # Get contact that belong to a specific list
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] list - Integer id of the list or ContactList object
+    # @param [Mixed] param - denotes the number of results per set, limited to 50, or a next parameter provided
+    # from a previous getContactsFromList call
+    # @raise [IllegalArgumentException] If contact is not an integer or contact
+    # @return [Array<Contact>] An array of contacts
+    def get_contacts_from_list(access_token, list, param = nil)
+      list_id = get_argument_id(list, 'ContactList')
+      param = determine_param(param)
+      Services::ListService.get_contacts_from_list(access_token, list_id, param)
+    end
+
+
+    # Get a set of campaigns
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     modified_since - ISO-8601 formatted timestamp.
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    #     email - the contact by email address to retrieve information for
+    # @return [ResultSet<Campaign>]
+    def get_email_campaigns(access_token, params = {})
+      Services::EmailMarketingService.get_campaigns(access_token, params)
+    end
+
+
+    # Get an individual campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Integer] campaign_id - Valid campaign id
+    # @return [Campaign]
+    def get_email_campaign(access_token, campaign_id)
+      Services::EmailMarketingService.get_campaign(access_token, campaign_id)
+    end
+
+
+    # Delete an individual campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Id of a campaign or a Campaign object
+    # @raise IllegalArgumentException - if a Campaign object or campaign id is not passed
+    # @return [Boolean]
+    def delete_email_campaign(access_token, campaign)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::EmailMarketingService.delete_campaign(access_token, campaign_id)
+    end
+
+
+    # Create a new campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Campaign] campaign - Campaign to be created
+    # @return [Campaign] - created campaign
+    def add_email_campaign(access_token, campaign)
+      Services::EmailMarketingService.add_campaign(access_token, campaign)
+    end
+
+
+    # Update a specific campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Campaign] campaign - Campaign to be updated
+    # @return [Campaign] - updated campaign
+    def update_email_campaign(access_token, campaign)
+      Services::EmailMarketingService.update_campaign(access_token, campaign)
+    end
+
+
+    # Schedule a campaign to be sent
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Id of a campaign or a Campaign object
+    # @param [Schedule] schedule - Schedule to be associated with the provided campaign
+    # @return [Campaign] - updated campaign
+    def add_email_campaign_schedule(access_token, campaign, schedule)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignScheduleService.add_schedule(access_token, campaign_id, schedule)
+    end
+
+
+    # Get an array of schedules associated with a given campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @return [Array<Schedule>]
+    def get_email_campaign_schedules(access_token, campaign)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignScheduleService.get_schedules(access_token, campaign_id)
+    end
+
+
+    # Get a specific schedule associated with a given campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Mixed] schedule - Schedule id or Schedule object itself
+    # @raise IllegalArgumentException
+    # @return [Schedule]
+    def get_email_campaign_schedule(access_token, campaign, schedule)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      schedule_id = get_argument_id(schedule, 'Schedule')
+      Services::CampaignScheduleService.get_schedule(access_token, campaign_id, schedule_id)
+    end
+
+
+    # Update a specific schedule associated with a given campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Schedule] schedule - Schedule to be updated
+    # @return [Schedule]
+    def update_email_campaign_schedule(access_token, campaign, schedule)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignScheduleService.update_schedule(access_token, campaign_id, schedule)
+    end
+
+
+    # Delete a specific schedule associated with a given campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Mixed] schedule - Schedule id or Schedule object itself
+    # @raise IllegalArgumentException
+    # @return [Boolean]
+    def delete_email_campaign_schedule(access_token, campaign, schedule)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      schedule_id = get_argument_id(schedule, 'Schedule')
+      Services::CampaignScheduleService.delete_schedule(access_token, campaign_id, schedule_id)
+    end
+
+
+    # Send a test send of a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [TestSend] test_send - test send details
+    # @return [TestSend]
+    def send_email_campaign_test(access_token, campaign, test_send)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignScheduleService.send_test(access_token, campaign_id, test_send)
+    end
+
+
+    # Get sends for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<SendActivity>]
+    def get_email_campaign_sends(access_token, campaign, params = {})
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_sends(access_token, campaign_id, params)
+    end
+
+
+    # Get bounces for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign  - Campaign id or Campaign object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<BounceActivity>]
+    def get_email_campaign_bounces(access_token, campaign, params = {})
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_bounces(access_token, campaign_id, params)
+    end
+
+
+    # Get clicks for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<ClickActivity>]
+    def get_email_campaign_clicks(access_token, campaign, params = {})
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_clicks(access_token, campaign_id, params)
+    end
+
+
+    # Get opens for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign  - Campaign id or Campaign object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<OpenActivity>]
+    def get_email_campaign_opens(access_token, campaign, params = {})
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_opens(access_token, campaign_id, params)
+    end
+
+
+    # Get forwards for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<ForwardActivity>]
+    def get_email_campaign_forwards(access_token, campaign, params = {})
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_forwards(access_token, campaign_id, params)
+    end
+
+
+    # Get unsubscribes for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign - Campaign id or Campaign object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<UnsubscribeActivity>] - Containing a results array of UnsubscribeActivity
+    def get_email_campaign_unsubscribes(access_token, campaign, params = {})
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_unsubscribes(access_token, campaign_id, params)
+    end
+
+
+    # Get a reporting summary for a campaign
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] campaign  - Campaign id or Campaign object itself
+    # @return [TrackingSummary]
+    def get_email_campaign_summary_report(access_token, campaign)
+      campaign_id = get_argument_id(campaign, 'Campaign')
+      Services::CampaignTrackingService.get_summary(access_token, campaign_id)
+    end
+
+
+    # Get sends for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or Contact object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<SendActivity>]
+    def get_contact_sends(access_token, contact, params = {})
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_sends(access_token, contact_id, params)
+    end
+
+
+    # Get bounces for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or Contact object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<BounceActivity>]
+    def get_contact_bounces(access_token, contact, params = {})
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_bounces(access_token, contact_id, params)
+    end
+
+
+    # Get clicks for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or Contact object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<ClickActivity>]
+    def get_contact_clicks(access_token, contact, params = {})
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_clicks(access_token, contact_id, params)
+    end
+
+
+    # Get opens for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact  - Contact id or Contact object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<OpenActivity>]
+    def get_contact_opens(access_token, contact, params = {})
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_opens(access_token, contact_id, params)
+    end
+
+
+    # Get forwards for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact  - Contact id or Contact object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [ResultSet<ForwardActivity>]
+    def get_contact_forwards(access_token, contact, params = {})
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_forwards(access_token, contact_id, params)
+    end
+
+
+    # Get unsubscribes for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or Contact object itself
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 500, default = 50.
+    #     created_since - Used to retrieve a list of events since the date and time specified (in ISO-8601 format).
+    #     next - the next link returned from a previous paginated call. May only be used by itself.
+    # @return [UnsubscribeActivity] - Containing a results array of UnsubscribeActivity
+    def get_contact_unsubscribes(access_token, contact, params = {})
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_unsubscribes(access_token, contact_id, params)
+    end
+
+
+    # Get a reporting summary for a Contact
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Mixed] contact - Contact id or Contact object itself
+    # @return [TrackingSummary]
+    def get_contact_summary_report(access_token, contact)
+      contact_id = get_argument_id(contact, 'Contact')
+      Services::ContactTrackingService.get_summary(access_token, contact_id)
+    end
+
+
+    # Get an array of activities
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     status - Status of the activity, must be one of UNCONFIRMED, PENDING, QUEUED, RUNNING, COMPLETE, ERROR
+    #     type - Type of activity, must be one of ADD_CONTACTS, REMOVE_CONTACTS_FROM_LISTS, CLEAR_CONTACTS_FROM_LISTS,
+    #            EXPORT_CONTACTS
+    # @return [Array<Activity>]
+    def get_activities(access_token, params = {})
+      Services::ActivityService.get_activities(access_token, params)
+    end
+
+
+    # Get a single activity by id
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] activity_id - Activity id
+    # @return [Activity]
+    def get_activity(access_token, activity_id)
+      Services::ActivityService.get_activity(access_token, activity_id)
+    end
+
+
+    # Add an AddContacts activity to add contacts in bulk
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [AddContacts] add_contacts - Add Contacts Activity
+    # @return [Activity]
+    def add_create_contacts_activity(access_token, add_contacts)
+      Services::ActivityService.create_add_contacts_activity(access_token, add_contacts)
+    end
+
+
+    # Create an Add Contacts Activity from a file. Valid file types are txt, csv, xls, xlsx
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] file_name - The name of the file (ie: contacts.csv)
+    # @param [String] contents - The content of the file
+    # @param [String] lists - Comma separated list of ContactList id's to add the contacts to
+    # @return [Activity]
+    def add_create_contacts_activity_from_file(access_token, file_name, contents, lists)
+      Services::ActivityService.create_add_contacts_activity_from_file(access_token, file_name, contents, lists)
+    end
+
+
+    # Add a ClearLists Activity to remove all contacts from the provided lists
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Array<Lists>] lists - Add Contacts Activity
+    # @return [Activity]
+    def add_clear_lists_activity(access_token, lists)
+      Services::ActivityService.add_clear_lists_activity(access_token, lists)
+    end
+
+
+    # Add a Remove Contacts From Lists Activity
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Array<EmailAddress>] email_addresses - email addresses to be removed
+    # @param [Array<Lists>] lists - lists to remove the provided email addresses from
+    # @return [Activity]
+    def add_remove_contacts_from_lists_activity(access_token, email_addresses, lists)
+      Services::ActivityService.add_remove_contacts_from_lists_activity(access_token, email_addresses, lists)
+    end
+
+
+    # Add a Remove Contacts From Lists Activity from a file. Valid file types are txt, csv, xls, xlsx
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] file_name - The name of the file (ie: contacts.csv)
+    # @param [String] contents - The content of the file
+    # @param [String] lists - Comma separated list of ContactList id' to add the contacts too
+    # @return [Activity]
+    def add_remove_contacts_from_lists_activity_from_file(access_token, file_name, contents, lists)
+      Services::ActivityService.add_remove_contacts_from_lists_activity_from_file(access_token, file_name, contents, lists)
+    end
+
+
+    # Create an Export Contacts Activity
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [<Array>Contacts] export_contacts - Contacts to be exported
+    # @return [Activity]
+    def add_export_contacts_activity(access_token, export_contacts)
+      Services::ActivityService.add_export_contacts_activity(access_token, export_contacts)
+    end
+
+
+    # Get a list of events
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @return [ResultSet<Event>]
+    def get_events(access_token)
+      Services::EventSpotService.get_events(access_token)
+    end
+
+
+    # Get an event
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - event id or object to be retrieved
+    # @return [Event]
+    def get_event(access_token, event)
+      Services::EventSpotService.get_event(access_token, event)
+    end
+
+
+    # Create an event
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Hash] event - Event data stored in an object which respods to to_json
+    # @return [Event]
+    def add_event(access_token, event)
+      Services::EventSpotService.add_event(access_token, event)
+    end
+
+
+    # Update an event
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event|Hash] event - Event details stored in an object that responds to to_json and has an :id attribute
+    # @return [Event]
+    def update_event(access_token, event)
+      Services::EventSpotService.update_event(access_token, event)
+    end
+
+
+    # Publish an event
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event to publish
+    # @return [Event]
+    def publish_event(access_token, event)
+      Services::EventSpotService.publish_event(access_token, event)
+    end
+
+
+    # Cancel an event
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event to cancel
+    # @return [Activity]
+    def cancel_event(access_token, event)
+      Services::EventSpotService.cancel_event(access_token, event)
+    end
+
+
+    # Delete an event
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event fee corresponds to
+    # @return [Activity]
+    def delete_event(access_token, event)
+      Services::EventSpotService.delete_event(access_token, event)
+    end
+
+
+    # Get a list of event fees
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event to get fees of
+    # @return [Activity]
+    def get_event_fees(access_token, event)
+      Services::EventSpotService.get_fees(access_token, event)
+    end
+
+
+    # Get an event fee
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event fee corresponds to
+    # @param [Fee] fee - Fee to retrieve
+    # @return [Activity]
+    def get_event_fee(access_token, event, fee)
+      Services::EventSpotService.get_fee(access_token, event, fee)
+    end
+
+
+    # Create an event fee
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event fee corresponds to
+    # @param [Hash] fee - Fee details
+    # @return [Activity]
+    def add_event_fee(access_token, event, fee)
+      Services::EventSpotService.add_fee(access_token, event, fee)
+    end
+
+
+    # Update an event fee
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event fee corresponds to
+    # @param [Fee] fee - Fee details
+    # @return [Activity]
+    def update_event_fee(access_token, event, fee)
+      Services::EventSpotService.update_fee(access_token, event, fee)
+    end
+
+
+    # Delete an event fee
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event fee corresponds to
+    # @param [Fee] fee - Fee details
+    # @return [Activity]
+    def delete_event_fee(access_token, event, fee)
+      Services::EventSpotService.delete_fee(access_token, event, fee)
+    end
+
+
+    # Get a list of event registrants
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event fee corresponds to
+    # @return [Activity]
+    def get_event_registrants(access_token, event)
+      Services::EventSpotService.get_registrants(access_token, event)
+    end
+
+
+    # Get an event registrant
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Event] event - Event registrant corresponds to
+    # @param [Registrant] registrant - registrant details
+    # @return [Activity]
+    def get_event_registrant(access_token, event, registrant)
+      Services::EventSpotService.get_registrant(access_token, event, registrant)
+    end
+
+
+    # Retrieve MyLibrary usage information
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @return [LibrarySummary]
+    def get_library_info(access_token)
+      Services::LibraryService.get_library_info(access_token)
+    end
+
+
+    # Retrieve a list of MyLibrary folders
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     sort_by - The method to sort by, valid values are :
+    #         CREATED_DATE - sorts by date folder was added, ascending (earliest to latest)
+    #         CREATED_DATE_DESC - (default) sorts by date folder was added, descending (latest to earliest)
+    #         MODIFIED_DATE - sorts by date folder was last modified, ascending (earliest to latest)
+    #         MODIFIED_DATE_DESC - sorts by date folder was last modified, descending (latest to earliest)
+    #         NAME - sorts alphabetically by folder name, a to z
+    #         NAME_DESC - sorts alphabetically by folder name, z to a
+    #     limit -  Specifies the number of results displayed per page of output, from 1 - 50, default = 50.
+    # @return [ResultSet<LibraryFolder>]
+    def get_library_folders(access_token, params = {})
+      Services::LibraryService.get_library_folders(access_token, params)
+    end
+
+
+    # Create a new MyLibrary folder
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [LibraryFolder] folder - Library Folder to be created
+    # @return [LibraryFolder]
+    def add_library_folder(access_token, folder)
+      Services::LibraryService.add_library_folder(access_token, folder)
+    end
+
+
+    # Retrieve a specific MyLibrary folder using the folder_id path parameter
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] folder_id - The ID for the folder to return
+    # @return [LibraryFolder]
+    def get_library_folder(access_token, folder_id)
+      Services::LibraryService.get_library_folder(access_token, folder_id)
+    end
+
+
+    # Update a specific MyLibrary folder
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [LibraryFolder] folder - MyLibrary folder to be updated
+    # @return [LibraryFolder]
+    def update_library_folder(access_token, folder)
+      Services::LibraryService.update_library_folder(access_token, folder)
+    end
+
+
+    # Delete a MyLibrary folder
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] folder_id - The ID for the MyLibrary folder to delete
+    # @return [Boolean]
+    def delete_library_folder(access_token, folder_id)
+      Services::LibraryService.delete_library_folder(access_token, folder_id)
+    end
+
+
+    # Retrieve all files in the Trash folder
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     type - Specifies the type of files to retrieve, valid values are : ALL, IMAGES, or DOCUMENTS
+    #     sort_by - The method to sort by, valid values are :
+    #         ADDED_DATE - sorts by date folder was added, ascending (earliest to latest)
+    #         ADDED_DATE_DESC - (default) sorts by date folder was added, descending (latest to earliest)
+    #         MODIFIED_DATE - sorts by date folder was last modified, ascending (earliest to latest)
+    #         MODIFIED_DATE_DESC - sorts by date folder was last modified, descending (latest to earliest)
+    #         NAME - sorts alphabetically by file name, a to z
+    #         NAME_DESC - sorts alphabetically by file name, z to a
+    #         SIZE - sorts by file size, smallest to largest
+    #         SIZE_DESC - sorts by file size, largest to smallest
+    #         DIMENSION - sorts by file dimensions (hxw), smallest to largest
+    #         DIMENSION_DESC - sorts by file dimensions (hxw), largest to smallest
+    #     limit -  Specifies the number of results displayed per page of output, from 1 - 50, default = 50.
+    # @return [ResultSet<LibraryFile>]
+    def get_library_trash(access_token, params = {})
+      Services::LibraryService.get_library_trash(access_token, params)
+    end
+
+
+    # Permanently deletes all files in the Trash folder
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @return [Boolean]
+    def delete_library_trash(access_token)
+      Services::LibraryService.delete_library_trash(access_token)
+    end
+
+
+    # Retrieve a collection of Library files in the Constant Contact account
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     type - Specifies the type of files to retrieve, valid values are : ALL, IMAGES, or DOCUMENTS
+    #     source - Specifies to retrieve files from a particular source, valid values are :
+    #         ALL - (default) files from all sources
+    #         MyComputer
+    #         StockImage
+    #         Facebook
+    #         Instagram
+    #         Shutterstock
+    #         Mobile
+    #     limit -  Specifies the number of results displayed per page of output, from 1 - 1000, default = 50.
+    # @return [ResultSet<LibraryFile>]
+    def get_library_files(access_token, params = {})
+      Services::LibraryService.get_library_files(access_token, params)
+    end
+
+
+    # Retrieves all files from a MyLibrary folder specified by the folder_id path parameter
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] folder_id  - Specifies the folder from which to retrieve files
+    # @param [Hash] params - hash of query parameters and values to append to the request.
+    #     Allowed parameters include:
+    #     limit - Specifies the number of results displayed per page of output, from 1 - 50, default = 50.
+    # @return [ResultSet<LibraryFile>]
+    def get_library_files_by_folder(access_token, folder_id, params = {})
+      Services::LibraryService.get_library_files_by_folder(access_token, folder_id, params)
+    end
+
+
+    # Retrieve a MyLibrary file using the file_id path parameter
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] file_id - Specifies the MyLibrary file for which to retrieve information
+    # @return [LibraryFile]
+    def get_library_file(access_token, file_id)
+      Services::LibraryService.get_library_file(access_token, file_id)
+    end
+
+
+    # Adds a new MyLibrary file using the multipart content-type
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] file_name - The name of the file (ie: dinnerplate-special.jpg)
+    # @param [String] folder_id - Folder id to add the file to
+    # @param [String] description - The description of the file provided by user 
+    # @param [String] source - indicates the source of the original file; 
+    #                          image files can be uploaded from the following sources :
+    #                          MyComputer, StockImage, Facebook - MyLibrary Plus customers only,
+    #                          Instagram - MyLibrary Plus customers only, Shutterstock, Mobile
+    # @param [String] file_type - Specifies the file type, valid values are: JPEG, JPG, GIF, PDF, PNG 
+    # @param [String] contents - The content of the file
+    # @return [LibraryFile]
+    def add_library_file(access_token, file_name, folder_id, description, source, file_type, contents)
+      Services::LibraryService.add_library_file(access_token, file_name, folder_id, description, source, file_type, contents)
+    end
+
+
+    # Update information for a specific MyLibrary file
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [LibraryFile] file - Library File to be updated
+    # @return [LibraryFile]
+    def update_library_file(access_token, file)
+      Services::LibraryService.update_library_file(access_token, file)
+    end
+
+
+    # Delete one or more MyLibrary files specified by the fileId path parameter;
+    # separate multiple file IDs with a comma. 
+    # Deleted files are moved from their current folder into the system Trash folder, and its status is set to Deleted.
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] file_id - Specifies the MyLibrary file to delete
+    # @return [Boolean]
+    def delete_library_file(access_token, file_id)
+      Services::LibraryService.delete_library_file(access_token, file_id)
+    end
+
+
+    # Retrieve the upload status for one or more MyLibrary files using the file_id path parameter; 
+    # separate multiple file IDs with a comma
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] file_id - Specifies the files for which to retrieve upload status information
+    # @return [Array<UploadStatus>]
+    def get_library_files_upload_status(access_token, file_id)
+      Services::LibraryService.get_library_files_upload_status(access_token, file_id)
+    end
+
+
+    # Move one or more MyLibrary files to a different folder in the user's account
+    # specify the destination folder using the folder_id path parameter. 
+    # @param [String] access_token - Constant Contact OAuth2 access token
+    # @param [String] folder_id - Specifies the destination MyLibrary folder to which the files will be moved
+    # @param [String] file_id - Specifies the files to move, in a string of comma separated file ids (e.g. 8,9)
+    # @return [Array<MoveResults>]
+    def move_library_files(access_token, folder_id, file_id)
+      Services::LibraryService.move_library_files(access_token, folder_id, file_id)
+    end
+
+
+
+    private
+
+
+    # Get the id of object, or attempt to convert the argument to an int
+    # @param [Mixed] item - object or a numeric value
+    # @param [String] class_name - class name to test the given object against
+    # @raise IllegalArgumentException - if the item is not an instance of the class name given, or cannot be
+    # converted to a numeric value
+    # @return [Integer]
+    def get_argument_id(item, class_name)
+      item_id = nil
+      if item.is_a?(Integer)
+        item_id = item
+      elsif item.class.to_s.split('::').last == class_name
+        item_id = item.id
+      else
+        raise Exceptions::IllegalArgumentException.new(sprintf(Util::Config.get('errors.id_or_object'), class_name))
+      end
+      item_id
+    end
+
+
+    # Append the limit parameter, if the value is an integer
+    # @param [String] param - parameter value
+    # @return [Hash] the parameters as a hash object
+    def determine_param(param)
+      params = {}
+      if param
+        param = param.to_s
+        if param[0, 1] == '?'
+          hash_params = CGI::parse(param[1..-1])
+          params = Hash[*hash_params.collect {|key, value| [key, value.first] }.flatten]
+        else
+          params['limit'] = param
+        end
+      end
+      params
+    end
+
+  end
 end