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.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +1 -1
- data/README.md +2 -2
- data/lib/google/cloud/talent/v4/company_service/client.rb +15 -12
- data/lib/google/cloud/talent/v4/company_service/rest/client.rb +682 -0
- data/lib/google/cloud/talent/v4/company_service/rest/service_stub.rb +345 -0
- data/lib/google/cloud/talent/v4/company_service/rest.rb +52 -0
- data/lib/google/cloud/talent/v4/company_service.rb +7 -1
- data/lib/google/cloud/talent/v4/completion/client.rb +4 -2
- data/lib/google/cloud/talent/v4/completion/rest/client.rb +380 -0
- data/lib/google/cloud/talent/v4/completion/rest/service_stub.rb +107 -0
- data/lib/google/cloud/talent/v4/completion/rest.rb +52 -0
- data/lib/google/cloud/talent/v4/completion.rb +7 -1
- data/lib/google/cloud/talent/v4/event_service/client.rb +2 -2
- data/lib/google/cloud/talent/v4/event_service/rest/client.rb +358 -0
- data/lib/google/cloud/talent/v4/event_service/rest/service_stub.rb +108 -0
- data/lib/google/cloud/talent/v4/event_service/rest.rb +52 -0
- data/lib/google/cloud/talent/v4/event_service.rb +7 -1
- data/lib/google/cloud/talent/v4/job_service/client.rb +238 -161
- data/lib/google/cloud/talent/v4/job_service/operations.rb +12 -14
- data/lib/google/cloud/talent/v4/job_service/rest/client.rb +1685 -0
- data/lib/google/cloud/talent/v4/job_service/rest/operations.rb +793 -0
- data/lib/google/cloud/talent/v4/job_service/rest/service_stub.rb +645 -0
- data/lib/google/cloud/talent/v4/job_service/rest.rb +53 -0
- data/lib/google/cloud/talent/v4/job_service.rb +7 -1
- data/lib/google/cloud/talent/v4/job_service_services_pb.rb +12 -8
- data/lib/google/cloud/talent/v4/rest.rb +41 -0
- data/lib/google/cloud/talent/v4/tenant_service/client.rb +10 -9
- data/lib/google/cloud/talent/v4/tenant_service/rest/client.rb +670 -0
- data/lib/google/cloud/talent/v4/tenant_service/rest/service_stub.rb +345 -0
- data/lib/google/cloud/talent/v4/tenant_service/rest.rb +52 -0
- data/lib/google/cloud/talent/v4/tenant_service.rb +7 -1
- data/lib/google/cloud/talent/v4/version.rb +1 -1
- data/lib/google/cloud/talent/v4.rb +7 -2
- data/proto_docs/google/api/client.rb +318 -0
- data/proto_docs/google/api/launch_stage.rb +71 -0
- data/proto_docs/google/cloud/talent/v4/common.rb +116 -56
- data/proto_docs/google/cloud/talent/v4/company.rb +12 -4
- data/proto_docs/google/cloud/talent/v4/company_service.rb +11 -6
- data/proto_docs/google/cloud/talent/v4/completion_service.rb +21 -10
- data/proto_docs/google/cloud/talent/v4/event.rb +17 -9
- data/proto_docs/google/cloud/talent/v4/event_service.rb +2 -2
- data/proto_docs/google/cloud/talent/v4/filters.rb +55 -37
- data/proto_docs/google/cloud/talent/v4/histogram.rb +6 -2
- data/proto_docs/google/cloud/talent/v4/job.rb +83 -55
- data/proto_docs/google/cloud/talent/v4/job_service.rb +199 -117
- data/proto_docs/google/cloud/talent/v4/tenant.rb +2 -1
- data/proto_docs/google/cloud/talent/v4/tenant_service.rb +6 -3
- data/proto_docs/google/protobuf/empty.rb +0 -2
- data/proto_docs/google/rpc/status.rb +4 -2
- 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
|
|
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}
|
|
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}
|
|
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
|
|
86
|
-
# {::Google::Cloud::Talent::V4::
|
|
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
|
|
92
|
-
#
|
|
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
|
|
121
|
-
# as "Hourly job with per-hour
|
|
122
|
-
# these criteria are searched. If a
|
|
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}
|
|
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
|
|
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
|
|
229
|
-
# If this field is set to
|
|
230
|
-
#
|
|
231
|
-
#
|
|
232
|
-
# {::Google::Cloud::Talent::V4::LocationFilter
|
|
233
|
-
#
|
|
234
|
-
#
|
|
235
|
-
#
|
|
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
|
|
293
|
-
#
|
|
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
|
|
296
|
-
#
|
|
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}
|
|
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
|
|
307
|
-
#
|
|
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}
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
26
|
-
#
|
|
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
|
|
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
|
|
50
|
-
# client to identify a job. This field is intended to be used
|
|
51
|
-
# for client identification and tracking of postings. A job isn't
|
|
52
|
-
# to be created if there is another job with the same
|
|
53
|
-
# {::Google::Cloud::Talent::V4::Job#
|
|
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
|
|
64
|
-
# description of the company and related information.
|
|
65
|
-
# provided on the job object for
|
|
66
|
-
# {::Google::Cloud::Talent::V4::Job#
|
|
67
|
-
#
|
|
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'
|
|
85
|
-
# multiple jobs with the same
|
|
86
|
-
# {::Google::Cloud::Talent::V4::Job#
|
|
87
|
-
#
|
|
88
|
-
#
|
|
89
|
-
#
|
|
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
|
|
156
|
-
#
|
|
157
|
-
#
|
|
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
|
|
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
|
|
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,
|
|
193
|
-
# which the job is available. If this field is
|
|
194
|
-
#
|
|
195
|
-
#
|
|
196
|
-
#
|
|
197
|
-
#
|
|
198
|
-
#
|
|
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
|
|
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
|
|
226
|
-
#
|
|
227
|
-
#
|
|
228
|
-
#
|
|
229
|
-
#
|
|
230
|
-
#
|
|
231
|
-
#
|
|
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}
|
|
246
|
-
#
|
|
247
|
-
#
|
|
248
|
-
#
|
|
249
|
-
#
|
|
250
|
-
#
|
|
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
|
|
259
|
-
# {::Google::Cloud::Talent::V4::
|
|
260
|
-
#
|
|
261
|
-
#
|
|
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
|
|
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
|
|
314
|
-
#
|
|
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}
|
|
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
|
|
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
|