feat: Add a new operator on companyDisplayNames filter to further sup…

…port fuzzy match by treating input value as a multi word token

feat: Add a new option TELECOMMUTE_JOBS_EXCLUDED under enum TelecommutePreference to completely filter out the telecommute jobs in response
docs: Deprecate option TELECOMMUTE_EXCLUDED under enum TelecommutePreference

PiperOrigin-RevId: 450699841

google/cloud/talent/v4/filters.proto

@@ -96,14 +96,22 @@ message JobQuery {
 
   // This filter specifies the company [Company.display_name][google.cloud.talent.v4.Company.display_name]
   // of the jobs to search against. The company name must match the value
-  // exactly (case sensitive).
+  // exactly.
   //
-  // Alternatively, if the value being searched for is wrapped in
-  // `SUBSTRING_MATCH([value])`, the company name must contain a case
-  // insensitive substring match of the value. Using this function may increase
-  // latency.
+  // Alternatively, the value being searched for can be wrapped in different
+  // match operators.
+  // `SUBSTRING_MATCH([value])`
+  // The company name must contain a case insensitive substring match of the
+  // value. Using this function may increase latency.
   //
-  // Sample Values: `["Google LLC", "SUBSTRING_MATCH(google)"]`
+  // Sample Value: `SUBSTRING_MATCH(google)`
+  //
+  // `MULTI_WORD_TOKEN_MATCH([value])`
+  // The value will be treated as a multi word token and the company name must
+  // contain a case insensitive match of the value. Using this function may
+  // increase latency.
+  //
+  // Sample Value: `MULTI_WORD_TOKEN_MATCH(google)`
   //
   // If a value isn't specified, jobs within the search results are
   // associated with any company.
@@ -193,11 +201,15 @@ message LocationFilter {
     // Default value if the telecommute preference isn't specified.
     TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0;
 
-    // Exclude telecommute jobs.
-    TELECOMMUTE_EXCLUDED = 1;
+    // Deprecated: Ignore telecommute status of jobs. Use
+    // TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.
+    TELECOMMUTE_EXCLUDED = 1 [deprecated = true];
 
     // Allow telecommute jobs.
     TELECOMMUTE_ALLOWED = 2;
+
+    // Exclude telecommute jobs.
+    TELECOMMUTE_JOBS_EXCLUDED = 3;
   }
 
   // The address name, such as "Mountain View" or "Bay Area".
@@ -231,7 +243,7 @@ message LocationFilter {
 
   // Allows the client to return jobs without a
   // set location, specifically, telecommuting jobs (telecommuting is considered
-  // by the service as a special location.
+  // by the service as a special location).
   // [Job.posting_region][google.cloud.talent.v4.Job.posting_region] indicates if a job permits telecommuting.
   // If this field is set to [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED],
   // telecommuting jobs are searched, and [address][google.cloud.talent.v4.LocationFilter.address] and [lat_lng][google.cloud.talent.v4.LocationFilter.lat_lng] are