google-cloud-talent-v4 0.8.0 → 0.9.0

Sign up to get free protection for your applications and to get access to all the features.
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
data/lib/google/cloud/talent/v4/job_service/client.rb CHANGED
@@ -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]