google-cloud-talent-v4 0.8.1 → 0.9.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/v4/company_service/client.rb +15 -12
  4. data/lib/google/cloud/talent/v4/company_service/rest/client.rb +682 -0
  5. data/lib/google/cloud/talent/v4/company_service/rest/service_stub.rb +345 -0
  6. data/lib/google/cloud/talent/v4/company_service/rest.rb +52 -0
  7. data/lib/google/cloud/talent/v4/company_service.rb +7 -1
  8. data/lib/google/cloud/talent/v4/completion/client.rb +4 -2
  9. data/lib/google/cloud/talent/v4/completion/rest/client.rb +380 -0
  10. data/lib/google/cloud/talent/v4/completion/rest/service_stub.rb +107 -0
  11. data/lib/google/cloud/talent/v4/completion/rest.rb +52 -0
  12. data/lib/google/cloud/talent/v4/completion.rb +7 -1
  13. data/lib/google/cloud/talent/v4/event_service/client.rb +2 -2
  14. data/lib/google/cloud/talent/v4/event_service/rest/client.rb +358 -0
  15. data/lib/google/cloud/talent/v4/event_service/rest/service_stub.rb +108 -0
  16. data/lib/google/cloud/talent/v4/event_service/rest.rb +52 -0
  17. data/lib/google/cloud/talent/v4/event_service.rb +7 -1
  18. data/lib/google/cloud/talent/v4/job_service/client.rb +240 -163
  19. data/lib/google/cloud/talent/v4/job_service/operations.rb +12 -14
  20. data/lib/google/cloud/talent/v4/job_service/rest/client.rb +1685 -0
  21. data/lib/google/cloud/talent/v4/job_service/rest/operations.rb +793 -0
  22. data/lib/google/cloud/talent/v4/job_service/rest/service_stub.rb +645 -0
  23. data/lib/google/cloud/talent/v4/job_service/rest.rb +53 -0
  24. data/lib/google/cloud/talent/v4/job_service.rb +7 -1
  25. data/lib/google/cloud/talent/v4/job_service_services_pb.rb +12 -8
  26. data/lib/google/cloud/talent/v4/rest.rb +41 -0
  27. data/lib/google/cloud/talent/v4/tenant_service/client.rb +10 -9
  28. data/lib/google/cloud/talent/v4/tenant_service/rest/client.rb +670 -0
  29. data/lib/google/cloud/talent/v4/tenant_service/rest/service_stub.rb +345 -0
  30. data/lib/google/cloud/talent/v4/tenant_service/rest.rb +52 -0
  31. data/lib/google/cloud/talent/v4/tenant_service.rb +7 -1
  32. data/lib/google/cloud/talent/v4/version.rb +1 -1
  33. data/lib/google/cloud/talent/v4.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/v4/common.rb +116 -56
  37. data/proto_docs/google/cloud/talent/v4/company.rb +10 -5
  38. data/proto_docs/google/cloud/talent/v4/company_service.rb +11 -6
  39. data/proto_docs/google/cloud/talent/v4/completion_service.rb +21 -10
  40. data/proto_docs/google/cloud/talent/v4/event.rb +17 -9
  41. data/proto_docs/google/cloud/talent/v4/event_service.rb +2 -2
  42. data/proto_docs/google/cloud/talent/v4/filters.rb +55 -37
  43. data/proto_docs/google/cloud/talent/v4/histogram.rb +6 -2
  44. data/proto_docs/google/cloud/talent/v4/job.rb +83 -55
  45. data/proto_docs/google/cloud/talent/v4/job_service.rb +200 -118
  46. data/proto_docs/google/cloud/talent/v4/tenant.rb +2 -1
  47. data/proto_docs/google/cloud/talent/v4/tenant_service.rb +6 -3
  48. data/proto_docs/google/rpc/status.rb +4 -2
  49. metadata +28 -8
@@ -57,8 +57,10 @@ module Google
57
57
  # @return [::Google::Protobuf::FieldMask]
58
58
  # Strongly recommended for the best service experience.
59
59
  #
60
- # If {::Google::Cloud::Talent::V4::UpdateJobRequest#update_mask update_mask} is provided, only the specified fields in
61
- # {::Google::Cloud::Talent::V4::UpdateJobRequest#job job} are updated. Otherwise all the fields are updated.
60
+ # If {::Google::Cloud::Talent::V4::UpdateJobRequest#update_mask update_mask} is
61
+ # provided, only the specified fields in
62
+ # {::Google::Cloud::Talent::V4::UpdateJobRequest#job job} are updated. Otherwise
63
+ # all the fields are updated.
62
64
  #
63
65
  # A field mask to restrict the fields that are updated. Only
64
66
  # top level fields of {::Google::Cloud::Talent::V4::Job Job} are supported.
@@ -119,15 +121,18 @@ module Google
119
121
  # @return [::Integer]
120
122
  # The maximum number of jobs to be returned per page of results.
121
123
  #
122
- # If {::Google::Cloud::Talent::V4::ListJobsRequest#job_view job_view} is set to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY}, the maximum allowed
123
- # page size is 1000. Otherwise, the maximum allowed page size is 100.
124
+ # If {::Google::Cloud::Talent::V4::ListJobsRequest#job_view job_view} is set to
125
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY},
126
+ # the maximum allowed page size is 1000. Otherwise, the maximum allowed page
127
+ # size is 100.
124
128
  #
125
129
  # Default is 100 if empty or a number < 1 is specified.
126
130
  # @!attribute [rw] job_view
127
131
  # @return [::Google::Cloud::Talent::V4::JobView]
128
132
  # The desired job attributes returned for jobs in the
129
- # search response. Defaults to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL} if no value is
130
- # specified.
133
+ # search response. Defaults to
134
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL} if no
135
+ # value is specified.
131
136
  class ListJobsRequest
132
137
  include ::Google::Protobuf::MessageExts
133
138
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -163,12 +168,13 @@ module Google
163
168
  # @return [::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode]
164
169
  # Mode of a search.
165
170
  #
166
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
171
+ # Defaults to
172
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
167
173
  # @!attribute [rw] request_metadata
168
174
  # @return [::Google::Cloud::Talent::V4::RequestMetadata]
169
- # Required. The meta information collected about the job searcher, used to improve the
170
- # search quality of the service. The identifiers (such as `user_id`) are
171
- # provided by users, and must be unique and consistent.
175
+ # Required. The meta information collected about the job searcher, used to
176
+ # improve the search quality of the service. The identifiers (such as
177
+ # `user_id`) are provided by users, and must be unique and consistent.
172
178
  # @!attribute [rw] job_query
173
179
  # @return [::Google::Cloud::Talent::V4::JobQuery]
174
180
  # Query used to search against jobs, such as keyword, location filters, etc.
@@ -215,23 +221,32 @@ module Google
215
221
  #
216
222
  # Job histogram facets:
217
223
  #
218
- # * company_display_name: histogram by {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}.
219
- # * employment_type: histogram by {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types}, for example,
224
+ # * company_display_name: histogram by
225
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}.
226
+ # * employment_type: histogram by
227
+ # {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types}, for
228
+ # example,
220
229
  # "FULL_TIME", "PART_TIME".
221
- # * company_size (DEPRECATED): histogram by {::Google::Cloud::Talent::V4::CompanySize CompanySize}, for example,
222
- # "SMALL", "MEDIUM", "BIG".
223
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
230
+ # * company_size (DEPRECATED): histogram by
231
+ # {::Google::Cloud::Talent::V4::CompanySize CompanySize}, for example, "SMALL",
232
+ # "MEDIUM", "BIG".
233
+ # * publish_time_in_day: histogram by the
234
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
224
235
  # in days.
225
236
  # Must specify list of numeric buckets in spec.
226
- # * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
237
+ # * publish_time_in_month: histogram by the
238
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
227
239
  # in months.
228
240
  # Must specify list of numeric buckets in spec.
229
- # * publish_time_in_year: histogram by the {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
241
+ # * publish_time_in_year: histogram by the
242
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
230
243
  # in years.
231
244
  # Must specify list of numeric buckets in spec.
232
- # * degree_types: histogram by the {::Google::Cloud::Talent::V4::Job#degree_types Job.degree_types}, for example,
245
+ # * degree_types: histogram by the
246
+ # {::Google::Cloud::Talent::V4::Job#degree_types Job.degree_types}, for example,
233
247
  # "Bachelors", "Masters".
234
- # * job_level: histogram by the {::Google::Cloud::Talent::V4::Job#job_level Job.job_level}, for example, "Entry
248
+ # * job_level: histogram by the
249
+ # {::Google::Cloud::Talent::V4::Job#job_level Job.job_level}, for example, "Entry
235
250
  # Level".
236
251
  # * country: histogram by the country code of jobs, for example, "US", "FR".
237
252
  # * admin1: histogram by the admin1 code of jobs, which is a global
@@ -246,25 +261,31 @@ module Google
246
261
  # and longitude), for example, 37.4038522,-122.0987765. Since the
247
262
  # coordinates of a city center can change, customers may need to refresh
248
263
  # them periodically.
249
- # * locale: histogram by the {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, for example, "en-US",
264
+ # * locale: histogram by the
265
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, for example,
266
+ # "en-US",
250
267
  # "fr-FR".
251
- # * language: histogram by the language subtag of the {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
268
+ # * language: histogram by the language subtag of the
269
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
252
270
  # for example, "en", "fr".
253
- # * category: histogram by the {::Google::Cloud::Talent::V4::JobCategory JobCategory}, for example,
271
+ # * category: histogram by the
272
+ # {::Google::Cloud::Talent::V4::JobCategory JobCategory}, for example,
254
273
  # "COMPUTER_AND_IT", "HEALTHCARE".
255
274
  # * base_compensation_unit: histogram by the
256
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit} of base
257
- # salary, for example, "WEEKLY", "MONTHLY".
275
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit}
276
+ # of base salary, for example, "WEEKLY", "MONTHLY".
258
277
  # * base_compensation: histogram by the base salary. Must specify list of
259
278
  # numeric buckets to group results by.
260
279
  # * annualized_base_compensation: histogram by the base annualized salary.
261
280
  # Must specify list of numeric buckets to group results by.
262
281
  # * annualized_total_compensation: histogram by the total annualized salary.
263
282
  # Must specify list of numeric buckets to group results by.
264
- # * string_custom_attribute: histogram by string {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
283
+ # * string_custom_attribute: histogram by string
284
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
265
285
  # Values can be accessed via square bracket notations like
266
286
  # string_custom_attribute["key1"].
267
- # * numeric_custom_attribute: histogram by numeric {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
287
+ # * numeric_custom_attribute: histogram by numeric
288
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}.
268
289
  # Values can be accessed via square bracket notations like
269
290
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
270
291
  # group results by.
@@ -280,12 +301,15 @@ module Google
280
301
  # @!attribute [rw] job_view
281
302
  # @return [::Google::Cloud::Talent::V4::JobView]
282
303
  # The desired job attributes returned for jobs in the search response.
283
- # Defaults to {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
304
+ # Defaults to
305
+ # {::Google::Cloud::Talent::V4::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if
306
+ # no value is specified.
284
307
  # @!attribute [rw] offset
285
308
  # @return [::Integer]
286
309
  # An integer that specifies the current offset (that is, starting result
287
310
  # location, amongst the jobs deemed by the API as relevant) in search
288
- # results. This field is only considered if {::Google::Cloud::Talent::V4::SearchJobsRequest#page_token page_token} is unset.
311
+ # results. This field is only considered if
312
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#page_token page_token} is unset.
289
313
  #
290
314
  # The maximum allowed value is 5000. Otherwise an error is thrown.
291
315
  #
@@ -301,8 +325,9 @@ module Google
301
325
  # @!attribute [rw] page_token
302
326
  # @return [::String]
303
327
  # The token specifying the current offset within
304
- # search results. See {::Google::Cloud::Talent::V4::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token} for
305
- # an explanation of how to obtain the next set of query results.
328
+ # search results. See
329
+ # {::Google::Cloud::Talent::V4::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token}
330
+ # for an explanation of how to obtain the next set of query results.
306
331
  # @!attribute [rw] order_by
307
332
  # @return [::String]
308
333
  # The criteria determining how search results are sorted. Default is
@@ -313,33 +338,36 @@ module Google
313
338
  # * `"relevance desc"`: By relevance descending, as determined by the API
314
339
  # algorithms. Relevance thresholding of query results is only available
315
340
  # with this ordering.
316
- # * `"posting_publish_time desc"`: By {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
341
+ # * `"posting_publish_time desc"`: By
342
+ # {::Google::Cloud::Talent::V4::Job#posting_publish_time Job.posting_publish_time}
317
343
  # descending.
318
- # * `"posting_update_time desc"`: By {::Google::Cloud::Talent::V4::Job#posting_update_time Job.posting_update_time}
344
+ # * `"posting_update_time desc"`: By
345
+ # {::Google::Cloud::Talent::V4::Job#posting_update_time Job.posting_update_time}
319
346
  # descending.
320
347
  # * `"title"`: By {::Google::Cloud::Talent::V4::Job#title Job.title} ascending.
321
- # * `"title desc"`: By {::Google::Cloud::Talent::V4::Job#title Job.title} descending.
348
+ # * `"title desc"`: By {::Google::Cloud::Talent::V4::Job#title Job.title}
349
+ # descending.
322
350
  # * `"annualized_base_compensation"`: By job's
323
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} ascending. Jobs
324
- # whose annualized base compensation is unspecified are put at the end of
325
- # search results.
351
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
352
+ # ascending. Jobs whose annualized base compensation is unspecified are put
353
+ # at the end of search results.
326
354
  # * `"annualized_base_compensation desc"`: By job's
327
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} descending. Jobs
328
- # whose annualized base compensation is unspecified are put at the end of
329
- # search results.
355
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
356
+ # descending. Jobs whose annualized base compensation is unspecified are
357
+ # put at the end of search results.
330
358
  # * `"annualized_total_compensation"`: By job's
331
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} ascending. Jobs
332
- # whose annualized base compensation is unspecified are put at the end of
333
- # search results.
359
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
360
+ # ascending. Jobs whose annualized base compensation is unspecified are put
361
+ # at the end of search results.
334
362
  # * `"annualized_total_compensation desc"`: By job's
335
- # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} descending. Jobs
336
- # whose annualized base compensation is unspecified are put at the end of
337
- # search results.
363
+ # {::Google::Cloud::Talent::V4::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
364
+ # descending. Jobs whose annualized base compensation is unspecified are
365
+ # put at the end of search results.
338
366
  # * `"custom_ranking desc"`: By the relevance score adjusted to the
339
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression} with weight
340
- # factor assigned by
341
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level} in descending
342
- # order.
367
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression}
368
+ # with weight factor assigned by
369
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level}
370
+ # in descending order.
343
371
  # * Location sorting: Use the special syntax to order jobs by distance:<br>
344
372
  # `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
345
373
  # `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
@@ -364,8 +392,9 @@ module Google
364
392
  # displayed to the job seeker higher up in the results, with the other jobs
365
393
  # being displayed lower down in the results.
366
394
  #
367
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE} if no value
368
- # is specified.
395
+ # Defaults to
396
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE}
397
+ # if no value is specified.
369
398
  # @!attribute [rw] custom_ranking_info
370
399
  # @return [::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo]
371
400
  # Controls over how job documents get ranked on top of existing relevance
@@ -373,29 +402,38 @@ module Google
373
402
  # @!attribute [rw] disable_keyword_match
374
403
  # @return [::Boolean]
375
404
  # This field is deprecated. Please use
376
- # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
405
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
406
+ # going forward.
377
407
  #
378
408
  # To migrate, disable_keyword_match set to false maps to
379
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
380
- # true maps to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
381
- # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
382
- #
383
- # Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4::Job#title Job.title},
384
- # {::Google::Cloud::Talent::V4::Job#description Job.description}, {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
385
- # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
386
- # keyword match returns jobs that do not match given category filters when
387
- # there are matching keywords. For example, for the query "program manager,"
388
- # a result is returned even if the job posting has the title "software
389
- # developer," which doesn't fall into "program manager" ontology, but does
390
- # have "program manager" appearing in its description.
409
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL},
410
+ # and disable_keyword_match set to true maps to
411
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}.
412
+ # If
413
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
414
+ # is set, this field is ignored.
415
+ #
416
+ # Controls whether to disable exact keyword match on
417
+ # {::Google::Cloud::Talent::V4::Job#title Job.title},
418
+ # {::Google::Cloud::Talent::V4::Job#description Job.description},
419
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name},
420
+ # {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
421
+ # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}. When
422
+ # disable keyword match is turned off, a keyword match returns jobs that do
423
+ # not match given category filters when there are matching keywords. For
424
+ # example, for the query "program manager," a result is returned even if the
425
+ # job posting has the title "software developer," which doesn't fall into
426
+ # "program manager" ontology, but does have "program manager" appearing in
427
+ # its description.
391
428
  #
392
429
  # For queries like "cloud" that don't contain title or
393
430
  # location specific ontology, jobs with "cloud" keyword matches are returned
394
431
  # regardless of this flag's value.
395
432
  #
396
- # Use {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
397
- # company-specific globally matched custom field/attribute string values are
398
- # needed. Enabling keyword match improves recall of subsequent search
433
+ # Use
434
+ # {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
435
+ # if company-specific globally matched custom field/attribute string values
436
+ # are needed. Enabling keyword match improves recall of subsequent search
399
437
  # requests.
400
438
  #
401
439
  # Defaults to false.
@@ -404,32 +442,36 @@ module Google
404
442
  # Controls what keyword match options to use. If both keyword_match_mode and
405
443
  # disable_keyword_match are set, keyword_match_mode will take precedence.
406
444
  #
407
- # Defaults to {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
408
- # is specified.
445
+ # Defaults to
446
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
447
+ # if no value is specified.
409
448
  class SearchJobsRequest
410
449
  include ::Google::Protobuf::MessageExts
411
450
  extend ::Google::Protobuf::MessageExts::ClassMethods
412
451
 
413
- # Custom ranking information for {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
452
+ # Custom ranking information for
453
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
414
454
  # @!attribute [rw] importance_level
415
455
  # @return [::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo::ImportanceLevel]
416
456
  # Required. Controls over how important the score of
417
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression} gets applied to job's final
418
- # ranking position.
457
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression}
458
+ # gets applied to job's final ranking position.
419
459
  #
420
460
  # An error is thrown if not specified.
421
461
  # @!attribute [rw] ranking_expression
422
462
  # @return [::String]
423
- # Required. Controls over how job documents get ranked on top of existing relevance
424
- # score (determined by API algorithm). A combination of the ranking
425
- # expression and relevance score is used to determine job's final ranking
426
- # position.
463
+ # Required. Controls over how job documents get ranked on top of existing
464
+ # relevance score (determined by API algorithm). A combination of the
465
+ # ranking expression and relevance score is used to determine job's final
466
+ # ranking position.
427
467
  #
428
468
  # The syntax for this expression is a subset of Google SQL syntax.
429
469
  #
430
470
  # Supported operators are: +, -, *, /, where the left and right side of
431
- # the operator is either a numeric {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes} key,
432
- # integer/double value or an expression that can be evaluated to a number.
471
+ # the operator is either a numeric
472
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}
473
+ # key, integer/double value or an expression that can be evaluated to a
474
+ # number.
433
475
  #
434
476
  # Parenthesis are supported to adjust calculation precedence. The
435
477
  # expression must be < 200 characters in length.
@@ -445,7 +487,8 @@ module Google
445
487
  include ::Google::Protobuf::MessageExts
446
488
  extend ::Google::Protobuf::MessageExts::ClassMethods
447
489
 
448
- # The importance level for {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression}.
490
+ # The importance level for
491
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression}.
449
492
  module ImportanceLevel
450
493
  # Default value if the importance level isn't specified.
451
494
  IMPORTANCE_LEVEL_UNSPECIFIED = 0
@@ -554,25 +597,33 @@ module Google
554
597
  # location specific ontology, jobs with "cloud" keyword matches are returned
555
598
  # regardless of this enum's value.
556
599
  #
557
- # Use {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
558
- # company-specific globally matched custom field/attribute string values are
559
- # needed. Enabling keyword match improves recall of subsequent search
600
+ # Use
601
+ # {::Google::Cloud::Talent::V4::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
602
+ # if company-specific globally matched custom field/attribute string values
603
+ # are needed. Enabling keyword match improves recall of subsequent search
560
604
  # requests.
561
605
  module KeywordMatchMode
562
606
  # The keyword match option isn't specified. Defaults to
563
- # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} behavior.
607
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
608
+ # behavior.
564
609
  KEYWORD_MATCH_MODE_UNSPECIFIED = 0
565
610
 
566
611
  # Disables keyword matching.
567
612
  KEYWORD_MATCH_DISABLED = 1
568
613
 
569
- # Enable keyword matching over {::Google::Cloud::Talent::V4::Job#title Job.title},
570
- # {::Google::Cloud::Talent::V4::Job#description Job.description}, {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
571
- # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}, and keyword searchable {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}
614
+ # Enable keyword matching over
615
+ # {::Google::Cloud::Talent::V4::Job#title Job.title},
616
+ # {::Google::Cloud::Talent::V4::Job#description Job.description},
617
+ # {::Google::Cloud::Talent::V4::Job#company_display_name Job.company_display_name},
618
+ # {::Google::Cloud::Talent::V4::Job#addresses Job.addresses},
619
+ # {::Google::Cloud::Talent::V4::Job#qualifications Job.qualifications}, and
620
+ # keyword searchable
621
+ # {::Google::Cloud::Talent::V4::Job#custom_attributes Job.custom_attributes}
572
622
  # fields.
573
623
  KEYWORD_MATCH_ALL = 2
574
624
 
575
- # Only enable keyword matching over {::Google::Cloud::Talent::V4::Job#title Job.title}.
625
+ # Only enable keyword matching over
626
+ # {::Google::Cloud::Talent::V4::Job#title Job.title}.
576
627
  KEYWORD_MATCH_TITLE_ONLY = 3
577
628
  end
578
629
  end
@@ -580,7 +631,8 @@ module Google
580
631
  # Response for SearchJob method.
581
632
  # @!attribute [rw] matching_jobs
582
633
  # @return [::Array<::Google::Cloud::Talent::V4::SearchJobsResponse::MatchingJob>]
583
- # The Job entities that match the specified {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
634
+ # The Job entities that match the specified
635
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
584
636
  # @!attribute [rw] histogram_query_results
585
637
  # @return [::Array<::Google::Cloud::Talent::V4::HistogramQueryResult>]
586
638
  # The histogram results that match with specified
@@ -592,7 +644,8 @@ module Google
592
644
  # @!attribute [rw] location_filters
593
645
  # @return [::Array<::Google::Cloud::Talent::V4::Location>]
594
646
  # The location filters that the service applied to the specified query. If
595
- # any filters are lat-lng based, the {::Google::Cloud::Talent::V4::Location#location_type Location.location_type} is
647
+ # any filters are lat-lng based, the
648
+ # {::Google::Cloud::Talent::V4::Location#location_type Location.location_type} is
596
649
  # {::Google::Cloud::Talent::V4::Location::LocationType::LOCATION_TYPE_UNSPECIFIED Location.LocationType.LOCATION_TYPE_UNSPECIFIED}.
597
650
  # @!attribute [rw] total_size
598
651
  # @return [::Integer]
@@ -619,22 +672,26 @@ module Google
619
672
  include ::Google::Protobuf::MessageExts
620
673
  extend ::Google::Protobuf::MessageExts::ClassMethods
621
674
 
622
- # Job entry with metadata inside {::Google::Cloud::Talent::V4::SearchJobsResponse SearchJobsResponse}.
675
+ # Job entry with metadata inside
676
+ # {::Google::Cloud::Talent::V4::SearchJobsResponse SearchJobsResponse}.
623
677
  # @!attribute [rw] job
624
678
  # @return [::Google::Cloud::Talent::V4::Job]
625
- # Job resource that matches the specified {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
679
+ # Job resource that matches the specified
680
+ # {::Google::Cloud::Talent::V4::SearchJobsRequest SearchJobsRequest}.
626
681
  # @!attribute [rw] job_summary
627
682
  # @return [::String]
628
683
  # A summary of the job with core information that's displayed on the search
629
684
  # results listing page.
630
685
  # @!attribute [rw] job_title_snippet
631
686
  # @return [::String]
632
- # Contains snippets of text from the {::Google::Cloud::Talent::V4::Job#title Job.title} field most
633
- # closely matching a search query's keywords, if available. The matching
634
- # query keywords are enclosed in HTML bold tags.
687
+ # Contains snippets of text from the
688
+ # {::Google::Cloud::Talent::V4::Job#title Job.title} field most closely matching
689
+ # a search query's keywords, if available. The matching query keywords are
690
+ # enclosed in HTML bold tags.
635
691
  # @!attribute [rw] search_text_snippet
636
692
  # @return [::String]
637
- # Contains snippets of text from the {::Google::Cloud::Talent::V4::Job#description Job.description} and similar
693
+ # Contains snippets of text from the
694
+ # {::Google::Cloud::Talent::V4::Job#description Job.description} and similar
638
695
  # fields that most closely match a search query's keywords, if available.
639
696
  # All HTML tags in the original fields are stripped when returned in this
640
697
  # field, and matching query keywords are enclosed in HTML bold tags.
@@ -695,17 +752,19 @@ module Google
695
752
  # Strongly recommended for the best service experience. Be aware that it will
696
753
  # also increase latency when checking the status of a batch operation.
697
754
  #
698
- # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask} is provided, only the specified fields in
699
- # {::Google::Cloud::Talent::V4::Job Job} are updated. Otherwise all the fields are updated.
755
+ # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask}
756
+ # is provided, only the specified fields in {::Google::Cloud::Talent::V4::Job Job}
757
+ # are updated. Otherwise all the fields are updated.
700
758
  #
701
759
  # A field mask to restrict the fields that are updated. Only
702
760
  # top level fields of {::Google::Cloud::Talent::V4::Job Job} are supported.
703
761
  #
704
- # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask} is provided, The {::Google::Cloud::Talent::V4::Job Job} inside
762
+ # If {::Google::Cloud::Talent::V4::BatchUpdateJobsRequest#update_mask update_mask}
763
+ # is provided, The {::Google::Cloud::Talent::V4::Job Job} inside
705
764
  # [JobResult][JobOperationResult.JobResult]
706
765
  # will only contains fields that is updated, plus the Id of the Job.
707
- # Otherwise, {::Google::Cloud::Talent::V4::Job Job} will include all fields, which can yield a very
708
- # large response.
766
+ # Otherwise, {::Google::Cloud::Talent::V4::Job Job} will include all fields,
767
+ # which can yield a very large response.
709
768
  class BatchUpdateJobsRequest
710
769
  include ::Google::Protobuf::MessageExts
711
770
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -736,10 +795,12 @@ module Google
736
795
  # Mutation result of a job from a batch operation.
737
796
  # @!attribute [rw] job
738
797
  # @return [::Google::Cloud::Talent::V4::Job]
739
- # Here {::Google::Cloud::Talent::V4::Job Job} only contains basic information including {::Google::Cloud::Talent::V4::Job#name name},
740
- # {::Google::Cloud::Talent::V4::Job#company company}, {::Google::Cloud::Talent::V4::Job#language_code language_code}
741
- # and {::Google::Cloud::Talent::V4::Job#requisition_id requisition_id}, use getJob method to retrieve
742
- # detailed information of the created/updated job.
798
+ # Here {::Google::Cloud::Talent::V4::Job Job} only contains basic information
799
+ # including {::Google::Cloud::Talent::V4::Job#name name},
800
+ # {::Google::Cloud::Talent::V4::Job#company company},
801
+ # {::Google::Cloud::Talent::V4::Job#language_code language_code} and
802
+ # {::Google::Cloud::Talent::V4::Job#requisition_id requisition_id}, use getJob
803
+ # method to retrieve detailed information of the created/updated job.
743
804
  # @!attribute [rw] status
744
805
  # @return [::Google::Rpc::Status]
745
806
  # The status of the job processed. This field is populated if the
@@ -749,8 +810,11 @@ module Google
749
810
  extend ::Google::Protobuf::MessageExts::ClassMethods
750
811
  end
751
812
 
752
- # The result of {::Google::Cloud::Talent::V4::JobService::Client#batch_create_jobs JobService.BatchCreateJobs}. It's used to
753
- # replace {::Google::Longrunning::Operation#response google.longrunning.Operation.response} in case of success.
813
+ # The result of
814
+ # {::Google::Cloud::Talent::V4::JobService::Client#batch_create_jobs JobService.BatchCreateJobs}.
815
+ # It's used to replace
816
+ # {::Google::Longrunning::Operation#response google.longrunning.Operation.response}
817
+ # in case of success.
754
818
  # @!attribute [rw] job_results
755
819
  # @return [::Array<::Google::Cloud::Talent::V4::JobResult>]
756
820
  # List of job mutation results from a batch create operation. It can change
@@ -760,8 +824,11 @@ module Google
760
824
  extend ::Google::Protobuf::MessageExts::ClassMethods
761
825
  end
762
826
 
763
- # The result of {::Google::Cloud::Talent::V4::JobService::Client#batch_update_jobs JobService.BatchUpdateJobs}. It's used to
764
- # replace {::Google::Longrunning::Operation#response google.longrunning.Operation.response} in case of success.
827
+ # The result of
828
+ # {::Google::Cloud::Talent::V4::JobService::Client#batch_update_jobs JobService.BatchUpdateJobs}.
829
+ # It's used to replace
830
+ # {::Google::Longrunning::Operation#response google.longrunning.Operation.response}
831
+ # in case of success.
765
832
  # @!attribute [rw] job_results
766
833
  # @return [::Array<::Google::Cloud::Talent::V4::JobResult>]
767
834
  # List of job mutation results from a batch update operation. It can change
@@ -771,8 +838,11 @@ module Google
771
838
  extend ::Google::Protobuf::MessageExts::ClassMethods
772
839
  end
773
840
 
774
- # The result of {::Google::Cloud::Talent::V4::JobService::Client#batch_delete_jobs JobService.BatchDeleteJobs}. It's used to
775
- # replace {::Google::Longrunning::Operation#response google.longrunning.Operation.response} in case of success.
841
+ # The result of
842
+ # {::Google::Cloud::Talent::V4::JobService::Client#batch_delete_jobs JobService.BatchDeleteJobs}.
843
+ # It's used to replace
844
+ # {::Google::Longrunning::Operation#response google.longrunning.Operation.response}
845
+ # in case of success.
776
846
  # @!attribute [rw] job_results
777
847
  # @return [::Array<::Google::Cloud::Talent::V4::JobResult>]
778
848
  # List of job mutation results from a batch delete operation. It can change
@@ -783,25 +853,37 @@ module Google
783
853
  end
784
854
 
785
855
  # An enum that specifies the job attributes that are returned in the
786
- # {::Google::Cloud::Talent::V4::SearchJobsResponse::MatchingJob#job MatchingJob.job} or
787
- # {::Google::Cloud::Talent::V4::ListJobsResponse#jobs ListJobsResponse.jobs} fields.
856
+ # {::Google::Cloud::Talent::V4::SearchJobsResponse::MatchingJob#job MatchingJob.job}
857
+ # or {::Google::Cloud::Talent::V4::ListJobsResponse#jobs ListJobsResponse.jobs}
858
+ # fields.
788
859
  module JobView
789
860
  # Default value.
790
861
  JOB_VIEW_UNSPECIFIED = 0
791
862
 
792
863
  # A ID only view of job, with following attributes:
793
- # {::Google::Cloud::Talent::V4::Job#name Job.name}, {::Google::Cloud::Talent::V4::Job#requisition_id Job.requisition_id}, {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}.
864
+ # {::Google::Cloud::Talent::V4::Job#name Job.name},
865
+ # {::Google::Cloud::Talent::V4::Job#requisition_id Job.requisition_id},
866
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}.
794
867
  JOB_VIEW_ID_ONLY = 1
795
868
 
796
869
  # A minimal view of the job, with the following attributes:
797
- # {::Google::Cloud::Talent::V4::Job#name Job.name}, {::Google::Cloud::Talent::V4::Job#requisition_id Job.requisition_id}, {::Google::Cloud::Talent::V4::Job#title Job.title},
798
- # {::Google::Cloud::Talent::V4::Job#company Job.company}, {::Google::Cloud::Talent::V4::Job::DerivedInfo#locations Job.DerivedInfo.locations}, {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}.
870
+ # {::Google::Cloud::Talent::V4::Job#name Job.name},
871
+ # {::Google::Cloud::Talent::V4::Job#requisition_id Job.requisition_id},
872
+ # {::Google::Cloud::Talent::V4::Job#title Job.title},
873
+ # {::Google::Cloud::Talent::V4::Job#company Job.company},
874
+ # {::Google::Cloud::Talent::V4::Job::DerivedInfo#locations Job.DerivedInfo.locations},
875
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}.
799
876
  JOB_VIEW_MINIMAL = 2
800
877
 
801
878
  # A small view of the job, with the following attributes in the search
802
- # results: {::Google::Cloud::Talent::V4::Job#name Job.name}, {::Google::Cloud::Talent::V4::Job#requisition_id Job.requisition_id}, {::Google::Cloud::Talent::V4::Job#title Job.title},
803
- # {::Google::Cloud::Talent::V4::Job#company Job.company}, {::Google::Cloud::Talent::V4::Job::DerivedInfo#locations Job.DerivedInfo.locations}, {::Google::Cloud::Talent::V4::Job#visibility Job.visibility},
804
- # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code}, {::Google::Cloud::Talent::V4::Job#description Job.description}.
879
+ # results: {::Google::Cloud::Talent::V4::Job#name Job.name},
880
+ # {::Google::Cloud::Talent::V4::Job#requisition_id Job.requisition_id},
881
+ # {::Google::Cloud::Talent::V4::Job#title Job.title},
882
+ # {::Google::Cloud::Talent::V4::Job#company Job.company},
883
+ # {::Google::Cloud::Talent::V4::Job::DerivedInfo#locations Job.DerivedInfo.locations},
884
+ # {::Google::Cloud::Talent::V4::Job#visibility Job.visibility},
885
+ # {::Google::Cloud::Talent::V4::Job#language_code Job.language_code},
886
+ # {::Google::Cloud::Talent::V4::Job#description Job.description}.
805
887
  JOB_VIEW_SMALL = 3
806
888
 
807
889
  # All available attributes are included in the search results.
@@ -36,7 +36,8 @@ module Google
36
36
  # "projects/foo/tenants/bar".
37
37
  # @!attribute [rw] external_id
38
38
  # @return [::String]
39
- # Required. Client side tenant identifier, used to uniquely identify the tenant.
39
+ # Required. Client side tenant identifier, used to uniquely identify the
40
+ # tenant.
40
41
  #
41
42
  # The maximum number of allowed characters is 255.
42
43
  class Tenant
@@ -51,13 +51,16 @@ module Google
51
51
  # Request for updating a specified tenant.
52
52
  # @!attribute [rw] tenant
53
53
  # @return [::Google::Cloud::Talent::V4::Tenant]
54
- # Required. The tenant resource to replace the current resource in the system.
54
+ # Required. The tenant resource to replace the current resource in the
55
+ # system.
55
56
  # @!attribute [rw] update_mask
56
57
  # @return [::Google::Protobuf::FieldMask]
57
58
  # Strongly recommended for the best service experience.
58
59
  #
59
- # If {::Google::Cloud::Talent::V4::UpdateTenantRequest#update_mask update_mask} is provided, only the specified fields in
60
- # {::Google::Cloud::Talent::V4::UpdateTenantRequest#tenant tenant} are updated. Otherwise all the fields are updated.
60
+ # If {::Google::Cloud::Talent::V4::UpdateTenantRequest#update_mask update_mask} is
61
+ # provided, only the specified fields in
62
+ # {::Google::Cloud::Talent::V4::UpdateTenantRequest#tenant tenant} are updated.
63
+ # Otherwise all the fields are updated.
61
64
  #
62
65
  # A field mask to specify the tenant fields to be updated. Only
63
66
  # top level fields of {::Google::Cloud::Talent::V4::Tenant Tenant} are supported.
@@ -28,12 +28,14 @@ module Google
28
28
  # [API Design Guide](https://cloud.google.com/apis/design/errors).
29
29
  # @!attribute [rw] code
30
30
  # @return [::Integer]
31
- # The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
31
+ # The status code, which should be an enum value of
32
+ # [google.rpc.Code][google.rpc.Code].
32
33
  # @!attribute [rw] message
33
34
  # @return [::String]
34
35
  # A developer-facing error message, which should be in English. Any
35
36
  # user-facing error message should be localized and sent in the
36
- # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
37
+ # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
38
+ # by the client.
37
39
  # @!attribute [rw] details
38
40
  # @return [::Array<::Google::Protobuf::Any>]
39
41
  # A list of messages that carry the error details. There is a common set of