google-cloud-talent-v4 0.8.0 → 0.9.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 (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/v4/company_service/client.rb +15 -12
  5. data/lib/google/cloud/talent/v4/company_service/rest/client.rb +682 -0
  6. data/lib/google/cloud/talent/v4/company_service/rest/service_stub.rb +345 -0
  7. data/lib/google/cloud/talent/v4/company_service/rest.rb +52 -0
  8. data/lib/google/cloud/talent/v4/company_service.rb +7 -1
  9. data/lib/google/cloud/talent/v4/completion/client.rb +4 -2
  10. data/lib/google/cloud/talent/v4/completion/rest/client.rb +380 -0
  11. data/lib/google/cloud/talent/v4/completion/rest/service_stub.rb +107 -0
  12. data/lib/google/cloud/talent/v4/completion/rest.rb +52 -0
  13. data/lib/google/cloud/talent/v4/completion.rb +7 -1
  14. data/lib/google/cloud/talent/v4/event_service/client.rb +2 -2
  15. data/lib/google/cloud/talent/v4/event_service/rest/client.rb +358 -0
  16. data/lib/google/cloud/talent/v4/event_service/rest/service_stub.rb +108 -0
  17. data/lib/google/cloud/talent/v4/event_service/rest.rb +52 -0
  18. data/lib/google/cloud/talent/v4/event_service.rb +7 -1
  19. data/lib/google/cloud/talent/v4/job_service/client.rb +238 -161
  20. data/lib/google/cloud/talent/v4/job_service/operations.rb +12 -14
  21. data/lib/google/cloud/talent/v4/job_service/rest/client.rb +1685 -0
  22. data/lib/google/cloud/talent/v4/job_service/rest/operations.rb +793 -0
  23. data/lib/google/cloud/talent/v4/job_service/rest/service_stub.rb +645 -0
  24. data/lib/google/cloud/talent/v4/job_service/rest.rb +53 -0
  25. data/lib/google/cloud/talent/v4/job_service.rb +7 -1
  26. data/lib/google/cloud/talent/v4/job_service_services_pb.rb +12 -8
  27. data/lib/google/cloud/talent/v4/rest.rb +41 -0
  28. data/lib/google/cloud/talent/v4/tenant_service/client.rb +10 -9
  29. data/lib/google/cloud/talent/v4/tenant_service/rest/client.rb +670 -0
  30. data/lib/google/cloud/talent/v4/tenant_service/rest/service_stub.rb +345 -0
  31. data/lib/google/cloud/talent/v4/tenant_service/rest.rb +52 -0
  32. data/lib/google/cloud/talent/v4/tenant_service.rb +7 -1
  33. data/lib/google/cloud/talent/v4/version.rb +1 -1
  34. data/lib/google/cloud/talent/v4.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/v4/common.rb +116 -56
  38. data/proto_docs/google/cloud/talent/v4/company.rb +12 -4
  39. data/proto_docs/google/cloud/talent/v4/company_service.rb +11 -6
  40. data/proto_docs/google/cloud/talent/v4/completion_service.rb +21 -10
  41. data/proto_docs/google/cloud/talent/v4/event.rb +17 -9
  42. data/proto_docs/google/cloud/talent/v4/event_service.rb +2 -2
  43. data/proto_docs/google/cloud/talent/v4/filters.rb +55 -37
  44. data/proto_docs/google/cloud/talent/v4/histogram.rb +6 -2
  45. data/proto_docs/google/cloud/talent/v4/job.rb +83 -55
  46. data/proto_docs/google/cloud/talent/v4/job_service.rb +199 -117
  47. data/proto_docs/google/cloud/talent/v4/tenant.rb +2 -1
  48. data/proto_docs/google/cloud/talent/v4/tenant_service.rb +6 -3
  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::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