google-cloud-talent-v4beta1 0.6.1 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (49) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -2
  3. data/lib/google/cloud/talent/v4beta1/company_service/client.rb +16 -12
  4. data/lib/google/cloud/talent/v4beta1/company_service/rest/client.rb +693 -0
  5. data/lib/google/cloud/talent/v4beta1/company_service/rest/service_stub.rb +382 -0
  6. data/lib/google/cloud/talent/v4beta1/company_service/rest.rb +52 -0
  7. data/lib/google/cloud/talent/v4beta1/company_service.rb +7 -1
  8. data/lib/google/cloud/talent/v4beta1/completion/client.rb +4 -2
  9. data/lib/google/cloud/talent/v4beta1/completion/rest/client.rb +386 -0
  10. data/lib/google/cloud/talent/v4beta1/completion/rest/service_stub.rb +114 -0
  11. data/lib/google/cloud/talent/v4beta1/completion/rest.rb +52 -0
  12. data/lib/google/cloud/talent/v4beta1/completion.rb +7 -1
  13. data/lib/google/cloud/talent/v4beta1/event_service/client.rb +2 -2
  14. data/lib/google/cloud/talent/v4beta1/event_service/rest/client.rb +359 -0
  15. data/lib/google/cloud/talent/v4beta1/event_service/rest/service_stub.rb +116 -0
  16. data/lib/google/cloud/talent/v4beta1/event_service/rest.rb +52 -0
  17. data/lib/google/cloud/talent/v4beta1/event_service.rb +7 -1
  18. data/lib/google/cloud/talent/v4beta1/job_service/client.rb +248 -159
  19. data/lib/google/cloud/talent/v4beta1/job_service/operations.rb +12 -14
  20. data/lib/google/cloud/talent/v4beta1/job_service/rest/client.rb +1712 -0
  21. data/lib/google/cloud/talent/v4beta1/job_service/rest/operations.rb +793 -0
  22. data/lib/google/cloud/talent/v4beta1/job_service/rest/service_stub.rb +721 -0
  23. data/lib/google/cloud/talent/v4beta1/job_service/rest.rb +53 -0
  24. data/lib/google/cloud/talent/v4beta1/job_service.rb +7 -1
  25. data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +12 -8
  26. data/lib/google/cloud/talent/v4beta1/rest.rb +41 -0
  27. data/lib/google/cloud/talent/v4beta1/tenant_service/client.rb +13 -10
  28. data/lib/google/cloud/talent/v4beta1/tenant_service/rest/client.rb +672 -0
  29. data/lib/google/cloud/talent/v4beta1/tenant_service/rest/service_stub.rb +345 -0
  30. data/lib/google/cloud/talent/v4beta1/tenant_service/rest.rb +52 -0
  31. data/lib/google/cloud/talent/v4beta1/tenant_service.rb +7 -1
  32. data/lib/google/cloud/talent/v4beta1/version.rb +1 -1
  33. data/lib/google/cloud/talent/v4beta1.rb +7 -2
  34. data/proto_docs/google/api/client.rb +318 -0
  35. data/proto_docs/google/api/launch_stage.rb +71 -0
  36. data/proto_docs/google/cloud/talent/v4beta1/common.rb +117 -56
  37. data/proto_docs/google/cloud/talent/v4beta1/company.rb +10 -5
  38. data/proto_docs/google/cloud/talent/v4beta1/company_service.rb +12 -6
  39. data/proto_docs/google/cloud/talent/v4beta1/completion_service.rb +21 -10
  40. data/proto_docs/google/cloud/talent/v4beta1/event.rb +20 -10
  41. data/proto_docs/google/cloud/talent/v4beta1/event_service.rb +2 -2
  42. data/proto_docs/google/cloud/talent/v4beta1/filters.rb +62 -38
  43. data/proto_docs/google/cloud/talent/v4beta1/histogram.rb +8 -3
  44. data/proto_docs/google/cloud/talent/v4beta1/job.rb +86 -54
  45. data/proto_docs/google/cloud/talent/v4beta1/job_service.rb +211 -120
  46. data/proto_docs/google/cloud/talent/v4beta1/tenant.rb +9 -5
  47. data/proto_docs/google/cloud/talent/v4beta1/tenant_service.rb +9 -4
  48. data/proto_docs/google/rpc/status.rb +4 -2
  49. metadata +28 -8
@@ -327,14 +327,14 @@ module Google
327
327
  # # Call the batch_create_jobs method.
328
328
  # result = client.batch_create_jobs request
329
329
  #
330
- # # The returned object is of type Gapic::Operation. You can use this
331
- # # object to check the status of an operation, cancel it, or wait
332
- # # for results. Here is how to block until completion:
330
+ # # The returned object is of type Gapic::Operation. You can use it to
331
+ # # check the status of an operation, cancel it, or wait for results.
332
+ # # Here is how to wait for a response.
333
333
  # result.wait_until_done! timeout: 60
334
334
  # if result.response?
335
335
  # p result.response
336
336
  # else
337
- # puts "Error!"
337
+ # puts "No response received."
338
338
  # end
339
339
  #
340
340
  def batch_create_jobs request, options = nil
@@ -498,8 +498,10 @@ module Google
498
498
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
499
499
  # Strongly recommended for the best service experience.
500
500
  #
501
- # If {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask} is provided, only the specified fields in
502
- # {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated. Otherwise all the fields are updated.
501
+ # If {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
502
+ # is provided, only the specified fields in
503
+ # {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated.
504
+ # Otherwise all the fields are updated.
503
505
  #
504
506
  # A field mask to restrict the fields that are updated. Only
505
507
  # top level fields of {::Google::Cloud::Talent::V4beta1::Job Job} are supported.
@@ -598,17 +600,22 @@ module Google
598
600
  # Strongly recommended for the best service experience. Be aware that it will
599
601
  # also increase latency when checking the status of a batch operation.
600
602
  #
601
- # If {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask} is provided, only the specified fields in
602
- # {::Google::Cloud::Talent::V4beta1::Job Job} are updated. Otherwise all the fields are updated.
603
+ # If
604
+ # {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}
605
+ # is provided, only the specified fields in
606
+ # {::Google::Cloud::Talent::V4beta1::Job Job} are updated. Otherwise all the
607
+ # fields are updated.
603
608
  #
604
609
  # A field mask to restrict the fields that are updated. Only
605
610
  # top level fields of {::Google::Cloud::Talent::V4beta1::Job Job} are supported.
606
611
  #
607
- # If {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask} is provided, The {::Google::Cloud::Talent::V4beta1::Job Job} inside
612
+ # If
613
+ # {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}
614
+ # is provided, The {::Google::Cloud::Talent::V4beta1::Job Job} inside
608
615
  # {::Google::Cloud::Talent::V4beta1::JobOperationResult::JobResult JobResult}
609
616
  # will only contains fields that is updated, plus the Id of the Job.
610
- # Otherwise, {::Google::Cloud::Talent::V4beta1::Job Job} will include all fields, which can yield a very
611
- # large response.
617
+ # Otherwise, {::Google::Cloud::Talent::V4beta1::Job Job} will include all fields,
618
+ # which can yield a very large response.
612
619
  #
613
620
  # @yield [response, operation] Access the result along with the RPC operation
614
621
  # @yieldparam response [::Gapic::Operation]
@@ -630,14 +637,14 @@ module Google
630
637
  # # Call the batch_update_jobs method.
631
638
  # result = client.batch_update_jobs request
632
639
  #
633
- # # The returned object is of type Gapic::Operation. You can use this
634
- # # object to check the status of an operation, cancel it, or wait
635
- # # for results. Here is how to block until completion:
640
+ # # The returned object is of type Gapic::Operation. You can use it to
641
+ # # check the status of an operation, cancel it, or wait for results.
642
+ # # Here is how to wait for a response.
636
643
  # result.wait_until_done! timeout: 60
637
644
  # if result.response?
638
645
  # p result.response
639
646
  # else
640
- # puts "Error!"
647
+ # puts "No response received."
641
648
  # end
642
649
  #
643
650
  def batch_update_jobs request, options = nil
@@ -931,14 +938,18 @@ module Google
931
938
  # @param page_size [::Integer]
932
939
  # The maximum number of jobs to be returned per page of results.
933
940
  #
934
- # If {::Google::Cloud::Talent::V4beta1::ListJobsRequest#job_view job_view} is set to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY}, the maximum allowed
935
- # page size is 1000. Otherwise, the maximum allowed page size is 100.
941
+ # If {::Google::Cloud::Talent::V4beta1::ListJobsRequest#job_view job_view} is set
942
+ # to
943
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY},
944
+ # the maximum allowed page size is 1000. Otherwise, the maximum allowed page
945
+ # size is 100.
936
946
  #
937
947
  # Default is 100 if empty or a number < 1 is specified.
938
948
  # @param job_view [::Google::Cloud::Talent::V4beta1::JobView]
939
949
  # The desired job attributes returned for jobs in the
940
- # search response. Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL} if no value is
941
- # specified.
950
+ # search response. Defaults to
951
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL}
952
+ # if no value is specified.
942
953
  #
943
954
  # @yield [response, operation] Access the result along with the RPC operation
944
955
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Talent::V4beta1::Job>]
@@ -960,13 +971,11 @@ module Google
960
971
  # # Call the list_jobs method.
961
972
  # result = client.list_jobs request
962
973
  #
963
- # # The returned object is of type Gapic::PagedEnumerable. You can
964
- # # iterate over all elements by calling #each, and the enumerable
965
- # # will lazily make API calls to fetch subsequent pages. Other
966
- # # methods are also available for managing paging directly.
967
- # result.each do |response|
974
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
975
+ # # over elements, and API calls will be issued to fetch pages as needed.
976
+ # result.each do |item|
968
977
  # # Each element is of type ::Google::Cloud::Talent::V4beta1::Job.
969
- # p response
978
+ # p item
970
979
  # end
971
980
  #
972
981
  def list_jobs request, options = nil
@@ -1012,11 +1021,13 @@ module Google
1012
1021
  end
1013
1022
 
1014
1023
  ##
1015
- # Searches for jobs using the provided {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
1024
+ # Searches for jobs using the provided
1025
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
1016
1026
  #
1017
- # This call constrains the {::Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs
1018
- # present in the database, and only returns jobs that the caller has
1019
- # permission to search against.
1027
+ # This call constrains the
1028
+ # {::Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs present in
1029
+ # the database, and only returns jobs that the caller has permission to
1030
+ # search against.
1020
1031
  #
1021
1032
  # @overload search_jobs(request, options = nil)
1022
1033
  # Pass arguments to `search_jobs` via a request object, either of type
@@ -1042,11 +1053,12 @@ module Google
1042
1053
  # @param search_mode [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
1043
1054
  # Mode of a search.
1044
1055
  #
1045
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1056
+ # Defaults to
1057
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1046
1058
  # @param request_metadata [::Google::Cloud::Talent::V4beta1::RequestMetadata, ::Hash]
1047
- # Required. The meta information collected about the job searcher, used to improve the
1048
- # search quality of the service. The identifiers (such as `user_id`) are
1049
- # provided by users, and must be unique and consistent.
1059
+ # Required. The meta information collected about the job searcher, used to
1060
+ # improve the search quality of the service. The identifiers (such as
1061
+ # `user_id`) are provided by users, and must be unique and consistent.
1050
1062
  # @param job_query [::Google::Cloud::Talent::V4beta1::JobQuery, ::Hash]
1051
1063
  # Query used to search against jobs, such as keyword, location filters, etc.
1052
1064
  # @param enable_broadening [::Boolean]
@@ -1092,23 +1104,34 @@ module Google
1092
1104
  #
1093
1105
  # Job histogram facets:
1094
1106
  #
1095
- # * company_display_name: histogram by {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}.
1096
- # * employment_type: histogram by {::Google::Cloud::Talent::V4beta1::Job#employment_types Job.employment_types}, for example,
1107
+ # * company_display_name: histogram by
1108
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}.
1109
+ # * employment_type: histogram by
1110
+ # {::Google::Cloud::Talent::V4beta1::Job#employment_types Job.employment_types},
1111
+ # for example,
1097
1112
  # "FULL_TIME", "PART_TIME".
1098
- # * company_size (DEPRECATED): histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
1113
+ # * company_size (DEPRECATED): histogram by
1114
+ # {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
1099
1115
  # "SMALL", "MEDIUM", "BIG".
1100
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1116
+ # * publish_time_in_day: histogram by the
1117
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1101
1118
  # in days.
1102
1119
  # Must specify list of numeric buckets in spec.
1103
- # * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1120
+ # * publish_time_in_month: histogram by the
1121
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1104
1122
  # in months.
1105
1123
  # Must specify list of numeric buckets in spec.
1106
- # * publish_time_in_year: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1124
+ # * publish_time_in_year: histogram by the
1125
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1107
1126
  # in years.
1108
1127
  # Must specify list of numeric buckets in spec.
1109
- # * degree_types: histogram by the {::Google::Cloud::Talent::V4beta1::Job#degree_types Job.degree_types}, for example,
1128
+ # * degree_types: histogram by the
1129
+ # {::Google::Cloud::Talent::V4beta1::Job#degree_types Job.degree_types}, for
1130
+ # example,
1110
1131
  # "Bachelors", "Masters".
1111
- # * job_level: histogram by the {::Google::Cloud::Talent::V4beta1::Job#job_level Job.job_level}, for example, "Entry
1132
+ # * job_level: histogram by the
1133
+ # {::Google::Cloud::Talent::V4beta1::Job#job_level Job.job_level}, for example,
1134
+ # "Entry
1112
1135
  # Level".
1113
1136
  # * country: histogram by the country code of jobs, for example, "US", "FR".
1114
1137
  # * admin1: histogram by the admin1 code of jobs, which is a global
@@ -1123,25 +1146,31 @@ module Google
1123
1146
  # and longitude), for example, 37.4038522,-122.0987765. Since the
1124
1147
  # coordinates of a city center can change, customers may need to refresh
1125
1148
  # them periodically.
1126
- # * locale: histogram by the {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, for example, "en-US",
1149
+ # * locale: histogram by the
1150
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, for
1151
+ # example, "en-US",
1127
1152
  # "fr-FR".
1128
- # * language: histogram by the language subtag of the {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
1153
+ # * language: histogram by the language subtag of the
1154
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
1129
1155
  # for example, "en", "fr".
1130
- # * category: histogram by the {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
1156
+ # * category: histogram by the
1157
+ # {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
1131
1158
  # "COMPUTER_AND_IT", "HEALTHCARE".
1132
1159
  # * base_compensation_unit: histogram by the
1133
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit} of base
1134
- # salary, for example, "WEEKLY", "MONTHLY".
1160
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit}
1161
+ # of base salary, for example, "WEEKLY", "MONTHLY".
1135
1162
  # * base_compensation: histogram by the base salary. Must specify list of
1136
1163
  # numeric buckets to group results by.
1137
1164
  # * annualized_base_compensation: histogram by the base annualized salary.
1138
1165
  # Must specify list of numeric buckets to group results by.
1139
1166
  # * annualized_total_compensation: histogram by the total annualized salary.
1140
1167
  # Must specify list of numeric buckets to group results by.
1141
- # * string_custom_attribute: histogram by string {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1168
+ # * string_custom_attribute: histogram by string
1169
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1142
1170
  # Values can be accessed via square bracket notations like
1143
1171
  # string_custom_attribute["key1"].
1144
- # * numeric_custom_attribute: histogram by numeric {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1172
+ # * numeric_custom_attribute: histogram by numeric
1173
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1145
1174
  # Values can be accessed via square bracket notations like
1146
1175
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
1147
1176
  # group results by.
@@ -1156,11 +1185,15 @@ module Google
1156
1185
  # [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
1157
1186
  # @param job_view [::Google::Cloud::Talent::V4beta1::JobView]
1158
1187
  # The desired job attributes returned for jobs in the search response.
1159
- # Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
1188
+ # Defaults to
1189
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL}
1190
+ # if no value is specified.
1160
1191
  # @param offset [::Integer]
1161
1192
  # An integer that specifies the current offset (that is, starting result
1162
1193
  # location, amongst the jobs deemed by the API as relevant) in search
1163
- # results. This field is only considered if {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is unset.
1194
+ # results. This field is only considered if
1195
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
1196
+ # unset.
1164
1197
  #
1165
1198
  # The maximum allowed value is 5000. Otherwise an error is thrown.
1166
1199
  #
@@ -1174,8 +1207,9 @@ module Google
1174
1207
  # response time. The value can be between 1 and 100.
1175
1208
  # @param page_token [::String]
1176
1209
  # The token specifying the current offset within
1177
- # search results. See {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token} for
1178
- # an explanation of how to obtain the next set of query results.
1210
+ # search results. See
1211
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token}
1212
+ # for an explanation of how to obtain the next set of query results.
1179
1213
  # @param order_by [::String]
1180
1214
  # The criteria determining how search results are sorted. Default is
1181
1215
  # `"relevance desc"`.
@@ -1185,33 +1219,37 @@ module Google
1185
1219
  # * `"relevance desc"`: By relevance descending, as determined by the API
1186
1220
  # algorithms. Relevance thresholding of query results is only available
1187
1221
  # with this ordering.
1188
- # * `"posting_publish_time desc"`: By {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1222
+ # * `"posting_publish_time desc"`: By
1223
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1189
1224
  # descending.
1190
- # * `"posting_update_time desc"`: By {::Google::Cloud::Talent::V4beta1::Job#posting_update_time Job.posting_update_time}
1225
+ # * `"posting_update_time desc"`: By
1226
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_update_time Job.posting_update_time}
1191
1227
  # descending.
1192
- # * `"title"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title} ascending.
1193
- # * `"title desc"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title} descending.
1228
+ # * `"title"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title}
1229
+ # ascending.
1230
+ # * `"title desc"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title}
1231
+ # descending.
1194
1232
  # * `"annualized_base_compensation"`: By job's
1195
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} ascending. Jobs
1196
- # whose annualized base compensation is unspecified are put at the end of
1197
- # search results.
1233
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1234
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1235
+ # at the end of search results.
1198
1236
  # * `"annualized_base_compensation desc"`: By job's
1199
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} descending. Jobs
1200
- # whose annualized base compensation is unspecified are put at the end of
1201
- # search results.
1237
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1238
+ # descending. Jobs whose annualized base compensation is unspecified are
1239
+ # put at the end of search results.
1202
1240
  # * `"annualized_total_compensation"`: By job's
1203
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} ascending. Jobs
1204
- # whose annualized base compensation is unspecified are put at the end of
1205
- # search results.
1241
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1242
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1243
+ # at the end of search results.
1206
1244
  # * `"annualized_total_compensation desc"`: By job's
1207
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} descending. Jobs
1208
- # whose annualized base compensation is unspecified are put at the end of
1209
- # search results.
1245
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1246
+ # descending. Jobs whose annualized base compensation is unspecified are
1247
+ # put at the end of search results.
1210
1248
  # * `"custom_ranking desc"`: By the relevance score adjusted to the
1211
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression} with weight
1212
- # factor assigned by
1213
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level} in descending
1214
- # order.
1249
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression}
1250
+ # with weight factor assigned by
1251
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level}
1252
+ # in descending order.
1215
1253
  # * Location sorting: Use the special syntax to order jobs by distance:<br>
1216
1254
  # `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
1217
1255
  # `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
@@ -1235,44 +1273,55 @@ module Google
1235
1273
  # displayed to the job seeker higher up in the results, with the other jobs
1236
1274
  # being displayed lower down in the results.
1237
1275
  #
1238
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE} if no value
1239
- # is specified.
1276
+ # Defaults to
1277
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE}
1278
+ # if no value is specified.
1240
1279
  # @param custom_ranking_info [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo, ::Hash]
1241
1280
  # Controls over how job documents get ranked on top of existing relevance
1242
1281
  # score (determined by API algorithm).
1243
1282
  # @param disable_keyword_match [::Boolean]
1244
1283
  # This field is deprecated. Please use
1245
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
1284
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1285
+ # going forward.
1246
1286
  #
1247
1287
  # To migrate, disable_keyword_match set to false maps to
1248
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
1249
- # true maps to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
1250
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
1251
- #
1252
- # Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
1253
- # {::Google::Cloud::Talent::V4beta1::Job#description Job.description}, {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
1254
- # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
1255
- # keyword match returns jobs that do not match given category filters when
1256
- # there are matching keywords. For example, for the query "program manager,"
1257
- # a result is returned even if the job posting has the title "software
1258
- # developer," which doesn't fall into "program manager" ontology, but does
1259
- # have "program manager" appearing in its description.
1288
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL},
1289
+ # and disable_keyword_match set to true maps to
1290
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}.
1291
+ # If
1292
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1293
+ # is set, this field is ignored.
1294
+ #
1295
+ # Controls whether to disable exact keyword match on
1296
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
1297
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description},
1298
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name},
1299
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
1300
+ # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When
1301
+ # disable keyword match is turned off, a keyword match returns jobs that do
1302
+ # not match given category filters when there are matching keywords. For
1303
+ # example, for the query "program manager," a result is returned even if the
1304
+ # job posting has the title "software developer," which doesn't fall into
1305
+ # "program manager" ontology, but does have "program manager" appearing in
1306
+ # its description.
1260
1307
  #
1261
1308
  # For queries like "cloud" that don't contain title or
1262
1309
  # location specific ontology, jobs with "cloud" keyword matches are returned
1263
1310
  # regardless of this flag's value.
1264
1311
  #
1265
- # Use {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
1266
- # company-specific globally matched custom field/attribute string values are
1267
- # needed. Enabling keyword match improves recall of subsequent search
1312
+ # Use
1313
+ # {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
1314
+ # if company-specific globally matched custom field/attribute string values
1315
+ # are needed. Enabling keyword match improves recall of subsequent search
1268
1316
  # requests.
1269
1317
  #
1270
1318
  # Defaults to false.
1271
1319
  # @param keyword_match_mode [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode]
1272
1320
  # Controls what keyword match options to use.
1273
1321
  #
1274
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
1275
- # is specified.
1322
+ # Defaults to
1323
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
1324
+ # if no value is specified.
1276
1325
  #
1277
1326
  # @yield [response, operation] Access the result along with the RPC operation
1278
1327
  # @yieldparam response [::Google::Cloud::Talent::V4beta1::SearchJobsResponse]
@@ -1339,16 +1388,18 @@ module Google
1339
1388
  end
1340
1389
 
1341
1390
  ##
1342
- # Searches for jobs using the provided {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
1391
+ # Searches for jobs using the provided
1392
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
1343
1393
  #
1344
1394
  # This API call is intended for the use case of targeting passive job
1345
1395
  # seekers (for example, job seekers who have signed up to receive email
1346
1396
  # alerts about potential job opportunities), and has different algorithmic
1347
1397
  # adjustments that are targeted to passive job seekers.
1348
1398
  #
1349
- # This call constrains the {::Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs
1350
- # present in the database, and only returns jobs the caller has
1351
- # permission to search against.
1399
+ # This call constrains the
1400
+ # {::Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs present in
1401
+ # the database, and only returns jobs the caller has permission to search
1402
+ # against.
1352
1403
  #
1353
1404
  # @overload search_jobs_for_alert(request, options = nil)
1354
1405
  # Pass arguments to `search_jobs_for_alert` via a request object, either of type
@@ -1374,11 +1425,12 @@ module Google
1374
1425
  # @param search_mode [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
1375
1426
  # Mode of a search.
1376
1427
  #
1377
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1428
+ # Defaults to
1429
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
1378
1430
  # @param request_metadata [::Google::Cloud::Talent::V4beta1::RequestMetadata, ::Hash]
1379
- # Required. The meta information collected about the job searcher, used to improve the
1380
- # search quality of the service. The identifiers (such as `user_id`) are
1381
- # provided by users, and must be unique and consistent.
1431
+ # Required. The meta information collected about the job searcher, used to
1432
+ # improve the search quality of the service. The identifiers (such as
1433
+ # `user_id`) are provided by users, and must be unique and consistent.
1382
1434
  # @param job_query [::Google::Cloud::Talent::V4beta1::JobQuery, ::Hash]
1383
1435
  # Query used to search against jobs, such as keyword, location filters, etc.
1384
1436
  # @param enable_broadening [::Boolean]
@@ -1424,23 +1476,34 @@ module Google
1424
1476
  #
1425
1477
  # Job histogram facets:
1426
1478
  #
1427
- # * company_display_name: histogram by {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}.
1428
- # * employment_type: histogram by {::Google::Cloud::Talent::V4beta1::Job#employment_types Job.employment_types}, for example,
1479
+ # * company_display_name: histogram by
1480
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}.
1481
+ # * employment_type: histogram by
1482
+ # {::Google::Cloud::Talent::V4beta1::Job#employment_types Job.employment_types},
1483
+ # for example,
1429
1484
  # "FULL_TIME", "PART_TIME".
1430
- # * company_size (DEPRECATED): histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
1485
+ # * company_size (DEPRECATED): histogram by
1486
+ # {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
1431
1487
  # "SMALL", "MEDIUM", "BIG".
1432
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1488
+ # * publish_time_in_day: histogram by the
1489
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1433
1490
  # in days.
1434
1491
  # Must specify list of numeric buckets in spec.
1435
- # * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1492
+ # * publish_time_in_month: histogram by the
1493
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1436
1494
  # in months.
1437
1495
  # Must specify list of numeric buckets in spec.
1438
- # * publish_time_in_year: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1496
+ # * publish_time_in_year: histogram by the
1497
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1439
1498
  # in years.
1440
1499
  # Must specify list of numeric buckets in spec.
1441
- # * degree_types: histogram by the {::Google::Cloud::Talent::V4beta1::Job#degree_types Job.degree_types}, for example,
1500
+ # * degree_types: histogram by the
1501
+ # {::Google::Cloud::Talent::V4beta1::Job#degree_types Job.degree_types}, for
1502
+ # example,
1442
1503
  # "Bachelors", "Masters".
1443
- # * job_level: histogram by the {::Google::Cloud::Talent::V4beta1::Job#job_level Job.job_level}, for example, "Entry
1504
+ # * job_level: histogram by the
1505
+ # {::Google::Cloud::Talent::V4beta1::Job#job_level Job.job_level}, for example,
1506
+ # "Entry
1444
1507
  # Level".
1445
1508
  # * country: histogram by the country code of jobs, for example, "US", "FR".
1446
1509
  # * admin1: histogram by the admin1 code of jobs, which is a global
@@ -1455,25 +1518,31 @@ module Google
1455
1518
  # and longitude), for example, 37.4038522,-122.0987765. Since the
1456
1519
  # coordinates of a city center can change, customers may need to refresh
1457
1520
  # them periodically.
1458
- # * locale: histogram by the {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, for example, "en-US",
1521
+ # * locale: histogram by the
1522
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, for
1523
+ # example, "en-US",
1459
1524
  # "fr-FR".
1460
- # * language: histogram by the language subtag of the {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
1525
+ # * language: histogram by the language subtag of the
1526
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
1461
1527
  # for example, "en", "fr".
1462
- # * category: histogram by the {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
1528
+ # * category: histogram by the
1529
+ # {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
1463
1530
  # "COMPUTER_AND_IT", "HEALTHCARE".
1464
1531
  # * base_compensation_unit: histogram by the
1465
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit} of base
1466
- # salary, for example, "WEEKLY", "MONTHLY".
1532
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit}
1533
+ # of base salary, for example, "WEEKLY", "MONTHLY".
1467
1534
  # * base_compensation: histogram by the base salary. Must specify list of
1468
1535
  # numeric buckets to group results by.
1469
1536
  # * annualized_base_compensation: histogram by the base annualized salary.
1470
1537
  # Must specify list of numeric buckets to group results by.
1471
1538
  # * annualized_total_compensation: histogram by the total annualized salary.
1472
1539
  # Must specify list of numeric buckets to group results by.
1473
- # * string_custom_attribute: histogram by string {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1540
+ # * string_custom_attribute: histogram by string
1541
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1474
1542
  # Values can be accessed via square bracket notations like
1475
1543
  # string_custom_attribute["key1"].
1476
- # * numeric_custom_attribute: histogram by numeric {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1544
+ # * numeric_custom_attribute: histogram by numeric
1545
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
1477
1546
  # Values can be accessed via square bracket notations like
1478
1547
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
1479
1548
  # group results by.
@@ -1488,11 +1557,15 @@ module Google
1488
1557
  # [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
1489
1558
  # @param job_view [::Google::Cloud::Talent::V4beta1::JobView]
1490
1559
  # The desired job attributes returned for jobs in the search response.
1491
- # Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
1560
+ # Defaults to
1561
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL}
1562
+ # if no value is specified.
1492
1563
  # @param offset [::Integer]
1493
1564
  # An integer that specifies the current offset (that is, starting result
1494
1565
  # location, amongst the jobs deemed by the API as relevant) in search
1495
- # results. This field is only considered if {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is unset.
1566
+ # results. This field is only considered if
1567
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
1568
+ # unset.
1496
1569
  #
1497
1570
  # The maximum allowed value is 5000. Otherwise an error is thrown.
1498
1571
  #
@@ -1506,8 +1579,9 @@ module Google
1506
1579
  # response time. The value can be between 1 and 100.
1507
1580
  # @param page_token [::String]
1508
1581
  # The token specifying the current offset within
1509
- # search results. See {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token} for
1510
- # an explanation of how to obtain the next set of query results.
1582
+ # search results. See
1583
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token}
1584
+ # for an explanation of how to obtain the next set of query results.
1511
1585
  # @param order_by [::String]
1512
1586
  # The criteria determining how search results are sorted. Default is
1513
1587
  # `"relevance desc"`.
@@ -1517,33 +1591,37 @@ module Google
1517
1591
  # * `"relevance desc"`: By relevance descending, as determined by the API
1518
1592
  # algorithms. Relevance thresholding of query results is only available
1519
1593
  # with this ordering.
1520
- # * `"posting_publish_time desc"`: By {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1594
+ # * `"posting_publish_time desc"`: By
1595
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
1521
1596
  # descending.
1522
- # * `"posting_update_time desc"`: By {::Google::Cloud::Talent::V4beta1::Job#posting_update_time Job.posting_update_time}
1597
+ # * `"posting_update_time desc"`: By
1598
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_update_time Job.posting_update_time}
1523
1599
  # descending.
1524
- # * `"title"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title} ascending.
1525
- # * `"title desc"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title} descending.
1600
+ # * `"title"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title}
1601
+ # ascending.
1602
+ # * `"title desc"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title}
1603
+ # descending.
1526
1604
  # * `"annualized_base_compensation"`: By job's
1527
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} ascending. Jobs
1528
- # whose annualized base compensation is unspecified are put at the end of
1529
- # search results.
1605
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1606
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1607
+ # at the end of search results.
1530
1608
  # * `"annualized_base_compensation desc"`: By job's
1531
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} descending. Jobs
1532
- # whose annualized base compensation is unspecified are put at the end of
1533
- # search results.
1609
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
1610
+ # descending. Jobs whose annualized base compensation is unspecified are
1611
+ # put at the end of search results.
1534
1612
  # * `"annualized_total_compensation"`: By job's
1535
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} ascending. Jobs
1536
- # whose annualized base compensation is unspecified are put at the end of
1537
- # search results.
1613
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1614
+ # ascending. Jobs whose annualized base compensation is unspecified are put
1615
+ # at the end of search results.
1538
1616
  # * `"annualized_total_compensation desc"`: By job's
1539
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} descending. Jobs
1540
- # whose annualized base compensation is unspecified are put at the end of
1541
- # search results.
1617
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
1618
+ # descending. Jobs whose annualized base compensation is unspecified are
1619
+ # put at the end of search results.
1542
1620
  # * `"custom_ranking desc"`: By the relevance score adjusted to the
1543
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression} with weight
1544
- # factor assigned by
1545
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level} in descending
1546
- # order.
1621
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression}
1622
+ # with weight factor assigned by
1623
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level}
1624
+ # in descending order.
1547
1625
  # * Location sorting: Use the special syntax to order jobs by distance:<br>
1548
1626
  # `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
1549
1627
  # `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
@@ -1567,44 +1645,55 @@ module Google
1567
1645
  # displayed to the job seeker higher up in the results, with the other jobs
1568
1646
  # being displayed lower down in the results.
1569
1647
  #
1570
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE} if no value
1571
- # is specified.
1648
+ # Defaults to
1649
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE}
1650
+ # if no value is specified.
1572
1651
  # @param custom_ranking_info [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo, ::Hash]
1573
1652
  # Controls over how job documents get ranked on top of existing relevance
1574
1653
  # score (determined by API algorithm).
1575
1654
  # @param disable_keyword_match [::Boolean]
1576
1655
  # This field is deprecated. Please use
1577
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
1656
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1657
+ # going forward.
1578
1658
  #
1579
1659
  # To migrate, disable_keyword_match set to false maps to
1580
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
1581
- # true maps to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
1582
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
1583
- #
1584
- # Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
1585
- # {::Google::Cloud::Talent::V4beta1::Job#description Job.description}, {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
1586
- # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
1587
- # keyword match returns jobs that do not match given category filters when
1588
- # there are matching keywords. For example, for the query "program manager,"
1589
- # a result is returned even if the job posting has the title "software
1590
- # developer," which doesn't fall into "program manager" ontology, but does
1591
- # have "program manager" appearing in its description.
1660
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL},
1661
+ # and disable_keyword_match set to true maps to
1662
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}.
1663
+ # If
1664
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
1665
+ # is set, this field is ignored.
1666
+ #
1667
+ # Controls whether to disable exact keyword match on
1668
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
1669
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description},
1670
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name},
1671
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
1672
+ # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When
1673
+ # disable keyword match is turned off, a keyword match returns jobs that do
1674
+ # not match given category filters when there are matching keywords. For
1675
+ # example, for the query "program manager," a result is returned even if the
1676
+ # job posting has the title "software developer," which doesn't fall into
1677
+ # "program manager" ontology, but does have "program manager" appearing in
1678
+ # its description.
1592
1679
  #
1593
1680
  # For queries like "cloud" that don't contain title or
1594
1681
  # location specific ontology, jobs with "cloud" keyword matches are returned
1595
1682
  # regardless of this flag's value.
1596
1683
  #
1597
- # Use {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
1598
- # company-specific globally matched custom field/attribute string values are
1599
- # needed. Enabling keyword match improves recall of subsequent search
1684
+ # Use
1685
+ # {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
1686
+ # if company-specific globally matched custom field/attribute string values
1687
+ # are needed. Enabling keyword match improves recall of subsequent search
1600
1688
  # requests.
1601
1689
  #
1602
1690
  # Defaults to false.
1603
1691
  # @param keyword_match_mode [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode]
1604
1692
  # Controls what keyword match options to use.
1605
1693
  #
1606
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
1607
- # is specified.
1694
+ # Defaults to
1695
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
1696
+ # if no value is specified.
1608
1697
  #
1609
1698
  # @yield [response, operation] Access the result along with the RPC operation
1610
1699
  # @yieldparam response [::Google::Cloud::Talent::V4beta1::SearchJobsResponse]