google-cloud-talent-v4 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +1 -1
  3. data/README.md +2 -2
  4. data/lib/google/cloud/talent/v4/company_service/client.rb +15 -12
  5. data/lib/google/cloud/talent/v4/company_service/rest/client.rb +682 -0
  6. data/lib/google/cloud/talent/v4/company_service/rest/service_stub.rb +345 -0
  7. data/lib/google/cloud/talent/v4/company_service/rest.rb +52 -0
  8. data/lib/google/cloud/talent/v4/company_service.rb +7 -1
  9. data/lib/google/cloud/talent/v4/completion/client.rb +4 -2
  10. data/lib/google/cloud/talent/v4/completion/rest/client.rb +380 -0
  11. data/lib/google/cloud/talent/v4/completion/rest/service_stub.rb +107 -0
  12. data/lib/google/cloud/talent/v4/completion/rest.rb +52 -0
  13. data/lib/google/cloud/talent/v4/completion.rb +7 -1
  14. data/lib/google/cloud/talent/v4/event_service/client.rb +2 -2
  15. data/lib/google/cloud/talent/v4/event_service/rest/client.rb +358 -0
  16. data/lib/google/cloud/talent/v4/event_service/rest/service_stub.rb +108 -0
  17. data/lib/google/cloud/talent/v4/event_service/rest.rb +52 -0
  18. data/lib/google/cloud/talent/v4/event_service.rb +7 -1
  19. data/lib/google/cloud/talent/v4/job_service/client.rb +238 -161
  20. data/lib/google/cloud/talent/v4/job_service/operations.rb +12 -14
  21. data/lib/google/cloud/talent/v4/job_service/rest/client.rb +1685 -0
  22. data/lib/google/cloud/talent/v4/job_service/rest/operations.rb +793 -0
  23. data/lib/google/cloud/talent/v4/job_service/rest/service_stub.rb +645 -0
  24. data/lib/google/cloud/talent/v4/job_service/rest.rb +53 -0
  25. data/lib/google/cloud/talent/v4/job_service.rb +7 -1
  26. data/lib/google/cloud/talent/v4/job_service_services_pb.rb +12 -8
  27. data/lib/google/cloud/talent/v4/rest.rb +41 -0
  28. data/lib/google/cloud/talent/v4/tenant_service/client.rb +10 -9
  29. data/lib/google/cloud/talent/v4/tenant_service/rest/client.rb +670 -0
  30. data/lib/google/cloud/talent/v4/tenant_service/rest/service_stub.rb +345 -0
  31. data/lib/google/cloud/talent/v4/tenant_service/rest.rb +52 -0
  32. data/lib/google/cloud/talent/v4/tenant_service.rb +7 -1
  33. data/lib/google/cloud/talent/v4/version.rb +1 -1
  34. data/lib/google/cloud/talent/v4.rb +7 -2
  35. data/proto_docs/google/api/client.rb +318 -0
  36. data/proto_docs/google/api/launch_stage.rb +71 -0
  37. data/proto_docs/google/cloud/talent/v4/common.rb +116 -56
  38. data/proto_docs/google/cloud/talent/v4/company.rb +12 -4
  39. data/proto_docs/google/cloud/talent/v4/company_service.rb +11 -6
  40. data/proto_docs/google/cloud/talent/v4/completion_service.rb +21 -10
  41. data/proto_docs/google/cloud/talent/v4/event.rb +17 -9
  42. data/proto_docs/google/cloud/talent/v4/event_service.rb +2 -2
  43. data/proto_docs/google/cloud/talent/v4/filters.rb +55 -37
  44. data/proto_docs/google/cloud/talent/v4/histogram.rb +6 -2
  45. data/proto_docs/google/cloud/talent/v4/job.rb +83 -55
  46. data/proto_docs/google/cloud/talent/v4/job_service.rb +199 -117
  47. data/proto_docs/google/cloud/talent/v4/tenant.rb +2 -1
  48. data/proto_docs/google/cloud/talent/v4/tenant_service.rb +6 -3
  49. data/proto_docs/google/protobuf/empty.rb +0 -2
  50. data/proto_docs/google/rpc/status.rb +4 -2
  51. metadata +28 -8
@@ -326,14 +326,14 @@ module Google
326
326
  # # Call the batch_create_jobs method.
327
327
  # result = client.batch_create_jobs request
328
328
  #
329
- # # The returned object is of type Gapic::Operation. You can use this
330
- # # object to check the status of an operation, cancel it, or wait
331
- # # for results. Here is how to block until completion:
329
+ # # The returned object is of type Gapic::Operation. You can use it to
330
+ # # check the status of an operation, cancel it, or wait for results.
331
+ # # Here is how to wait for a response.
332
332
  # result.wait_until_done! timeout: 60
333
333
  # if result.response?
334
334
  # p result.response
335
335
  # else
336
- # puts "Error!"
336
+ # puts "No response received."
337
337
  # end
338
338
  #
339
339
  def batch_create_jobs request, options = nil
@@ -494,8 +494,10 @@ module Google
494
494
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
495
495
  # Strongly recommended for the best service experience.
496
496
  #
497
- # If {::Google::Cloud::Talent::V4::UpdateJobRequest#update_mask update_mask} is provided, only the specified fields in
498
- # {::Google::Cloud::Talent::V4::UpdateJobRequest#job job} are updated. Otherwise all the fields are updated.
497
+ # If {::Google::Cloud::Talent::V4::UpdateJobRequest#update_mask update_mask} is
498
+ # provided, only the specified fields in
499
+ # {::Google::Cloud::Talent::V4::UpdateJobRequest#job job} are updated. Otherwise
500
+ # all the fields are updated.
499
501
  #
500
502
  # A field mask to restrict the fields that are updated. Only
501
503
  # top level fields of {::Google::Cloud::Talent::V4::Job Job} are supported.
@@ -594,17 +596,19 @@ module Google
594
596
  # Strongly recommended for the best service experience. Be aware that it will
595
597
  # also increase latency when checking the status of a batch operation.
596
598
  #
597
- # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask} is provided, only the specified fields in
598
- # {::Google::Cloud::Talent::V4::Job Job} are updated. Otherwise all the fields are updated.
599
+ # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask}
600
+ # is provided, only the specified fields in {::Google::Cloud::Talent::V4::Job Job}
601
+ # are updated. Otherwise all the fields are updated.
599
602
  #
600
603
  # A field mask to restrict the fields that are updated. Only
601
604
  # top level fields of {::Google::Cloud::Talent::V4::Job Job} are supported.
602
605
  #
603
- # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask} is provided, The {::Google::Cloud::Talent::V4::Job Job} inside
606
+ # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask}
607
+ # is provided, The {::Google::Cloud::Talent::V4::Job Job} inside
604
608
  # [JobResult][JobOperationResult.JobResult]
605
609
  # will only contains fields that is updated, plus the Id of the Job.
606
- # Otherwise, {::Google::Cloud::Talent::V4::Job Job} will include all fields, which can yield a very
607
- # large response.
610
+ # Otherwise, {::Google::Cloud::Talent::V4::Job Job} will include all fields,
611
+ # which can yield a very large response.
608
612
  #
609
613
  # @yield [response, operation] Access the result along with the RPC operation
610
614
  # @yieldparam response [::Gapic::Operation]
@@ -626,14 +630,14 @@ module Google
626
630
  # # Call the batch_update_jobs method.
627
631
  # result = client.batch_update_jobs request
628
632
  #
629
- # # The returned object is of type Gapic::Operation. You can use this
630
- # # object to check the status of an operation, cancel it, or wait
631
- # # for results. Here is how to block until completion:
633
+ # # The returned object is of type Gapic::Operation. You can use it to
634
+ # # check the status of an operation, cancel it, or wait for results.
635
+ # # Here is how to wait for a response.
632
636
  # result.wait_until_done! timeout: 60
633
637
  # if result.response?
634
638
  # p result.response
635
639
  # else
636
- # puts "Error!"
640
+ # puts "No response received."
637
641
  # end
638
642
  #
639
643
  def batch_update_jobs request, options = nil
@@ -823,14 +827,14 @@ module Google
823
827
  # # Call the batch_delete_jobs method.
824
828
  # result = client.batch_delete_jobs request
825
829
  #
826
- # # The returned object is of type Gapic::Operation. You can use this
827
- # # object to check the status of an operation, cancel it, or wait
828
- # # for results. Here is how to block until completion:
830
+ # # The returned object is of type Gapic::Operation. You can use it to
831
+ # # check the status of an operation, cancel it, or wait for results.
832
+ # # Here is how to wait for a response.
829
833
  # result.wait_until_done! timeout: 60
830
834
  # if result.response?
831
835
  # p result.response
832
836
  # else
833
- # puts "Error!"
837
+ # puts "No response received."
834
838
  # end
835
839
  #
836
840
  def batch_delete_jobs request, options = nil
@@ -927,14 +931,17 @@ module Google
927
931
  # @param page_size [::Integer]
928
932
  # The maximum number of jobs to be returned per page of results.
929
933
  #
930
- # If {::Google::Cloud::Talent::V4::ListJobsRequest#job_view job_view} is set to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY}, the maximum allowed
931
- # page size is 1000. Otherwise, the maximum allowed page size is 100.
934
+ # If {::Google::Cloud::Talent::V4::ListJobsRequest#job_view job_view} is set to
935
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY},
936
+ # the maximum allowed page size is 1000. Otherwise, the maximum allowed page
937
+ # size is 100.
932
938
  #
933
939
  # Default is 100 if empty or a number < 1 is specified.
934
940
  # @param job_view [::Google::Cloud::Talent::V4::JobView]
935
941
  # The desired job attributes returned for jobs in the
936
- # search response. Defaults to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL} if no value is
937
- # specified.
942
+ # search response. Defaults to
943
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL} if no
944
+ # value is specified.
938
945
  #
939
946
  # @yield [response, operation] Access the result along with the RPC operation
940
947
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Talent::V4::Job>]
@@ -956,13 +963,11 @@ module Google
956
963
  # # Call the list_jobs method.
957
964
  # result = client.list_jobs request
958
965
  #
959
- # # The returned object is of type Gapic::PagedEnumerable. You can
960
- # # iterate over all elements by calling #each, and the enumerable
961
- # # will lazily make API calls to fetch subsequent pages. Other
962
- # # methods are also available for managing paging directly.
963
- # result.each do |response|
966
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
967
+ # # over elements, and API calls will be issued to fetch pages as needed.
968
+ # result.each do |item|
964
969
  # # Each element is of type ::Google::Cloud::Talent::V4::Job.
965
- # p response
970
+ # p item
966
971
  # end
967
972
  #
968
973
  def list_jobs request, options = nil
@@ -1008,11 +1013,13 @@ module Google
1008
1013
  end
1009
1014
 
1010
1015
  ##
1011
- # Searches for jobs using the provided {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
1016
+ # Searches for jobs using the provided
1017
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
1012
1018
  #
1013
- # This call constrains the {::Google::Cloud::Talent::V4::Job#visibility visibility} of jobs
1014
- # present in the database, and only returns jobs that the caller has
1015
- # permission to search against.
1019
+ # This call constrains the
1020
+ # {::Google::Cloud::Talent::V4::Job#visibility visibility} of jobs present in the
1021
+ # database, and only returns jobs that the caller has permission to search
1022
+ # against.
1016
1023
  #
1017
1024
  # @overload search_jobs(request, options = nil)
1018
1025
  # Pass arguments to `search_jobs` via a request object, either of type
@@ -1037,11 +1044,12 @@ module Google
1037
1044
  # @param search_mode [::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode]
1038
1045
  # Mode of a search.
1039
1046
  #
1040
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1047
+ # Defaults to
1048
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1041
1049
  # @param request_metadata [::Google::Cloud::Talent::V4::RequestMetadata, ::Hash]
1042
- # Required. The meta information collected about the job searcher, used to improve the
1043
- # search quality of the service. The identifiers (such as `user_id`) are
1044
- # provided by users, and must be unique and consistent.
1050
+ # Required. The meta information collected about the job searcher, used to
1051
+ # improve the search quality of the service. The identifiers (such as
1052
+ # `user_id`) are provided by users, and must be unique and consistent.
1045
1053
  # @param job_query [::Google::Cloud::Talent::V4::JobQuery, ::Hash]
1046
1054
  # Query used to search against jobs, such as keyword, location filters, etc.
1047
1055
  # @param enable_broadening [::Boolean]
@@ -1085,23 +1093,32 @@ module Google
1085
1093
  #
1086
1094
  # Job histogram facets:
1087
1095
  #
1088
- # * company_display_name: histogram by {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}.
1089
- # * employment_type: histogram by {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types}, for example,
1096
+ # * company_display_name: histogram by
1097
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}.
1098
+ # * employment_type: histogram by
1099
+ # {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types}, for
1100
+ # example,
1090
1101
  # "FULL_TIME", "PART_TIME".
1091
- # * company_size: histogram by {::Google::Cloud::Talent::V4::CompanySize CompanySize}, for example, "SMALL",
1102
+ # * company_size (DEPRECATED): histogram by
1103
+ # {::Google::Cloud::Talent::V4::CompanySize CompanySize}, for example, "SMALL",
1092
1104
  # "MEDIUM", "BIG".
1093
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1105
+ # * publish_time_in_day: histogram by the
1106
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1094
1107
  # in days.
1095
1108
  # Must specify list of numeric buckets in spec.
1096
- # * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1109
+ # * publish_time_in_month: histogram by the
1110
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1097
1111
  # in months.
1098
1112
  # Must specify list of numeric buckets in spec.
1099
- # * publish_time_in_year: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1113
+ # * publish_time_in_year: histogram by the
1114
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1100
1115
  # in years.
1101
1116
  # Must specify list of numeric buckets in spec.
1102
- # * degree_types: histogram by the {::Google::Cloud::Talent::V4::Job#degree_types Job.degree_types}, for example,
1117
+ # * degree_types: histogram by the
1118
+ # {::Google::Cloud::Talent::V4::Job#degree_types Job.degree_types}, for example,
1103
1119
  # "Bachelors", "Masters".
1104
- # * job_level: histogram by the {::Google::Cloud::Talent::V4::Job#job_level Job.job_level}, for example, "Entry
1120
+ # * job_level: histogram by the
1121
+ # {::Google::Cloud::Talent::V4::Job#job_level Job.job_level}, for example, "Entry
1105
1122
  # Level".
1106
1123
  # * country: histogram by the country code of jobs, for example, "US", "FR".
1107
1124
  # * admin1: histogram by the admin1 code of jobs, which is a global
@@ -1116,25 +1133,31 @@ module Google
1116
1133
  # and longitude), for example, 37.4038522,-122.0987765. Since the
1117
1134
  # coordinates of a city center can change, customers may need to refresh
1118
1135
  # them periodically.
1119
- # * locale: histogram by the {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, for example, "en-US",
1136
+ # * locale: histogram by the
1137
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, for example,
1138
+ # "en-US",
1120
1139
  # "fr-FR".
1121
- # * language: histogram by the language subtag of the {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
1140
+ # * language: histogram by the language subtag of the
1141
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
1122
1142
  # for example, "en", "fr".
1123
- # * category: histogram by the {::Google::Cloud::Talent::V4::JobCategory JobCategory}, for example,
1143
+ # * category: histogram by the
1144
+ # {::Google::Cloud::Talent::V4::JobCategory JobCategory}, for example,
1124
1145
  # "COMPUTER_AND_IT", "HEALTHCARE".
1125
1146
  # * base_compensation_unit: histogram by the
1126
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit} of base
1127
- # salary, for example, "WEEKLY", "MONTHLY".
1147
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit}
1148
+ # of base salary, for example, "WEEKLY", "MONTHLY".
1128
1149
  # * base_compensation: histogram by the base salary. Must specify list of
1129
1150
  # numeric buckets to group results by.
1130
1151
  # * annualized_base_compensation: histogram by the base annualized salary.
1131
1152
  # Must specify list of numeric buckets to group results by.
1132
1153
  # * annualized_total_compensation: histogram by the total annualized salary.
1133
1154
  # Must specify list of numeric buckets to group results by.
1134
- # * string_custom_attribute: histogram by string {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1155
+ # * string_custom_attribute: histogram by string
1156
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1135
1157
  # Values can be accessed via square bracket notations like
1136
1158
  # string_custom_attribute["key1"].
1137
- # * numeric_custom_attribute: histogram by numeric {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1159
+ # * numeric_custom_attribute: histogram by numeric
1160
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1138
1161
  # Values can be accessed via square bracket notations like
1139
1162
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
1140
1163
  # group results by.
@@ -1149,11 +1172,14 @@ module Google
1149
1172
  # [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
1150
1173
  # @param job_view [::Google::Cloud::Talent::V4::JobView]
1151
1174
  # The desired job attributes returned for jobs in the search response.
1152
- # Defaults to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
1175
+ # Defaults to
1176
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if
1177
+ # no value is specified.
1153
1178
  # @param offset [::Integer]
1154
1179
  # An integer that specifies the current offset (that is, starting result
1155
1180
  # location, amongst the jobs deemed by the API as relevant) in search
1156
- # results. This field is only considered if {::Google::Cloud::Talent::V4::SearchJobsRequest#page_token page_token} is unset.
1181
+ # results. This field is only considered if
1182
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#page_token page_token} is unset.
1157
1183
  #
1158
1184
  # The maximum allowed value is 5000. Otherwise an error is thrown.
1159
1185
  #
@@ -1167,8 +1193,9 @@ module Google
1167
1193
  # response time. The value can be between 1 and 100.
1168
1194
  # @param page_token [::String]
1169
1195
  # The token specifying the current offset within
1170
- # search results. See {::Google::Cloud::Talent::V4::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token} for
1171
- # an explanation of how to obtain the next set of query results.
1196
+ # search results. See
1197
+ # {::Google::Cloud::Talent::V4::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token}
1198
+ # for an explanation of how to obtain the next set of query results.
1172
1199
  # @param order_by [::String]
1173
1200
  # The criteria determining how search results are sorted. Default is
1174
1201
  # `"relevance desc"`.
@@ -1178,33 +1205,36 @@ module Google
1178
1205
  # * `"relevance desc"`: By relevance descending, as determined by the API
1179
1206
  # algorithms. Relevance thresholding of query results is only available
1180
1207
  # with this ordering.
1181
- # * `"posting_publish_time desc"`: By {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1208
+ # * `"posting_publish_time desc"`: By
1209
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1182
1210
  # descending.
1183
- # * `"posting_update_time desc"`: By {::Google::Cloud::Talent::V4::Job#posting_update_time Job.posting_update_time}
1211
+ # * `"posting_update_time desc"`: By
1212
+ # {::Google::Cloud::Talent::V4::Job#posting_update_time Job.posting_update_time}
1184
1213
  # descending.
1185
1214
  # * `"title"`: By {::Google::Cloud::Talent::V4::Job#title Job.title} ascending.
1186
- # * `"title desc"`: By {::Google::Cloud::Talent::V4::Job#title Job.title} descending.
1215
+ # * `"title desc"`: By {::Google::Cloud::Talent::V4::Job#title Job.title}
1216
+ # descending.
1187
1217
  # * `"annualized_base_compensation"`: By job's
1188
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} ascending. Jobs
1189
- # whose annualized base compensation is unspecified are put at the end of
1190
- # search results.
1218
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1219
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1220
+ # at the end of search results.
1191
1221
  # * `"annualized_base_compensation desc"`: By job's
1192
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} descending. Jobs
1193
- # whose annualized base compensation is unspecified are put at the end of
1194
- # search results.
1222
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1223
+ # descending. Jobs whose annualized base compensation is unspecified are
1224
+ # put at the end of search results.
1195
1225
  # * `"annualized_total_compensation"`: By job's
1196
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} ascending. Jobs
1197
- # whose annualized base compensation is unspecified are put at the end of
1198
- # search results.
1226
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1227
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1228
+ # at the end of search results.
1199
1229
  # * `"annualized_total_compensation desc"`: By job's
1200
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} descending. Jobs
1201
- # whose annualized base compensation is unspecified are put at the end of
1202
- # search results.
1230
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1231
+ # descending. Jobs whose annualized base compensation is unspecified are
1232
+ # put at the end of search results.
1203
1233
  # * `"custom_ranking desc"`: By the relevance score adjusted to the
1204
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression} with weight
1205
- # factor assigned by
1206
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level} in descending
1207
- # order.
1234
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression}
1235
+ # with weight factor assigned by
1236
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level}
1237
+ # in descending order.
1208
1238
  # * Location sorting: Use the special syntax to order jobs by distance:<br>
1209
1239
  # `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
1210
1240
  # `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
@@ -1228,36 +1258,46 @@ module Google
1228
1258
  # displayed to the job seeker higher up in the results, with the other jobs
1229
1259
  # being displayed lower down in the results.
1230
1260
  #
1231
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE} if no value
1232
- # is specified.
1261
+ # Defaults to
1262
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE}
1263
+ # if no value is specified.
1233
1264
  # @param custom_ranking_info [::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo, ::Hash]
1234
1265
  # Controls over how job documents get ranked on top of existing relevance
1235
1266
  # score (determined by API algorithm).
1236
1267
  # @param disable_keyword_match [::Boolean]
1237
1268
  # This field is deprecated. Please use
1238
- # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
1269
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1270
+ # going forward.
1239
1271
  #
1240
1272
  # To migrate, disable_keyword_match set to false maps to
1241
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
1242
- # true maps to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
1243
- # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
1244
- #
1245
- # Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4::Job#title Job.title},
1246
- # {::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},
1247
- # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
1248
- # keyword match returns jobs that do not match given category filters when
1249
- # there are matching keywords. For example, for the query "program manager,"
1250
- # a result is returned even if the job posting has the title "software
1251
- # developer," which doesn't fall into "program manager" ontology, but does
1252
- # have "program manager" appearing in its description.
1273
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL},
1274
+ # and disable_keyword_match set to true maps to
1275
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}.
1276
+ # If
1277
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1278
+ # is set, this field is ignored.
1279
+ #
1280
+ # Controls whether to disable exact keyword match on
1281
+ # {::Google::Cloud::Talent::V4::Job#title Job.title},
1282
+ # {::Google::Cloud::Talent::V4::Job#description Job.description},
1283
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name},
1284
+ # {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
1285
+ # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When
1286
+ # disable keyword match is turned off, a keyword match returns jobs that do
1287
+ # not match given category filters when there are matching keywords. For
1288
+ # example, for the query "program manager," a result is returned even if the
1289
+ # job posting has the title "software developer," which doesn't fall into
1290
+ # "program manager" ontology, but does have "program manager" appearing in
1291
+ # its description.
1253
1292
  #
1254
1293
  # For queries like "cloud" that don't contain title or
1255
1294
  # location specific ontology, jobs with "cloud" keyword matches are returned
1256
1295
  # regardless of this flag's value.
1257
1296
  #
1258
- # Use {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
1259
- # company-specific globally matched custom field/attribute string values are
1260
- # needed. Enabling keyword match improves recall of subsequent search
1297
+ # Use
1298
+ # {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
1299
+ # if company-specific globally matched custom field/attribute string values
1300
+ # are needed. Enabling keyword match improves recall of subsequent search
1261
1301
  # requests.
1262
1302
  #
1263
1303
  # Defaults to false.
@@ -1265,8 +1305,9 @@ module Google
1265
1305
  # Controls what keyword match options to use. If both keyword_match_mode and
1266
1306
  # disable_keyword_match are set, keyword_match_mode will take precedence.
1267
1307
  #
1268
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
1269
- # is specified.
1308
+ # Defaults to
1309
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
1310
+ # if no value is specified.
1270
1311
  #
1271
1312
  # @yield [response, operation] Access the result along with the RPC operation
1272
1313
  # @yieldparam response [::Google::Cloud::Talent::V4::SearchJobsResponse]
@@ -1333,16 +1374,18 @@ module Google
1333
1374
  end
1334
1375
 
1335
1376
  ##
1336
- # Searches for jobs using the provided {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
1377
+ # Searches for jobs using the provided
1378
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
1337
1379
  #
1338
1380
  # This API call is intended for the use case of targeting passive job
1339
1381
  # seekers (for example, job seekers who have signed up to receive email
1340
1382
  # alerts about potential job opportunities), it has different algorithmic
1341
1383
  # adjustments that are designed to specifically target passive job seekers.
1342
1384
  #
1343
- # This call constrains the {::Google::Cloud::Talent::V4::Job#visibility visibility} of jobs
1344
- # present in the database, and only returns jobs the caller has
1345
- # permission to search against.
1385
+ # This call constrains the
1386
+ # {::Google::Cloud::Talent::V4::Job#visibility visibility} of jobs present in the
1387
+ # database, and only returns jobs the caller has permission to search
1388
+ # against.
1346
1389
  #
1347
1390
  # @overload search_jobs_for_alert(request, options = nil)
1348
1391
  # Pass arguments to `search_jobs_for_alert` via a request object, either of type
@@ -1367,11 +1410,12 @@ module Google
1367
1410
  # @param search_mode [::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode]
1368
1411
  # Mode of a search.
1369
1412
  #
1370
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1413
+ # Defaults to
1414
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1371
1415
  # @param request_metadata [::Google::Cloud::Talent::V4::RequestMetadata, ::Hash]
1372
- # Required. The meta information collected about the job searcher, used to improve the
1373
- # search quality of the service. The identifiers (such as `user_id`) are
1374
- # provided by users, and must be unique and consistent.
1416
+ # Required. The meta information collected about the job searcher, used to
1417
+ # improve the search quality of the service. The identifiers (such as
1418
+ # `user_id`) are provided by users, and must be unique and consistent.
1375
1419
  # @param job_query [::Google::Cloud::Talent::V4::JobQuery, ::Hash]
1376
1420
  # Query used to search against jobs, such as keyword, location filters, etc.
1377
1421
  # @param enable_broadening [::Boolean]
@@ -1415,23 +1459,32 @@ module Google
1415
1459
  #
1416
1460
  # Job histogram facets:
1417
1461
  #
1418
- # * company_display_name: histogram by {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}.
1419
- # * employment_type: histogram by {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types}, for example,
1462
+ # * company_display_name: histogram by
1463
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}.
1464
+ # * employment_type: histogram by
1465
+ # {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types}, for
1466
+ # example,
1420
1467
  # "FULL_TIME", "PART_TIME".
1421
- # * company_size: histogram by {::Google::Cloud::Talent::V4::CompanySize CompanySize}, for example, "SMALL",
1468
+ # * company_size (DEPRECATED): histogram by
1469
+ # {::Google::Cloud::Talent::V4::CompanySize CompanySize}, for example, "SMALL",
1422
1470
  # "MEDIUM", "BIG".
1423
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1471
+ # * publish_time_in_day: histogram by the
1472
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1424
1473
  # in days.
1425
1474
  # Must specify list of numeric buckets in spec.
1426
- # * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1475
+ # * publish_time_in_month: histogram by the
1476
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1427
1477
  # in months.
1428
1478
  # Must specify list of numeric buckets in spec.
1429
- # * publish_time_in_year: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1479
+ # * publish_time_in_year: histogram by the
1480
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1430
1481
  # in years.
1431
1482
  # Must specify list of numeric buckets in spec.
1432
- # * degree_types: histogram by the {::Google::Cloud::Talent::V4::Job#degree_types Job.degree_types}, for example,
1483
+ # * degree_types: histogram by the
1484
+ # {::Google::Cloud::Talent::V4::Job#degree_types Job.degree_types}, for example,
1433
1485
  # "Bachelors", "Masters".
1434
- # * job_level: histogram by the {::Google::Cloud::Talent::V4::Job#job_level Job.job_level}, for example, "Entry
1486
+ # * job_level: histogram by the
1487
+ # {::Google::Cloud::Talent::V4::Job#job_level Job.job_level}, for example, "Entry
1435
1488
  # Level".
1436
1489
  # * country: histogram by the country code of jobs, for example, "US", "FR".
1437
1490
  # * admin1: histogram by the admin1 code of jobs, which is a global
@@ -1446,25 +1499,31 @@ module Google
1446
1499
  # and longitude), for example, 37.4038522,-122.0987765. Since the
1447
1500
  # coordinates of a city center can change, customers may need to refresh
1448
1501
  # them periodically.
1449
- # * locale: histogram by the {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, for example, "en-US",
1502
+ # * locale: histogram by the
1503
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, for example,
1504
+ # "en-US",
1450
1505
  # "fr-FR".
1451
- # * language: histogram by the language subtag of the {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
1506
+ # * language: histogram by the language subtag of the
1507
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
1452
1508
  # for example, "en", "fr".
1453
- # * category: histogram by the {::Google::Cloud::Talent::V4::JobCategory JobCategory}, for example,
1509
+ # * category: histogram by the
1510
+ # {::Google::Cloud::Talent::V4::JobCategory JobCategory}, for example,
1454
1511
  # "COMPUTER_AND_IT", "HEALTHCARE".
1455
1512
  # * base_compensation_unit: histogram by the
1456
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit} of base
1457
- # salary, for example, "WEEKLY", "MONTHLY".
1513
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit}
1514
+ # of base salary, for example, "WEEKLY", "MONTHLY".
1458
1515
  # * base_compensation: histogram by the base salary. Must specify list of
1459
1516
  # numeric buckets to group results by.
1460
1517
  # * annualized_base_compensation: histogram by the base annualized salary.
1461
1518
  # Must specify list of numeric buckets to group results by.
1462
1519
  # * annualized_total_compensation: histogram by the total annualized salary.
1463
1520
  # Must specify list of numeric buckets to group results by.
1464
- # * string_custom_attribute: histogram by string {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1521
+ # * string_custom_attribute: histogram by string
1522
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1465
1523
  # Values can be accessed via square bracket notations like
1466
1524
  # string_custom_attribute["key1"].
1467
- # * numeric_custom_attribute: histogram by numeric {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1525
+ # * numeric_custom_attribute: histogram by numeric
1526
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
1468
1527
  # Values can be accessed via square bracket notations like
1469
1528
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
1470
1529
  # group results by.
@@ -1479,11 +1538,14 @@ module Google
1479
1538
  # [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
1480
1539
  # @param job_view [::Google::Cloud::Talent::V4::JobView]
1481
1540
  # The desired job attributes returned for jobs in the search response.
1482
- # Defaults to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
1541
+ # Defaults to
1542
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if
1543
+ # no value is specified.
1483
1544
  # @param offset [::Integer]
1484
1545
  # An integer that specifies the current offset (that is, starting result
1485
1546
  # location, amongst the jobs deemed by the API as relevant) in search
1486
- # results. This field is only considered if {::Google::Cloud::Talent::V4::SearchJobsRequest#page_token page_token} is unset.
1547
+ # results. This field is only considered if
1548
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#page_token page_token} is unset.
1487
1549
  #
1488
1550
  # The maximum allowed value is 5000. Otherwise an error is thrown.
1489
1551
  #
@@ -1497,8 +1559,9 @@ module Google
1497
1559
  # response time. The value can be between 1 and 100.
1498
1560
  # @param page_token [::String]
1499
1561
  # The token specifying the current offset within
1500
- # search results. See {::Google::Cloud::Talent::V4::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token} for
1501
- # an explanation of how to obtain the next set of query results.
1562
+ # search results. See
1563
+ # {::Google::Cloud::Talent::V4::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token}
1564
+ # for an explanation of how to obtain the next set of query results.
1502
1565
  # @param order_by [::String]
1503
1566
  # The criteria determining how search results are sorted. Default is
1504
1567
  # `"relevance desc"`.
@@ -1508,33 +1571,36 @@ module Google
1508
1571
  # * `"relevance desc"`: By relevance descending, as determined by the API
1509
1572
  # algorithms. Relevance thresholding of query results is only available
1510
1573
  # with this ordering.
1511
- # * `"posting_publish_time desc"`: By {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1574
+ # * `"posting_publish_time desc"`: By
1575
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
1512
1576
  # descending.
1513
- # * `"posting_update_time desc"`: By {::Google::Cloud::Talent::V4::Job#posting_update_time Job.posting_update_time}
1577
+ # * `"posting_update_time desc"`: By
1578
+ # {::Google::Cloud::Talent::V4::Job#posting_update_time Job.posting_update_time}
1514
1579
  # descending.
1515
1580
  # * `"title"`: By {::Google::Cloud::Talent::V4::Job#title Job.title} ascending.
1516
- # * `"title desc"`: By {::Google::Cloud::Talent::V4::Job#title Job.title} descending.
1581
+ # * `"title desc"`: By {::Google::Cloud::Talent::V4::Job#title Job.title}
1582
+ # descending.
1517
1583
  # * `"annualized_base_compensation"`: By job's
1518
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} ascending. Jobs
1519
- # whose annualized base compensation is unspecified are put at the end of
1520
- # search results.
1584
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1585
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1586
+ # at the end of search results.
1521
1587
  # * `"annualized_base_compensation desc"`: By job's
1522
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} descending. Jobs
1523
- # whose annualized base compensation is unspecified are put at the end of
1524
- # search results.
1588
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1589
+ # descending. Jobs whose annualized base compensation is unspecified are
1590
+ # put at the end of search results.
1525
1591
  # * `"annualized_total_compensation"`: By job's
1526
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} ascending. Jobs
1527
- # whose annualized base compensation is unspecified are put at the end of
1528
- # search results.
1592
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1593
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1594
+ # at the end of search results.
1529
1595
  # * `"annualized_total_compensation desc"`: By job's
1530
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} descending. Jobs
1531
- # whose annualized base compensation is unspecified are put at the end of
1532
- # search results.
1596
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1597
+ # descending. Jobs whose annualized base compensation is unspecified are
1598
+ # put at the end of search results.
1533
1599
  # * `"custom_ranking desc"`: By the relevance score adjusted to the
1534
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression} with weight
1535
- # factor assigned by
1536
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level} in descending
1537
- # order.
1600
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression}
1601
+ # with weight factor assigned by
1602
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level}
1603
+ # in descending order.
1538
1604
  # * Location sorting: Use the special syntax to order jobs by distance:<br>
1539
1605
  # `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
1540
1606
  # `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
@@ -1558,36 +1624,46 @@ module Google
1558
1624
  # displayed to the job seeker higher up in the results, with the other jobs
1559
1625
  # being displayed lower down in the results.
1560
1626
  #
1561
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE} if no value
1562
- # is specified.
1627
+ # Defaults to
1628
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE}
1629
+ # if no value is specified.
1563
1630
  # @param custom_ranking_info [::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo, ::Hash]
1564
1631
  # Controls over how job documents get ranked on top of existing relevance
1565
1632
  # score (determined by API algorithm).
1566
1633
  # @param disable_keyword_match [::Boolean]
1567
1634
  # This field is deprecated. Please use
1568
- # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
1635
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1636
+ # going forward.
1569
1637
  #
1570
1638
  # To migrate, disable_keyword_match set to false maps to
1571
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
1572
- # true maps to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
1573
- # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
1574
- #
1575
- # Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4::Job#title Job.title},
1576
- # {::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},
1577
- # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
1578
- # keyword match returns jobs that do not match given category filters when
1579
- # there are matching keywords. For example, for the query "program manager,"
1580
- # a result is returned even if the job posting has the title "software
1581
- # developer," which doesn't fall into "program manager" ontology, but does
1582
- # have "program manager" appearing in its description.
1639
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL},
1640
+ # and disable_keyword_match set to true maps to
1641
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}.
1642
+ # If
1643
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1644
+ # is set, this field is ignored.
1645
+ #
1646
+ # Controls whether to disable exact keyword match on
1647
+ # {::Google::Cloud::Talent::V4::Job#title Job.title},
1648
+ # {::Google::Cloud::Talent::V4::Job#description Job.description},
1649
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name},
1650
+ # {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
1651
+ # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When
1652
+ # disable keyword match is turned off, a keyword match returns jobs that do
1653
+ # not match given category filters when there are matching keywords. For
1654
+ # example, for the query "program manager," a result is returned even if the
1655
+ # job posting has the title "software developer," which doesn't fall into
1656
+ # "program manager" ontology, but does have "program manager" appearing in
1657
+ # its description.
1583
1658
  #
1584
1659
  # For queries like "cloud" that don't contain title or
1585
1660
  # location specific ontology, jobs with "cloud" keyword matches are returned
1586
1661
  # regardless of this flag's value.
1587
1662
  #
1588
- # Use {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
1589
- # company-specific globally matched custom field/attribute string values are
1590
- # needed. Enabling keyword match improves recall of subsequent search
1663
+ # Use
1664
+ # {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
1665
+ # if company-specific globally matched custom field/attribute string values
1666
+ # are needed. Enabling keyword match improves recall of subsequent search
1591
1667
  # requests.
1592
1668
  #
1593
1669
  # Defaults to false.
@@ -1595,8 +1671,9 @@ module Google
1595
1671
  # Controls what keyword match options to use. If both keyword_match_mode and
1596
1672
  # disable_keyword_match are set, keyword_match_mode will take precedence.
1597
1673
  #
1598
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
1599
- # is specified.
1674
+ # Defaults to
1675
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
1676
+ # if no value is specified.
1600
1677
  #
1601
1678
  # @yield [response, operation] Access the result along with the RPC operation
1602
1679
  # @yieldparam response [::Google::Cloud::Talent::V4::SearchJobsResponse]