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.
- checksums.yaml +4 -4
- data/lib/google/cloud/talent.rb +28 -0
- data/lib/google/cloud/talent/v4beta1.rb +57 -0
- data/lib/google/cloud/talent/v4beta1/application_pb.rb +1 -2
- data/lib/google/cloud/talent/v4beta1/application_service_client.rb +26 -24
- data/lib/google/cloud/talent/v4beta1/application_service_pb.rb +1 -0
- data/lib/google/cloud/talent/v4beta1/batch_pb.rb +30 -0
- data/lib/google/cloud/talent/v4beta1/common_pb.rb +1 -0
- data/lib/google/cloud/talent/v4beta1/company_pb.rb +1 -1
- data/lib/google/cloud/talent/v4beta1/company_service_client.rb +28 -29
- data/lib/google/cloud/talent/v4beta1/company_service_pb.rb +1 -0
- data/lib/google/cloud/talent/v4beta1/completion_client.rb +36 -32
- data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb +1 -0
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application.rb +14 -33
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application_service.rb +18 -27
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/common.rb +144 -135
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company.rb +19 -36
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company_service.rb +20 -32
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/completion_service.rb +30 -32
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event.rb +121 -41
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event_service.rb +3 -7
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/filters.rb +239 -281
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/histogram.rb +9 -3
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job.rb +129 -142
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job_service.rb +280 -215
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile.rb +198 -338
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile_service.rb +128 -108
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant.rb +11 -13
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant_service.rb +16 -27
- data/lib/google/cloud/talent/v4beta1/doc/google/longrunning/operations.rb +51 -0
- data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/any.rb +131 -0
- data/lib/google/cloud/talent/v4beta1/doc/google/rpc/status.rb +87 -0
- data/lib/google/cloud/talent/v4beta1/doc/google/type/postal_address.rb +1 -1
- data/lib/google/cloud/talent/v4beta1/event_pb.rb +1 -1
- data/lib/google/cloud/talent/v4beta1/event_service_client.rb +13 -10
- data/lib/google/cloud/talent/v4beta1/event_service_pb.rb +1 -0
- data/lib/google/cloud/talent/v4beta1/filters_pb.rb +6 -1
- data/lib/google/cloud/talent/v4beta1/histogram_pb.rb +1 -1
- data/lib/google/cloud/talent/v4beta1/job_pb.rb +1 -1
- data/lib/google/cloud/talent/v4beta1/job_service_client.rb +528 -301
- data/lib/google/cloud/talent/v4beta1/job_service_client_config.json +10 -0
- data/lib/google/cloud/talent/v4beta1/job_service_pb.rb +13 -0
- data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +16 -8
- data/lib/google/cloud/talent/v4beta1/profile_service_client.rb +118 -91
- data/lib/google/cloud/talent/v4beta1/profile_service_pb.rb +3 -0
- data/lib/google/cloud/talent/v4beta1/profile_service_services_pb.rb +3 -1
- data/lib/google/cloud/talent/v4beta1/tenant_pb.rb +1 -1
- data/lib/google/cloud/talent/v4beta1/tenant_service_client.rb +24 -24
- data/lib/google/cloud/talent/v4beta1/tenant_service_pb.rb +1 -0
- data/lib/google/cloud/talent/version.rb +22 -0
- metadata +8 -9
- data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/resume_service.rb +0 -98
- data/lib/google/cloud/talent/v4beta1/resume_service_client.rb +0 -296
- data/lib/google/cloud/talent/v4beta1/resume_service_client_config.json +0 -31
- data/lib/google/cloud/talent/v4beta1/resume_service_pb.rb +0 -37
- data/lib/google/cloud/talent/v4beta1/resume_service_services_pb.rb +0 -75
@@ -22,9 +22,7 @@ module Google
|
|
22
22
|
# Create job request.
|
23
23
|
# @!attribute [rw] parent
|
24
24
|
# @return [String]
|
25
|
-
# Required.
|
26
|
-
#
|
27
|
-
# The resource name of the tenant under which the job is created.
|
25
|
+
# Required. The resource name of the tenant under which the job is created.
|
28
26
|
#
|
29
27
|
# The format is "projects/{project_id}/tenants/{tenant_id}", for example,
|
30
28
|
# "projects/api-test-project/tenant/foo".
|
@@ -33,9 +31,7 @@ module Google
|
|
33
31
|
# example, "projects/api-test-project".
|
34
32
|
# @!attribute [rw] job
|
35
33
|
# @return [Google::Cloud::Talent::V4beta1::Job]
|
36
|
-
# Required.
|
37
|
-
#
|
38
|
-
# The Job to be created.
|
34
|
+
# Required. The Job to be created.
|
39
35
|
class CreateJobRequest; end
|
40
36
|
|
41
37
|
# Input only.
|
@@ -43,9 +39,7 @@ module Google
|
|
43
39
|
# Get job request.
|
44
40
|
# @!attribute [rw] name
|
45
41
|
# @return [String]
|
46
|
-
# Required.
|
47
|
-
#
|
48
|
-
# The resource name of the job to retrieve.
|
42
|
+
# Required. The resource name of the job to retrieve.
|
49
43
|
#
|
50
44
|
# The format is
|
51
45
|
# "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
|
@@ -60,16 +54,16 @@ module Google
|
|
60
54
|
# Update job request.
|
61
55
|
# @!attribute [rw] job
|
62
56
|
# @return [Google::Cloud::Talent::V4beta1::Job]
|
63
|
-
# Required.
|
64
|
-
#
|
65
|
-
# The Job to be updated.
|
57
|
+
# Required. The Job to be updated.
|
66
58
|
# @!attribute [rw] update_mask
|
67
59
|
# @return [Google::Protobuf::FieldMask]
|
68
60
|
# Optional but strongly recommended to be provided for the best service
|
69
61
|
# experience.
|
70
62
|
#
|
71
|
-
# If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
|
72
|
-
#
|
63
|
+
# If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
|
64
|
+
# is provided, only the specified fields in
|
65
|
+
# {Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated.
|
66
|
+
# Otherwise all the fields are updated.
|
73
67
|
#
|
74
68
|
# A field mask to restrict the fields that are updated. Only
|
75
69
|
# top level fields of {Google::Cloud::Talent::V4beta1::Job Job} are supported.
|
@@ -80,9 +74,7 @@ module Google
|
|
80
74
|
# Delete job request.
|
81
75
|
# @!attribute [rw] name
|
82
76
|
# @return [String]
|
83
|
-
# Required.
|
84
|
-
#
|
85
|
-
# The resource name of the job to be deleted.
|
77
|
+
# Required. The resource name of the job to be deleted.
|
86
78
|
#
|
87
79
|
# The format is
|
88
80
|
# "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
|
@@ -97,9 +89,7 @@ module Google
|
|
97
89
|
# Batch delete jobs request.
|
98
90
|
# @!attribute [rw] parent
|
99
91
|
# @return [String]
|
100
|
-
# Required.
|
101
|
-
#
|
102
|
-
# The resource name of the tenant under which the job is created.
|
92
|
+
# Required. The resource name of the tenant under which the job is created.
|
103
93
|
#
|
104
94
|
# The format is "projects/{project_id}/tenants/{tenant_id}", for example,
|
105
95
|
# "projects/api-test-project/tenant/foo".
|
@@ -108,9 +98,7 @@ module Google
|
|
108
98
|
# example, "projects/api-test-project".
|
109
99
|
# @!attribute [rw] filter
|
110
100
|
# @return [String]
|
111
|
-
# Required.
|
112
|
-
#
|
113
|
-
# The filter string specifies the jobs to be deleted.
|
101
|
+
# Required. The filter string specifies the jobs to be deleted.
|
114
102
|
#
|
115
103
|
# Supported operator: =, AND
|
116
104
|
#
|
@@ -128,9 +116,7 @@ module Google
|
|
128
116
|
# List jobs request.
|
129
117
|
# @!attribute [rw] parent
|
130
118
|
# @return [String]
|
131
|
-
# Required.
|
132
|
-
#
|
133
|
-
# The resource name of the tenant under which the job is created.
|
119
|
+
# Required. The resource name of the tenant under which the job is created.
|
134
120
|
#
|
135
121
|
# The format is "projects/{project_id}/tenants/{tenant_id}", for example,
|
136
122
|
# "projects/api-test-project/tenant/foo".
|
@@ -139,9 +125,7 @@ module Google
|
|
139
125
|
# example, "projects/api-test-project".
|
140
126
|
# @!attribute [rw] filter
|
141
127
|
# @return [String]
|
142
|
-
# Required.
|
143
|
-
#
|
144
|
-
# The filter string specifies the jobs to be enumerated.
|
128
|
+
# Required. The filter string specifies the jobs to be enumerated.
|
145
129
|
#
|
146
130
|
# Supported operator: =, AND
|
147
131
|
#
|
@@ -161,26 +145,24 @@ module Google
|
|
161
145
|
# status = "EXPIRED"
|
162
146
|
# @!attribute [rw] page_token
|
163
147
|
# @return [String]
|
164
|
-
# Optional.
|
165
|
-
#
|
166
|
-
# The starting point of a query result.
|
148
|
+
# Optional. The starting point of a query result.
|
167
149
|
# @!attribute [rw] page_size
|
168
150
|
# @return [Integer]
|
169
|
-
# Optional.
|
151
|
+
# Optional. The maximum number of jobs to be returned per page of results.
|
170
152
|
#
|
171
|
-
#
|
172
|
-
#
|
173
|
-
#
|
174
|
-
# page size is 1000. Otherwise, the maximum allowed page
|
153
|
+
# If {Google::Cloud::Talent::V4beta1::ListJobsRequest#job_view job_view} is set
|
154
|
+
# to
|
155
|
+
# {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_ID_ONLY JobView::JOB_VIEW_ID_ONLY},
|
156
|
+
# the maximum allowed page size is 1000. Otherwise, the maximum allowed page
|
157
|
+
# size is 100.
|
175
158
|
#
|
176
159
|
# Default is 100 if empty or a number < 1 is specified.
|
177
160
|
# @!attribute [rw] job_view
|
178
161
|
# @return [Google::Cloud::Talent::V4beta1::JobView]
|
179
|
-
# Optional.
|
180
|
-
#
|
181
|
-
#
|
182
|
-
#
|
183
|
-
# specified.
|
162
|
+
# Optional. The desired job attributes returned for jobs in the
|
163
|
+
# search response. Defaults to
|
164
|
+
# {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView::JOB_VIEW_FULL}
|
165
|
+
# if no value is specified.
|
184
166
|
class ListJobsRequest; end
|
185
167
|
|
186
168
|
# Output only.
|
@@ -206,9 +188,7 @@ module Google
|
|
206
188
|
# The Request body of the `SearchJobs` call.
|
207
189
|
# @!attribute [rw] parent
|
208
190
|
# @return [String]
|
209
|
-
# Required.
|
210
|
-
#
|
211
|
-
# The resource name of the tenant to search within.
|
191
|
+
# Required. The resource name of the tenant to search within.
|
212
192
|
#
|
213
193
|
# The format is "projects/{project_id}/tenants/{tenant_id}", for example,
|
214
194
|
# "projects/api-test-project/tenant/foo".
|
@@ -217,38 +197,30 @@ module Google
|
|
217
197
|
# example, "projects/api-test-project".
|
218
198
|
# @!attribute [rw] search_mode
|
219
199
|
# @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
|
220
|
-
# Optional.
|
221
|
-
#
|
222
|
-
# Mode of a search.
|
200
|
+
# Optional. Mode of a search.
|
223
201
|
#
|
224
|
-
# Defaults to
|
202
|
+
# Defaults to
|
203
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
|
225
204
|
# @!attribute [rw] request_metadata
|
226
205
|
# @return [Google::Cloud::Talent::V4beta1::RequestMetadata]
|
227
|
-
# Required.
|
228
|
-
#
|
229
|
-
#
|
230
|
-
# search quality of the service.. The identifiers, (such as `user_id`) are
|
231
|
-
# provided by users, and must be unique and consistent.
|
206
|
+
# Required. The meta information collected about the job searcher, used to
|
207
|
+
# improve the search quality of the service. The identifiers (such as
|
208
|
+
# `user_id`) are provided by users, and must be unique and consistent.
|
232
209
|
# @!attribute [rw] job_query
|
233
210
|
# @return [Google::Cloud::Talent::V4beta1::JobQuery]
|
234
|
-
# Optional.
|
235
|
-
#
|
236
|
-
# Query used to search against jobs, such as keyword, location filters, etc.
|
211
|
+
# Optional. Query used to search against jobs, such as keyword, location
|
212
|
+
# filters, etc.
|
237
213
|
# @!attribute [rw] enable_broadening
|
238
214
|
# @return [true, false]
|
239
|
-
# Optional.
|
240
|
-
#
|
241
|
-
#
|
242
|
-
# Broadened queries append results to the end of the matching results
|
243
|
-
# list.
|
215
|
+
# Optional. Controls whether to broaden the search when it produces sparse
|
216
|
+
# results. Broadened queries append results to the end of the matching
|
217
|
+
# results list.
|
244
218
|
#
|
245
219
|
# Defaults to false.
|
246
220
|
# @!attribute [rw] require_precise_result_size
|
247
221
|
# @return [true, false]
|
248
|
-
# Optional.
|
249
|
-
#
|
250
|
-
# Controls if the search job request requires the return of a precise
|
251
|
-
# count of the first 300 results. Setting this to `true` ensures
|
222
|
+
# Optional. Controls if the search job request requires the return of a
|
223
|
+
# precise count of the first 300 results. Setting this to `true` ensures
|
252
224
|
# consistency in the number of results per page. Best practice is to set this
|
253
225
|
# value to true if a client allows users to jump directly to a
|
254
226
|
# non-sequential search results page.
|
@@ -258,9 +230,8 @@ module Google
|
|
258
230
|
# Defaults to false.
|
259
231
|
# @!attribute [rw] histogram_queries
|
260
232
|
# @return [Array<Google::Cloud::Talent::V4beta1::HistogramQuery>]
|
261
|
-
# Optional.
|
262
|
-
#
|
263
|
-
# An expression specifies a histogram request against matching jobs.
|
233
|
+
# Optional. An expression specifies a histogram request against matching
|
234
|
+
# jobs.
|
264
235
|
#
|
265
236
|
# Expression syntax is an aggregation function call with histogram facets and
|
266
237
|
# other options.
|
@@ -292,19 +263,30 @@ module Google
|
|
292
263
|
#
|
293
264
|
# Job histogram facets:
|
294
265
|
#
|
295
|
-
# *
|
296
|
-
#
|
297
|
-
# * employment_type: histogram by
|
266
|
+
# * company_display_name: histogram by
|
267
|
+
# {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
|
268
|
+
# * employment_type: histogram by
|
269
|
+
# {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types},
|
270
|
+
# for example,
|
298
271
|
# "FULL_TIME", "PART_TIME".
|
299
|
-
# * company_size: histogram by
|
300
|
-
#
|
301
|
-
#
|
272
|
+
# * company_size: histogram by
|
273
|
+
# {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
|
274
|
+
# "SMALL", "MEDIUM", "BIG".
|
275
|
+
# * publish_time_in_month: histogram by the
|
276
|
+
# {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
|
277
|
+
# in months.
|
302
278
|
# Must specify list of numeric buckets in spec.
|
303
|
-
# * publish_time_in_year: histogram by the
|
279
|
+
# * publish_time_in_year: histogram by the
|
280
|
+
# {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
|
281
|
+
# in years.
|
304
282
|
# Must specify list of numeric buckets in spec.
|
305
|
-
# *
|
283
|
+
# * degree_types: histogram by the
|
284
|
+
# {Google::Cloud::Talent::V4beta1::Job#degree_types Job#degree_types}, for
|
285
|
+
# example,
|
306
286
|
# "Bachelors", "Masters".
|
307
|
-
# * job_level: histogram by the
|
287
|
+
# * job_level: histogram by the
|
288
|
+
# {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example,
|
289
|
+
# "Entry
|
308
290
|
# Level".
|
309
291
|
# * country: histogram by the country code of jobs, for example, "US", "FR".
|
310
292
|
# * admin1: histogram by the admin1 code of jobs, which is a global
|
@@ -316,51 +298,59 @@ module Google
|
|
316
298
|
# * admin1_country: histogram by a combination of the "admin1 code, country",
|
317
299
|
# for example, "CA, US", "IL, US".
|
318
300
|
# * city_coordinate: histogram by the city center's GPS coordinates (latitude
|
319
|
-
# and longitude), for example, 37.4038522,-122.0987765. Since the
|
320
|
-
# of a city center can change, customers may need to refresh
|
321
|
-
# periodically.
|
322
|
-
# * locale: histogram by the
|
301
|
+
# and longitude), for example, 37.4038522,-122.0987765. Since the
|
302
|
+
# coordinates of a city center can change, customers may need to refresh
|
303
|
+
# them periodically.
|
304
|
+
# * locale: histogram by the
|
305
|
+
# {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
|
306
|
+
# example, "en-US",
|
323
307
|
# "fr-FR".
|
324
|
-
# * language: histogram by the language subtag of the
|
308
|
+
# * language: histogram by the language subtag of the
|
309
|
+
# {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code},
|
325
310
|
# for example, "en", "fr".
|
326
|
-
# * category: histogram by the
|
311
|
+
# * category: histogram by the
|
312
|
+
# {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
|
327
313
|
# "COMPUTER_AND_IT", "HEALTHCARE".
|
328
|
-
# * base_compensation_unit: histogram by the
|
329
|
-
#
|
314
|
+
# * base_compensation_unit: histogram by the
|
315
|
+
# {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo::CompensationUnit}
|
316
|
+
# of base salary, for example, "WEEKLY", "MONTHLY".
|
330
317
|
# * base_compensation: histogram by the base salary. Must specify list of
|
331
318
|
# numeric buckets to group results by.
|
332
319
|
# * annualized_base_compensation: histogram by the base annualized salary.
|
333
320
|
# Must specify list of numeric buckets to group results by.
|
334
321
|
# * annualized_total_compensation: histogram by the total annualized salary.
|
335
322
|
# Must specify list of numeric buckets to group results by.
|
336
|
-
# * string_custom_attribute: histogram by string
|
323
|
+
# * string_custom_attribute: histogram by string
|
324
|
+
# {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
|
337
325
|
# Values can be accessed via square bracket notations like
|
338
326
|
# string_custom_attribute["key1"].
|
339
|
-
# * numeric_custom_attribute: histogram by numeric
|
327
|
+
# * numeric_custom_attribute: histogram by numeric
|
328
|
+
# {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
|
340
329
|
# Values can be accessed via square bracket notations like
|
341
330
|
# numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
|
342
331
|
# group results by.
|
343
332
|
#
|
344
333
|
# Example expressions:
|
345
|
-
#
|
346
|
-
# * count(
|
347
|
-
#
|
348
|
-
#
|
349
|
-
# * count(
|
350
|
-
#
|
334
|
+
#
|
335
|
+
# * `count(admin1)`
|
336
|
+
# * `count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000),
|
337
|
+
# bucket(100000, MAX)])`
|
338
|
+
# * `count(string_custom_attribute["some-string-custom-attribute"])`
|
339
|
+
# * `count(numeric_custom_attribute["some-numeric-custom-attribute"],
|
340
|
+
# [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])`
|
351
341
|
# @!attribute [rw] job_view
|
352
342
|
# @return [Google::Cloud::Talent::V4beta1::JobView]
|
353
|
-
# Optional.
|
354
|
-
#
|
355
|
-
#
|
356
|
-
#
|
343
|
+
# Optional. The desired job attributes returned for jobs in the search
|
344
|
+
# response. Defaults to
|
345
|
+
# {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView::JOB_VIEW_SMALL}
|
346
|
+
# if no value is specified.
|
357
347
|
# @!attribute [rw] offset
|
358
348
|
# @return [Integer]
|
359
|
-
# Optional.
|
360
|
-
#
|
361
|
-
#
|
362
|
-
#
|
363
|
-
#
|
349
|
+
# Optional. An integer that specifies the current offset (that is, starting
|
350
|
+
# result location, amongst the jobs deemed by the API as relevant) in search
|
351
|
+
# results. This field is only considered if
|
352
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
|
353
|
+
# unset.
|
364
354
|
#
|
365
355
|
# For example, 0 means to return results starting from the first matching
|
366
356
|
# job, and 10 means to return from the 11th job. This can be used for
|
@@ -368,138 +358,140 @@ module Google
|
|
368
358
|
# from the second page).
|
369
359
|
# @!attribute [rw] page_size
|
370
360
|
# @return [Integer]
|
371
|
-
# Optional.
|
372
|
-
#
|
373
|
-
# A limit on the number of jobs returned in the search results.
|
361
|
+
# Optional. A limit on the number of jobs returned in the search results.
|
374
362
|
# Increasing this value above the default value of 10 can increase search
|
375
363
|
# response time. The value can be between 1 and 100.
|
376
364
|
# @!attribute [rw] page_token
|
377
365
|
# @return [String]
|
378
|
-
# Optional.
|
379
|
-
#
|
380
|
-
#
|
381
|
-
#
|
382
|
-
# an explanation of how to obtain the next set of query results.
|
366
|
+
# Optional. The token specifying the current offset within
|
367
|
+
# search results. See
|
368
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse#next_page_token}
|
369
|
+
# for an explanation of how to obtain the next set of query results.
|
383
370
|
# @!attribute [rw] order_by
|
384
371
|
# @return [String]
|
385
|
-
# Optional.
|
386
|
-
#
|
387
|
-
#
|
388
|
-
# "relevance desc".
|
372
|
+
# Optional. The criteria determining how search results are sorted. Default
|
373
|
+
# is
|
374
|
+
# `"relevance desc"`.
|
389
375
|
#
|
390
376
|
# Supported options are:
|
391
377
|
#
|
392
|
-
# * "relevance desc"
|
378
|
+
# * `"relevance desc"`: By relevance descending, as determined by the API
|
393
379
|
# algorithms. Relevance thresholding of query results is only available
|
394
380
|
# with this ordering.
|
395
|
-
# * "
|
381
|
+
# * `"posting_publish_time desc"`: By
|
382
|
+
# {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
|
383
|
+
# descending.
|
384
|
+
# * `"posting_update_time desc"`: By
|
385
|
+
# {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
|
396
386
|
# descending.
|
397
|
-
# *
|
387
|
+
# * `"title"`: By {Google::Cloud::Talent::V4beta1::Job#title Job#title}
|
388
|
+
# ascending.
|
389
|
+
# * `"title desc"`: By {Google::Cloud::Talent::V4beta1::Job#title Job#title}
|
398
390
|
# descending.
|
399
|
-
# * "
|
400
|
-
#
|
401
|
-
#
|
402
|
-
#
|
403
|
-
#
|
404
|
-
#
|
405
|
-
#
|
406
|
-
#
|
407
|
-
#
|
408
|
-
#
|
409
|
-
#
|
410
|
-
#
|
411
|
-
#
|
412
|
-
#
|
413
|
-
#
|
414
|
-
#
|
415
|
-
#
|
416
|
-
#
|
417
|
-
#
|
418
|
-
# {SearchJobsRequest#
|
419
|
-
#
|
420
|
-
#
|
421
|
-
#
|
422
|
-
#
|
423
|
-
#
|
424
|
-
#
|
425
|
-
#
|
426
|
-
#
|
427
|
-
#
|
428
|
-
#
|
429
|
-
#
|
430
|
-
#
|
431
|
-
#
|
432
|
-
#
|
433
|
-
#
|
434
|
-
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest#diversification_level
|
391
|
+
# * `"annualized_base_compensation"`: By job's
|
392
|
+
# {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
|
393
|
+
# ascending. Jobs whose annualized base compensation is unspecified are put
|
394
|
+
# at the end of search results.
|
395
|
+
# * `"annualized_base_compensation desc"`: By job's
|
396
|
+
# {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
|
397
|
+
# descending. Jobs whose annualized base compensation is unspecified are
|
398
|
+
# put at the end of search results.
|
399
|
+
# * `"annualized_total_compensation"`: By job's
|
400
|
+
# {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
|
401
|
+
# ascending. Jobs whose annualized base compensation is unspecified are put
|
402
|
+
# at the end of search results.
|
403
|
+
# * `"annualized_total_compensation desc"`: By job's
|
404
|
+
# {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
|
405
|
+
# descending. Jobs whose annualized base compensation is unspecified are
|
406
|
+
# put at the end of search results.
|
407
|
+
# * `"custom_ranking desc"`: By the relevance score adjusted to the
|
408
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression SearchJobsRequest::CustomRankingInfo#ranking_expression}
|
409
|
+
# with weight factor assigned by
|
410
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#importance_level SearchJobsRequest::CustomRankingInfo#importance_level}
|
411
|
+
# in descending order.
|
412
|
+
# * Location sorting: Use the special syntax to order jobs by distance:<br>
|
413
|
+
# `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
|
414
|
+
# `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
|
415
|
+
# `"distance_from('Hawaii'), distance_from('Puerto Rico')"`: Order by
|
416
|
+
# multiple locations. See details below.<br>
|
417
|
+
# `"distance_from('Hawaii'), distance_from(19.89, 155.5)"`: Order by
|
418
|
+
# multiple locations. See details below.<br>
|
419
|
+
# The string can have a maximum of 256 characters. When multiple distance
|
420
|
+
# centers are provided, a job that is close to any of the distance centers
|
421
|
+
# would have a high rank. When a job has multiple locations, the job
|
422
|
+
# location closest to one of the distance centers will be used. Jobs that
|
423
|
+
# don't have locations will be ranked at the bottom. Distance is calculated
|
424
|
+
# with a precision of 11.3 meters (37.4 feet). Diversification strategy is
|
425
|
+
# still applied unless explicitly disabled in
|
426
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest#diversification_level diversification_level}.
|
435
427
|
# @!attribute [rw] diversification_level
|
436
428
|
# @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel]
|
437
|
-
# Optional.
|
438
|
-
#
|
439
|
-
# Controls whether highly similar jobs are returned next to each other in
|
440
|
-
# the search results. Jobs are identified as highly similar based on
|
429
|
+
# Optional. Controls whether highly similar jobs are returned next to each
|
430
|
+
# other in the search results. Jobs are identified as highly similar based on
|
441
431
|
# their titles, job categories, and locations. Highly similar results are
|
442
432
|
# clustered so that only one representative job of the cluster is
|
443
433
|
# displayed to the job seeker higher up in the results, with the other jobs
|
444
434
|
# being displayed lower down in the results.
|
445
435
|
#
|
446
|
-
# Defaults to
|
447
|
-
#
|
436
|
+
# Defaults to
|
437
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE}
|
438
|
+
# if no value is specified.
|
448
439
|
# @!attribute [rw] custom_ranking_info
|
449
440
|
# @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo]
|
450
|
-
# Optional.
|
451
|
-
#
|
452
|
-
# Controls over how job documents get ranked on top of existing relevance
|
453
|
-
# score (determined by API algorithm).
|
441
|
+
# Optional. Controls over how job documents get ranked on top of existing
|
442
|
+
# relevance score (determined by API algorithm).
|
454
443
|
# @!attribute [rw] disable_keyword_match
|
455
444
|
# @return [true, false]
|
456
|
-
# Optional.
|
457
|
-
#
|
458
|
-
#
|
459
|
-
# {Google::Cloud::Talent::V4beta1::Job#
|
460
|
-
# {Google::Cloud::Talent::V4beta1::Job#
|
461
|
-
#
|
462
|
-
#
|
463
|
-
#
|
464
|
-
#
|
465
|
-
#
|
445
|
+
# Optional. Controls whether to disable exact keyword match on
|
446
|
+
# {Google::Cloud::Talent::V4beta1::Job#title Job#title},
|
447
|
+
# {Google::Cloud::Talent::V4beta1::Job#description Job#description},
|
448
|
+
# {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name},
|
449
|
+
# {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses},
|
450
|
+
# {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When
|
451
|
+
# disable keyword match is turned off, a keyword match returns jobs that do
|
452
|
+
# not match given category filters when there are matching keywords. For
|
453
|
+
# example, for the query "program manager," a result is returned even if the
|
454
|
+
# job posting has the title "software developer," which doesn't fall into
|
455
|
+
# "program manager" ontology, but does have "program manager" appearing in
|
456
|
+
# its description.
|
466
457
|
#
|
467
458
|
# For queries like "cloud" that don't contain title or
|
468
459
|
# location specific ontology, jobs with "cloud" keyword matches are returned
|
469
460
|
# regardless of this flag's value.
|
470
461
|
#
|
471
|
-
#
|
472
|
-
# {Company#
|
473
|
-
# globally matched custom field/attribute string values
|
474
|
-
# keyword match improves recall of subsequent search
|
462
|
+
# Use
|
463
|
+
# {Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company#keyword_searchable_job_custom_attributes}
|
464
|
+
# if company-specific globally matched custom field/attribute string values
|
465
|
+
# are needed. Enabling keyword match improves recall of subsequent search
|
466
|
+
# requests.
|
475
467
|
#
|
476
468
|
# Defaults to false.
|
477
469
|
class SearchJobsRequest
|
478
470
|
# Input only.
|
479
471
|
#
|
480
|
-
# Custom ranking information for
|
472
|
+
# Custom ranking information for
|
473
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
|
481
474
|
# @!attribute [rw] importance_level
|
482
475
|
# @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel]
|
483
|
-
# Required.
|
484
|
-
#
|
485
|
-
#
|
486
|
-
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression} gets applied to job's final
|
487
|
-
# ranking position.
|
476
|
+
# Required. Controls over how important the score of
|
477
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression}
|
478
|
+
# gets applied to job's final ranking position.
|
488
479
|
#
|
489
480
|
# An error is thrown if not specified.
|
490
481
|
# @!attribute [rw] ranking_expression
|
491
482
|
# @return [String]
|
492
|
-
# Required.
|
493
|
-
#
|
494
|
-
#
|
495
|
-
#
|
496
|
-
# and relevance score is used to determine job's final ranking position.
|
483
|
+
# Required. Controls over how job documents get ranked on top of existing
|
484
|
+
# relevance score (determined by API algorithm). The product of ranking
|
485
|
+
# expression and relevance score is used to determine job's final ranking
|
486
|
+
# position.
|
497
487
|
#
|
498
488
|
# The syntax for this expression is a subset of Google SQL syntax.
|
499
489
|
#
|
500
490
|
# Supported operators are: +, -, *, /, where the left and right side of
|
501
|
-
# the operator is either a numeric
|
502
|
-
#
|
491
|
+
# the operator is either a numeric
|
492
|
+
# {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}
|
493
|
+
# key, integer/double value or an expression that can be evaluated to a
|
494
|
+
# number.
|
503
495
|
#
|
504
496
|
# Parenthesis are supported to adjust calculation precedence. The
|
505
497
|
# expression must be < 100 characters in length.
|
@@ -507,7 +499,8 @@ module Google
|
|
507
499
|
# Sample ranking expression
|
508
500
|
# (year + 25) * 0.25 - (freshness / 0.5)
|
509
501
|
class CustomRankingInfo
|
510
|
-
# The importance level for
|
502
|
+
# The importance level for
|
503
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression}.
|
511
504
|
module ImportanceLevel
|
512
505
|
# Default value if the importance level isn't specified.
|
513
506
|
IMPORTANCE_LEVEL_UNSPECIFIED = 0
|
@@ -589,7 +582,8 @@ module Google
|
|
589
582
|
# Response for SearchJob method.
|
590
583
|
# @!attribute [rw] matching_jobs
|
591
584
|
# @return [Array<Google::Cloud::Talent::V4beta1::SearchJobsResponse::MatchingJob>]
|
592
|
-
# The Job entities that match the specified
|
585
|
+
# The Job entities that match the specified
|
586
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
|
593
587
|
# @!attribute [rw] histogram_query_results
|
594
588
|
# @return [Array<Google::Cloud::Talent::V4beta1::HistogramQueryResult>]
|
595
589
|
# The histogram results that match with specified
|
@@ -601,19 +595,23 @@ module Google
|
|
601
595
|
# @!attribute [rw] location_filters
|
602
596
|
# @return [Array<Google::Cloud::Talent::V4beta1::Location>]
|
603
597
|
# The location filters that the service applied to the specified query. If
|
604
|
-
# any filters are lat-lng based, the
|
605
|
-
# {
|
598
|
+
# any filters are lat-lng based, the
|
599
|
+
# {Google::Cloud::Talent::V4beta1::Location#location_type Location#location_type}
|
600
|
+
# is
|
601
|
+
# {Google::Cloud::Talent::V4beta1::Location::LocationType::LOCATION_TYPE_UNSPECIFIED Location::LocationType::LOCATION_TYPE_UNSPECIFIED}.
|
606
602
|
# @!attribute [rw] estimated_total_size
|
607
603
|
# @return [Integer]
|
608
604
|
# An estimation of the number of jobs that match the specified query.
|
609
605
|
#
|
610
606
|
# This number isn't guaranteed to be accurate. For accurate results,
|
611
|
-
# see
|
607
|
+
# see
|
608
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest#require_precise_result_size SearchJobsRequest#require_precise_result_size}.
|
612
609
|
# @!attribute [rw] total_size
|
613
610
|
# @return [Integer]
|
614
611
|
# The precise result count, which is available only if the client set
|
615
|
-
# {
|
616
|
-
# is the last page of results. Otherwise, the
|
612
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest#require_precise_result_size SearchJobsRequest#require_precise_result_size}
|
613
|
+
# to `true`, or if the response is the last page of results. Otherwise, the
|
614
|
+
# value is `-1`.
|
617
615
|
# @!attribute [rw] metadata
|
618
616
|
# @return [Google::Cloud::Talent::V4beta1::ResponseMetadata]
|
619
617
|
# Additional information for the API invocation, such as the request
|
@@ -633,25 +631,30 @@ module Google
|
|
633
631
|
class SearchJobsResponse
|
634
632
|
# Output only.
|
635
633
|
#
|
636
|
-
# Job entry with metadata inside
|
634
|
+
# Job entry with metadata inside
|
635
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse}.
|
637
636
|
# @!attribute [rw] job
|
638
637
|
# @return [Google::Cloud::Talent::V4beta1::Job]
|
639
|
-
# Job resource that matches the specified
|
638
|
+
# Job resource that matches the specified
|
639
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
|
640
640
|
# @!attribute [rw] job_summary
|
641
641
|
# @return [String]
|
642
642
|
# A summary of the job with core information that's displayed on the search
|
643
643
|
# results listing page.
|
644
644
|
# @!attribute [rw] job_title_snippet
|
645
645
|
# @return [String]
|
646
|
-
# Contains snippets of text from the
|
647
|
-
#
|
648
|
-
# query keywords
|
646
|
+
# Contains snippets of text from the
|
647
|
+
# {Google::Cloud::Talent::V4beta1::Job#title Job#title} field most closely
|
648
|
+
# matching a search query's keywords, if available. The matching query
|
649
|
+
# keywords are enclosed in HTML bold tags.
|
649
650
|
# @!attribute [rw] search_text_snippet
|
650
651
|
# @return [String]
|
651
|
-
# Contains snippets of text from the
|
652
|
-
#
|
653
|
-
#
|
654
|
-
#
|
652
|
+
# Contains snippets of text from the
|
653
|
+
# {Google::Cloud::Talent::V4beta1::Job#description Job#description} and
|
654
|
+
# similar fields that most closely match a search query's keywords, if
|
655
|
+
# available. All HTML tags in the original fields are stripped when
|
656
|
+
# returned in this field, and matching query keywords are enclosed in HTML
|
657
|
+
# bold tags.
|
655
658
|
# @!attribute [rw] commute_info
|
656
659
|
# @return [Google::Cloud::Talent::V4beta1::SearchJobsResponse::CommuteInfo]
|
657
660
|
# Commute information which is generated based on specified
|
@@ -673,26 +676,88 @@ module Google
|
|
673
676
|
class CommuteInfo; end
|
674
677
|
end
|
675
678
|
|
679
|
+
# Request to create a batch of jobs.
|
680
|
+
# @!attribute [rw] parent
|
681
|
+
# @return [String]
|
682
|
+
# Required. The resource name of the tenant under which the job is created.
|
683
|
+
#
|
684
|
+
# The format is "projects/{project_id}/tenants/{tenant_id}", for example,
|
685
|
+
# "projects/api-test-project/tenant/foo".
|
686
|
+
#
|
687
|
+
# Tenant id is optional and a default tenant is created if unspecified, for
|
688
|
+
# example, "projects/api-test-project".
|
689
|
+
# @!attribute [rw] jobs
|
690
|
+
# @return [Array<Google::Cloud::Talent::V4beta1::Job>]
|
691
|
+
# Required. The jobs to be created.
|
692
|
+
class BatchCreateJobsRequest; end
|
693
|
+
|
694
|
+
# Request to update a batch of jobs.
|
695
|
+
# @!attribute [rw] parent
|
696
|
+
# @return [String]
|
697
|
+
# Required. The resource name of the tenant under which the job is created.
|
698
|
+
#
|
699
|
+
# The format is "projects/{project_id}/tenants/{tenant_id}", for example,
|
700
|
+
# "projects/api-test-project/tenant/foo".
|
701
|
+
#
|
702
|
+
# Tenant id is optional and the default tenant is used if unspecified, for
|
703
|
+
# example, "projects/api-test-project".
|
704
|
+
# @!attribute [rw] jobs
|
705
|
+
# @return [Array<Google::Cloud::Talent::V4beta1::Job>]
|
706
|
+
# Required. The jobs to be updated.
|
707
|
+
# @!attribute [rw] update_mask
|
708
|
+
# @return [Google::Protobuf::FieldMask]
|
709
|
+
# Optional but strongly recommended to be provided for the best service
|
710
|
+
# experience, also increase latency when checking status of batch operation.
|
711
|
+
#
|
712
|
+
# If
|
713
|
+
# {Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}
|
714
|
+
# is provided, only the specified fields in
|
715
|
+
# {Google::Cloud::Talent::V4beta1::Job Job} are updated. Otherwise all the
|
716
|
+
# fields are updated.
|
717
|
+
#
|
718
|
+
# A field mask to restrict the fields that are updated. Only
|
719
|
+
# top level fields of {Google::Cloud::Talent::V4beta1::Job Job} are supported.
|
720
|
+
#
|
721
|
+
# If
|
722
|
+
# {Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}
|
723
|
+
# is provided, The {Google::Cloud::Talent::V4beta1::Job Job} inside
|
724
|
+
# {JobResult} will only contains fields that is updated, plus the Id of the
|
725
|
+
# Job. Otherwise, {Google::Cloud::Talent::V4beta1::Job Job} will include all
|
726
|
+
# fields, which can yield a very large response.
|
727
|
+
class BatchUpdateJobsRequest; end
|
728
|
+
|
676
729
|
# An enum that specifies the job attributes that are returned in the
|
677
|
-
# {
|
678
|
-
# {Google::Cloud::Talent::V4beta1::ListJobsResponse ListJobsResponse}
|
730
|
+
# {Google::Cloud::Talent::V4beta1::SearchJobsResponse::MatchingJob#job MatchingJob#job}
|
731
|
+
# or {Google::Cloud::Talent::V4beta1::ListJobsResponse#jobs ListJobsResponse#jobs}
|
732
|
+
# fields.
|
679
733
|
module JobView
|
680
734
|
# Default value.
|
681
735
|
JOB_VIEW_UNSPECIFIED = 0
|
682
736
|
|
683
737
|
# A ID only view of job, with following attributes:
|
684
|
-
# {Google::Cloud::Talent::V4beta1::Job#name Job#name},
|
738
|
+
# {Google::Cloud::Talent::V4beta1::Job#name Job#name},
|
739
|
+
# {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id},
|
740
|
+
# {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}.
|
685
741
|
JOB_VIEW_ID_ONLY = 1
|
686
742
|
|
687
743
|
# A minimal view of the job, with the following attributes:
|
688
|
-
# {Google::Cloud::Talent::V4beta1::Job#name Job#name},
|
689
|
-
# {Google::Cloud::Talent::V4beta1::Job#
|
744
|
+
# {Google::Cloud::Talent::V4beta1::Job#name Job#name},
|
745
|
+
# {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id},
|
746
|
+
# {Google::Cloud::Talent::V4beta1::Job#title Job#title},
|
747
|
+
# {Google::Cloud::Talent::V4beta1::Job#company Job#company},
|
748
|
+
# {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job::DerivedInfo#locations},
|
749
|
+
# {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}.
|
690
750
|
JOB_VIEW_MINIMAL = 2
|
691
751
|
|
692
752
|
# A small view of the job, with the following attributes in the search
|
693
|
-
# results: {Google::Cloud::Talent::V4beta1::Job#name Job#name},
|
694
|
-
# {Google::Cloud::Talent::V4beta1::Job#
|
695
|
-
# {Google::Cloud::Talent::V4beta1::Job#
|
753
|
+
# results: {Google::Cloud::Talent::V4beta1::Job#name Job#name},
|
754
|
+
# {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id},
|
755
|
+
# {Google::Cloud::Talent::V4beta1::Job#title Job#title},
|
756
|
+
# {Google::Cloud::Talent::V4beta1::Job#company Job#company},
|
757
|
+
# {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job::DerivedInfo#locations},
|
758
|
+
# {Google::Cloud::Talent::V4beta1::Job#visibility Job#visibility},
|
759
|
+
# {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code},
|
760
|
+
# {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
|
696
761
|
JOB_VIEW_SMALL = 3
|
697
762
|
|
698
763
|
# All available attributes are included in the search results.
|