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
@@ -30,8 +30,8 @@ module Google
30
30
  # The maximum number of allowed characters is 255.
31
31
  # @!attribute [rw] query_language_code
32
32
  # @return [::String]
33
- # The language code of {::Google::Cloud::Talent::V4beta1::JobQuery#query query}. For example, "en-US". This field helps to
34
- # better interpret the query.
33
+ # The language code of {::Google::Cloud::Talent::V4beta1::JobQuery#query query}.
34
+ # For example, "en-US". This field helps to better interpret the query.
35
35
  #
36
36
  # If a value isn't specified, the query language code is automatically
37
37
  # detected, which may not be accurate.
@@ -60,21 +60,24 @@ module Google
60
60
  # @!attribute [rw] location_filters
61
61
  # @return [::Array<::Google::Cloud::Talent::V4beta1::LocationFilter>]
62
62
  # The location filter specifies geo-regions containing the jobs to
63
- # search against. See {::Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more information.
63
+ # search against. See
64
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more
65
+ # information.
64
66
  #
65
67
  # If a location value isn't specified, jobs fitting the other search
66
68
  # criteria are retrieved regardless of where they're located.
67
69
  #
68
70
  # If multiple values are specified, jobs are retrieved from any of the
69
71
  # specified locations. If different values are specified for the
70
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} parameter, the maximum provided
71
- # distance is used for all locations.
72
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles}
73
+ # parameter, the maximum provided distance is used for all locations.
72
74
  #
73
75
  # At most 5 location filters are allowed.
74
76
  # @!attribute [rw] job_categories
75
77
  # @return [::Array<::Google::Cloud::Talent::V4beta1::JobCategory>]
76
78
  # The category filter specifies the categories of jobs to search against.
77
- # See {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory} for more information.
79
+ # See {::Google::Cloud::Talent::V4beta1::JobCategory JobCategory} for more
80
+ # information.
78
81
  #
79
82
  # If a value isn't specified, jobs from any category are searched against.
80
83
  #
@@ -85,15 +88,17 @@ module Google
85
88
  # Allows filtering jobs by commute time with different travel methods (for
86
89
  # example, driving or public transit).
87
90
  #
88
- # Note: This only works when you specify a {::Google::Cloud::Talent::V4beta1::CommuteMethod CommuteMethod}. In this case,
89
- # {::Google::Cloud::Talent::V4beta1::JobQuery#location_filters location_filters} is ignored.
91
+ # Note: This only works when you specify a
92
+ # {::Google::Cloud::Talent::V4beta1::CommuteMethod CommuteMethod}. In this case,
93
+ # {::Google::Cloud::Talent::V4beta1::JobQuery#location_filters location_filters}
94
+ # is ignored.
90
95
  #
91
96
  # Currently we don't support sorting by commute time.
92
97
  # @!attribute [rw] company_display_names
93
98
  # @return [::Array<::String>]
94
- # This filter specifies the company {::Google::Cloud::Talent::V4beta1::Company#display_name Company.display_name}
95
- # of the jobs to search against. The company name must match the value
96
- # exactly.
99
+ # This filter specifies the company
100
+ # {::Google::Cloud::Talent::V4beta1::Company#display_name Company.display_name} of
101
+ # the jobs to search against. The company name must match the value exactly.
97
102
  #
98
103
  # Alternatively, the value being searched for can be wrapped in different
99
104
  # match operators.
@@ -120,14 +125,15 @@ module Google
120
125
  # @!attribute [rw] compensation_filter
121
126
  # @return [::Google::Cloud::Talent::V4beta1::CompensationFilter]
122
127
  # This search filter is applied only to
123
- # {::Google::Cloud::Talent::V4beta1::Job#compensation_info Job.compensation_info}. For example, if the filter is specified
124
- # as "Hourly job with per-hour compensation > $15", only jobs meeting
125
- # these criteria are searched. If a filter isn't defined, all open jobs
126
- # are searched.
128
+ # {::Google::Cloud::Talent::V4beta1::Job#compensation_info Job.compensation_info}.
129
+ # For example, if the filter is specified as "Hourly job with per-hour
130
+ # compensation > $15", only jobs meeting these criteria are searched. If a
131
+ # filter isn't defined, all open jobs are searched.
127
132
  # @!attribute [rw] custom_attribute_filter
128
133
  # @return [::String]
129
134
  # This filter specifies a structured syntax to match against the
130
- # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes} marked as `filterable`.
135
+ # {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}
136
+ # marked as `filterable`.
131
137
  #
132
138
  # The syntax for this expression is a subset of SQL syntax.
133
139
  #
@@ -158,7 +164,8 @@ module Google
158
164
  # @!attribute [rw] employment_types
159
165
  # @return [::Array<::Google::Cloud::Talent::V4beta1::EmploymentType>]
160
166
  # The employment type filter specifies the employment type of jobs to
161
- # search against, such as {::Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME EmploymentType.FULL_TIME}.
167
+ # search against, such as
168
+ # {::Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME EmploymentType.FULL_TIME}.
162
169
  #
163
170
  # If a value isn't specified, jobs in the search results includes any
164
171
  # employment type.
@@ -228,14 +235,21 @@ module Google
228
235
  # Allows the client to return jobs without a
229
236
  # set location, specifically, telecommuting jobs (telecommuting is considered
230
237
  # by the service as a special location).
231
- # {::Google::Cloud::Talent::V4beta1::Job#posting_region Job.posting_region} indicates if a job permits telecommuting.
232
- # If this field is set to {::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference.TELECOMMUTE_ALLOWED},
233
- # telecommuting jobs are searched, and {::Google::Cloud::Talent::V4beta1::LocationFilter#address address} and {::Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are
234
- # ignored. If not set or set to
235
- # {::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference.TELECOMMUTE_EXCLUDED}, the telecommute status of
236
- # the jobs is ignored. Jobs that have {::Google::Cloud::Talent::V4beta1::PostingRegion::TELECOMMUTE PostingRegion.TELECOMMUTE} and have
237
- # additional {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses} may still be matched based on other location
238
- # filters using {::Google::Cloud::Talent::V4beta1::LocationFilter#address address} or [latlng][].
238
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_region Job.posting_region}
239
+ # indicates if a job permits telecommuting. If this field is set to
240
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference.TELECOMMUTE_ALLOWED},
241
+ # telecommuting jobs are searched, and
242
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter#address address} and
243
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are ignored.
244
+ # If not set or set to
245
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference.TELECOMMUTE_EXCLUDED},
246
+ # the telecommute status of the jobs is ignored. Jobs that have
247
+ # {::Google::Cloud::Talent::V4beta1::PostingRegion::TELECOMMUTE PostingRegion.TELECOMMUTE}
248
+ # and have additional
249
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses} may still be
250
+ # matched based on other location filters using
251
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter#address address} or
252
+ # [latlng][].
239
253
  #
240
254
  # This filter can be used by itself to search exclusively for telecommuting
241
255
  # jobs, or it can be combined with another location
@@ -296,32 +310,42 @@ module Google
296
310
 
297
311
  # Filter by `base compensation entry's` unit. A job is a match if and
298
312
  # only if the job contains a base CompensationEntry and the base
299
- # CompensationEntry's unit matches provided {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
300
- # Populate one or more {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
313
+ # CompensationEntry's unit matches provided
314
+ # {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units}. Populate
315
+ # one or more
316
+ # {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
301
317
  #
302
- # See {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo.CompensationEntry} for definition of
303
- # base compensation entry.
318
+ # See
319
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo.CompensationEntry}
320
+ # for definition of base compensation entry.
304
321
  UNIT_ONLY = 1
305
322
 
306
323
  # Filter by `base compensation entry's` unit and amount / range. A job
307
324
  # is a match if and only if the job contains a base CompensationEntry, and
308
325
  # the base entry's unit matches provided
309
- # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationUnit} and
310
- # amount or range overlaps with provided
326
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationUnit}
327
+ # and amount or range overlaps with provided
311
328
  # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationRange CompensationRange}.
312
329
  #
313
- # See {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo.CompensationEntry} for definition of
314
- # base compensation entry.
330
+ # See
331
+ # {::Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo.CompensationEntry}
332
+ # for definition of base compensation entry.
315
333
  #
316
- # Set exactly one {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units} and populate {::Google::Cloud::Talent::V4beta1::CompensationFilter#range range}.
334
+ # Set exactly one
335
+ # {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units} and
336
+ # populate {::Google::Cloud::Talent::V4beta1::CompensationFilter#range range}.
317
337
  UNIT_AND_AMOUNT = 2
318
338
 
319
339
  # Filter by annualized base compensation amount and `base compensation
320
- # entry's` unit. Populate [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
340
+ # entry's` unit. Populate
341
+ # {::Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or
342
+ # more {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
321
343
  ANNUALIZED_BASE_AMOUNT = 3
322
344
 
323
345
  # Filter by annualized total compensation amount and `base compensation
324
- # entry's` unit . Populate [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
346
+ # entry's` unit . Populate
347
+ # {::Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or
348
+ # more {::Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
325
349
  ANNUALIZED_TOTAL_AMOUNT = 4
326
350
  end
327
351
  end
@@ -336,8 +360,8 @@ module Google
336
360
  # commute time from.
337
361
  # @!attribute [rw] travel_duration
338
362
  # @return [::Google::Protobuf::Duration]
339
- # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
340
- # (one hour). Format is `123s`.
363
+ # Required. The maximum travel time in seconds. The maximum allowed value is
364
+ # `3600s` (one hour). Format is `123s`.
341
365
  # @!attribute [rw] allow_imprecise_addresses
342
366
  # @return [::Boolean]
343
367
  # If `true`, jobs without street level addresses may also be returned.
@@ -27,14 +27,19 @@ module Google
27
27
  # An expression specifies a histogram request against matching resources
28
28
  # (for example, jobs, profiles) for searches.
29
29
  #
30
- # See {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest.histogram_queries} and
31
- # [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries] for details about syntax.
30
+ # See
31
+ # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest.histogram_queries}
32
+ # and
33
+ # [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries]
34
+ # for details about syntax.
32
35
  class HistogramQuery
33
36
  include ::Google::Protobuf::MessageExts
34
37
  extend ::Google::Protobuf::MessageExts::ClassMethods
35
38
  end
36
39
 
37
- # Histogram result that matches {::Google::Cloud::Talent::V4beta1::HistogramQuery HistogramQuery} specified in searches.
40
+ # Histogram result that matches
41
+ # {::Google::Cloud::Talent::V4beta1::HistogramQuery HistogramQuery} specified in
42
+ # searches.
38
43
  # @!attribute [rw] histogram_query
39
44
  # @return [::String]
40
45
  # Requested histogram expression.
@@ -22,8 +22,9 @@ module Google
22
22
  module Talent
23
23
  module V4beta1
24
24
  # A Job resource represents a job posting (also referred to as a "job listing"
25
- # or "job requisition"). A job belongs to a {::Google::Cloud::Talent::V4beta1::Company Company}, which is the hiring
26
- # entity responsible for the job.
25
+ # or "job requisition"). A job belongs to a
26
+ # {::Google::Cloud::Talent::V4beta1::Company Company}, which is the hiring entity
27
+ # responsible for the job.
27
28
  # @!attribute [rw] name
28
29
  # @return [::String]
29
30
  # Required during job update.
@@ -39,7 +40,8 @@ module Google
39
40
  # example, "projects/foo/jobs/bar".
40
41
  #
41
42
  # Use of this field in job queries and API calls is preferred over the use of
42
- # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} since this value is unique.
43
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} since this
44
+ # value is unique.
43
45
  # @!attribute [rw] company
44
46
  # @return [::String]
45
47
  # Required. The resource name of the company listing the job.
@@ -52,11 +54,13 @@ module Google
52
54
  # example, "projects/foo/companies/bar".
53
55
  # @!attribute [rw] requisition_id
54
56
  # @return [::String]
55
- # Required. The requisition ID, also referred to as the posting ID, is assigned by the
56
- # client to identify a job. This field is intended to be used by clients
57
- # for client identification and tracking of postings. A job isn't allowed
58
- # to be created if there is another job with the same {::Google::Cloud::Talent::V4beta1::Job#name company},
59
- # {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
57
+ # Required. The requisition ID, also referred to as the posting ID, is
58
+ # assigned by the client to identify a job. This field is intended to be used
59
+ # by clients for client identification and tracking of postings. A job isn't
60
+ # allowed to be created if there is another job with the same
61
+ # {::Google::Cloud::Talent::V4beta1::Job#name company},
62
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
63
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
60
64
  #
61
65
  # The maximum number of allowed characters is 255.
62
66
  # @!attribute [rw] title
@@ -66,11 +70,12 @@ module Google
66
70
  # The maximum number of allowed characters is 500.
67
71
  # @!attribute [rw] description
68
72
  # @return [::String]
69
- # Required. The description of the job, which typically includes a multi-paragraph
70
- # description of the company and related information. Separate fields are
71
- # provided on the job object for {::Google::Cloud::Talent::V4beta1::Job#responsibilities responsibilities},
72
- # {::Google::Cloud::Talent::V4beta1::Job#qualifications qualifications}, and other job characteristics. Use of
73
- # these separate job fields is recommended.
73
+ # Required. The description of the job, which typically includes a
74
+ # multi-paragraph description of the company and related information.
75
+ # Separate fields are provided on the job object for
76
+ # {::Google::Cloud::Talent::V4beta1::Job#responsibilities responsibilities},
77
+ # {::Google::Cloud::Talent::V4beta1::Job#qualifications qualifications}, and other
78
+ # job characteristics. Use of these separate job fields is recommended.
74
79
  #
75
80
  # This field accepts and sanitizes HTML input, and also accepts
76
81
  # bold, italic, ordered list, and unordered list markup tags.
@@ -87,12 +92,16 @@ module Google
87
92
  #
88
93
  # At most 50 locations are allowed for best search performance. If a job has
89
94
  # more locations, it is suggested to split it into multiple jobs with unique
90
- # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}s (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as
91
- # multiple jobs with the same {::Google::Cloud::Talent::V4beta1::Job#company company}, {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
92
- # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} are not allowed. If the original {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} must
93
- # be preserved, a custom field should be used for storage. It is also
94
- # suggested to group the locations that close to each other in the same job
95
- # for better search experience.
95
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}s (e.g.
96
+ # 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as multiple jobs with the
97
+ # same {::Google::Cloud::Talent::V4beta1::Job#company company},
98
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
99
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} are not
100
+ # allowed. If the original
101
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} must be
102
+ # preserved, a custom field should be used for storage. It is also suggested
103
+ # to group the locations that close to each other in the same job for better
104
+ # search experience.
96
105
  #
97
106
  # The maximum number of allowed characters is 500.
98
107
  # @!attribute [rw] application_info
@@ -149,9 +158,11 @@ module Google
149
158
  # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
150
159
  # class="external" target="_blank" }.
151
160
  #
152
- # If this field is unspecified and {::Google::Cloud::Talent::V4beta1::Job#description Job.description} is present, detected
153
- # language code based on {::Google::Cloud::Talent::V4beta1::Job#description Job.description} is assigned, otherwise
154
- # defaults to 'en_US'.
161
+ # If this field is unspecified and
162
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description} is present,
163
+ # detected language code based on
164
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description} is assigned,
165
+ # otherwise defaults to 'en_US'.
155
166
  # @!attribute [rw] job_level
156
167
  # @return [::Google::Cloud::Talent::V4beta1::JobLevel]
157
168
  # The experience level associated with the job, such as "Entry Level".
@@ -168,7 +179,8 @@ module Google
168
179
  # @return [::String]
169
180
  # A description of the qualifications required to perform the
170
181
  # job. The use of this field is recommended
171
- # as an alternative to using the more general {::Google::Cloud::Talent::V4beta1::Job#description description} field.
182
+ # as an alternative to using the more general
183
+ # {::Google::Cloud::Talent::V4beta1::Job#description description} field.
172
184
  #
173
185
  # This field accepts and sanitizes HTML input, and also accepts
174
186
  # bold, italic, ordered list, and unordered list markup tags.
@@ -177,8 +189,8 @@ module Google
177
189
  # @!attribute [rw] responsibilities
178
190
  # @return [::String]
179
191
  # A description of job responsibilities. The use of this field is
180
- # recommended as an alternative to using the more general {::Google::Cloud::Talent::V4beta1::Job#description description}
181
- # field.
192
+ # recommended as an alternative to using the more general
193
+ # {::Google::Cloud::Talent::V4beta1::Job#description description} field.
182
194
  #
183
195
  # This field accepts and sanitizes HTML input, and also accepts
184
196
  # bold, italic, ordered list, and unordered list markup tags.
@@ -186,20 +198,25 @@ module Google
186
198
  # The maximum number of allowed characters is 10,000.
187
199
  # @!attribute [rw] posting_region
188
200
  # @return [::Google::Cloud::Talent::V4beta1::PostingRegion]
189
- # The job {::Google::Cloud::Talent::V4beta1::PostingRegion PostingRegion} (for example, state, country) throughout
190
- # which the job is available. If this field is set, a {::Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter}
191
- # in a search query within the job region finds this job posting if an
192
- # exact location match isn't specified. If this field is set to
193
- # {::Google::Cloud::Talent::V4beta1::PostingRegion::NATION PostingRegion.NATION} or {::Google::Cloud::Talent::V4beta1::PostingRegion::ADMINISTRATIVE_AREA PostingRegion.ADMINISTRATIVE_AREA},
194
- # setting job {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses} to the same location level as this field
195
- # is strongly recommended.
201
+ # The job {::Google::Cloud::Talent::V4beta1::PostingRegion PostingRegion} (for
202
+ # example, state, country) throughout which the job is available. If this
203
+ # field is set, a
204
+ # {::Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} in a search
205
+ # query within the job region finds this job posting if an exact location
206
+ # match isn't specified. If this field is set to
207
+ # {::Google::Cloud::Talent::V4beta1::PostingRegion::NATION PostingRegion.NATION} or
208
+ # {::Google::Cloud::Talent::V4beta1::PostingRegion::ADMINISTRATIVE_AREA PostingRegion.ADMINISTRATIVE_AREA},
209
+ # setting job {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses} to
210
+ # the same location level as this field is strongly recommended.
196
211
  # @!attribute [rw] visibility
197
212
  # @return [::Google::Cloud::Talent::V4beta1::Visibility]
198
213
  # Deprecated. The job is only visible to the owner.
199
214
  #
200
215
  # The visibility of the job.
201
216
  #
202
- # Defaults to {::Google::Cloud::Talent::V4beta1::Visibility::ACCOUNT_ONLY Visibility.ACCOUNT_ONLY} if not specified.
217
+ # Defaults to
218
+ # {::Google::Cloud::Talent::V4beta1::Visibility::ACCOUNT_ONLY Visibility.ACCOUNT_ONLY}
219
+ # if not specified.
203
220
  # @!attribute [rw] job_start_time
204
221
  # @return [::Google::Protobuf::Timestamp]
205
222
  # The start timestamp of the job in UTC time zone. Typically this field
@@ -219,13 +236,18 @@ module Google
219
236
  #
220
237
  # The expiration timestamp of the job. After this timestamp, the
221
238
  # job is marked as expired, and it no longer appears in search results. The
222
- # expired job can't be listed by the {::Google::Cloud::Talent::V4beta1::JobService::Client#list_jobs ListJobs} API,
223
- # but it can be retrieved with the {::Google::Cloud::Talent::V4beta1::JobService::Client#get_job GetJob} API or
224
- # updated with the {::Google::Cloud::Talent::V4beta1::JobService::Client#update_job UpdateJob} API or deleted with
225
- # the {::Google::Cloud::Talent::V4beta1::JobService::Client#delete_job DeleteJob} API. An expired job can
226
- # be updated and opened again by using a future expiration timestamp.
227
- # Updating an expired job fails if there is another existing open job with
228
- # same {::Google::Cloud::Talent::V4beta1::Job#company company}, {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
239
+ # expired job can't be listed by the
240
+ # {::Google::Cloud::Talent::V4beta1::JobService::Client#list_jobs ListJobs} API, but it can
241
+ # be retrieved with the
242
+ # {::Google::Cloud::Talent::V4beta1::JobService::Client#get_job GetJob} API or updated with
243
+ # the {::Google::Cloud::Talent::V4beta1::JobService::Client#update_job UpdateJob} API or
244
+ # deleted with the
245
+ # {::Google::Cloud::Talent::V4beta1::JobService::Client#delete_job DeleteJob} API. An
246
+ # expired job can be updated and opened again by using a future expiration
247
+ # timestamp. Updating an expired job fails if there is another existing open
248
+ # job with same {::Google::Cloud::Talent::V4beta1::Job#company company},
249
+ # {::Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
250
+ # {::Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
229
251
  #
230
252
  # The expired jobs are retained in our system for 90 days. However, the
231
253
  # overall expired job count cannot exceed 3 times the maximum number of
@@ -239,12 +261,13 @@ module Google
239
261
  # If the timestamp is before the instant request is made, the job
240
262
  # is treated as expired immediately on creation. This kind of job can
241
263
  # not be updated. And when creating a job with past timestamp, the
242
- # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time posting_publish_time} must be set before
243
- # {::Google::Cloud::Talent::V4beta1::Job#posting_expire_time posting_expire_time}. The purpose of this feature is
244
- # to allow other objects, such as [Application][google.cloud.talent.v4beta1.Application], to refer a job
245
- # that didn't exist in the system prior to becoming expired. If you
246
- # want to modify a job that was expired on creation,
247
- # delete it and create a new one.
264
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time posting_publish_time}
265
+ # must be set before
266
+ # {::Google::Cloud::Talent::V4beta1::Job#posting_expire_time posting_expire_time}.
267
+ # The purpose of this feature is to allow other objects, such as
268
+ # [Application][google.cloud.talent.v4beta1.Application], to refer a job that
269
+ # didn't exist in the system prior to becoming expired. If you want to modify
270
+ # a job that was expired on creation, delete it and create a new one.
248
271
  #
249
272
  # If this value isn't provided at the time of job creation or is invalid,
250
273
  # the job posting expires after 30 days from the job's creation time. For
@@ -252,10 +275,13 @@ module Google
252
275
  # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
253
276
  #
254
277
  # If this value isn't provided on job update, it depends on the field masks
255
- # set by {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask UpdateJobRequest.update_mask}. If the field masks include
256
- # {::Google::Cloud::Talent::V4beta1::Job#job_end_time job_end_time}, or the masks are empty meaning that every field is
257
- # updated, the job posting expires after 30 days from the job's last
258
- # update time. Otherwise the expiration date isn't updated.
278
+ # set by
279
+ # {::Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask UpdateJobRequest.update_mask}.
280
+ # If the field masks include
281
+ # {::Google::Cloud::Talent::V4beta1::Job#job_end_time job_end_time}, or the masks
282
+ # are empty meaning that every field is updated, the job posting expires
283
+ # after 30 days from the job's last update time. Otherwise the expiration
284
+ # date isn't updated.
259
285
  # @!attribute [r] posting_create_time
260
286
  # @return [::Google::Protobuf::Timestamp]
261
287
  # Output only. The timestamp when this job posting was created.
@@ -305,13 +331,18 @@ module Google
305
331
  # Derived details about the job posting.
306
332
  # @!attribute [rw] locations
307
333
  # @return [::Array<::Google::Cloud::Talent::V4beta1::Location>]
308
- # Structured locations of the job, resolved from {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses}.
334
+ # Structured locations of the job, resolved from
335
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses}.
309
336
  #
310
- # {::Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations locations} are exactly matched to {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses} in the same
337
+ # {::Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations locations} are
338
+ # exactly matched to
339
+ # {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses} in the same
311
340
  # order.
312
341
  # @!attribute [rw] job_categories
313
342
  # @return [::Array<::Google::Cloud::Talent::V4beta1::JobCategory>]
314
- # Job categories derived from {::Google::Cloud::Talent::V4beta1::Job#title Job.title} and {::Google::Cloud::Talent::V4beta1::Job#description Job.description}.
343
+ # Job categories derived from
344
+ # {::Google::Cloud::Talent::V4beta1::Job#title Job.title} and
345
+ # {::Google::Cloud::Talent::V4beta1::Job#description Job.description}.
315
346
  class DerivedInfo
316
347
  include ::Google::Protobuf::MessageExts
317
348
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -335,7 +366,8 @@ module Google
335
366
  # HTML tags in these fields may be stripped if sanitiazation isn't
336
367
  # disabled.
337
368
  #
338
- # Defaults to {::Google::Cloud::Talent::V4beta1::HtmlSanitization::SIMPLE_FORMATTING_ONLY HtmlSanitization.SIMPLE_FORMATTING_ONLY}.
369
+ # Defaults to
370
+ # {::Google::Cloud::Talent::V4beta1::HtmlSanitization::SIMPLE_FORMATTING_ONLY HtmlSanitization.SIMPLE_FORMATTING_ONLY}.
339
371
  class ProcessingOptions
340
372
  include ::Google::Protobuf::MessageExts
341
373
  extend ::Google::Protobuf::MessageExts::ClassMethods