cielo24 0.0.16 → 0.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e334329bde7311af931b6b69fd8bb2fbf3f9642c
-  data.tar.gz: e321a51097a5d236d07ebb6f134203a495aeddef
+  metadata.gz: ed8f9b9f2fbd20edca9c999d8d3be9504304547d
+  data.tar.gz: 2d6127f5367b2778438c016c613de13d1ac6a8cf
 SHA512:
-  metadata.gz: 3b653d28dc45ee1c37eeac09c6b3559c2cfaceda39864eadbde955b6ac73e821c7e4972e0071b61a8a1bf73060c2ef7abadde8e42e502f1788ec4b0aca8680e4
-  data.tar.gz: 58f5b34fe7b3f74015dc2bededd03c6b59bfa87e069256bfaf272b871b50f9548609cc158b81c1f075988fb7f9176d92243f0fe5ff4b4d56e3fa2935e437a9e0
+  metadata.gz: cbce8d5f218e768aa47f2aa4a21f10baef1870cf09153f68175db86ed37b8afbab9f177c8c8234d0605eeec8e17efce24c34464e17dfa39a8dc2dc0ffc4a643e
+  data.tar.gz: 00c9011893639c32fe7c90717e6f9beab87422ab9b086c37aa37a596c3ac47fba129753992f00b54e0457206f5d6549316f2741cc70ad2eb4b250b1d79224764

data/lib/cielo24.rb

@@ -1,10 +1,10 @@
-require 'cielo24/actions'
-require 'cielo24/enums'
-require 'cielo24/options'
-require 'cielo24/web_utils'
-
-require 'hashie'
-require 'httpclient'
-
-module Cielo24
+require 'cielo24/actions'
+require 'cielo24/enums'
+require 'cielo24/options'
+require 'cielo24/web_utils'
+
+require 'hashie'
+require 'httpclient'
+
+module Cielo24
 end

data/lib/cielo24/actions.rb

@@ -1,275 +1,288 @@
-module Cielo24
-  class Actions
-
-    require 'uri'
-    require 'hashie'
-    require_relative 'web_utils'
-    require_relative 'enums'
-    require 'json'
-    include Errno
-    include Hashie
-    include Cielo24
-
-    attr_accessor :base_url
-
-    API_VERSION = 1
-    LOGIN_PATH = '/api/account/login'
-    LOGOUT_PATH = '/api/account/logout'
-    UPDATE_PASSWORD_PATH = '/api/account/update_password'
-    GENERATE_API_KEY_PATH = '/api/account/generate_api_key'
-    REMOVE_API_KEY_PATH = '/api/account/remove_api_key'
-    CREATE_JOB_PATH = '/api/job/new'
-    AUTHORIZE_JOB_PATH = '/api/job/authorize'
-    DELETE_JOB_PATH = '/api/job/del'
-    GET_JOB_INFO_PATH = '/api/job/info'
-    GET_JOB_LIST_PATH = '/api/job/list'
-    ADD_MEDIA_TO_JOB_PATH = '/api/job/add_media'
-    ADD_EMBEDDED_MEDIA_TO_JOB_PATH = '/api/job/add_media_url'
-    GET_MEDIA_PATH = '/api/job/media'
-    PERFORM_TRANSCRIPTION = '/api/job/perform_transcription'
-    GET_TRANSCRIPT_PATH = '/api/job/get_transcript'
-    GET_CAPTION_PATH = '/api/job/get_caption'
-    GET_ELEMENT_LIST_PATH = '/api/job/get_elementlist'
-    GET_LIST_OF_ELEMENT_LISTS_PATH = '/api/job/list_elementlists'
-
-    def initialize(base_url='https://api.cielo24.com')
-      @base_url = base_url
-    end
-
-    ######################
-    ### ACCESS CONTROL ###
-    ######################
-
-    def login(username, password=nil, api_securekey=nil, use_headers=false)
-      assert_argument(username, 'Username')
-      raise ArgumentError.new('Password or API Secure Key must be supplied for login.') if (password.nil? and api_securekey.nil?)
-
-      query_hash = init_version_dict
-      headers = Hash.new
-
-      if use_headers
-        headers[:'x-auth-user'] = username
-        headers[:'x-auth-password'] = password unless password.nil?
-        headers[:'x-auth-securekey'] = api_securekey unless api_securekey.nil?
-      else
-        query_hash[:username] = username
-        query_hash[:password] = password unless password.nil?
-        query_hash[:securekey] = api_securekey unless api_securekey.nil?
-      end
-
-      response = WebUtils.get_json(@base_url + LOGIN_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash, headers)
-      response['ApiToken']
-    end
-
-    def logout(api_token)
-      query_hash = init_access_req_dict(api_token)
-      # Nothing returned
-      WebUtils.http_request(@base_url + LOGOUT_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-    end
-
-    def update_password(api_token, new_password, sub_account=nil)
-      assert_argument(new_password, 'New Password')
-      query_hash = init_access_req_dict(api_token)
-      query_hash[:new_password] = new_password
-      # username parameter named sub_account for clarity
-      query_hash[:username] = sub_account unless sub_account.nil?
-      # Nothing returned
-      WebUtils.http_request(@base_url + UPDATE_PASSWORD_PATH, 'POST', WebUtils::BASIC_TIMEOUT, nil, nil, query_hash)
-    end
-
-    def generate_api_key(api_token, username, force_new=false)
-      assert_argument(username, 'Username')
-      query_hash = init_access_req_dict(api_token)
-      query_hash[:account_id] = username
-      query_hash[:force_new] = force_new
-      response = WebUtils.get_json(@base_url + GENERATE_API_KEY_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      response['ApiKey']
-    end
-
-    def remove_api_key(api_token, api_securekey)
-      assert_argument(api_securekey, 'API Secure Key')
-      query_hash = init_access_req_dict(api_token)
-      query_hash[:api_securekey] = api_securekey
-      # Nothing returned
-      WebUtils.http_request(@base_url + REMOVE_API_KEY_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-    end
-
-    ###################
-    ### JOB CONTROL ###
-    ###################
-
-    def create_job(api_token, job_name=nil, language=Language::ENGLISH, external_id=nil, sub_account=nil)
-      query_hash = init_access_req_dict(api_token)
-      query_hash[:job_name] = job_name unless job_name.nil?
-      query_hash[:language] = language unless language.nil?
-      query_hash[:external_id] = external_id unless external_id.nil?
-      # username parameter named sub_account for clarity
-      query_hash[:username] = sub_account unless sub_account.nil?
-
-      response = WebUtils.get_json(@base_url + CREATE_JOB_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      # Return a hash with JobId and TaskId
-      Mash.new(response)
-    end
-
-    def authorize_job(api_token, job_id)
-      query_hash = init_job_req_dict(api_token, job_id)
-      # Nothing returned
-      WebUtils.http_request(@base_url + AUTHORIZE_JOB_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-    end
-
-    def delete_job(api_token, job_id)
-      query_hash = init_job_req_dict(api_token, job_id)
-      response = WebUtils.get_json(@base_url + DELETE_JOB_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      response['TaskId']
-    end
-
-    def get_job_info(api_token, job_id)
-      query_hash = init_job_req_dict(api_token, job_id)
-      response = WebUtils.get_json(@base_url + GET_JOB_INFO_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      fix_job_info_offsets Mash.new(response)
-    end
-
-    def get_job_list(api_token, options=nil)
-      query_hash = init_access_req_dict(api_token)
-      query_hash.merge!(options.get_hash) unless options.nil?
-      response = WebUtils.get_json(@base_url + GET_JOB_LIST_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      fix_job_list_offsets Mash.new(response)
-    end
-
-    def add_media_to_job_file(api_token, job_id, media_file)
-      assert_argument(media_file, 'Media File')
-      query_hash = init_job_req_dict(api_token, job_id)
-      file_size = File.size(media_file.path)
-      response = WebUtils.get_json(@base_url + ADD_MEDIA_TO_JOB_PATH, 'POST', nil, query_hash,
-                                   {'Content-Type' => 'video/mp4', 'Content-Length' => file_size}, media_file)
-      response['TaskId']
-    end
-
-    def add_media_to_job_url(api_token, job_id, media_url)
-      send_media_url(api_token, job_id, media_url, ADD_MEDIA_TO_JOB_PATH)
-    end
-
-    def add_media_to_job_embedded(api_token, job_id, media_url)
-      send_media_url(api_token, job_id, media_url, ADD_EMBEDDED_MEDIA_TO_JOB_PATH)
-    end
-
-    def get_media(api_token, job_id)
-      query_hash = init_job_req_dict(api_token, job_id)
-      response = WebUtils.get_json(@base_url + GET_MEDIA_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      response['MediaUrl']
-    end
-
-    def perform_transcription(api_token,
-                              job_id,
-                              fidelity,
-                              priority=nil,
-                              callback_uri=nil,
-                              turnaround_hours=nil,
-                              target_language=nil,
-                              options=nil)
-      assert_argument(fidelity, 'Fidelity')
-      query_hash = init_job_req_dict(api_token, job_id)
-      query_hash[:transcription_fidelity] = fidelity
-      query_hash[:priority] = priority unless priority.nil?
-      query_hash[:callback_url] = callback_uri unless callback_uri.nil?
-      query_hash[:turnaround_hours] = turnaround_hours unless turnaround_hours.nil?
-      query_hash[:target_language] = target_language unless target_language.nil?
-      query_hash[:options] = options.get_hash.to_json unless options.nil?
-
-      response = WebUtils.get_json(@base_url + PERFORM_TRANSCRIPTION, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      response['TaskId']
-    end
-
-    def get_transcript(api_token, job_id, transcript_options=nil)
-      query_hash = init_job_req_dict(api_token, job_id)
-      query_hash.merge!(transcript_options.get_hash) unless transcript_options.nil?
-      # Returns raw transcript text
-      WebUtils.http_request(@base_url + GET_TRANSCRIPT_PATH, 'GET', WebUtils::DOWNLOAD_TIMEOUT, query_hash)
-    end
-
-    def get_caption(api_token, job_id, caption_format, caption_options=nil)
-      assert_argument(caption_format, 'Caption Format')
-      query_hash = init_job_req_dict(api_token, job_id)
-      query_hash[:caption_format] = caption_format
-      query_hash.merge!(caption_options.get_hash) unless caption_options.nil?
-
-      response = WebUtils.http_request(@base_url + GET_CAPTION_PATH, 'GET', WebUtils::DOWNLOAD_TIMEOUT, query_hash)
-      if not caption_options.nil? and caption_options.build_url # If build_url is true
-        JSON.parse(response)['CaptionUrl']
-      else
-        response # Else return raw caption text
-      end
-    end
-
-    def get_element_list(api_token, job_id, elementlist_version=nil)
-      query_hash = init_job_req_dict(api_token, job_id)
-      query_hash[:elementlist_version] = elementlist_version unless elementlist_version.nil?
-      response = WebUtils.get_json(@base_url + GET_ELEMENT_LIST_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      Mash.new(response)
-    end
-
-    def get_list_of_element_lists(api_token, job_id)
-      query_hash = init_job_req_dict(api_token, job_id)
-      WebUtils.get_json(@base_url + GET_LIST_OF_ELEMENT_LISTS_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-    end
-
-    ##############################
-    ### PRIVATE HELPER METHODS ###
-    ##############################
-    private
-
-    def send_media_url(api_token, job_id, media_url, path)
-      assert_argument(media_url, 'Media URL')
-      query_hash = init_job_req_dict(api_token, job_id)
-      query_hash[:media_url] = media_url
-      response = WebUtils.get_json(@base_url + path, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
-      response['TaskId']
-    end
-
-    def init_job_req_dict(api_token, job_id)
-      assert_argument(job_id, 'Job ID')
-      init_access_req_dict(api_token).merge({job_id: job_id})
-    end
-
-    def init_access_req_dict(api_token)
-      assert_argument(api_token, 'API Token')
-      init_version_dict.merge({api_token: api_token})
-    end
-
-    def init_version_dict
-      {v: API_VERSION}
-    end
-
-    def assert_argument(arg, arg_name)
-      if arg.nil?
-        raise ArgumentError.new('Invalid argument - ' + arg_name)
-      end
-    end
-
-    def fix_job_info_offsets(job_info)
-      top_keys = %w(CreationDate StartDate DueDate CompletedDate ReturnDate AuthorizationDate)
-      task_keys = %w(TaskRequestTime)
-      job_info = fix_offsets(job_info, top_keys)
-      job_info.Tasks = job_info.Tasks.map do |task_item|
-        fix_offsets(task_item, task_keys)
-      end
-      job_info
-    end
-
-    def fix_job_list_offsets(job_list)
-      keys = %w(CreationDate CreationTime StartDate StartTime DueDate CompletedDate
-                ReturnDate CompletedTime AuthorizationDate)
-      job_list.ActiveJobs = job_list.ActiveJobs.map do |job_item|
-        fix_offsets(job_item, keys)
-      end
-      job_list
-    end
-
-    def fix_offsets(hash, keys)
-      keys.each do |key|
-        hash[key] = WebUtils.to_utc(hash[key])
-      end
-      hash
-    end
-  end
+module Cielo24
+  class Actions
+
+    require 'uri'
+    require 'hashie'
+    require_relative 'web_utils'
+    require_relative 'enums'
+    require 'json'
+    include Errno
+    include Hashie
+    include Cielo24
+
+    attr_accessor :base_url
+
+    API_VERSION = 1
+    LOGIN_PATH = '/api/account/login'
+    LOGOUT_PATH = '/api/account/logout'
+    UPDATE_PASSWORD_PATH = '/api/account/update_password'
+    GENERATE_API_KEY_PATH = '/api/account/generate_api_key'
+    REMOVE_API_KEY_PATH = '/api/account/remove_api_key'
+    CREATE_JOB_PATH = '/api/job/new'
+    AUTHORIZE_JOB_PATH = '/api/job/authorize'
+    DELETE_JOB_PATH = '/api/job/del'
+    GET_JOB_INFO_PATH = '/api/job/info'
+    GET_JOB_LIST_PATH = '/api/job/list'
+    ADD_MEDIA_TO_JOB_PATH = '/api/job/add_media'
+    ADD_EMBEDDED_MEDIA_TO_JOB_PATH = '/api/job/add_media_url'
+    GET_MEDIA_PATH = '/api/job/media'
+    PERFORM_TRANSCRIPTION = '/api/job/perform_transcription'
+    GET_TRANSCRIPT_PATH = '/api/job/get_transcript'
+    GET_CAPTION_PATH = '/api/job/get_caption'
+    GET_ELEMENT_LIST_PATH = '/api/job/get_elementlist'
+    GET_LIST_OF_ELEMENT_LISTS_PATH = '/api/job/list_elementlists'
+    AGGREGATE_STATISTICS_PATH = '/api/job/aggregate_statistics'
+
+    def initialize(base_url='https://api.cielo24.com')
+      @base_url = base_url
+    end
+
+    ######################
+    ### ACCESS CONTROL ###
+    ######################
+
+    def login(username, password=nil, api_securekey=nil, use_headers=false)
+      assert_argument(username, 'Username')
+      raise ArgumentError.new('Password or API Secure Key must be supplied for login.') if (password.nil? and api_securekey.nil?)
+
+      query_hash = init_version_dict
+      headers = Hash.new
+
+      if use_headers
+        headers[:'x-auth-user'] = username
+        headers[:'x-auth-password'] = password unless password.nil?
+        headers[:'x-auth-securekey'] = api_securekey unless api_securekey.nil?
+      else
+        query_hash[:username] = username
+        query_hash[:password] = password unless password.nil?
+        query_hash[:securekey] = api_securekey unless api_securekey.nil?
+      end
+
+      response = WebUtils.get_json(@base_url + LOGIN_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash, headers)
+      response['ApiToken']
+    end
+
+    def logout(api_token)
+      query_hash = init_access_req_dict(api_token)
+      # Nothing returned
+      WebUtils.http_request(@base_url + LOGOUT_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+    end
+
+    def update_password(api_token, new_password, sub_account=nil)
+      assert_argument(new_password, 'New Password')
+      query_hash = init_access_req_dict(api_token)
+      query_hash[:new_password] = new_password
+      # username parameter named sub_account for clarity
+      query_hash[:username] = sub_account unless sub_account.nil?
+      # Nothing returned
+      WebUtils.http_request(@base_url + UPDATE_PASSWORD_PATH, 'POST', WebUtils::BASIC_TIMEOUT, nil, nil, query_hash)
+    end
+
+    def generate_api_key(api_token, sub_account=nil, force_new=false)
+      query_hash = init_access_req_dict(api_token)
+      # account_id parameter named sub_account for clarity
+      query_hash[:account_id] = sub_account unless sub_account.nil?
+      query_hash[:force_new] = force_new
+      response = WebUtils.get_json(@base_url + GENERATE_API_KEY_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      response['ApiKey']
+    end
+
+    def remove_api_key(api_token, api_securekey)
+      assert_argument(api_securekey, 'API Secure Key')
+      query_hash = init_access_req_dict(api_token)
+      query_hash[:api_securekey] = api_securekey
+      # Nothing returned
+      WebUtils.http_request(@base_url + REMOVE_API_KEY_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+    end
+
+    ###################
+    ### JOB CONTROL ###
+    ###################
+
+    def create_job(api_token, job_name=nil, language=Language::ENGLISH, external_id=nil, sub_account=nil)
+      query_hash = init_access_req_dict(api_token)
+      query_hash[:job_name] = job_name unless job_name.nil?
+      query_hash[:language] = language unless language.nil?
+      query_hash[:external_id] = external_id unless external_id.nil?
+      # username parameter named sub_account for clarity
+      query_hash[:username] = sub_account unless sub_account.nil?
+
+      response = WebUtils.get_json(@base_url + CREATE_JOB_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      # Return a hash with JobId and TaskId
+      Mash.new(response)
+    end
+
+    def authorize_job(api_token, job_id)
+      query_hash = init_job_req_dict(api_token, job_id)
+      # Nothing returned
+      WebUtils.http_request(@base_url + AUTHORIZE_JOB_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+    end
+
+    def delete_job(api_token, job_id)
+      query_hash = init_job_req_dict(api_token, job_id)
+      response = WebUtils.get_json(@base_url + DELETE_JOB_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      response['TaskId']
+    end
+
+    def get_job_info(api_token, job_id)
+      query_hash = init_job_req_dict(api_token, job_id)
+      response = WebUtils.get_json(@base_url + GET_JOB_INFO_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      fix_job_info_offsets Mash.new(response)
+    end
+
+    def get_job_list(api_token, options=nil)
+      query_hash = init_access_req_dict(api_token)
+      query_hash.merge!(options.get_hash) unless options.nil?
+      response = WebUtils.get_json(@base_url + GET_JOB_LIST_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      fix_job_list_offsets Mash.new(response)
+    end
+
+    def add_media_to_job_file(api_token, job_id, media_file)
+      assert_argument(media_file, 'Media File')
+      query_hash = init_job_req_dict(api_token, job_id)
+      file_size = File.size(media_file.path)
+      response = WebUtils.get_json(@base_url + ADD_MEDIA_TO_JOB_PATH, 'POST', nil, query_hash,
+                                   {'Content-Type' => 'video/mp4', 'Content-Length' => file_size}, media_file)
+      response['TaskId']
+    end
+
+    def add_media_to_job_url(api_token, job_id, media_url)
+      send_media_url(api_token, job_id, media_url, ADD_MEDIA_TO_JOB_PATH)
+    end
+
+    def add_media_to_job_embedded(api_token, job_id, media_url)
+      send_media_url(api_token, job_id, media_url, ADD_EMBEDDED_MEDIA_TO_JOB_PATH)
+    end
+
+    def get_media(api_token, job_id)
+      query_hash = init_job_req_dict(api_token, job_id)
+      response = WebUtils.get_json(@base_url + GET_MEDIA_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      response['MediaUrl']
+    end
+
+    def perform_transcription(api_token,
+                              job_id,
+                              fidelity,
+                              priority=nil,
+                              callback_uri=nil,
+                              turnaround_hours=nil,
+                              target_language=nil,
+                              options=nil)
+      assert_argument(fidelity, 'Fidelity')
+      query_hash = init_job_req_dict(api_token, job_id)
+      query_hash[:transcription_fidelity] = fidelity
+      query_hash[:priority] = priority unless priority.nil?
+      query_hash[:callback_url] = callback_uri unless callback_uri.nil?
+      query_hash[:turnaround_hours] = turnaround_hours unless turnaround_hours.nil?
+      query_hash[:target_language] = target_language unless target_language.nil?
+      query_hash[:options] = options.get_hash.to_json unless options.nil?
+
+      response = WebUtils.get_json(@base_url + PERFORM_TRANSCRIPTION, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      response['TaskId']
+    end
+
+    def get_transcript(api_token, job_id, transcript_options=nil)
+      query_hash = init_job_req_dict(api_token, job_id)
+      query_hash.merge!(transcript_options.get_hash) unless transcript_options.nil?
+      # Returns raw transcript text
+      WebUtils.http_request(@base_url + GET_TRANSCRIPT_PATH, 'GET', WebUtils::DOWNLOAD_TIMEOUT, query_hash)
+    end
+
+    def get_caption(api_token, job_id, caption_format, caption_options=nil)
+      assert_argument(caption_format, 'Caption Format')
+      query_hash = init_job_req_dict(api_token, job_id)
+      query_hash[:caption_format] = caption_format
+      query_hash.merge!(caption_options.get_hash) unless caption_options.nil?
+
+      response = WebUtils.http_request(@base_url + GET_CAPTION_PATH, 'GET', WebUtils::DOWNLOAD_TIMEOUT, query_hash)
+      if not caption_options.nil? and caption_options.build_url # If build_url is true
+        JSON.parse(response)['CaptionUrl']
+      else
+        response # Else return raw caption text
+      end
+    end
+
+    def get_element_list(api_token, job_id, elementlist_version=nil)
+      query_hash = init_job_req_dict(api_token, job_id)
+      query_hash[:elementlist_version] = elementlist_version unless elementlist_version.nil?
+      response = WebUtils.get_json(@base_url + GET_ELEMENT_LIST_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      Mash.new(response)
+    end
+
+    def get_list_of_element_lists(api_token, job_id)
+      query_hash = init_job_req_dict(api_token, job_id)
+      WebUtils.get_json(@base_url + GET_LIST_OF_ELEMENT_LISTS_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+    end
+
+    def aggregate_statistics(api_token, metrics=nil, group_by=nil, start_date=nil, end_date=nil, sub_account=nil)
+      query_hash = init_access_req_dict(api_token)
+      query_hash[:metrics] = metrics.to_json unless metrics.nil?
+      query_hash[:group_by] = group_by unless group_by.nil?
+      query_hash[:start_date] = start_date unless start_date.nil?
+      query_hash[:end_date] = end_date unless end_date.nil?
+      # account_id parameter named sub_account for clarity
+      query_hash[:account_id] = sub_account unless sub_account.nil?
+      response = WebUtils.get_json(@base_url + AGGREGATE_STATISTICS_PATH, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      Mash.new(response)
+    end
+
+    ##############################
+    ### PRIVATE HELPER METHODS ###
+    ##############################
+    private
+
+    def send_media_url(api_token, job_id, media_url, path)
+      assert_argument(media_url, 'Media URL')
+      query_hash = init_job_req_dict(api_token, job_id)
+      query_hash[:media_url] = media_url
+      response = WebUtils.get_json(@base_url + path, 'GET', WebUtils::BASIC_TIMEOUT, query_hash)
+      response['TaskId']
+    end
+
+    def init_job_req_dict(api_token, job_id)
+      assert_argument(job_id, 'Job ID')
+      init_access_req_dict(api_token).merge({job_id: job_id})
+    end
+
+    def init_access_req_dict(api_token)
+      assert_argument(api_token, 'API Token')
+      init_version_dict.merge({api_token: api_token})
+    end
+
+    def init_version_dict
+      {v: API_VERSION}
+    end
+
+    def assert_argument(arg, arg_name)
+      if arg.nil?
+        raise ArgumentError.new('Invalid argument - ' + arg_name)
+      end
+    end
+
+    def fix_job_info_offsets(job_info)
+      top_keys = %w(CreationDate StartDate DueDate CompletedDate ReturnDate AuthorizationDate)
+      task_keys = %w(TaskRequestTime)
+      job_info = fix_offsets(job_info, top_keys)
+      job_info.Tasks = job_info.Tasks.map do |task_item|
+        fix_offsets(task_item, task_keys)
+      end
+      job_info
+    end
+
+    def fix_job_list_offsets(job_list)
+      keys = %w(CreationDate CreationTime StartDate StartTime DueDate CompletedDate
+                ReturnDate CompletedTime AuthorizationDate)
+      job_list.ActiveJobs = job_list.ActiveJobs.map do |job_item|
+        fix_offsets(job_item, keys)
+      end
+      job_list
+    end
+
+    def fix_offsets(hash, keys)
+      keys.each do |key|
+        hash[key] = WebUtils.to_utc(hash[key])
+      end
+      hash
+    end
+  end
 end