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>

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -40,7 +40,7 @@ module.exports = {
     includePattern: '\\.js$'
   },
   templates: {
-    copyright: 'Copyright 2024 Google LLC',
+    copyright: 'Copyright 2025 Google LLC',
     includeDate: false,
     sourceFiles: false,
     systemName: '@google-cloud/talent',

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

packages/google-cloud-talent/README.md

@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
 1.  [Enable the Google Cloud Talent Solution API][enable_api].
-1.  [Set up authentication with a service account][auth] so you can access the
+1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
 
 ### Installing the client library
@@ -176,4 +176,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 [projects]: https://console.cloud.google.com/project
 [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
 [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=jobs.googleapis.com
-[auth]: https://cloud.google.com/docs/authentication/getting-started
+[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local

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

@@ -261,7 +261,8 @@ message LocationFilter {
   // [PostingRegion.TELECOMMUTE][google.cloud.talent.v4.PostingRegion.TELECOMMUTE]
   // and have additional [Job.addresses][google.cloud.talent.v4.Job.addresses]
   // may still be matched based on other location filters using
-  // [address][google.cloud.talent.v4.LocationFilter.address] or [latlng][].
+  // [address][google.cloud.talent.v4.LocationFilter.address] or
+  // [lat_lng][google.cloud.talent.v4.LocationFilter.lat_lng].
   //
   // This filter can be used by itself to search exclusively for telecommuting
   // jobs, or it can be combined with another location

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

@@ -172,13 +172,16 @@ message Job {
   // search experience.
   //
   // Jobs with multiple addresses must have their addresses with the same
-  // [LocationType][] to allow location filtering to work properly. (For
-  // example, a Job with addresses "1600 Amphitheatre Parkway, Mountain View,
-  // CA, USA" and "London, UK" may not have location filters applied correctly
-  // at search time since the first is a [LocationType.STREET_ADDRESS][] and the
-  // second is a [LocationType.LOCALITY][].) If a job needs to have multiple
-  // addresses, it is suggested to split it into multiple jobs with same
-  // LocationTypes.
+  // [LocationType][google.cloud.talent.v4.Location.LocationType] to allow
+  // location filtering to work properly. (For example, a Job with addresses
+  // "1600 Amphitheatre Parkway, Mountain View, CA, USA" and "London, UK" may
+  // not have location filters applied correctly at search time since the first
+  // is a
+  // [LocationType.STREET_ADDRESS][google.cloud.talent.v4.Location.LocationType.STREET_ADDRESS]
+  // and the second is a
+  // [LocationType.LOCALITY][google.cloud.talent.v4.Location.LocationType.LOCALITY].)
+  // If a job needs to have multiple addresses, it is suggested to split it into
+  // multiple jobs with same LocationTypes.
   //
   // The maximum number of allowed characters is 500.
   repeated string addresses = 6;
@@ -339,10 +342,11 @@ message Job {
   // [posting_publish_time][google.cloud.talent.v4.Job.posting_publish_time]
   // must be set before
   // [posting_expire_time][google.cloud.talent.v4.Job.posting_expire_time]. The
-  // purpose of this feature is to allow other objects, such as [Application][],
-  // to refer a job that didn't exist in the system prior to becoming expired.
-  // If you want to modify a job that was expired on creation, delete it and
-  // create a new one.
+  // purpose of this feature is to allow other objects, such as
+  // [ApplicationInfo][google.cloud.talent.v4.Job.ApplicationInfo], to refer a
+  // job that didn't exist in the system prior to becoming expired. If you want
+  // to modify a job that was expired on creation, delete it and create a new
+  // one.
   //
   // If this value isn't provided at the time of job creation or is invalid,
   // 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

@@ -448,6 +448,27 @@ message SearchJobsRequest {
     KEYWORD_MATCH_TITLE_ONLY = 3;
   }
 
+  // The relevance threshold of the search results. The higher relevance
+  // threshold is, the higher relevant results are shown and the less number of
+  // results are returned.
+  enum RelevanceThreshold {
+    // Default value. In this case, server behavior defaults to Google defined
+    // threshold.
+    RELEVANCE_THRESHOLD_UNSPECIFIED = 0;
+
+    // Lowest relevance threshold.
+    LOWEST = 1;
+
+    // Low relevance threshold.
+    LOW = 2;
+
+    // Medium relevance threshold.
+    MEDIUM = 3;
+
+    // High relevance threshold.
+    HIGH = 4;
+  }
+
   // Custom ranking information for
   // [SearchJobsRequest][google.cloud.talent.v4.SearchJobsRequest].
   message CustomRankingInfo {
@@ -811,6 +832,14 @@ message SearchJobsRequest {
   // [KeywordMatchMode.KEYWORD_MATCH_ALL][google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode.KEYWORD_MATCH_ALL]
   // if no value is specified.
   KeywordMatchMode keyword_match_mode = 18;
+
+  // Optional. The relevance threshold of the search results.
+  //
+  // Default to Google defined threshold, leveraging a balance of
+  // precision and recall to deliver both highly accurate results and
+  // comprehensive coverage of relevant information.
+  RelevanceThreshold relevance_threshold = 19
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for SearchJob method.
@@ -939,7 +968,7 @@ message BatchUpdateJobsRequest {
   //
   // If [update_mask][google.cloud.talent.v4.BatchUpdateJobsRequest.update_mask]
   // is provided, The [Job][google.cloud.talent.v4.Job] inside
-  // [JobResult][JobOperationResult.JobResult]
+  // [JobResult][google.cloud.talent.v4.JobResult]
   // will only contains fields that is updated, plus the Id of the Job.
   // Otherwise,  [Job][google.cloud.talent.v4.Job] will include all fields,
   // which can yield a very large response.

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

@@ -486,6 +486,27 @@ message SearchJobsRequest {
     KEYWORD_MATCH_TITLE_ONLY = 3;
   }
 
+  // The relevance threshold of the search results. The higher relevance
+  // threshold is, the higher relevant results are shown and the less number of
+  // results are returned.
+  enum RelevanceThreshold {
+    // Default value. In this case, server behavior defaults to Google defined
+    // threshold.
+    RELEVANCE_THRESHOLD_UNSPECIFIED = 0;
+
+    // Lowest relevance threshold.
+    LOWEST = 1;
+
+    // Low relevance threshold.
+    LOW = 2;
+
+    // Medium relevance threshold.
+    MEDIUM = 3;
+
+    // High relevance threshold.
+    HIGH = 4;
+  }
+
   // Custom ranking information for
   // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
   message CustomRankingInfo {
@@ -856,6 +877,14 @@ message SearchJobsRequest {
   // [KeywordMatchMode.KEYWORD_MATCH_ALL][google.cloud.talent.v4beta1.SearchJobsRequest.KeywordMatchMode.KEYWORD_MATCH_ALL]
   // if no value is specified.
   KeywordMatchMode keyword_match_mode = 18;
+
+  // Optional. The relevance threshold of the search results.
+  //
+  // Default to Google defined threshold, leveraging a balance of
+  // precision and recall to deliver both highly accurate results and
+  // comprehensive coverage of relevant information.
+  RelevanceThreshold relevance_threshold = 19
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for SearchJob method.