google-cloud-talent 0.3.0 → 0.4.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (56) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/talent.rb +28 -0
  3. data/lib/google/cloud/talent/v4beta1.rb +57 -0
  4. data/lib/google/cloud/talent/v4beta1/application_pb.rb +1 -2
  5. data/lib/google/cloud/talent/v4beta1/application_service_client.rb +26 -24
  6. data/lib/google/cloud/talent/v4beta1/application_service_pb.rb +1 -0
  7. data/lib/google/cloud/talent/v4beta1/batch_pb.rb +30 -0
  8. data/lib/google/cloud/talent/v4beta1/common_pb.rb +1 -0
  9. data/lib/google/cloud/talent/v4beta1/company_pb.rb +1 -1
  10. data/lib/google/cloud/talent/v4beta1/company_service_client.rb +28 -29
  11. data/lib/google/cloud/talent/v4beta1/company_service_pb.rb +1 -0
  12. data/lib/google/cloud/talent/v4beta1/completion_client.rb +36 -32
  13. data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb +1 -0
  14. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application.rb +14 -33
  15. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application_service.rb +18 -27
  16. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/common.rb +144 -135
  17. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company.rb +19 -36
  18. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company_service.rb +20 -32
  19. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/completion_service.rb +30 -32
  20. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event.rb +121 -41
  21. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event_service.rb +3 -7
  22. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/filters.rb +239 -281
  23. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/histogram.rb +9 -3
  24. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job.rb +129 -142
  25. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job_service.rb +280 -215
  26. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile.rb +198 -338
  27. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile_service.rb +128 -108
  28. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant.rb +11 -13
  29. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant_service.rb +16 -27
  30. data/lib/google/cloud/talent/v4beta1/doc/google/longrunning/operations.rb +51 -0
  31. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/any.rb +131 -0
  32. data/lib/google/cloud/talent/v4beta1/doc/google/rpc/status.rb +87 -0
  33. data/lib/google/cloud/talent/v4beta1/doc/google/type/postal_address.rb +1 -1
  34. data/lib/google/cloud/talent/v4beta1/event_pb.rb +1 -1
  35. data/lib/google/cloud/talent/v4beta1/event_service_client.rb +13 -10
  36. data/lib/google/cloud/talent/v4beta1/event_service_pb.rb +1 -0
  37. data/lib/google/cloud/talent/v4beta1/filters_pb.rb +6 -1
  38. data/lib/google/cloud/talent/v4beta1/histogram_pb.rb +1 -1
  39. data/lib/google/cloud/talent/v4beta1/job_pb.rb +1 -1
  40. data/lib/google/cloud/talent/v4beta1/job_service_client.rb +528 -301
  41. data/lib/google/cloud/talent/v4beta1/job_service_client_config.json +10 -0
  42. data/lib/google/cloud/talent/v4beta1/job_service_pb.rb +13 -0
  43. data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +16 -8
  44. data/lib/google/cloud/talent/v4beta1/profile_service_client.rb +118 -91
  45. data/lib/google/cloud/talent/v4beta1/profile_service_pb.rb +3 -0
  46. data/lib/google/cloud/talent/v4beta1/profile_service_services_pb.rb +3 -1
  47. data/lib/google/cloud/talent/v4beta1/tenant_pb.rb +1 -1
  48. data/lib/google/cloud/talent/v4beta1/tenant_service_client.rb +24 -24
  49. data/lib/google/cloud/talent/v4beta1/tenant_service_pb.rb +1 -0
  50. data/lib/google/cloud/talent/version.rb +22 -0
  51. metadata +8 -9
  52. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/resume_service.rb +0 -98
  53. data/lib/google/cloud/talent/v4beta1/resume_service_client.rb +0 -296
  54. data/lib/google/cloud/talent/v4beta1/resume_service_client_config.json +0 -31
  55. data/lib/google/cloud/talent/v4beta1/resume_service_pb.rb +0 -37
  56. data/lib/google/cloud/talent/v4beta1/resume_service_services_pb.rb +0 -75
@@ -25,13 +25,18 @@ module Google
25
25
  # An expression specifies a histogram request against matching resources
26
26
  # (for example, jobs, profiles) for searches.
27
27
  #
28
- # See {Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest#histogram_queries} and
29
- # {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#histogram_queries SearchProfilesRequest#histogram_queries} for details about syntax.
28
+ # See
29
+ # {Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest#histogram_queries}
30
+ # and
31
+ # {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#histogram_queries SearchProfilesRequest#histogram_queries}
32
+ # for details about syntax.
30
33
  class HistogramQuery; end
31
34
 
32
35
  # Output only.
33
36
  #
34
- # Histogram result that matches {HistogramSpec} specified in searches.
37
+ # Histogram result that matches
38
+ # {Google::Cloud::Talent::V4beta1::HistogramQuery HistogramQuery} specified in
39
+ # searches.
35
40
  # @!attribute [rw] histogram_query
36
41
  # @return [String]
37
42
  # Requested histogram expression.
@@ -41,6 +46,7 @@ module Google
41
46
  # number of matching entries with corresponding value.
42
47
  #
43
48
  # The key format is:
49
+ #
44
50
  # * (for string histogram) string values stored in the field.
45
51
  # * (for named numeric bucket) name specified in `bucket()` function, like
46
52
  # for `bucket(0, MAX, "non-negative")`, the key will be `non-negative`.
@@ -18,8 +18,9 @@ module Google
18
18
  module Talent
19
19
  module V4beta1
20
20
  # A Job resource represents a job posting (also referred to as a "job listing"
21
- # or "job requisition"). A job belongs to a {Google::Cloud::Talent::V4beta1::Company Company}, which is the hiring
22
- # entity responsible for the job.
21
+ # or "job requisition"). A job belongs to a
22
+ # {Google::Cloud::Talent::V4beta1::Company Company}, which is the hiring entity
23
+ # responsible for the job.
23
24
  # @!attribute [rw] name
24
25
  # @return [String]
25
26
  # Required during job update.
@@ -35,12 +36,11 @@ module Google
35
36
  # example, "projects/api-test-project/jobs/1234".
36
37
  #
37
38
  # Use of this field in job queries and API calls is preferred over the use of
38
- # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} since this value is unique.
39
+ # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} since this
40
+ # value is unique.
39
41
  # @!attribute [rw] company
40
42
  # @return [String]
41
- # Required.
42
- #
43
- # The resource name of the company listing the job.
43
+ # Required. The resource name of the company listing the job.
44
44
  #
45
45
  # The format is
46
46
  # "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
@@ -50,31 +50,28 @@ module Google
50
50
  # example, "projects/api-test-project/companies/bar".
51
51
  # @!attribute [rw] requisition_id
52
52
  # @return [String]
53
- # Required.
54
- #
55
- # The requisition ID, also referred to as the posting ID, is assigned by the
56
- # client to identify a job. This field is intended to be used by clients
57
- # for client identification and tracking of postings. A job isn't allowed
58
- # to be created if there is another job with the same {Google::Cloud::Talent::V4beta1::Job#name company},
59
- # {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
53
+ # Required. The requisition ID, also referred to as the posting ID, is
54
+ # assigned by the client to identify a job. This field is intended to be used
55
+ # by clients for client identification and tracking of postings. A job isn't
56
+ # allowed to be created if there is another job with the same
57
+ # {Google::Cloud::Talent::V4beta1::Job#name company},
58
+ # {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
59
+ # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
60
60
  #
61
61
  # The maximum number of allowed characters is 255.
62
62
  # @!attribute [rw] title
63
63
  # @return [String]
64
- # Required.
65
- #
66
- # The title of the job, such as "Software Engineer"
64
+ # Required. The title of the job, such as "Software Engineer"
67
65
  #
68
66
  # The maximum number of allowed characters is 500.
69
67
  # @!attribute [rw] description
70
68
  # @return [String]
71
- # Required.
72
- #
73
- # The description of the job, which typically includes a multi-paragraph
74
- # description of the company and related information. Separate fields are
75
- # provided on the job object for {Google::Cloud::Talent::V4beta1::Job#responsibilities responsibilities},
76
- # {Google::Cloud::Talent::V4beta1::Job#qualifications qualifications}, and other job characteristics. Use of
77
- # these separate job fields is recommended.
69
+ # Required. The description of the job, which typically includes a
70
+ # multi-paragraph description of the company and related information.
71
+ # Separate fields are provided on the job object for
72
+ # {Google::Cloud::Talent::V4beta1::Job#responsibilities responsibilities},
73
+ # {Google::Cloud::Talent::V4beta1::Job#qualifications qualifications}, and other
74
+ # job characteristics. Use of these separate job fields is recommended.
78
75
  #
79
76
  # This field accepts and sanitizes HTML input, and also accepts
80
77
  # bold, italic, ordered list, and unordered list markup tags.
@@ -91,36 +88,32 @@ module Google
91
88
  #
92
89
  # At most 50 locations are allowed for best search performance. If a job has
93
90
  # more locations, it is suggested to split it into multiple jobs with unique
94
- # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}s (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as
95
- # multiple jobs with the same {Google::Cloud::Talent::V4beta1::Job#name company}[], {Language_code} and
96
- # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} are not allowed. If the original {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} must
97
- # be preserved, a custom field should be used for storage. It is also
98
- # suggested to group the locations that close to each other in the same job
99
- # for better search experience.
91
+ # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}s (e.g.
92
+ # 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as multiple jobs with the
93
+ # same {Google::Cloud::Talent::V4beta1::Job#company company},
94
+ # {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
95
+ # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} are not
96
+ # allowed. If the original
97
+ # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} must be
98
+ # preserved, a custom field should be used for storage. It is also suggested
99
+ # to group the locations that close to each other in the same job for better
100
+ # search experience.
100
101
  #
101
102
  # The maximum number of allowed characters is 500.
102
103
  # @!attribute [rw] application_info
103
104
  # @return [Google::Cloud::Talent::V4beta1::Job::ApplicationInfo]
104
- # Optional.
105
- #
106
- # Job application information.
105
+ # Optional. Job application information.
107
106
  # @!attribute [rw] job_benefits
108
107
  # @return [Array<Google::Cloud::Talent::V4beta1::JobBenefit>]
109
- # Optional.
110
- #
111
- # The benefits included with the job.
108
+ # Optional. The benefits included with the job.
112
109
  # @!attribute [rw] compensation_info
113
110
  # @return [Google::Cloud::Talent::V4beta1::CompensationInfo]
114
- # Optional.
115
- #
116
- # Job compensation information (a.k.a. "pay rate") i.e., the compensation
117
- # that will paid to the employee.
111
+ # Optional. Job compensation information (a.k.a. "pay rate") i.e., the
112
+ # compensation that will paid to the employee.
118
113
  # @!attribute [rw] custom_attributes
119
114
  # @return [Hash{String => Google::Cloud::Talent::V4beta1::CustomAttribute}]
120
- # Optional.
121
- #
122
- # A map of fields to hold both filterable and non-filterable custom job
123
- # attributes that are not covered by the provided structured fields.
115
+ # Optional. A map of fields to hold both filterable and non-filterable custom
116
+ # job attributes that are not covered by the provided structured fields.
124
117
  #
125
118
  # The keys of the map are strings up to 64 bytes and must match the
126
119
  # pattern: [a-zA-Z][a-zA-Z0-9_]*. For example, key0LikeThis or
@@ -133,37 +126,28 @@ module Google
133
126
  # is 50KB.
134
127
  # @!attribute [rw] degree_types
135
128
  # @return [Array<Google::Cloud::Talent::V4beta1::DegreeType>]
136
- # Optional.
137
- #
138
- # The desired education degrees for the job, such as Bachelors, Masters.
129
+ # Optional. The desired education degrees for the job, such as Bachelors,
130
+ # Masters.
139
131
  # @!attribute [rw] department
140
132
  # @return [String]
141
- # Optional.
142
- #
143
- # The department or functional area within the company with the open
144
- # position.
133
+ # Optional. The department or functional area within the company with the
134
+ # open position.
145
135
  #
146
136
  # The maximum number of allowed characters is 255.
147
137
  # @!attribute [rw] employment_types
148
138
  # @return [Array<Google::Cloud::Talent::V4beta1::EmploymentType>]
149
- # Optional.
150
- #
151
- # The employment type(s) of a job, for example,
139
+ # Optional. The employment type(s) of a job, for example,
152
140
  # {Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME full time} or
153
141
  # {Google::Cloud::Talent::V4beta1::EmploymentType::PART_TIME part time}.
154
142
  # @!attribute [rw] incentives
155
143
  # @return [String]
156
- # Optional.
157
- #
158
- # A description of bonus, commission, and other compensation
144
+ # Optional. A description of bonus, commission, and other compensation
159
145
  # incentives associated with the job not including salary or pay.
160
146
  #
161
147
  # The maximum number of allowed characters is 10,000.
162
148
  # @!attribute [rw] language_code
163
149
  # @return [String]
164
- # Optional.
165
- #
166
- # The language of the posting. This field is distinct from
150
+ # Optional. The language of the posting. This field is distinct from
167
151
  # any requirements for fluency that are associated with the job.
168
152
  #
169
153
  # Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
@@ -171,19 +155,18 @@ module Google
171
155
  # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
172
156
  # class="external" target="_blank" }.
173
157
  #
174
- # If this field is unspecified and {Google::Cloud::Talent::V4beta1::Job#description Job#description} is present, detected
175
- # language code based on {Google::Cloud::Talent::V4beta1::Job#description Job#description} is assigned, otherwise
176
- # defaults to 'en_US'.
158
+ # If this field is unspecified and
159
+ # {Google::Cloud::Talent::V4beta1::Job#description Job#description} is present,
160
+ # detected language code based on
161
+ # {Google::Cloud::Talent::V4beta1::Job#description Job#description} is assigned,
162
+ # otherwise defaults to 'en_US'.
177
163
  # @!attribute [rw] job_level
178
164
  # @return [Google::Cloud::Talent::V4beta1::JobLevel]
179
- # Optional.
180
- #
181
- # The experience level associated with the job, such as "Entry Level".
165
+ # Optional. The experience level associated with the job, such as "Entry
166
+ # Level".
182
167
  # @!attribute [rw] promotion_value
183
168
  # @return [Integer]
184
- # Optional.
185
- #
186
- # A promotion value of the job, as determined by the client.
169
+ # Optional. A promotion value of the job, as determined by the client.
187
170
  # The value determines the sort order of the jobs returned when searching for
188
171
  # jobs using the featured jobs search call, with higher promotional values
189
172
  # being returned first and ties being resolved by relevance sort. Only the
@@ -192,11 +175,10 @@ module Google
192
175
  # Default value is 0, and negative values are treated as 0.
193
176
  # @!attribute [rw] qualifications
194
177
  # @return [String]
195
- # Optional.
196
- #
197
- # A description of the qualifications required to perform the
178
+ # Optional. A description of the qualifications required to perform the
198
179
  # job. The use of this field is recommended
199
- # as an alternative to using the more general {Google::Cloud::Talent::V4beta1::Job#description description} field.
180
+ # as an alternative to using the more general
181
+ # {Google::Cloud::Talent::V4beta1::Job#description description} field.
200
182
  #
201
183
  # This field accepts and sanitizes HTML input, and also accepts
202
184
  # bold, italic, ordered list, and unordered list markup tags.
@@ -204,11 +186,9 @@ module Google
204
186
  # The maximum number of allowed characters is 10,000.
205
187
  # @!attribute [rw] responsibilities
206
188
  # @return [String]
207
- # Optional.
208
- #
209
- # A description of job responsibilities. The use of this field is
210
- # recommended as an alternative to using the more general {Google::Cloud::Talent::V4beta1::Job#description description}
211
- # field.
189
+ # Optional. A description of job responsibilities. The use of this field is
190
+ # recommended as an alternative to using the more general
191
+ # {Google::Cloud::Talent::V4beta1::Job#description description} field.
212
192
  #
213
193
  # This field accepts and sanitizes HTML input, and also accepts
214
194
  # bold, italic, ordered list, and unordered list markup tags.
@@ -216,41 +196,36 @@ module Google
216
196
  # The maximum number of allowed characters is 10,000.
217
197
  # @!attribute [rw] posting_region
218
198
  # @return [Google::Cloud::Talent::V4beta1::PostingRegion]
219
- # Optional.
220
- #
221
- # The job {Google::Cloud::Talent::V4beta1::PostingRegion PostingRegion} (for example, state, country) throughout
222
- # which the job is available. If this field is set, a {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter}
223
- # in a search query within the job region finds this job posting if an
224
- # exact location match isn't specified. If this field is set to
225
- # {Google::Cloud::Talent::V4beta1::PostingRegion::NATION PostingRegion::NATION} or {Google::Cloud::Talent::V4beta1::PostingRegion::ADMINISTRATIVE_AREA PostingRegion::ADMINISTRATIVE_AREA},
226
- # setting job {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} to the same location level as this field
227
- # is strongly recommended.
199
+ # Optional. The job
200
+ # {Google::Cloud::Talent::V4beta1::PostingRegion PostingRegion} (for example,
201
+ # state, country) throughout which the job is available. If this field is
202
+ # set, a {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} in a
203
+ # search query within the job region finds this job posting if an exact
204
+ # location match isn't specified. If this field is set to
205
+ # {Google::Cloud::Talent::V4beta1::PostingRegion::NATION PostingRegion::NATION} or
206
+ # {Google::Cloud::Talent::V4beta1::PostingRegion::ADMINISTRATIVE_AREA PostingRegion::ADMINISTRATIVE_AREA},
207
+ # setting job {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} to
208
+ # the same location level as this field is strongly recommended.
228
209
  # @!attribute [rw] visibility
229
210
  # @return [Google::Cloud::Talent::V4beta1::Visibility]
230
- # Optional.
231
- #
232
- # The visibility of the job.
211
+ # Optional. The visibility of the job.
233
212
  #
234
- # Defaults to {Google::Cloud::Talent::V4beta1::Visibility::ACCOUNT_ONLY Visibility::ACCOUNT_ONLY} if not specified.
213
+ # Defaults to
214
+ # {Google::Cloud::Talent::V4beta1::Visibility::ACCOUNT_ONLY Visibility::ACCOUNT_ONLY}
215
+ # if not specified.
235
216
  # @!attribute [rw] job_start_time
236
217
  # @return [Google::Protobuf::Timestamp]
237
- # Optional.
238
- #
239
- # The start timestamp of the job in UTC time zone. Typically this field
240
- # is used for contracting engagements. Invalid timestamps are ignored.
218
+ # Optional. The start timestamp of the job in UTC time zone. Typically this
219
+ # field is used for contracting engagements. Invalid timestamps are ignored.
241
220
  # @!attribute [rw] job_end_time
242
221
  # @return [Google::Protobuf::Timestamp]
243
- # Optional.
244
- #
245
- # The end timestamp of the job. Typically this field is used for contracting
246
- # engagements. Invalid timestamps are ignored.
222
+ # Optional. The end timestamp of the job. Typically this field is used for
223
+ # contracting engagements. Invalid timestamps are ignored.
247
224
  # @!attribute [rw] posting_publish_time
248
225
  # @return [Google::Protobuf::Timestamp]
249
- # Optional.
250
- #
251
- # The timestamp this job posting was most recently published. The default
252
- # value is the time the request arrives at the server. Invalid timestamps are
253
- # ignored.
226
+ # Optional. The timestamp this job posting was most recently published. The
227
+ # default value is the time the request arrives at the server. Invalid
228
+ # timestamps are ignored.
254
229
  # @!attribute [rw] posting_expire_time
255
230
  # @return [Google::Protobuf::Timestamp]
256
231
  # Optional but strongly recommended for the best service
@@ -258,23 +233,38 @@ module Google
258
233
  #
259
234
  # The expiration timestamp of the job. After this timestamp, the
260
235
  # job is marked as expired, and it no longer appears in search results. The
261
- # expired job can't be deleted or listed by the {DeleteJob} and
262
- # {ListJobs} APIs, but it can be retrieved with the {GetJob} API or
263
- # updated with the {UpdateJob} API. An expired job can be updated and
264
- # opened again by using a future expiration timestamp. Updating an expired
265
- # job fails if there is another existing open job with same
266
- # {Google::Cloud::Talent::V4beta1::Job#name company}[], {Language_code} and {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
236
+ # expired job can't be listed by the
237
+ # {Google::Cloud::Talent::V4beta1::JobService::ListJobs ListJobs} API, but it can
238
+ # be retrieved with the
239
+ # {Google::Cloud::Talent::V4beta1::JobService::GetJob GetJob} API or updated with
240
+ # the {Google::Cloud::Talent::V4beta1::JobService::UpdateJob UpdateJob} API or
241
+ # deleted with the
242
+ # {Google::Cloud::Talent::V4beta1::JobService::DeleteJob DeleteJob} API. An
243
+ # expired job can be updated and opened again by using a future expiration
244
+ # timestamp. Updating an expired job fails if there is another existing open
245
+ # job with same {Google::Cloud::Talent::V4beta1::Job#company company},
246
+ # {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
247
+ # {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
267
248
  #
268
249
  # The expired jobs are retained in our system for 90 days. However, the
269
- # overall expired job count cannot exceed 3 times the maximum of open jobs
270
- # count over the past week, otherwise jobs with earlier expire time are
271
- # cleaned first. Expired jobs are no longer accessible after they are cleaned
250
+ # overall expired job count cannot exceed 3 times the maximum number of
251
+ # open jobs over previous 7 days. If this threshold is exceeded,
252
+ # expired jobs are cleaned out in order of earliest expire time.
253
+ # Expired jobs are no longer accessible after they are cleaned
272
254
  # out.
273
255
  #
274
256
  # Invalid timestamps are ignored, and treated as expire time not provided.
275
257
  #
276
- # Timestamp before the instant request is made is considered valid, the job
277
- # will be treated as expired immediately.
258
+ # If the timestamp is before the instant request is made, the job
259
+ # is treated as expired immediately on creation. This kind of job can
260
+ # not be updated. And when creating a job with past timestamp, the
261
+ # {Google::Cloud::Talent::V4beta1::Job#posting_publish_time posting_publish_time}
262
+ # must be set before
263
+ # {Google::Cloud::Talent::V4beta1::Job#posting_expire_time posting_expire_time}.
264
+ # The purpose of this feature is to allow other objects, such as
265
+ # {Google::Cloud::Talent::V4beta1::Application Application}, to refer a job that
266
+ # didn't exist in the system prior to becoming expired. If you want to modify
267
+ # a job that was expired on creation, delete it and create a new one.
278
268
  #
279
269
  # If this value isn't provided at the time of job creation or is invalid,
280
270
  # the job posting expires after 30 days from the job's creation time. For
@@ -282,10 +272,13 @@ module Google
282
272
  # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
283
273
  #
284
274
  # If this value isn't provided on job update, it depends on the field masks
285
- # set by {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask UpdateJobRequest#update_mask}. If the field masks include
286
- # {Expiry_time}, or the masks are empty meaning that every field is
287
- # updated, the job posting expires after 30 days from the job's last
288
- # update time. Otherwise the expiration date isn't updated.
275
+ # set by
276
+ # {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask UpdateJobRequest#update_mask}.
277
+ # If the field masks include
278
+ # {Google::Cloud::Talent::V4beta1::Job#job_end_time job_end_time}, or the masks
279
+ # are empty meaning that every field is updated, the job posting expires
280
+ # after 30 days from the job's last update time. Otherwise the expiration
281
+ # date isn't updated.
289
282
  # @!attribute [rw] posting_create_time
290
283
  # @return [Google::Protobuf::Timestamp]
291
284
  # Output only. The timestamp when this job posting was created.
@@ -300,25 +293,19 @@ module Google
300
293
  # Output only. Derived details about the job posting.
301
294
  # @!attribute [rw] processing_options
302
295
  # @return [Google::Cloud::Talent::V4beta1::Job::ProcessingOptions]
303
- # Optional.
304
- #
305
- # Options for job processing.
296
+ # Optional. Options for job processing.
306
297
  class Job
307
298
  # Application related details of a job posting.
308
299
  # @!attribute [rw] emails
309
300
  # @return [Array<String>]
310
- # Optional.
311
- #
312
- # Use this field to specify email address(es) to which resumes or
301
+ # Optional. Use this field to specify email address(es) to which resumes or
313
302
  # applications can be sent.
314
303
  #
315
304
  # The maximum number of allowed characters for each entry is 255.
316
305
  # @!attribute [rw] instruction
317
306
  # @return [String]
318
- # Optional.
319
- #
320
- # Use this field to provide instructions, such as "Mail your application
321
- # to ...", that a candidate can follow to apply for the job.
307
+ # Optional. Use this field to provide instructions, such as "Mail your
308
+ # application to ...", that a candidate can follow to apply for the job.
322
309
  #
323
310
  # This field accepts and sanitizes HTML input, and also accepts
324
311
  # bold, italic, ordered list, and unordered list markup tags.
@@ -326,10 +313,8 @@ module Google
326
313
  # The maximum number of allowed characters is 3,000.
327
314
  # @!attribute [rw] uris
328
315
  # @return [Array<String>]
329
- # Optional.
330
- #
331
- # Use this URI field to direct an applicant to a website, for example to
332
- # link to an online application form.
316
+ # Optional. Use this URI field to direct an applicant to a website, for
317
+ # example to link to an online application form.
333
318
  #
334
319
  # The maximum number of allowed characters for each entry is 2,000.
335
320
  class ApplicationInfo; end
@@ -339,13 +324,18 @@ module Google
339
324
  # Derived details about the job posting.
340
325
  # @!attribute [rw] locations
341
326
  # @return [Array<Google::Cloud::Talent::V4beta1::Location>]
342
- # Structured locations of the job, resolved from {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses}.
327
+ # Structured locations of the job, resolved from
328
+ # {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses}.
343
329
  #
344
- # {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations locations} are exactly matched to {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} in the same
330
+ # {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations locations} are
331
+ # exactly matched to
332
+ # {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} in the same
345
333
  # order.
346
334
  # @!attribute [rw] job_categories
347
335
  # @return [Array<Google::Cloud::Talent::V4beta1::JobCategory>]
348
- # Job categories derived from {Google::Cloud::Talent::V4beta1::Job#title Job#title} and {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
336
+ # Job categories derived from
337
+ # {Google::Cloud::Talent::V4beta1::Job#title Job#title} and
338
+ # {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
349
339
  class DerivedInfo; end
350
340
 
351
341
  # Input only.
@@ -353,15 +343,11 @@ module Google
353
343
  # Options for job processing.
354
344
  # @!attribute [rw] disable_street_address_resolution
355
345
  # @return [true, false]
356
- # Optional.
357
- #
358
- # If set to `true`, the service does not attempt to resolve a
346
+ # Optional. If set to `true`, the service does not attempt to resolve a
359
347
  # more precise address for the job.
360
348
  # @!attribute [rw] html_sanitization
361
349
  # @return [Google::Cloud::Talent::V4beta1::HtmlSanitization]
362
- # Optional.
363
- #
364
- # Option for job HTML content sanitization. Applied fields are:
350
+ # Optional. Option for job HTML content sanitization. Applied fields are:
365
351
  #
366
352
  # * description
367
353
  # * applicationInfo.instruction
@@ -372,7 +358,8 @@ module Google
372
358
  # HTML tags in these fields may be stripped if sanitiazation isn't
373
359
  # disabled.
374
360
  #
375
- # Defaults to {Google::Cloud::Talent::V4beta1::HtmlSanitization::SIMPLE_FORMATTING_ONLY HtmlSanitization::SIMPLE_FORMATTING_ONLY}.
361
+ # Defaults to
362
+ # {Google::Cloud::Talent::V4beta1::HtmlSanitization::SIMPLE_FORMATTING_ONLY HtmlSanitization::SIMPLE_FORMATTING_ONLY}.
376
363
  class ProcessingOptions; end
377
364
  end
378
365
  end