cb-api 22.4.0 → 22.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 99629dc781ee505fc6ec3f8ba0a4d525c136ccf9
-  data.tar.gz: be4a2c3689438298268a40b484b986d042e7431d
+  metadata.gz: c388320407546f44682f60598e856282ac2a8a48
+  data.tar.gz: 9d8e84236801abe54a931403235020a78a702aa8
 SHA512:
-  metadata.gz: ea98db5cb9afcfc405d39ff66ccda63ceec7b9a030c7ad7aafc769b10d370358b397deea430c6448485124688219c19c94eb90965a62cde57334779ec001e917
-  data.tar.gz: 0c4cecd0b35f04985e2e2c26436da9fecb6d752c59a300e066d6b227c96e5ecda7b3d6595fa0cf4dbd2977224a72b9fa12a6b1d742d1a87160477f9eb3178694
+  metadata.gz: d4b5d38c5bccbe8ffc3fc55542b59ad2e7e19b930b368c9f4a496652f6d94899cb1eb394312d92ac793bcdde2ca773d87d093be6ccd65b1c55d3b135f1805fc7
+  data.tar.gz: 2a7b46d8a2c1a361b3b260493e749828e4f9c5841e55935b9af9aae203a283ec78db9f274edbc89f1a03fa64ac2061b6ff4359d1ad7638ce74ea5946b50c304d

data/CHANGELOG.md

@@ -2,8 +2,9 @@ Version History
 ====
     * All Version bumps are required to update this file as well!!
 ----
+* 22.5.0 Add clients side-by-side existing requests.
 * 22.4.0 Add optional resume POST param: entry_path
-* 22.3.2 Add is_dynamic_screener to application form API 
+* 22.3.2 Add is_dynamic_screener to application form API
 * 22.3.1 Return an empty array for NoMethodError on recs.
 * 22.3.0 Update validator to handle errors node being nested in the response.
 * 22.2.1 Add error checking and raising back on Job call

data/lib/cb/clients/email_subscriptions.rb

@@ -0,0 +1,67 @@
+# Copyright 2017 CareerBuilder, LLC
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+require_relative 'base'
+module Cb
+  module Clients
+    class EmailSubscriptions < Base
+      class << self
+        def get(args = {})
+          cb_client.cb_get(Cb.configuration.uri_subscription_retrieve, query: query(args), headers: headers(args))
+        end
+
+        def post(args = {})
+          @unsubscribe_all = args[:unsubscribe_all]
+          cb_client.cb_post(Cb.configuration.uri_subscription_modify, body: body(args), headers: post_headers(args))
+        end
+
+        private
+
+        def query(args = {})
+          {
+            ExternalID: args[:external_id],
+            HostSite: args[:host_site] || Cb.configuration.host_site
+          }
+        end
+
+        def post_headers(args = {})
+          headers(args).merge('Content-Type' => 'application/xml')
+        end
+
+        def body(args = {})
+          <<-eos.gsub /^\s+/, ""
+          <Request>
+            <DeveloperKey>#{Cb.configuration.dev_key}</DeveloperKey>
+            <ExternalID>#{args[:external_id]}</ExternalID>
+            <Hostsite>#{args[:host_site] || Cb.configuration.host_site}</Hostsite>
+            <CareerResources>#{validate args[:career_resources]}</CareerResources>
+            <ProductSponsorInfo>#{validate args[:product_sponsor_info]}</ProductSponsorInfo>
+            <ApplicantSurveyInvites>#{validate args[:applicant_survey_invites]}</ApplicantSurveyInvites>
+            <JobRecs>#{validate args[:job_recs]}</JobRecs>
+            <DJR>#{validate args[:djr]}</DJR>
+            <ResumeViewed>#{validate args[:resume_viewed]}</ResumeViewed>
+            <ApplicationViewed>#{validate args[:application_viewed]}</ApplicationViewed>
+            <UnsubscribeAll>#{args[:unsubscribe_all]}</UnsubscribeAll>
+          </Request>
+          eos
+        end
+
+        def validate(value)
+          return value unless unsubscribe_all?
+          false.to_s
+        end
+
+        def unsubscribe_all?
+          @unsubscribe_all
+        end
+      end
+    end
+  end
+end

data/lib/cb/clients/job.rb

@@ -13,19 +13,35 @@ module Cb
   module Clients
     class Job < Base
       class << self
-        def get(args={})
+        def get(args = {})
           response = cb_client.cb_get(Cb.configuration.uri_job_find, query: args)
           not_found_check(response)
           response
         end
-        
+
+        def report(args = {})
+          cb_client.cb_post(Cb.configuration.uri_report_job, body: report_body(args))
+        end
+
         private
-        
+
         def not_found_check(response)
           return if response.nil?
           errors = Cb::Responses::Errors.new(response['ResponseJob'], false).parsed.join
           raise Cb::DocumentNotFoundError, errors if errors.downcase.include? 'job was not found'
         end
+
+        def report_body(args = {})
+          <<-eos.gsub /^\s+/, ""
+          <Request>
+            <DeveloperKey>#{Cb.configuration.dev_key}</DeveloperKey>
+            <JobDID>#{args[:job_id]}</JobDID>
+            <UserID>#{args[:user_id]}</UserID>
+            <ReportType>#{args[:report_type]}</ReportType>
+            <Comments>#{args[:comments]}</Comments>
+          </Request>
+          eos
+        end
       end
     end
   end

data/lib/cb/clients/job_search.rb

@@ -0,0 +1,37 @@
+# Copyright 2017 CareerBuilder, LLC
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+require_relative 'base'
+module Cb
+  module Clients
+    class JobSearch < Base
+      class << self
+        def get(args = {})
+          cb_client.cb_get(Cb.configuration.uri_job_search, query: query(args), headers: headers(args))
+        end
+
+        private
+
+        def headers(args = {})
+          {
+             'Accept' => 'application/json;version=3.0',
+             'Authorization' => "Bearer #{ args[:oauth_token] }",
+             'Content-Type' => 'application/json',
+             'HostSite' => args[:host_site] || args[:HostSite] || Cb.configuration.host_site
+          }
+        end
+
+        def query(args = {})
+          args.reject { |k, _| k == :oauth_token }
+        end
+      end
+    end
+  end
+end

data/lib/cb/clients/resumes.rb

@@ -12,10 +12,131 @@ require_relative 'base'
 module Cb
   module Clients
     class Resumes < Base
-      def self.get(args={})
-        uri = Cb.configuration.uri_resumes
-        query_params = args[:site] ? { site: args[:site] } : { }
-        cb_client.cb_get(uri, headers: headers(args), query: query_params)
+      class << self
+        def get(args = {})
+          uri = Cb.configuration.uri_resumes
+          query_params = args[:site] ? { site: args[:site] } : {}
+          cb_client.cb_get(uri, headers: headers(args), query: query_params)
+        end
+
+        def post(args = {})
+          cb_client.cb_post(Cb.configuration.uri_resume_post, body: post_body(args), headers: headers(args))
+        end
+
+        def delete(args = {})
+          cb_client.cb_delete(Cb.configuration.uri_resume_delete.sub(':resume_hash', args[:resume_hash].to_s), query: { externalUserId: args[:external_user_id] }, headers: headers(args))
+        end
+
+        def put(args = {})
+          cb_client.cb_put(Cb.configuration.uri_resume_put.gsub(':resume_hash', args[:resume_hash].to_s), headers: headers(args), body: put_body(args))
+        end
+
+        private
+
+        def post_body(args = {})
+          {
+            desiredJobTitle: args[:desired_job_title],
+            privacySetting: args[:privacy_setting],
+            resumeFileData: args[:resume_file_data],
+            resumeFileName: args[:resume_file_name],
+            hostSite: args[:host_site],
+            entryPath: args[:entry_path]
+          }.to_json
+        end
+
+        def headers(args = {})
+          {
+            'HostSite' => args[:host_site] || Cb.configuration.host_site,
+            'Content-Type' => 'application/json;version=1.0',
+            'Authorization' => "Bearer #{ args[:oauth_token] }"
+          }
+        end
+
+        def put_body(args = {})
+          {
+            userIdentifier: args[:user_identifier],
+            resumeHash: args[:resume_hash],
+            desiredJobTitle: args[:desired_job_title],
+            privacySetting: args[:privacy_setting],
+            workExperience: extract_work_experience(args),
+            salaryInformation: extract_salary_information(args),
+            educations: extract_educations(args),
+            skillsAndQualifications: extract_skills_and_qualifications(args),
+            relocations: extract_relocations(args),
+            governmentAndMilitary: extract_government_and_military(args)
+          }.to_json
+        end
+
+        def extract_work_experience(args = {})
+          return [] if args[:work_experience].blank?
+          args[:work_experience].map do |experience|
+            {
+              jobTitle: experience[:job_title],
+              companyName: experience[:company_name],
+              employmentType: experience[:employment_type],
+              startDate: experience[:start_date],
+              endDate: experience[:end_date],
+              currentlyEmployedHere: experience[:currently_employed_here],
+              id: experience[:id]
+            }
+          end
+        end
+
+        def extract_salary_information(args = {})
+          salary = args[:salary_information]
+          return {} if salary.blank?
+          {
+            mostRecentPayAmount: salary[:most_recent_pay_amount],
+            perHourOrPerYear: salary[:per_hour_or_per_year],
+            currencyCode: salary[:currency_code],
+            workExperienceId: salary[:work_experience_id],
+            annualBonus: salary[:annual_bonus],
+            annualCommission: salary[:annual_commission]
+          }
+        end
+
+        def extract_educations(args = {})
+          return [] if args[:educations].blank?
+          args[:educations].map do |education|
+            {
+              schoolName: education[:school_name],
+              majorOrProgram: education[:major_or_program],
+              degree: education[:degree],
+              graduationDate: education[:graduation_date]
+            }
+          end
+        end
+
+        def extract_skills_and_qualifications(args = {})
+          skills = args[:skills_and_qualifications]
+          return {} if skills.blank?
+          {
+            accreditationsAndCertifications: skills[:accreditations_and_certifications],
+            languagesSpoken: skills[:languages_spoken],
+            hasManagementExperience: skills[:has_management_experience],
+            sizeOfTeamManaged: skills[:size_of_team_managed]
+          }
+        end
+
+        def extract_relocations(args = {})
+          return [] unless args[:relocations]
+          args[:relocations].map do |relocate|
+            {
+              city: relocate[:city],
+              adminArea: relocate[:admin_area],
+              countryCode: relocate[:country_code]
+            }
+          end
+        end
+
+        def extract_government_and_military(args = {})
+          government = args[:government_and_military]
+          return {} if government.blank?
+          {
+            hasSecurityClearance: government[:has_security_clearance],
+            militaryExperience: government[:military_experience]
+          }
+        end
       end
     end
   end

data/lib/cb/version.rb

@@ -9,5 +9,5 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and limitations under the License.
 module Cb
-  VERSION = '22.4.0'
+  VERSION = '22.5.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cb-api
 version: !ruby/object:Gem::Version
-  version: 22.4.0
+  version: 22.5.0
 platform: ruby
 authors:
 - The CareerBuilder.com Niche and Consumer Development teams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-23 00:00:00.000000000 Z
+date: 2017-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -218,10 +218,12 @@ files:
 - lib/cb/clients/company.rb
 - lib/cb/clients/cover_letters.rb
 - lib/cb/clients/data_list.rb
+- lib/cb/clients/email_subscriptions.rb
 - lib/cb/clients/expired_job.rb
 - lib/cb/clients/job.rb
 - lib/cb/clients/job_branding.rb
 - lib/cb/clients/job_insights.rb
+- lib/cb/clients/job_search.rb
 - lib/cb/clients/recommendation.rb
 - lib/cb/clients/recommendations.rb
 - lib/cb/clients/resume_insights.rb