google-cloud-talent-v4 0.8.1 → 0.9.0

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