google-cloud-talent-v4beta1 0.4.6 → 0.5.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 (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.