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
@@ -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 (DEPRECATED): histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
269
+ # * company_size (DEPRECATED): histogram by
270
+ # {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
260
271
  # "SMALL", "MEDIUM", "BIG".
261
- # * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
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.