google-cloud-talent-v4 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e537942ec731fc39aeafa4159281e74d0d0446a4a1d6b5529c22d98c320fdfb
-  data.tar.gz: 11aed772767ea9711909cf20de1cddecc675ed3f859518da7a9695d62eec3568
+  metadata.gz: 437585d9004d5afece6039397ebcc29ff9c8be7d9acc06796ef1cb383ed7ff01
+  data.tar.gz: 705e5ad8695306fe0f87832b3715173a11670a2ec1ad4b3e4a0236897daa2c5f
 SHA512:
-  metadata.gz: 64ad3a81914c31b2ec67fb0c0c06ce1ef58e6f36b8299105e9c9c719cc960a3d05bb850ab7642323eefd306cfb511f725d3636f50ec46424dcf5cb631f1c3759
-  data.tar.gz: 42f0debe5dc26d2c08b7a0dcf597591ba9198a2b8f19854b1c005c674aafed6b5034febba974f0517326d443a9ba0d16fd61a91ca2e5fc69b3540f94a69e7918
+  metadata.gz: 973ac752c4655fe01ccf9db90356e9226f6ef88a3a2430f6f6d3419a6d92beaf421ab9ccc454e803c941db0b5a8ca826ed6b2094ca4638efd01311d7d381317a
+  data.tar.gz: 0e41761b4d7e4f5159b4b5711a4a576ee4c36095126a32295cf766fdd35b4834010e70599b5920ed888a2bfc0d71694af2aa50bd63c76dc87f27969c862e4f6f

data/lib/google/cloud/talent/v4/job_service/client.rb

@@ -860,7 +860,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search_jobs(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, histogram_queries: nil, job_view: nil, offset: nil, max_page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil)
+            # @overload search_jobs(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, histogram_queries: nil, job_view: nil, offset: nil, max_page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil, keyword_match_mode: nil)
             #   Pass arguments to `search_jobs` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1068,6 +1068,14 @@ module Google
             #     Controls over how job documents get ranked on top of existing relevance
             #     score (determined by API algorithm).
             #   @param disable_keyword_match [::Boolean]
+            #     This field is deprecated. Please use
+            #     {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
+            #
+            #     To migrate, disable_keyword_match set to false maps to
+            #     {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
+            #     true maps to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
+            #     {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
+            #
             #     Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4::Job#title Job.title},
             #     {::Google::Cloud::Talent::V4::Job#description Job.description}, {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
             #     {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
@@ -1087,6 +1095,12 @@ module Google
             #     requests.
             #
             #     Defaults to false.
+            #   @param keyword_match_mode [::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode]
+            #     Controls what keyword match options to use. If both keyword_match_mode and
+            #     disable_keyword_match are set, keyword_match_mode will take precedence.
+            #
+            #     Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
+            #     is specified.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Talent::V4::SearchJobsResponse]
@@ -1157,7 +1171,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search_jobs_for_alert(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, histogram_queries: nil, job_view: nil, offset: nil, max_page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil)
+            # @overload search_jobs_for_alert(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, histogram_queries: nil, job_view: nil, offset: nil, max_page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil, keyword_match_mode: nil)
             #   Pass arguments to `search_jobs_for_alert` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1365,6 +1379,14 @@ module Google
             #     Controls over how job documents get ranked on top of existing relevance
             #     score (determined by API algorithm).
             #   @param disable_keyword_match [::Boolean]
+            #     This field is deprecated. Please use
+            #     {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
+            #
+            #     To migrate, disable_keyword_match set to false maps to
+            #     {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
+            #     true maps to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
+            #     {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
+            #
             #     Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4::Job#title Job.title},
             #     {::Google::Cloud::Talent::V4::Job#description Job.description}, {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
             #     {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
@@ -1384,6 +1406,12 @@ module Google
             #     requests.
             #
             #     Defaults to false.
+            #   @param keyword_match_mode [::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode]
+            #     Controls what keyword match options to use. If both keyword_match_mode and
+            #     disable_keyword_match are set, keyword_match_mode will take precedence.
+            #
+            #     Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
+            #     is specified.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Talent::V4::SearchJobsResponse]

data/lib/google/cloud/talent/v4/job_service_pb.rb

@@ -60,6 +60,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :diversification_level, :enum, 13, "google.cloud.talent.v4.SearchJobsRequest.DiversificationLevel"
       optional :custom_ranking_info, :message, 14, "google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo"
       optional :disable_keyword_match, :bool, 16
+      optional :keyword_match_mode, :enum, 18, "google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode"
     end
     add_message "google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo" do
       optional :importance_level, :enum, 1, "google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo.ImportanceLevel"
@@ -83,6 +84,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :DIVERSIFICATION_LEVEL_UNSPECIFIED, 0
       value :DISABLED, 1
       value :SIMPLE, 2
+      value :ONE_PER_COMPANY, 3
+      value :TWO_PER_COMPANY, 4
+      value :DIVERSIFY_BY_LOOSER_SIMILARITY, 5
+    end
+    add_enum "google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode" do
+      value :KEYWORD_MATCH_MODE_UNSPECIFIED, 0
+      value :KEYWORD_MATCH_DISABLED, 1
+      value :KEYWORD_MATCH_ALL, 2
+      value :KEYWORD_MATCH_TITLE_ONLY, 3
     end
     add_message "google.cloud.talent.v4.SearchJobsResponse" do
       repeated :matching_jobs, :message, 1, "google.cloud.talent.v4.SearchJobsResponse.MatchingJob"
@@ -156,6 +166,7 @@ module Google
         SearchJobsRequest::CustomRankingInfo::ImportanceLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo.ImportanceLevel").enummodule
         SearchJobsRequest::SearchMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.SearchMode").enummodule
         SearchJobsRequest::DiversificationLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.DiversificationLevel").enummodule
+        SearchJobsRequest::KeywordMatchMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode").enummodule
         SearchJobsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsResponse").msgclass
         SearchJobsResponse::MatchingJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsResponse.MatchingJob").msgclass
         SearchJobsResponse::CommuteInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsResponse.CommuteInfo").msgclass

data/lib/google/cloud/talent/v4/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Talent
       module V4
-        VERSION = "0.5.0"
+        VERSION = "0.6.0"
       end
     end
   end

data/proto_docs/google/cloud/talent/v4/job_service.rb

@@ -370,6 +370,14 @@ module Google
         #     score (determined by API algorithm).
         # @!attribute [rw] disable_keyword_match
         #   @return [::Boolean]
+        #     This field is deprecated. Please use
+        #     {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
+        #
+        #     To migrate, disable_keyword_match set to false maps to
+        #     {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
+        #     true maps to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
+        #     {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
+        #
         #     Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4::Job#title Job.title},
         #     {::Google::Cloud::Talent::V4::Job#description Job.description}, {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
         #     {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
@@ -389,6 +397,13 @@ module Google
         #     requests.
         #
         #     Defaults to false.
+        # @!attribute [rw] keyword_match_mode
+        #   @return [::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode]
+        #     Controls what keyword match options to use. If both keyword_match_mode and
+        #     disable_keyword_match are set, keyword_match_mode will take precedence.
+        #
+        #     Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
+        #     is specified.
         class SearchJobsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -415,7 +430,7 @@ module Google
           #     integer/double value or an expression that can be evaluated to a number.
           #
           #     Parenthesis are supported to adjust calculation precedence. The
-          #     expression must be < 100 characters in length.
+          #     expression must be < 200 characters in length.
           #
           #     The expression is considered invalid for a job if the expression
           #     references custom attributes that are not populated on the job or if the
@@ -490,6 +505,11 @@ module Google
           # clustered so that only one representative job of the cluster is
           # displayed to the job seeker higher up in the results, with the other jobs
           # being displayed lower down in the results.
+          #
+          # If you are using pageToken to page through the result set,
+          # latency might be lower but we can't guarantee that all results are
+          # returned. If you are using page offset, latency might be higher but all
+          # results are returned.
           module DiversificationLevel
             # The diversification level isn't specified.
             DIVERSIFICATION_LEVEL_UNSPECIFIED = 0
@@ -501,11 +521,57 @@ module Google
 
             # Default diversifying behavior. The result list is ordered so that
             # highly similar results are pushed to the end of the last page of search
-            # results. If you are using pageToken to page through the result set,
-            # latency might be lower but we can't guarantee that all results are
-            # returned. If you are using page offset, latency might be higher but all
-            # results are returned.
+            # results.
             SIMPLE = 2
+
+            # Only one job from the same company will be shown at once, other jobs
+            # under same company are pushed to the end of the last page of search
+            # result.
+            ONE_PER_COMPANY = 3
+
+            # Similar to ONE_PER_COMPANY, but it allows at most two jobs in the
+            # same company to be shown at once, the other jobs under same company are
+            # pushed to the end of the last page of search result.
+            TWO_PER_COMPANY = 4
+
+            # The result list is ordered such that somewhat similar results are pushed
+            # to the end of the last page of the search results. This option is
+            # recommended if SIMPLE diversification does not diversify enough.
+            DIVERSIFY_BY_LOOSER_SIMILARITY = 5
+          end
+
+          # Controls what keyword matching behavior the search has. When keyword
+          # matching is enabled, a keyword match returns jobs that may not match given
+          # category filters when there are matching keywords. For example, for the
+          # query "program manager" with KeywordMatchMode set to KEYWORD_MATCH_ALL, a
+          # job posting with the title "software developer," which doesn't fall into
+          # "program manager" ontology, and "program manager" appearing in its
+          # description will be surfaced.
+          #
+          # For queries like "cloud" that don't contain title or
+          # location specific ontology, jobs with "cloud" keyword matches are returned
+          # regardless of this enum's value.
+          #
+          # Use {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
+          # company-specific globally matched custom field/attribute string values are
+          # needed. Enabling keyword match improves recall of subsequent search
+          # requests.
+          module KeywordMatchMode
+            # The keyword match option isn't specified. Defaults to
+            # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} behavior.
+            KEYWORD_MATCH_MODE_UNSPECIFIED = 0
+
+            # Disables keyword matching.
+            KEYWORD_MATCH_DISABLED = 1
+
+            # Enable keyword matching over {::Google::Cloud::Talent::V4::Job#title Job.title},
+            # {::Google::Cloud::Talent::V4::Job#description Job.description}, {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
+            # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}, and keyword searchable {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}
+            # fields.
+            KEYWORD_MATCH_ALL = 2
+
+            # Only enable keyword matching over {::Google::Cloud::Talent::V4::Job#title Job.title}.
+            KEYWORD_MATCH_TITLE_ONLY = 3
           end
         end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-talent-v4
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-19 00:00:00.000000000 Z
+date: 2021-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common