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