feat: A new enum RelevanceThreshold is added

Google APIs · copybara-github · commit c72d73854355 · 2025-01-02T15:13:59.000-08:00
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
diff --git a/google/cloud/talent/v4/filters.proto b/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
diff --git a/google/cloud/talent/v4/job.proto b/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
diff --git a/google/cloud/talent/v4/job_service.proto b/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.
