google-cloud-talent-v4beta1 0.6.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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]