Skip to content

Commit cd9f303

Browse files
feat: [talent] A new enum RelevanceThreshold is added (#5910)
* feat: A new enum `RelevanceThreshold` is added feat: A new field `relevance_threshold` is added to message `.google.cloud.talent.v4beta1.SearchJobsRequest` PiperOrigin-RevId: 711468273 Source-Link: googleapis/googleapis@528ea46 Source-Link: googleapis/googleapis-gen@7adb146 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRhbGVudC8uT3dsQm90LnlhbWwiLCJoIjoiN2FkYjE0NmY5MzUwNWMwYmEyNTRmNzJhNGY1ZGZjMDI0MzcyNmMwNyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * feat: A new enum `RelevanceThreshold` is added feat: A new field `relevance_threshold` is added to message `.google.cloud.talent.v4.SearchJobsRequest` docs: multiple fixes for links in documentation PiperOrigin-RevId: 711534942 Source-Link: googleapis/googleapis@c72d738 Source-Link: googleapis/googleapis-gen@19d73c3 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRhbGVudC8uT3dsQm90LnlhbWwiLCJoIjoiMTlkNzNjMzgxZjg3N2FhODYwNjRiYTNmOWI2NGEyNmRjM2EzMGNhYyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 5e0e4c1 commit cd9f303

83 files changed

Lines changed: 447 additions & 97 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

packages/google-cloud-talent/.jsdoc.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2024 Google LLC
1+
// Copyright 2025 Google LLC
22
//
33
// Licensed under the Apache License, Version 2.0 (the "License");
44
// you may not use this file except in compliance with the License.
@@ -40,7 +40,7 @@ module.exports = {
4040
includePattern: '\\.js$'
4141
},
4242
templates: {
43-
copyright: 'Copyright 2024 Google LLC',
43+
copyright: 'Copyright 2025 Google LLC',
4444
includeDate: false,
4545
sourceFiles: false,
4646
systemName: '@google-cloud/talent',

packages/google-cloud-talent/.mocharc.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2024 Google LLC
1+
// Copyright 2025 Google LLC
22
//
33
// Licensed under the Apache License, Version 2.0 (the "License");
44
// you may not use this file except in compliance with the License.

packages/google-cloud-talent/.prettierrc.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2024 Google LLC
1+
// Copyright 2025 Google LLC
22
//
33
// Licensed under the Apache License, Version 2.0 (the "License");
44
// you may not use this file except in compliance with the License.

packages/google-cloud-talent/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
4444
1. [Select or create a Cloud Platform project][projects].
4545
1. [Enable billing for your project][billing].
4646
1. [Enable the Google Cloud Talent Solution API][enable_api].
47-
1. [Set up authentication with a service account][auth] so you can access the
47+
1. [Set up authentication][auth] so you can access the
4848
API from your local workstation.
4949

5050
### Installing the client library
@@ -176,4 +176,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
176176
[projects]: https://console.cloud.google.com/project
177177
[billing]: https://support.google.com/cloud/answer/6293499#enable-billing
178178
[enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=jobs.googleapis.com
179-
[auth]: https://cloud.google.com/docs/authentication/getting-started
179+
[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local

packages/google-cloud-talent/protos/google/cloud/talent/v4/filters.proto

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,8 @@ message LocationFilter {
261261
// [PostingRegion.TELECOMMUTE][google.cloud.talent.v4.PostingRegion.TELECOMMUTE]
262262
// and have additional [Job.addresses][google.cloud.talent.v4.Job.addresses]
263263
// may still be matched based on other location filters using
264-
// [address][google.cloud.talent.v4.LocationFilter.address] or [latlng][].
264+
// [address][google.cloud.talent.v4.LocationFilter.address] or
265+
// [lat_lng][google.cloud.talent.v4.LocationFilter.lat_lng].
265266
//
266267
// This filter can be used by itself to search exclusively for telecommuting
267268
// jobs, or it can be combined with another location

packages/google-cloud-talent/protos/google/cloud/talent/v4/job.proto

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -172,13 +172,16 @@ message Job {
172172
// search experience.
173173
//
174174
// Jobs with multiple addresses must have their addresses with the same
175-
// [LocationType][] to allow location filtering to work properly. (For
176-
// example, a Job with addresses "1600 Amphitheatre Parkway, Mountain View,
177-
// CA, USA" and "London, UK" may not have location filters applied correctly
178-
// at search time since the first is a [LocationType.STREET_ADDRESS][] and the
179-
// second is a [LocationType.LOCALITY][].) If a job needs to have multiple
180-
// addresses, it is suggested to split it into multiple jobs with same
181-
// LocationTypes.
175+
// [LocationType][google.cloud.talent.v4.Location.LocationType] to allow
176+
// location filtering to work properly. (For example, a Job with addresses
177+
// "1600 Amphitheatre Parkway, Mountain View, CA, USA" and "London, UK" may
178+
// not have location filters applied correctly at search time since the first
179+
// is a
180+
// [LocationType.STREET_ADDRESS][google.cloud.talent.v4.Location.LocationType.STREET_ADDRESS]
181+
// and the second is a
182+
// [LocationType.LOCALITY][google.cloud.talent.v4.Location.LocationType.LOCALITY].)
183+
// If a job needs to have multiple addresses, it is suggested to split it into
184+
// multiple jobs with same LocationTypes.
182185
//
183186
// The maximum number of allowed characters is 500.
184187
repeated string addresses = 6;
@@ -339,10 +342,11 @@ message Job {
339342
// [posting_publish_time][google.cloud.talent.v4.Job.posting_publish_time]
340343
// must be set before
341344
// [posting_expire_time][google.cloud.talent.v4.Job.posting_expire_time]. The
342-
// purpose of this feature is to allow other objects, such as [Application][],
343-
// to refer a job that didn't exist in the system prior to becoming expired.
344-
// If you want to modify a job that was expired on creation, delete it and
345-
// create a new one.
345+
// purpose of this feature is to allow other objects, such as
346+
// [ApplicationInfo][google.cloud.talent.v4.Job.ApplicationInfo], to refer a
347+
// job that didn't exist in the system prior to becoming expired. If you want
348+
// to modify a job that was expired on creation, delete it and create a new
349+
// one.
346350
//
347351
// If this value isn't provided at the time of job creation or is invalid,
348352
// the job posting expires after 30 days from the job's creation time. For

packages/google-cloud-talent/protos/google/cloud/talent/v4/job_service.proto

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -448,6 +448,27 @@ message SearchJobsRequest {
448448
KEYWORD_MATCH_TITLE_ONLY = 3;
449449
}
450450

451+
// The relevance threshold of the search results. The higher relevance
452+
// threshold is, the higher relevant results are shown and the less number of
453+
// results are returned.
454+
enum RelevanceThreshold {
455+
// Default value. In this case, server behavior defaults to Google defined
456+
// threshold.
457+
RELEVANCE_THRESHOLD_UNSPECIFIED = 0;
458+
459+
// Lowest relevance threshold.
460+
LOWEST = 1;
461+
462+
// Low relevance threshold.
463+
LOW = 2;
464+
465+
// Medium relevance threshold.
466+
MEDIUM = 3;
467+
468+
// High relevance threshold.
469+
HIGH = 4;
470+
}
471+
451472
// Custom ranking information for
452473
// [SearchJobsRequest][google.cloud.talent.v4.SearchJobsRequest].
453474
message CustomRankingInfo {
@@ -811,6 +832,14 @@ message SearchJobsRequest {
811832
// [KeywordMatchMode.KEYWORD_MATCH_ALL][google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode.KEYWORD_MATCH_ALL]
812833
// if no value is specified.
813834
KeywordMatchMode keyword_match_mode = 18;
835+
836+
// Optional. The relevance threshold of the search results.
837+
//
838+
// Default to Google defined threshold, leveraging a balance of
839+
// precision and recall to deliver both highly accurate results and
840+
// comprehensive coverage of relevant information.
841+
RelevanceThreshold relevance_threshold = 19
842+
[(google.api.field_behavior) = OPTIONAL];
814843
}
815844

816845
// Response for SearchJob method.
@@ -939,7 +968,7 @@ message BatchUpdateJobsRequest {
939968
//
940969
// If [update_mask][google.cloud.talent.v4.BatchUpdateJobsRequest.update_mask]
941970
// is provided, The [Job][google.cloud.talent.v4.Job] inside
942-
// [JobResult][JobOperationResult.JobResult]
971+
// [JobResult][google.cloud.talent.v4.JobResult]
943972
// will only contains fields that is updated, plus the Id of the Job.
944973
// Otherwise, [Job][google.cloud.talent.v4.Job] will include all fields,
945974
// which can yield a very large response.

packages/google-cloud-talent/protos/google/cloud/talent/v4beta1/job_service.proto

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -486,6 +486,27 @@ message SearchJobsRequest {
486486
KEYWORD_MATCH_TITLE_ONLY = 3;
487487
}
488488

489+
// The relevance threshold of the search results. The higher relevance
490+
// threshold is, the higher relevant results are shown and the less number of
491+
// results are returned.
492+
enum RelevanceThreshold {
493+
// Default value. In this case, server behavior defaults to Google defined
494+
// threshold.
495+
RELEVANCE_THRESHOLD_UNSPECIFIED = 0;
496+
497+
// Lowest relevance threshold.
498+
LOWEST = 1;
499+
500+
// Low relevance threshold.
501+
LOW = 2;
502+
503+
// Medium relevance threshold.
504+
MEDIUM = 3;
505+
506+
// High relevance threshold.
507+
HIGH = 4;
508+
}
509+
489510
// Custom ranking information for
490511
// [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
491512
message CustomRankingInfo {
@@ -856,6 +877,14 @@ message SearchJobsRequest {
856877
// [KeywordMatchMode.KEYWORD_MATCH_ALL][google.cloud.talent.v4beta1.SearchJobsRequest.KeywordMatchMode.KEYWORD_MATCH_ALL]
857878
// if no value is specified.
858879
KeywordMatchMode keyword_match_mode = 18;
880+
881+
// Optional. The relevance threshold of the search results.
882+
//
883+
// Default to Google defined threshold, leveraging a balance of
884+
// precision and recall to deliver both highly accurate results and
885+
// comprehensive coverage of relevant information.
886+
RelevanceThreshold relevance_threshold = 19
887+
[(google.api.field_behavior) = OPTIONAL];
859888
}
860889

861890
// Response for SearchJob method.

packages/google-cloud-talent/protos/protos.d.ts

Lines changed: 31 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)