google-cloud-talent-v4beta1 0.4.6 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (48) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +6 -6
  3. data/README.md +9 -4
  4. data/lib/google/cloud/talent/v4beta1/batch_pb.rb +0 -1
  5. data/lib/google/cloud/talent/v4beta1/common_pb.rb +3 -65
  6. data/lib/google/cloud/talent/v4beta1/company_pb.rb +2 -2
  7. data/lib/google/cloud/talent/v4beta1/company_service_pb.rb +2 -1
  8. data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb +3 -2
  9. data/lib/google/cloud/talent/v4beta1/event_pb.rb +2 -16
  10. data/lib/google/cloud/talent/v4beta1/event_service_pb.rb +2 -1
  11. data/lib/google/cloud/talent/v4beta1/filters_pb.rb +3 -102
  12. data/lib/google/cloud/talent/v4beta1/histogram_pb.rb +0 -1
  13. data/lib/google/cloud/talent/v4beta1/job_pb.rb +2 -3
  14. data/lib/google/cloud/talent/v4beta1/job_service/client.rb +48 -23
  15. data/lib/google/cloud/talent/v4beta1/job_service_pb.rb +10 -2
  16. data/lib/google/cloud/talent/v4beta1/tenant_pb.rb +2 -3
  17. data/lib/google/cloud/talent/v4beta1/tenant_service_pb.rb +2 -1
  18. data/lib/google/cloud/talent/v4beta1/version.rb +1 -1
  19. data/lib/google/cloud/talent/v4beta1.rb +3 -3
  20. data/proto_docs/google/cloud/talent/v4beta1/common.rb +10 -227
  21. data/proto_docs/google/cloud/talent/v4beta1/event.rb +1 -60
  22. data/proto_docs/google/cloud/talent/v4beta1/filters.rb +40 -482
  23. data/proto_docs/google/cloud/talent/v4beta1/histogram.rb +1 -1
  24. data/proto_docs/google/cloud/talent/v4beta1/job.rb +1 -1
  25. data/proto_docs/google/cloud/talent/v4beta1/job_service.rb +64 -16
  26. data/proto_docs/google/cloud/talent/v4beta1/tenant.rb +1 -1
  27. data/proto_docs/google/protobuf/any.rb +3 -3
  28. data/proto_docs/google/type/timeofday.rb +1 -1
  29. metadata +3 -22
  30. data/lib/google/cloud/talent/v4beta1/application_pb.rb +0 -64
  31. data/lib/google/cloud/talent/v4beta1/application_service/client.rb +0 -813
  32. data/lib/google/cloud/talent/v4beta1/application_service/credentials.rb +0 -52
  33. data/lib/google/cloud/talent/v4beta1/application_service/paths.rb +0 -155
  34. data/lib/google/cloud/talent/v4beta1/application_service.rb +0 -50
  35. data/lib/google/cloud/talent/v4beta1/application_service_pb.rb +0 -56
  36. data/lib/google/cloud/talent/v4beta1/application_service_services_pb.rb +0 -54
  37. data/lib/google/cloud/talent/v4beta1/profile_pb.rb +0 -214
  38. data/lib/google/cloud/talent/v4beta1/profile_service/client.rb +0 -1107
  39. data/lib/google/cloud/talent/v4beta1/profile_service/credentials.rb +0 -52
  40. data/lib/google/cloud/talent/v4beta1/profile_service/paths.rb +0 -69
  41. data/lib/google/cloud/talent/v4beta1/profile_service.rb +0 -50
  42. data/lib/google/cloud/talent/v4beta1/profile_service_pb.rb +0 -92
  43. data/lib/google/cloud/talent/v4beta1/profile_service_services_pb.rb +0 -63
  44. data/proto_docs/google/cloud/talent/v4beta1/application.rb +0 -169
  45. data/proto_docs/google/cloud/talent/v4beta1/application_service.rb +0 -122
  46. data/proto_docs/google/cloud/talent/v4beta1/profile.rb +0 -811
  47. data/proto_docs/google/cloud/talent/v4beta1/profile_service.rb +0 -392
  48. data/proto_docs/google/type/date.rb +0 -53
@@ -91,8 +91,24 @@ module Google
91
91
  # Currently we don't support sorting by commute time.
92
92
  # @!attribute [rw] company_display_names
93
93
  # @return [::Array<::String>]
94
- # This filter specifies the exact company {::Google::Cloud::Talent::V4beta1::Company#display_name Company.display_name}
95
- # of the jobs to search against.
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.
97
+ #
98
+ # Alternatively, the value being searched for can be wrapped in different
99
+ # match operators.
100
+ # `SUBSTRING_MATCH([value])`
101
+ # The company name must contain a case insensitive substring match of the
102
+ # value. Using this function may increase latency.
103
+ #
104
+ # Sample Value: `SUBSTRING_MATCH(google)`
105
+ #
106
+ # `MULTI_WORD_TOKEN_MATCH([value])`
107
+ # The value will be treated as a multi word token and the company name must
108
+ # contain a case insensitive match of the value. Using this function may
109
+ # increase latency.
110
+ #
111
+ # Sample Value: `MULTI_WORD_TOKEN_MATCH(google)`
96
112
  #
97
113
  # If a value isn't specified, jobs within the search results are
98
114
  # associated with any company.
@@ -127,7 +143,7 @@ module Google
127
143
  # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
128
144
  # nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum of 100
129
145
  # comparisons or functions are allowed in the expression. The expression
130
- # must be < 6000 bytes in length.
146
+ # must be < 10000 bytes in length.
131
147
  #
132
148
  # Sample Query:
133
149
  # `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND
@@ -177,262 +193,27 @@ module Google
177
193
  extend ::Google::Protobuf::MessageExts::ClassMethods
178
194
  end
179
195
 
180
- # Filters to apply when performing the search query.
181
- # @!attribute [rw] query
182
- # @return [::String]
183
- # Keywords to match any text fields of profiles.
184
- #
185
- # For example, "software engineer in Palo Alto".
186
- # @!attribute [rw] location_filters
187
- # @return [::Array<::Google::Cloud::Talent::V4beta1::LocationFilter>]
188
- # The location filter specifies geo-regions containing the profiles to
189
- # search against.
190
- #
191
- # One of {::Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter.address} or {::Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng LocationFilter.lat_lng} must be
192
- # provided or an error is thrown. If both {::Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter.address} and
193
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng LocationFilter.lat_lng} are provided, an error is thrown.
194
- #
195
- # The following logic is used to determine which locations in
196
- # the profile to filter against:
197
- #
198
- # 1. All of the profile's geocoded {::Google::Cloud::Talent::V4beta1::Profile#addresses Profile.addresses} where
199
- # {::Google::Cloud::Talent::V4beta1::Address#usage Address.usage} is PERSONAL and {::Google::Cloud::Talent::V4beta1::Address#current Address.current} is true.
200
- #
201
- # 2. If the above set of locations is empty, all of the profile's geocoded
202
- # {::Google::Cloud::Talent::V4beta1::Profile#addresses Profile.addresses} where {::Google::Cloud::Talent::V4beta1::Address#usage Address.usage} is
203
- # CONTACT_INFO_USAGE_UNSPECIFIED and {::Google::Cloud::Talent::V4beta1::Address#current Address.current} is true.
204
- #
205
- # 3. If the above set of locations is empty, all of the profile's geocoded
206
- # {::Google::Cloud::Talent::V4beta1::Profile#addresses Profile.addresses} where {::Google::Cloud::Talent::V4beta1::Address#usage Address.usage} is PERSONAL or
207
- # CONTACT_INFO_USAGE_UNSPECIFIED and {::Google::Cloud::Talent::V4beta1::Address#current Address.current} is not set.
208
- #
209
- # This means that any profiles without any {::Google::Cloud::Talent::V4beta1::Profile#addresses Profile.addresses} that match
210
- # any of the above criteria will not be included in a search with location
211
- # filter. Furthermore, any {::Google::Cloud::Talent::V4beta1::Profile#addresses Profile.addresses} where {::Google::Cloud::Talent::V4beta1::Address#usage Address.usage} is
212
- # WORK or SCHOOL or where {::Google::Cloud::Talent::V4beta1::Address#current Address.current} is false are not considered for
213
- # location filter.
214
- #
215
- # If a location filter isn't specified, profiles fitting the other search
216
- # criteria are retrieved regardless of where they're located.
217
- #
218
- # If {::Google::Cloud::Talent::V4beta1::LocationFilter#negated LocationFilter.negated} is specified, the result doesn't contain
219
- # profiles from that location.
220
- #
221
- # If {::Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter.address} is provided, the
222
- # {::Google::Cloud::Talent::V4beta1::Location::LocationType LocationType}, center
223
- # point (latitude and longitude), and radius are automatically detected by
224
- # the Google Maps Geocoding API and included as well. If
225
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter.address} cannot be geocoded, the filter
226
- # falls back to keyword search.
227
- #
228
- # If the detected
229
- # {::Google::Cloud::Talent::V4beta1::Location::LocationType LocationType} is
230
- # {::Google::Cloud::Talent::V4beta1::Location::LocationType::SUB_ADMINISTRATIVE_AREA LocationType.SUB_ADMINISTRATIVE_AREA},
231
- # {::Google::Cloud::Talent::V4beta1::Location::LocationType::ADMINISTRATIVE_AREA LocationType.ADMINISTRATIVE_AREA},
232
- # or
233
- # {::Google::Cloud::Talent::V4beta1::Location::LocationType::COUNTRY LocationType.COUNTRY},
234
- # the filter is performed against the detected location name (using exact
235
- # text matching). Otherwise, the filter is performed against the detected
236
- # center point and a radius of detected location radius +
237
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles}.
238
- #
239
- # If {::Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter.address} is provided,
240
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} is the additional radius on top of the
241
- # radius of the location geocoded from {::Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter.address}. If
242
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng LocationFilter.lat_lng} is provided,
243
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} is the only radius that is used.
244
- #
245
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} is 10 by default. Note that the value
246
- # of {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} is 0 if it is unset, so the server
247
- # does not differentiate {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} that is
248
- # explicitly set to 0 and {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} that is not
249
- # set. Which means that if {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} is explicitly
250
- # set to 0, the server will use the default value of
251
- # {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} which is 10. To work around this and
252
- # effectively set {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} to 0, we recommend
253
- # setting {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} to a very small decimal number
254
- # (such as 0.00001).
255
- #
256
- # If {::Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter.distance_in_miles} is negative, an error is thrown.
257
- # @!attribute [rw] job_title_filters
258
- # @return [::Array<::Google::Cloud::Talent::V4beta1::JobTitleFilter>]
259
- # Job title filter specifies job titles of profiles to match on.
260
- #
261
- # If a job title isn't specified, profiles with any titles are retrieved.
262
- #
263
- # If multiple values are specified, profiles are retrieved with any of the
264
- # specified job titles.
265
- #
266
- # If {::Google::Cloud::Talent::V4beta1::JobTitleFilter#negated JobTitleFilter.negated} is specified, the result won't contain
267
- # profiles with the job titles.
268
- #
269
- # For example, search for profiles with a job title "Product Manager".
270
- # @!attribute [rw] employer_filters
271
- # @return [::Array<::Google::Cloud::Talent::V4beta1::EmployerFilter>]
272
- # Employer filter specifies employers of profiles to match on.
273
- #
274
- # If an employer filter isn't specified, profiles with any employers are
275
- # retrieved.
276
- #
277
- # If multiple employer filters are specified, profiles with any matching
278
- # employers are retrieved.
279
- #
280
- # If {::Google::Cloud::Talent::V4beta1::EmployerFilter#negated EmployerFilter.negated} is specified, the result won't contain
281
- # profiles that match the employers.
282
- #
283
- # For example, search for profiles that have working experience at "Google
284
- # LLC".
285
- # @!attribute [rw] education_filters
286
- # @return [::Array<::Google::Cloud::Talent::V4beta1::EducationFilter>]
287
- # Education filter specifies education of profiles to match on.
288
- #
289
- # If an education filter isn't specified, profiles with any education are
290
- # retrieved.
291
- #
292
- # If multiple education filters are specified, profiles that match any
293
- # education filters are retrieved.
294
- #
295
- # If {::Google::Cloud::Talent::V4beta1::EducationFilter#negated EducationFilter.negated} is specified, the result won't contain
296
- # profiles that match the educations.
297
- #
298
- # For example, search for profiles with a master degree.
299
- # @!attribute [rw] skill_filters
300
- # @return [::Array<::Google::Cloud::Talent::V4beta1::SkillFilter>]
301
- # Skill filter specifies skill of profiles to match on.
302
- #
303
- # If a skill filter isn't specified, profiles with any skills are retrieved.
304
- #
305
- # If multiple skill filters are specified, profiles that match any skill
306
- # filters are retrieved.
307
- #
308
- # If {::Google::Cloud::Talent::V4beta1::SkillFilter#negated SkillFilter.negated} is specified, the result won't contain profiles
309
- # that match the skills.
310
- #
311
- # For example, search for profiles that have "Java" and "Python" in skill
312
- # list.
313
- # @!attribute [rw] work_experience_filter
314
- # @return [::Array<::Google::Cloud::Talent::V4beta1::WorkExperienceFilter>]
315
- # Work experience filter specifies the total working experience of profiles
316
- # to match on.
317
- #
318
- # If a work experience filter isn't specified, profiles with any
319
- # professional experience are retrieved.
320
- #
321
- # If multiple work experience filters are specified, profiles that match any
322
- # work experience filters are retrieved.
323
- #
324
- # For example, search for profiles with 10 years of work experience.
325
- # @!attribute [rw] time_filters
326
- # @return [::Array<::Google::Cloud::Talent::V4beta1::TimeFilter>]
327
- # Time filter specifies the create/update timestamp of the profiles to match
328
- # on.
329
- #
330
- # For example, search for profiles created since "2018-1-1".
331
- # @!attribute [rw] hirable_filter
332
- # @return [::Google::Protobuf::BoolValue]
333
- # The hirable filter specifies the profile's hirable status to match on.
334
- # @!attribute [rw] application_date_filters
335
- # @return [::Array<::Google::Cloud::Talent::V4beta1::ApplicationDateFilter>]
336
- # The application date filters specify application date ranges to match on.
337
- # @!attribute [rw] application_outcome_notes_filters
338
- # @return [::Array<::Google::Cloud::Talent::V4beta1::ApplicationOutcomeNotesFilter>]
339
- # The application outcome notes filters specify the notes for the outcome of
340
- # the job application.
341
- # @!attribute [rw] application_job_filters
342
- # @return [::Array<::Google::Cloud::Talent::V4beta1::ApplicationJobFilter>]
343
- # The application job filters specify the job applied for in the application.
344
- # @!attribute [rw] custom_attribute_filter
345
- # @return [::String]
346
- # This filter specifies a structured syntax to match against the
347
- # {::Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile.custom_attributes} that are marked as `filterable`.
348
- #
349
- # The syntax for this expression is a subset of Google SQL syntax.
350
- #
351
- # String custom attributes: supported operators are =, != where the left of
352
- # the operator is a custom field key and the right of the operator is a
353
- # string (surrounded by quotes) value.
354
- #
355
- # Numeric custom attributes: Supported operators are '>', '<' or '='
356
- # operators where the left of the operator is a custom field key and the
357
- # right of the operator is a numeric value.
358
- #
359
- # Supported functions are LOWER(<field_name>) to
360
- # perform case insensitive match and EMPTY(<field_name>) to filter on the
361
- # existence of a key.
362
- #
363
- # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
364
- # nesting (for example "((A AND B AND C) OR NOT D) AND E"), and there can be
365
- # a maximum of 50 comparisons/functions in the expression. The expression
366
- # must be < 2000 characters in length.
367
- #
368
- # Sample Query:
369
- # (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1))
370
- # @!attribute [rw] candidate_availability_filter
371
- # @return [::Google::Cloud::Talent::V4beta1::CandidateAvailabilityFilter]
372
- # Deprecated. Use availability_filters instead.
373
- #
374
- # The candidate availability filter which filters based on availability
375
- # signals.
376
- #
377
- # Signal 1: Number of days since most recent job application. See
378
- # [Availability.JobApplicationAvailabilitySignal][google.cloud.talent.v4beta1.Availability.JobApplicationAvailabilitySignal] for the details of this
379
- # signal.
380
- #
381
- # Signal 2: Number of days since last profile update. See
382
- # [Availability.ProfileUpdateAvailabilitySignal][google.cloud.talent.v4beta1.Availability.ProfileUpdateAvailabilitySignal]
383
- # for the details of this signal.
384
- #
385
- # The candidate availability filter helps a recruiter understand if a
386
- # specific candidate is likely to be actively seeking new job opportunities
387
- # based on an aggregated set of signals. Specifically, the intent is NOT to
388
- # indicate the candidate's potential qualification / interest / close ability
389
- # for a specific job.
390
- # @!attribute [rw] availability_filters
391
- # @return [::Array<::Google::Cloud::Talent::V4beta1::AvailabilityFilter>]
392
- # The availability filter which filters based on
393
- # {::Google::Cloud::Talent::V4beta1::Profile#availability_signals Profile.availability_signals}.
394
- #
395
- # The availability filter helps a recruiter understand if a
396
- # specific candidate is likely to be actively seeking new job opportunities
397
- # based on an aggregated set of signals. Specifically, the intent is NOT to
398
- # indicate the candidate's potential qualification / interest / close ability
399
- # for a specific job.
400
- #
401
- # There can be at most one {::Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} per
402
- # {::Google::Cloud::Talent::V4beta1::AvailabilityFilter#signal_type signal_type}. If there are multiple
403
- # {::Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} for a {::Google::Cloud::Talent::V4beta1::AvailabilityFilter#signal_type signal_type},
404
- # an error is thrown.
405
- # @!attribute [rw] person_name_filters
406
- # @return [::Array<::Google::Cloud::Talent::V4beta1::PersonNameFilter>]
407
- # Person name filter specifies person name of profiles to match on.
408
- #
409
- # If multiple person name filters are specified, profiles that match any
410
- # person name filters are retrieved.
411
- #
412
- # For example, search for profiles of candidates with name "John Smith".
413
- class ProfileQuery
414
- include ::Google::Protobuf::MessageExts
415
- extend ::Google::Protobuf::MessageExts::ClassMethods
416
- end
417
-
418
196
  # Geographic region of the search.
419
197
  # @!attribute [rw] address
420
198
  # @return [::String]
421
199
  # The address name, such as "Mountain View" or "Bay Area".
422
200
  # @!attribute [rw] region_code
423
201
  # @return [::String]
424
- # CLDR region code of the country/region of the address. This is used
425
- # to address ambiguity of the user-input location, for example, "Liverpool"
426
- # against "Liverpool, NY, US" or "Liverpool, UK".
202
+ # CLDR region code of the country/region. This field may be used in two ways:
427
203
  #
428
- # Set this field to bias location resolution toward a specific country
429
- # or territory. If this field is not set, application behavior is biased
430
- # toward the United States by default.
204
+ # 1) If telecommute preference is not set, this field is used address
205
+ # ambiguity of the user-input address. For example, "Liverpool" may refer to
206
+ # "Liverpool, NY, US" or "Liverpool, UK". This region code biases the
207
+ # address resolution toward a specific country or territory. If this field is
208
+ # not set, address resolution is biased toward the United States by default.
209
+ #
210
+ # 2) If telecommute preference is set to TELECOMMUTE_ALLOWED, the
211
+ # telecommute location filter will be limited to the region specified in this
212
+ # field. If this field is not set, the telecommute job locations will not be
431
213
  #
432
214
  # See
433
- # https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
215
+ # https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/territory_information.html
434
216
  # for details. Example: "CH" for Switzerland.
435
- # Note that this filter is not applicable for Profile Search related queries.
436
217
  # @!attribute [rw] lat_lng
437
218
  # @return [::Google::Type::LatLng]
438
219
  # The latitude and longitude of the geographic center to search from. This
@@ -446,13 +227,15 @@ module Google
446
227
  # @return [::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference]
447
228
  # Allows the client to return jobs without a
448
229
  # set location, specifically, telecommuting jobs (telecommuting is considered
449
- # by the service as a special location.
230
+ # by the service as a special location).
450
231
  # {::Google::Cloud::Talent::V4beta1::Job#posting_region Job.posting_region} indicates if a job permits telecommuting.
451
232
  # If this field is set to {::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference.TELECOMMUTE_ALLOWED},
452
233
  # telecommuting jobs are searched, and {::Google::Cloud::Talent::V4beta1::LocationFilter#address address} and {::Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are
453
234
  # ignored. If not set or set to
454
- # {::Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference.TELECOMMUTE_EXCLUDED}, telecommute job are not
455
- # searched.
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][].
456
239
  #
457
240
  # This filter can be used by itself to search exclusively for telecommuting
458
241
  # jobs, or it can be combined with another location
@@ -466,8 +249,6 @@ module Google
466
249
  # @return [::Boolean]
467
250
  # Whether to apply negation to the filter so profiles matching the filter
468
251
  # are excluded.
469
- #
470
- # Currently only supported in profile search.
471
252
  class LocationFilter
472
253
  include ::Google::Protobuf::MessageExts
473
254
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -477,11 +258,15 @@ module Google
477
258
  # Default value if the telecommute preference isn't specified.
478
259
  TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0
479
260
 
480
- # Exclude telecommute jobs.
261
+ # Deprecated: Ignore telecommute status of jobs. Use
262
+ # TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.
481
263
  TELECOMMUTE_EXCLUDED = 1
482
264
 
483
265
  # Allow telecommute jobs.
484
266
  TELECOMMUTE_ALLOWED = 2
267
+
268
+ # Exclude telecommute jobs.
269
+ TELECOMMUTE_JOBS_EXCLUDED = 3
485
270
  end
486
271
  end
487
272
 
@@ -585,233 +370,6 @@ module Google
585
370
  BUSY_HOUR = 2
586
371
  end
587
372
  end
588
-
589
- # Job title of the search.
590
- # @!attribute [rw] job_title
591
- # @return [::String]
592
- # Required. The job title. For example, "Software engineer", or "Product manager".
593
- # @!attribute [rw] negated
594
- # @return [::Boolean]
595
- # Whether to apply negation to the filter so profiles matching the filter
596
- # are excluded.
597
- class JobTitleFilter
598
- include ::Google::Protobuf::MessageExts
599
- extend ::Google::Protobuf::MessageExts::ClassMethods
600
- end
601
-
602
- # Skill filter of the search.
603
- # @!attribute [rw] skill
604
- # @return [::String]
605
- # Required. The skill name. For example, "java", "j2ee", and so on.
606
- # @!attribute [rw] negated
607
- # @return [::Boolean]
608
- # Whether to apply negation to the filter so profiles matching the filter
609
- # are excluded.
610
- class SkillFilter
611
- include ::Google::Protobuf::MessageExts
612
- extend ::Google::Protobuf::MessageExts::ClassMethods
613
- end
614
-
615
- # Employer filter of the search.
616
- # @!attribute [rw] employer
617
- # @return [::String]
618
- # Required. The name of the employer, for example "Google", "Alphabet".
619
- # @!attribute [rw] mode
620
- # @return [::Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode]
621
- # Define set of {::Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord}s to search against.
622
- #
623
- # Defaults to {::Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode::ALL_EMPLOYMENT_RECORDS EmployerFilterMode.ALL_EMPLOYMENT_RECORDS}.
624
- # @!attribute [rw] negated
625
- # @return [::Boolean]
626
- # Whether to apply negation to the filter so profiles matching the filter
627
- # is excluded.
628
- class EmployerFilter
629
- include ::Google::Protobuf::MessageExts
630
- extend ::Google::Protobuf::MessageExts::ClassMethods
631
-
632
- # Enum indicating which set of {::Google::Cloud::Talent::V4beta1::Profile#employment_records Profile.employment_records} to search
633
- # against.
634
- module EmployerFilterMode
635
- # Default value.
636
- EMPLOYER_FILTER_MODE_UNSPECIFIED = 0
637
-
638
- # Apply to all employers in {::Google::Cloud::Talent::V4beta1::Profile#employment_records Profile.employment_records}.
639
- ALL_EMPLOYMENT_RECORDS = 1
640
-
641
- # Apply only to current employer in {::Google::Cloud::Talent::V4beta1::Profile#employment_records Profile.employment_records}.
642
- CURRENT_EMPLOYMENT_RECORDS_ONLY = 2
643
-
644
- # Apply only to past (not current) employers in
645
- # {::Google::Cloud::Talent::V4beta1::Profile#employment_records Profile.employment_records}.
646
- PAST_EMPLOYMENT_RECORDS_ONLY = 3
647
- end
648
- end
649
-
650
- # Education filter of the search.
651
- # @!attribute [rw] school
652
- # @return [::String]
653
- # The school name. For example "MIT", "University of California, Berkeley".
654
- # @!attribute [rw] field_of_study
655
- # @return [::String]
656
- # The field of study. This is to search against value provided in
657
- # {::Google::Cloud::Talent::V4beta1::Degree#fields_of_study Degree.fields_of_study}.
658
- # For example "Computer Science", "Mathematics".
659
- # @!attribute [rw] degree_type
660
- # @return [::Google::Cloud::Talent::V4beta1::DegreeType]
661
- # Education degree in ISCED code. Each value in degree covers a specific
662
- # level of education, without any expansion to upper nor lower levels of
663
- # education degree.
664
- # @!attribute [rw] negated
665
- # @return [::Boolean]
666
- # Whether to apply negation to the filter so profiles matching the filter
667
- # is excluded.
668
- class EducationFilter
669
- include ::Google::Protobuf::MessageExts
670
- extend ::Google::Protobuf::MessageExts::ClassMethods
671
- end
672
-
673
- # Work experience filter.
674
- #
675
- # This filter is used to search for profiles with working experience length
676
- # between {::Google::Cloud::Talent::V4beta1::WorkExperienceFilter#min_experience min_experience} and {::Google::Cloud::Talent::V4beta1::WorkExperienceFilter#max_experience max_experience}.
677
- # @!attribute [rw] min_experience
678
- # @return [::Google::Protobuf::Duration]
679
- # The minimum duration of the work experience (inclusive).
680
- # @!attribute [rw] max_experience
681
- # @return [::Google::Protobuf::Duration]
682
- # The maximum duration of the work experience (exclusive).
683
- class WorkExperienceFilter
684
- include ::Google::Protobuf::MessageExts
685
- extend ::Google::Protobuf::MessageExts::ClassMethods
686
- end
687
-
688
- # Application Date Range Filter.
689
- #
690
- # The API matches profiles with {::Google::Cloud::Talent::V4beta1::Application#application_date Application.application_date} between
691
- # start date and end date (both boundaries are inclusive). The filter is
692
- # ignored if both {::Google::Cloud::Talent::V4beta1::ApplicationDateFilter#start_date start_date} and {::Google::Cloud::Talent::V4beta1::ApplicationDateFilter#end_date end_date} are missing.
693
- # @!attribute [rw] start_date
694
- # @return [::Google::Type::Date]
695
- # Start date. If it's missing, The API matches profiles with application date
696
- # not after the end date.
697
- # @!attribute [rw] end_date
698
- # @return [::Google::Type::Date]
699
- # End date. If it's missing, The API matches profiles with application date
700
- # not before the start date.
701
- class ApplicationDateFilter
702
- include ::Google::Protobuf::MessageExts
703
- extend ::Google::Protobuf::MessageExts::ClassMethods
704
- end
705
-
706
- # Outcome Notes Filter.
707
- # @!attribute [rw] outcome_notes
708
- # @return [::String]
709
- # Required. User entered or selected outcome reason. The API does an exact match on the
710
- # {::Google::Cloud::Talent::V4beta1::Application#outcome_notes Application.outcome_notes} in profiles.
711
- # @!attribute [rw] negated
712
- # @return [::Boolean]
713
- # If true, The API excludes all candidates with any
714
- # {::Google::Cloud::Talent::V4beta1::Application#outcome_notes Application.outcome_notes} matching the outcome reason specified in
715
- # the filter.
716
- class ApplicationOutcomeNotesFilter
717
- include ::Google::Protobuf::MessageExts
718
- extend ::Google::Protobuf::MessageExts::ClassMethods
719
- end
720
-
721
- # Filter on the job information of Application.
722
- # @!attribute [rw] job_requisition_id
723
- # @return [::String]
724
- # The job requisition id in the application. The API does an exact match on
725
- # the {::Google::Cloud::Talent::V4beta1::Job#requisition_id Job.requisition_id} of {::Google::Cloud::Talent::V4beta1::Application#job Application.job} in profiles.
726
- # @!attribute [rw] job_title
727
- # @return [::String]
728
- # The job title in the application. The API does an exact match on the
729
- # {::Google::Cloud::Talent::V4beta1::Job#title Job.title} of {::Google::Cloud::Talent::V4beta1::Application#job Application.job} in profiles.
730
- # @!attribute [rw] negated
731
- # @return [::Boolean]
732
- # If true, the API excludes all profiles with any {::Google::Cloud::Talent::V4beta1::Application#job Application.job}
733
- # matching the filters.
734
- class ApplicationJobFilter
735
- include ::Google::Protobuf::MessageExts
736
- extend ::Google::Protobuf::MessageExts::ClassMethods
737
- end
738
-
739
- # Filter on create timestamp or update timestamp of profiles.
740
- # @!attribute [rw] start_time
741
- # @return [::Google::Protobuf::Timestamp]
742
- # Start timestamp, matching profiles with the start time. If this field
743
- # missing, The API matches profiles with create / update timestamp before the
744
- # end timestamp.
745
- # @!attribute [rw] end_time
746
- # @return [::Google::Protobuf::Timestamp]
747
- # End timestamp, matching profiles with the end time. If this field
748
- # missing, The API matches profiles with create / update timestamp after the
749
- # start timestamp.
750
- # @!attribute [rw] time_field
751
- # @return [::Google::Cloud::Talent::V4beta1::TimeFilter::TimeField]
752
- # Specifies which time field to filter profiles.
753
- #
754
- # Defaults to {::Google::Cloud::Talent::V4beta1::TimeFilter::TimeField::CREATE_TIME TimeField.CREATE_TIME}.
755
- class TimeFilter
756
- include ::Google::Protobuf::MessageExts
757
- extend ::Google::Protobuf::MessageExts::ClassMethods
758
-
759
- # Time fields can be used in TimeFilter.
760
- module TimeField
761
- # Default value.
762
- TIME_FIELD_UNSPECIFIED = 0
763
-
764
- # Earliest profile create time.
765
- CREATE_TIME = 1
766
-
767
- # Latest profile update time.
768
- UPDATE_TIME = 2
769
- end
770
- end
771
-
772
- # Deprecated. Use AvailabilityFilter instead.
773
- #
774
- # Filter on availability signals.
775
- # @!attribute [rw] negated
776
- # @return [::Boolean]
777
- # It is false by default. If true, API excludes all the potential available
778
- # profiles.
779
- class CandidateAvailabilityFilter
780
- include ::Google::Protobuf::MessageExts
781
- extend ::Google::Protobuf::MessageExts::ClassMethods
782
- end
783
-
784
- # Filter on availability signals.
785
- # @!attribute [rw] signal_type
786
- # @return [::Google::Cloud::Talent::V4beta1::AvailabilitySignalType]
787
- # Required. Type of signal to apply filter on.
788
- # @!attribute [rw] range
789
- # @return [::Google::Cloud::Talent::V4beta1::TimestampRange]
790
- # Required. Range of times to filter candidate signals by.
791
- # @!attribute [rw] required
792
- # @return [::Boolean]
793
- # If multiple {::Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} are provided, the default
794
- # behavior is to OR all filters, but if this field is set to true, this
795
- # particular {::Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} will be AND'ed against other
796
- # {::Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter}.
797
- class AvailabilityFilter
798
- include ::Google::Protobuf::MessageExts
799
- extend ::Google::Protobuf::MessageExts::ClassMethods
800
- end
801
-
802
- # Filter on person name.
803
- # @!attribute [rw] person_name
804
- # @return [::String]
805
- # Required. The person name. For example, "John Smith".
806
- #
807
- # Can be any combination of [PersonName.structured_name.given_name][],
808
- # [PersonName.structured_name.middle_initial][],
809
- # [PersonName.structured_name.family_name][], and
810
- # {::Google::Cloud::Talent::V4beta1::PersonName#formatted_name PersonName.formatted_name}.
811
- class PersonNameFilter
812
- include ::Google::Protobuf::MessageExts
813
- extend ::Google::Protobuf::MessageExts::ClassMethods
814
- end
815
373
  end
816
374
  end
817
375
  end
@@ -28,7 +28,7 @@ module Google
28
28
  # (for example, jobs, profiles) for searches.
29
29
  #
30
30
  # See {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest.histogram_queries} and
31
- # {::Google::Cloud::Talent::V4beta1::SearchProfilesRequest#histogram_queries SearchProfilesRequest.histogram_queries} for details about syntax.
31
+ # [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries] for details about syntax.
32
32
  class HistogramQuery
33
33
  include ::Google::Protobuf::MessageExts
34
34
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -241,7 +241,7 @@ module Google
241
241
  # not be updated. And when creating a job with past timestamp, the
242
242
  # {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time posting_publish_time} must be set before
243
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 {::Google::Cloud::Talent::V4beta1::Application Application}, to refer a job
244
+ # to allow other objects, such as [Application][google.cloud.talent.v4beta1.Application], to refer a job
245
245
  # that didn't exist in the system prior to becoming expired. If you
246
246
  # want to modify a job that was expired on creation,
247
247
  # delete it and create a new one.