google-cloud-talent-v4beta1 0.6.0 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (51) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +1 -1
  3. data/README.md +2 -2
  4. data/lib/google/cloud/talent/v4beta1/company_service/client.rb +16 -12
  5. data/lib/google/cloud/talent/v4beta1/company_service/rest/client.rb +693 -0
  6. data/lib/google/cloud/talent/v4beta1/company_service/rest/service_stub.rb +382 -0
  7. data/lib/google/cloud/talent/v4beta1/company_service/rest.rb +52 -0
  8. data/lib/google/cloud/talent/v4beta1/company_service.rb +7 -1
  9. data/lib/google/cloud/talent/v4beta1/completion/client.rb +4 -2
  10. data/lib/google/cloud/talent/v4beta1/completion/rest/client.rb +386 -0
  11. data/lib/google/cloud/talent/v4beta1/completion/rest/service_stub.rb +114 -0
  12. data/lib/google/cloud/talent/v4beta1/completion/rest.rb +52 -0
  13. data/lib/google/cloud/talent/v4beta1/completion.rb +7 -1
  14. data/lib/google/cloud/talent/v4beta1/event_service/client.rb +2 -2
  15. data/lib/google/cloud/talent/v4beta1/event_service/rest/client.rb +359 -0
  16. data/lib/google/cloud/talent/v4beta1/event_service/rest/service_stub.rb +116 -0
  17. data/lib/google/cloud/talent/v4beta1/event_service/rest.rb +52 -0
  18. data/lib/google/cloud/talent/v4beta1/event_service.rb +7 -1
  19. data/lib/google/cloud/talent/v4beta1/job_service/client.rb +250 -161
  20. data/lib/google/cloud/talent/v4beta1/job_service/operations.rb +12 -14
  21. data/lib/google/cloud/talent/v4beta1/job_service/rest/client.rb +1712 -0
  22. data/lib/google/cloud/talent/v4beta1/job_service/rest/operations.rb +793 -0
  23. data/lib/google/cloud/talent/v4beta1/job_service/rest/service_stub.rb +721 -0
  24. data/lib/google/cloud/talent/v4beta1/job_service/rest.rb +53 -0
  25. data/lib/google/cloud/talent/v4beta1/job_service.rb +7 -1
  26. data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +12 -8
  27. data/lib/google/cloud/talent/v4beta1/rest.rb +41 -0
  28. data/lib/google/cloud/talent/v4beta1/tenant_service/client.rb +13 -10
  29. data/lib/google/cloud/talent/v4beta1/tenant_service/rest/client.rb +672 -0
  30. data/lib/google/cloud/talent/v4beta1/tenant_service/rest/service_stub.rb +345 -0
  31. data/lib/google/cloud/talent/v4beta1/tenant_service/rest.rb +52 -0
  32. data/lib/google/cloud/talent/v4beta1/tenant_service.rb +7 -1
  33. data/lib/google/cloud/talent/v4beta1/version.rb +1 -1
  34. data/lib/google/cloud/talent/v4beta1.rb +7 -2
  35. data/proto_docs/google/api/client.rb +318 -0
  36. data/proto_docs/google/api/launch_stage.rb +71 -0
  37. data/proto_docs/google/cloud/talent/v4beta1/common.rb +117 -56
  38. data/proto_docs/google/cloud/talent/v4beta1/company.rb +12 -4
  39. data/proto_docs/google/cloud/talent/v4beta1/company_service.rb +12 -6
  40. data/proto_docs/google/cloud/talent/v4beta1/completion_service.rb +21 -10
  41. data/proto_docs/google/cloud/talent/v4beta1/event.rb +20 -10
  42. data/proto_docs/google/cloud/talent/v4beta1/event_service.rb +2 -2
  43. data/proto_docs/google/cloud/talent/v4beta1/filters.rb +62 -38
  44. data/proto_docs/google/cloud/talent/v4beta1/histogram.rb +8 -3
  45. data/proto_docs/google/cloud/talent/v4beta1/job.rb +86 -54
  46. data/proto_docs/google/cloud/talent/v4beta1/job_service.rb +212 -121
  47. data/proto_docs/google/cloud/talent/v4beta1/tenant.rb +9 -5
  48. data/proto_docs/google/cloud/talent/v4beta1/tenant_service.rb +9 -4
  49. data/proto_docs/google/protobuf/empty.rb +0 -2
  50. data/proto_docs/google/rpc/status.rb +4 -2
  51. metadata +28 -8
@@ -61,8 +61,10 @@ module Google
61
61
  # @return [::Google::Protobuf::FieldMask]
62
62
  # Strongly recommended for the best service experience.
63
63
  #
64
- # If {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask} is provided, only the specified fields in
65
- # {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated. Otherwise all the fields are updated.
64
+ # If {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
65
+ # is provided, only the specified fields in
66
+ # {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated.
67
+ # Otherwise all the fields are updated.
66
68
  #
67
69
  # A field mask to restrict the fields that are updated. Only
68
70
  # top level fields of {::Google::Cloud::Talent::V4beta1::Job Job} are supported.
@@ -153,15 +155,19 @@ module Google
153
155
  # @return [::Integer]
154
156
  # The maximum number of jobs to be returned per page of results.
155
157
  #
156
- # 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
157
- # page size is 1000. Otherwise, the maximum allowed page size is 100.
158
+ # If {::Google::Cloud::Talent::V4beta1::ListJobsRequest#job_view job_view} is set
159
+ # to
160
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_ID_ONLY JobView.JOB_VIEW_ID_ONLY},
161
+ # the maximum allowed page size is 1000. Otherwise, the maximum allowed page
162
+ # size is 100.
158
163
  #
159
164
  # Default is 100 if empty or a number < 1 is specified.
160
165
  # @!attribute [rw] job_view
161
166
  # @return [::Google::Cloud::Talent::V4beta1::JobView]
162
167
  # The desired job attributes returned for jobs in the
163
- # search response. Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL} if no value is
164
- # specified.
168
+ # search response. Defaults to
169
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView.JOB_VIEW_FULL}
170
+ # if no value is specified.
165
171
  class ListJobsRequest
166
172
  include ::Google::Protobuf::MessageExts
167
173
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -198,12 +204,13 @@ module Google
198
204
  # @return [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
199
205
  # Mode of a search.
200
206
  #
201
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
207
+ # Defaults to
208
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode.JOB_SEARCH}.
202
209
  # @!attribute [rw] request_metadata
203
210
  # @return [::Google::Cloud::Talent::V4beta1::RequestMetadata]
204
- # Required. The meta information collected about the job searcher, used to improve the
205
- # search quality of the service. The identifiers (such as `user_id`) are
206
- # provided by users, and must be unique and consistent.
211
+ # Required. The meta information collected about the job searcher, used to
212
+ # improve the search quality of the service. The identifiers (such as
213
+ # `user_id`) are provided by users, and must be unique and consistent.
207
214
  # @!attribute [rw] job_query
208
215
  # @return [::Google::Cloud::Talent::V4beta1::JobQuery]
209
216
  # Query used to search against jobs, such as keyword, location filters, etc.
@@ -253,23 +260,34 @@ module Google
253
260
  #
254
261
  # Job histogram facets:
255
262
  #
256
- # * company_display_name: histogram by {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}.
257
- # * employment_type: histogram by {::Google::Cloud::Talent::V4beta1::Job#employment_types Job.employment_types}, for example,
263
+ # * company_display_name: histogram by
264
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}.
265
+ # * employment_type: histogram by
266
+ # {::Google::Cloud::Talent::V4beta1::Job#employment_types Job.employment_types},
267
+ # for example,
258
268
  # "FULL_TIME", "PART_TIME".
259
- # * company_size: histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
260
- # "MEDIUM", "BIG".
261
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
269
+ # * company_size (DEPRECATED): histogram by
270
+ # {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
271
+ # "SMALL", "MEDIUM", "BIG".
272
+ # * publish_time_in_day: histogram by the
273
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
262
274
  # in days.
263
275
  # Must specify list of numeric buckets in spec.
264
- # * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
276
+ # * publish_time_in_month: histogram by the
277
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
265
278
  # in months.
266
279
  # Must specify list of numeric buckets in spec.
267
- # * publish_time_in_year: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
280
+ # * publish_time_in_year: histogram by the
281
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
268
282
  # in years.
269
283
  # Must specify list of numeric buckets in spec.
270
- # * degree_types: histogram by the {::Google::Cloud::Talent::V4beta1::Job#degree_types Job.degree_types}, for example,
284
+ # * degree_types: histogram by the
285
+ # {::Google::Cloud::Talent::V4beta1::Job#degree_types Job.degree_types}, for
286
+ # example,
271
287
  # "Bachelors", "Masters".
272
- # * job_level: histogram by the {::Google::Cloud::Talent::V4beta1::Job#job_level Job.job_level}, for example, "Entry
288
+ # * job_level: histogram by the
289
+ # {::Google::Cloud::Talent::V4beta1::Job#job_level Job.job_level}, for example,
290
+ # "Entry
273
291
  # Level".
274
292
  # * country: histogram by the country code of jobs, for example, "US", "FR".
275
293
  # * admin1: histogram by the admin1 code of jobs, which is a global
@@ -284,25 +302,31 @@ module Google
284
302
  # and longitude), for example, 37.4038522,-122.0987765. Since the
285
303
  # coordinates of a city center can change, customers may need to refresh
286
304
  # them periodically.
287
- # * locale: histogram by the {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, for example, "en-US",
305
+ # * locale: histogram by the
306
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, for
307
+ # example, "en-US",
288
308
  # "fr-FR".
289
- # * language: histogram by the language subtag of the {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
309
+ # * language: histogram by the language subtag of the
310
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
290
311
  # for example, "en", "fr".
291
- # * category: histogram by the {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
312
+ # * category: histogram by the
313
+ # {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
292
314
  # "COMPUTER_AND_IT", "HEALTHCARE".
293
315
  # * base_compensation_unit: histogram by the
294
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit} of base
295
- # salary, for example, "WEEKLY", "MONTHLY".
316
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo.CompensationUnit}
317
+ # of base salary, for example, "WEEKLY", "MONTHLY".
296
318
  # * base_compensation: histogram by the base salary. Must specify list of
297
319
  # numeric buckets to group results by.
298
320
  # * annualized_base_compensation: histogram by the base annualized salary.
299
321
  # Must specify list of numeric buckets to group results by.
300
322
  # * annualized_total_compensation: histogram by the total annualized salary.
301
323
  # Must specify list of numeric buckets to group results by.
302
- # * string_custom_attribute: histogram by string {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
324
+ # * string_custom_attribute: histogram by string
325
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
303
326
  # Values can be accessed via square bracket notations like
304
327
  # string_custom_attribute["key1"].
305
- # * numeric_custom_attribute: histogram by numeric {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
328
+ # * numeric_custom_attribute: histogram by numeric
329
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}.
306
330
  # Values can be accessed via square bracket notations like
307
331
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
308
332
  # group results by.
@@ -318,12 +342,16 @@ module Google
318
342
  # @!attribute [rw] job_view
319
343
  # @return [::Google::Cloud::Talent::V4beta1::JobView]
320
344
  # The desired job attributes returned for jobs in the search response.
321
- # Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
345
+ # Defaults to
346
+ # {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL}
347
+ # if no value is specified.
322
348
  # @!attribute [rw] offset
323
349
  # @return [::Integer]
324
350
  # An integer that specifies the current offset (that is, starting result
325
351
  # location, amongst the jobs deemed by the API as relevant) in search
326
- # results. This field is only considered if {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is unset.
352
+ # results. This field is only considered if
353
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
354
+ # unset.
327
355
  #
328
356
  # The maximum allowed value is 5000. Otherwise an error is thrown.
329
357
  #
@@ -339,8 +367,9 @@ module Google
339
367
  # @!attribute [rw] page_token
340
368
  # @return [::String]
341
369
  # The token specifying the current offset within
342
- # search results. See {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token} for
343
- # an explanation of how to obtain the next set of query results.
370
+ # search results. See
371
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse.next_page_token}
372
+ # for an explanation of how to obtain the next set of query results.
344
373
  # @!attribute [rw] order_by
345
374
  # @return [::String]
346
375
  # The criteria determining how search results are sorted. Default is
@@ -351,33 +380,37 @@ module Google
351
380
  # * `"relevance desc"`: By relevance descending, as determined by the API
352
381
  # algorithms. Relevance thresholding of query results is only available
353
382
  # with this ordering.
354
- # * `"posting_publish_time desc"`: By {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
383
+ # * `"posting_publish_time desc"`: By
384
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
355
385
  # descending.
356
- # * `"posting_update_time desc"`: By {::Google::Cloud::Talent::V4beta1::Job#posting_update_time Job.posting_update_time}
386
+ # * `"posting_update_time desc"`: By
387
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_update_time Job.posting_update_time}
357
388
  # descending.
358
- # * `"title"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title} ascending.
359
- # * `"title desc"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title} descending.
389
+ # * `"title"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title}
390
+ # ascending.
391
+ # * `"title desc"`: By {::Google::Cloud::Talent::V4beta1::Job#title Job.title}
392
+ # descending.
360
393
  # * `"annualized_base_compensation"`: By job's
361
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} ascending. Jobs
362
- # whose annualized base compensation is unspecified are put at the end of
363
- # search results.
394
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
395
+ # ascending. Jobs whose annualized base compensation is unspecified are put
396
+ # at the end of search results.
364
397
  # * `"annualized_base_compensation desc"`: By job's
365
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range} descending. Jobs
366
- # whose annualized base compensation is unspecified are put at the end of
367
- # search results.
398
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo.annualized_base_compensation_range}
399
+ # descending. Jobs whose annualized base compensation is unspecified are
400
+ # put at the end of search results.
368
401
  # * `"annualized_total_compensation"`: By job's
369
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} ascending. Jobs
370
- # whose annualized base compensation is unspecified are put at the end of
371
- # search results.
402
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
403
+ # ascending. Jobs whose annualized base compensation is unspecified are put
404
+ # at the end of search results.
372
405
  # * `"annualized_total_compensation desc"`: By job's
373
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range} descending. Jobs
374
- # whose annualized base compensation is unspecified are put at the end of
375
- # search results.
406
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo.annualized_total_compensation_range}
407
+ # descending. Jobs whose annualized base compensation is unspecified are
408
+ # put at the end of search results.
376
409
  # * `"custom_ranking desc"`: By the relevance score adjusted to the
377
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression} with weight
378
- # factor assigned by
379
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level} in descending
380
- # order.
410
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest.CustomRankingInfo.ranking_expression}
411
+ # with weight factor assigned by
412
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest.CustomRankingInfo.importance_level}
413
+ # in descending order.
381
414
  # * Location sorting: Use the special syntax to order jobs by distance:<br>
382
415
  # `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
383
416
  # `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
@@ -402,8 +435,9 @@ module Google
402
435
  # displayed to the job seeker higher up in the results, with the other jobs
403
436
  # being displayed lower down in the results.
404
437
  #
405
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE} if no value
406
- # is specified.
438
+ # Defaults to
439
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel.SIMPLE}
440
+ # if no value is specified.
407
441
  # @!attribute [rw] custom_ranking_info
408
442
  # @return [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo]
409
443
  # Controls over how job documents get ranked on top of existing relevance
@@ -411,29 +445,38 @@ module Google
411
445
  # @!attribute [rw] disable_keyword_match
412
446
  # @return [::Boolean]
413
447
  # This field is deprecated. Please use
414
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
448
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
449
+ # going forward.
415
450
  #
416
451
  # To migrate, disable_keyword_match set to false maps to
417
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
418
- # true maps to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
419
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
420
- #
421
- # Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
422
- # {::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},
423
- # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
424
- # keyword match returns jobs that do not match given category filters when
425
- # there are matching keywords. For example, for the query "program manager,"
426
- # a result is returned even if the job posting has the title "software
427
- # developer," which doesn't fall into "program manager" ontology, but does
428
- # have "program manager" appearing in its description.
452
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL},
453
+ # and disable_keyword_match set to true maps to
454
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}.
455
+ # If
456
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode}
457
+ # is set, this field is ignored.
458
+ #
459
+ # Controls whether to disable exact keyword match on
460
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
461
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description},
462
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name},
463
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
464
+ # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When
465
+ # disable keyword match is turned off, a keyword match returns jobs that do
466
+ # not match given category filters when there are matching keywords. For
467
+ # example, for the query "program manager," a result is returned even if the
468
+ # job posting has the title "software developer," which doesn't fall into
469
+ # "program manager" ontology, but does have "program manager" appearing in
470
+ # its description.
429
471
  #
430
472
  # For queries like "cloud" that don't contain title or
431
473
  # location specific ontology, jobs with "cloud" keyword matches are returned
432
474
  # regardless of this flag's value.
433
475
  #
434
- # Use {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
435
- # company-specific globally matched custom field/attribute string values are
436
- # needed. Enabling keyword match improves recall of subsequent search
476
+ # Use
477
+ # {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
478
+ # if company-specific globally matched custom field/attribute string values
479
+ # are needed. Enabling keyword match improves recall of subsequent search
437
480
  # requests.
438
481
  #
439
482
  # Defaults to false.
@@ -441,32 +484,36 @@ module Google
441
484
  # @return [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode]
442
485
  # Controls what keyword match options to use.
443
486
  #
444
- # Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
445
- # is specified.
487
+ # Defaults to
488
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
489
+ # if no value is specified.
446
490
  class SearchJobsRequest
447
491
  include ::Google::Protobuf::MessageExts
448
492
  extend ::Google::Protobuf::MessageExts::ClassMethods
449
493
 
450
- # Custom ranking information for {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
494
+ # Custom ranking information for
495
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
451
496
  # @!attribute [rw] importance_level
452
497
  # @return [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel]
453
498
  # Required. Controls over how important the score of
454
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression} gets applied to job's final
455
- # ranking position.
499
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression}
500
+ # gets applied to job's final ranking position.
456
501
  #
457
502
  # An error is thrown if not specified.
458
503
  # @!attribute [rw] ranking_expression
459
504
  # @return [::String]
460
- # Required. Controls over how job documents get ranked on top of existing relevance
461
- # score (determined by API algorithm). A combination of the ranking
462
- # expression and relevance score is used to determine job's final ranking
463
- # position.
505
+ # Required. Controls over how job documents get ranked on top of existing
506
+ # relevance score (determined by API algorithm). A combination of the
507
+ # ranking expression and relevance score is used to determine job's final
508
+ # ranking position.
464
509
  #
465
510
  # The syntax for this expression is a subset of Google SQL syntax.
466
511
  #
467
512
  # Supported operators are: +, -, *, /, where the left and right side of
468
- # the operator is either a numeric {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes} key,
469
- # integer/double value or an expression that can be evaluated to a number.
513
+ # the operator is either a numeric
514
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}
515
+ # key, integer/double value or an expression that can be evaluated to a
516
+ # number.
470
517
  #
471
518
  # Parenthesis are supported to adjust calculation precedence. The
472
519
  # expression must be < 200 characters in length.
@@ -482,7 +529,8 @@ module Google
482
529
  include ::Google::Protobuf::MessageExts
483
530
  extend ::Google::Protobuf::MessageExts::ClassMethods
484
531
 
485
- # The importance level for {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression}.
532
+ # The importance level for
533
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo.ranking_expression}.
486
534
  module ImportanceLevel
487
535
  # Default value if the importance level isn't specified.
488
536
  IMPORTANCE_LEVEL_UNSPECIFIED = 0
@@ -574,25 +622,33 @@ module Google
574
622
  # location specific ontology, jobs with "cloud" keyword matches are returned
575
623
  # regardless of this enum's value.
576
624
  #
577
- # Use {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
578
- # company-specific globally matched custom field/attribute string values are
579
- # needed. Enabling keyword match improves recall of subsequent search
625
+ # Use
626
+ # {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes}
627
+ # if company-specific globally matched custom field/attribute string values
628
+ # are needed. Enabling keyword match improves recall of subsequent search
580
629
  # requests.
581
630
  module KeywordMatchMode
582
631
  # The keyword match option isn't specified. Defaults to
583
- # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} behavior.
632
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}
633
+ # behavior.
584
634
  KEYWORD_MATCH_MODE_UNSPECIFIED = 0
585
635
 
586
636
  # Disables keyword matching.
587
637
  KEYWORD_MATCH_DISABLED = 1
588
638
 
589
- # Enable keyword matching over {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
590
- # {::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},
591
- # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}, and keyword searchable {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}
639
+ # Enable keyword matching over
640
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
641
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description},
642
+ # {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name},
643
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
644
+ # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}, and
645
+ # keyword searchable
646
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}
592
647
  # fields.
593
648
  KEYWORD_MATCH_ALL = 2
594
649
 
595
- # Only enable keyword matching over {::Google::Cloud::Talent::V4beta1::Job#title Job.title}.
650
+ # Only enable keyword matching over
651
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title}.
596
652
  KEYWORD_MATCH_TITLE_ONLY = 3
597
653
  end
598
654
  end
@@ -600,7 +656,8 @@ module Google
600
656
  # Response for SearchJob method.
601
657
  # @!attribute [rw] matching_jobs
602
658
  # @return [::Array<::Google::Cloud::Talent::V4beta1::SearchJobsResponse::MatchingJob>]
603
- # The Job entities that match the specified {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
659
+ # The Job entities that match the specified
660
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
604
661
  # @!attribute [rw] histogram_query_results
605
662
  # @return [::Array<::Google::Cloud::Talent::V4beta1::HistogramQueryResult>]
606
663
  # The histogram results that match with specified
@@ -612,14 +669,17 @@ module Google
612
669
  # @!attribute [rw] location_filters
613
670
  # @return [::Array<::Google::Cloud::Talent::V4beta1::Location>]
614
671
  # The location filters that the service applied to the specified query. If
615
- # any filters are lat-lng based, the {::Google::Cloud::Talent::V4beta1::Location#location_type Location.location_type} is
672
+ # any filters are lat-lng based, the
673
+ # {::Google::Cloud::Talent::V4beta1::Location#location_type Location.location_type}
674
+ # is
616
675
  # {::Google::Cloud::Talent::V4beta1::Location::LocationType::LOCATION_TYPE_UNSPECIFIED Location.LocationType.LOCATION_TYPE_UNSPECIFIED}.
617
676
  # @!attribute [rw] estimated_total_size
618
677
  # @return [::Integer]
619
678
  # An estimation of the number of jobs that match the specified query.
620
679
  #
621
680
  # This number isn't guaranteed to be accurate. For accurate results,
622
- # see {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#total_size SearchJobsResponse.total_size}.
681
+ # see
682
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#total_size SearchJobsResponse.total_size}.
623
683
  # @!attribute [rw] total_size
624
684
  # @return [::Integer]
625
685
  # The precise result count with limit 100,000.
@@ -643,25 +703,30 @@ module Google
643
703
  include ::Google::Protobuf::MessageExts
644
704
  extend ::Google::Protobuf::MessageExts::ClassMethods
645
705
 
646
- # Job entry with metadata inside {::Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse}.
706
+ # Job entry with metadata inside
707
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse}.
647
708
  # @!attribute [rw] job
648
709
  # @return [::Google::Cloud::Talent::V4beta1::Job]
649
- # Job resource that matches the specified {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
710
+ # Job resource that matches the specified
711
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
650
712
  # @!attribute [rw] job_summary
651
713
  # @return [::String]
652
714
  # A summary of the job with core information that's displayed on the search
653
715
  # results listing page.
654
716
  # @!attribute [rw] job_title_snippet
655
717
  # @return [::String]
656
- # Contains snippets of text from the {::Google::Cloud::Talent::V4beta1::Job#title Job.title} field most
657
- # closely matching a search query's keywords, if available. The matching
658
- # query keywords are enclosed in HTML bold tags.
718
+ # Contains snippets of text from the
719
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title} field most closely
720
+ # matching a search query's keywords, if available. The matching query
721
+ # keywords are enclosed in HTML bold tags.
659
722
  # @!attribute [rw] search_text_snippet
660
723
  # @return [::String]
661
- # Contains snippets of text from the {::Google::Cloud::Talent::V4beta1::Job#description Job.description} and similar
662
- # fields that most closely match a search query's keywords, if available.
663
- # All HTML tags in the original fields are stripped when returned in this
664
- # field, and matching query keywords are enclosed in HTML bold tags.
724
+ # Contains snippets of text from the
725
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description} and
726
+ # similar fields that most closely match a search query's keywords, if
727
+ # available. All HTML tags in the original fields are stripped when
728
+ # returned in this field, and matching query keywords are enclosed in HTML
729
+ # bold tags.
665
730
  # @!attribute [rw] commute_info
666
731
  # @return [::Google::Cloud::Talent::V4beta1::SearchJobsResponse::CommuteInfo]
667
732
  # Commute information which is generated based on specified
@@ -719,25 +784,34 @@ module Google
719
784
  # Strongly recommended for the best service experience. Be aware that it will
720
785
  # also increase latency when checking the status of a batch operation.
721
786
  #
722
- # If {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask} is provided, only the specified fields in
723
- # {::Google::Cloud::Talent::V4beta1::Job Job} are updated. Otherwise all the fields are updated.
787
+ # If
788
+ # {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}
789
+ # is provided, only the specified fields in
790
+ # {::Google::Cloud::Talent::V4beta1::Job Job} are updated. Otherwise all the
791
+ # fields are updated.
724
792
  #
725
793
  # A field mask to restrict the fields that are updated. Only
726
794
  # top level fields of {::Google::Cloud::Talent::V4beta1::Job Job} are supported.
727
795
  #
728
- # If {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask} is provided, The {::Google::Cloud::Talent::V4beta1::Job Job} inside
796
+ # If
797
+ # {::Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}
798
+ # is provided, The {::Google::Cloud::Talent::V4beta1::Job Job} inside
729
799
  # {::Google::Cloud::Talent::V4beta1::JobOperationResult::JobResult JobResult}
730
800
  # will only contains fields that is updated, plus the Id of the Job.
731
- # Otherwise, {::Google::Cloud::Talent::V4beta1::Job Job} will include all fields, which can yield a very
732
- # large response.
801
+ # Otherwise, {::Google::Cloud::Talent::V4beta1::Job Job} will include all fields,
802
+ # which can yield a very large response.
733
803
  class BatchUpdateJobsRequest
734
804
  include ::Google::Protobuf::MessageExts
735
805
  extend ::Google::Protobuf::MessageExts::ClassMethods
736
806
  end
737
807
 
738
- # The result of {::Google::Cloud::Talent::V4beta1::JobService::Client#batch_create_jobs JobService.BatchCreateJobs} or
739
- # {::Google::Cloud::Talent::V4beta1::JobService::Client#batch_update_jobs JobService.BatchUpdateJobs} APIs. It's used to
740
- # replace {::Google::Longrunning::Operation#response google.longrunning.Operation.response} in case of success.
808
+ # The result of
809
+ # {::Google::Cloud::Talent::V4beta1::JobService::Client#batch_create_jobs JobService.BatchCreateJobs}
810
+ # or
811
+ # {::Google::Cloud::Talent::V4beta1::JobService::Client#batch_update_jobs JobService.BatchUpdateJobs}
812
+ # APIs. It's used to replace
813
+ # {::Google::Longrunning::Operation#response google.longrunning.Operation.response}
814
+ # in case of success.
741
815
  # @!attribute [rw] job_results
742
816
  # @return [::Array<::Google::Cloud::Talent::V4beta1::JobOperationResult::JobResult>]
743
817
  # List of job mutation results from a batch mutate operation. It can change
@@ -749,14 +823,19 @@ module Google
749
823
  # Mutation result of a job.
750
824
  # @!attribute [rw] job
751
825
  # @return [::Google::Cloud::Talent::V4beta1::Job]
752
- # Here {::Google::Cloud::Talent::V4beta1::Job Job} only contains basic information including {::Google::Cloud::Talent::V4beta1::Job#name name},
753
- # {::Google::Cloud::Talent::V4beta1::Job#company company}, {::Google::Cloud::Talent::V4beta1::Job#language_code language_code}
754
- # and {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}, use getJob method to retrieve
755
- # detailed information of the created/updated job.
826
+ # Here {::Google::Cloud::Talent::V4beta1::Job Job} only contains basic
827
+ # information including {::Google::Cloud::Talent::V4beta1::Job#name name},
828
+ # {::Google::Cloud::Talent::V4beta1::Job#company company},
829
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
830
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}, use
831
+ # getJob method to retrieve detailed information of the created/updated
832
+ # job.
756
833
  # @!attribute [rw] status
757
834
  # @return [::Google::Rpc::Status]
758
835
  # The status of the job processed. This field is populated if the
759
- # processing of the {::Google::Cloud::Talent::V4beta1::JobOperationResult::JobResult#job job} fails.
836
+ # processing of the
837
+ # {::Google::Cloud::Talent::V4beta1::JobOperationResult::JobResult#job job}
838
+ # fails.
760
839
  class JobResult
761
840
  include ::Google::Protobuf::MessageExts
762
841
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -764,25 +843,37 @@ module Google
764
843
  end
765
844
 
766
845
  # An enum that specifies the job attributes that are returned in the
767
- # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse::MatchingJob#job MatchingJob.job} or
768
- # {::Google::Cloud::Talent::V4beta1::ListJobsResponse#jobs ListJobsResponse.jobs} fields.
846
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsResponse::MatchingJob#job MatchingJob.job}
847
+ # or {::Google::Cloud::Talent::V4beta1::ListJobsResponse#jobs ListJobsResponse.jobs}
848
+ # fields.
769
849
  module JobView
770
850
  # Default value.
771
851
  JOB_VIEW_UNSPECIFIED = 0
772
852
 
773
853
  # A ID only view of job, with following attributes:
774
- # {::Google::Cloud::Talent::V4beta1::Job#name Job.name}, {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id}, {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}.
854
+ # {::Google::Cloud::Talent::V4beta1::Job#name Job.name},
855
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id},
856
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}.
775
857
  JOB_VIEW_ID_ONLY = 1
776
858
 
777
859
  # A minimal view of the job, with the following attributes:
778
- # {::Google::Cloud::Talent::V4beta1::Job#name Job.name}, {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id}, {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
779
- # {::Google::Cloud::Talent::V4beta1::Job#company Job.company}, {::Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job.DerivedInfo.locations}, {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}.
860
+ # {::Google::Cloud::Talent::V4beta1::Job#name Job.name},
861
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id},
862
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
863
+ # {::Google::Cloud::Talent::V4beta1::Job#company Job.company},
864
+ # {::Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job.DerivedInfo.locations},
865
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}.
780
866
  JOB_VIEW_MINIMAL = 2
781
867
 
782
868
  # A small view of the job, with the following attributes in the search
783
- # results: {::Google::Cloud::Talent::V4beta1::Job#name Job.name}, {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id}, {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
784
- # {::Google::Cloud::Talent::V4beta1::Job#company Job.company}, {::Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job.DerivedInfo.locations}, {::Google::Cloud::Talent::V4beta1::Job#visibility Job.visibility},
785
- # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code}, {::Google::Cloud::Talent::V4beta1::Job#description Job.description}.
869
+ # results: {::Google::Cloud::Talent::V4beta1::Job#name Job.name},
870
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id},
871
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
872
+ # {::Google::Cloud::Talent::V4beta1::Job#company Job.company},
873
+ # {::Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job.DerivedInfo.locations},
874
+ # {::Google::Cloud::Talent::V4beta1::Job#visibility Job.visibility},
875
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code Job.language_code},
876
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description}.
786
877
  JOB_VIEW_SMALL = 3
787
878
 
788
879
  # 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
  # @!attribute [rw] usage_type
@@ -44,12 +45,15 @@ module Google
44
45
  # Indicates whether data owned by this tenant may be used to provide product
45
46
  # improvements across other tenants.
46
47
  #
47
- # Defaults behavior is {::Google::Cloud::Talent::V4beta1::Tenant::DataUsageType::ISOLATED DataUsageType.ISOLATED} if it's unset.
48
+ # Defaults behavior is
49
+ # {::Google::Cloud::Talent::V4beta1::Tenant::DataUsageType::ISOLATED DataUsageType.ISOLATED}
50
+ # if it's unset.
48
51
  # @!attribute [rw] keyword_searchable_profile_custom_attributes
49
52
  # @return [::Array<::String>]
50
- # A list of keys of filterable [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes], whose
51
- # corresponding `string_values` are used in keyword searches. Profiles with
52
- # `string_values` under these specified field keys are returned if any
53
+ # A list of keys of filterable
54
+ # [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes],
55
+ # whose corresponding `string_values` are used in keyword searches. Profiles
56
+ # with `string_values` under these specified field keys are returned if any
53
57
  # of the values match the search keyword. Custom field values with
54
58
  # parenthesis, brackets and special symbols are not searchable as-is,
55
59
  # and must be surrounded by quotes.