feat: Add new commute methods in Search APIs

google-cloud-talent/src/main/java/com/google/cloud/talent/v4/JobServiceClient.java

@@ -976,16 +976,20 @@ public final UnaryCallable<BatchDeleteJobsRequest, Operation> batchDeleteJobsCal
    *     <p>Supported operator: =, AND
    *     <p>The fields eligible for filtering are:
    *     <ul>
-   *       <li>`companyName` (Required)
+   *       <li>`companyName`
    *       <li>`requisitionId`
    *       <li>`status` Available values: OPEN, EXPIRED, ALL. Defaults to OPEN if no value is
    *           specified.
    *     </ul>
+   *     <p>At least one of `companyName` and `requisitionId` must present or an INVALID_ARGUMENT
+   *     error is thrown.
    *     <p>Sample Query:
    *     <ul>
    *       <li>companyName = "projects/foo/tenants/bar/companies/baz"
    *       <li>companyName = "projects/foo/tenants/bar/companies/baz" AND requisitionId = "req-1"
    *       <li>companyName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED"
+   *       <li>requisitionId = "req-1"
+   *       <li>requisitionId = "req-1" AND status = "EXPIRED"
    *     </ul>
    *
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -1022,16 +1026,20 @@ public final ListJobsPagedResponse listJobs(TenantName parent, String filter) {
    *     <p>Supported operator: =, AND
    *     <p>The fields eligible for filtering are:
    *     <ul>
-   *       <li>`companyName` (Required)
+   *       <li>`companyName`
    *       <li>`requisitionId`
    *       <li>`status` Available values: OPEN, EXPIRED, ALL. Defaults to OPEN if no value is
    *           specified.
    *     </ul>
+   *     <p>At least one of `companyName` and `requisitionId` must present or an INVALID_ARGUMENT
+   *     error is thrown.
    *     <p>Sample Query:
    *     <ul>
    *       <li>companyName = "projects/foo/tenants/bar/companies/baz"
    *       <li>companyName = "projects/foo/tenants/bar/companies/baz" AND requisitionId = "req-1"
    *       <li>companyName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED"
+   *       <li>requisitionId = "req-1"
+   *       <li>requisitionId = "req-1" AND status = "EXPIRED"
    *     </ul>
    *
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails

proto-google-cloud-talent-v4/src/main/java/com/google/cloud/talent/v4/CommonProto.java

@@ -209,12 +209,13 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "_PUBLIC\020\003\032\002\030\001*q\n\020HtmlSanitization\022!\n\035HTM"
           + "L_SANITIZATION_UNSPECIFIED\020\000\022\036\n\032HTML_SAN"
           + "ITIZATION_DISABLED\020\001\022\032\n\026SIMPLE_FORMATTIN"
-          + "G_ONLY\020\002*I\n\rCommuteMethod\022\036\n\032COMMUTE_MET"
+          + "G_ONLY\020\002*{\n\rCommuteMethod\022\036\n\032COMMUTE_MET"
           + "HOD_UNSPECIFIED\020\000\022\013\n\007DRIVING\020\001\022\013\n\007TRANSI"
-          + "T\020\002Bo\n\032com.google.cloud.talent.v4B\013Commo"
-          + "nProtoP\001Z<google.golang.org/genproto/goo"
-          + "gleapis/cloud/talent/v4;talent\242\002\003CTSb\006pr"
-          + "oto3"
+          + "T\020\002\022\013\n\007WALKING\020\003\022\013\n\007CYCLING\020\004\022\026\n\022TRANSIT"
+          + "_ACCESSIBLE\020\005Bo\n\032com.google.cloud.talent"
+          + ".v4B\013CommonProtoP\001Z<google.golang.org/ge"
+          + "nproto/googleapis/cloud/talent/v4;talent"
+          + "\242\002\003CTSb\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(

proto-google-cloud-talent-v4/src/main/java/com/google/cloud/talent/v4/CommuteMethod.java

@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Method for commute.
+ * Method for commute. Walking, biking and wheelchair accessible transit is
+ * still in the Preview stage.
  * </pre>
  *
  * Protobuf enum {@code google.cloud.talent.v4.CommuteMethod}
@@ -59,6 +60,37 @@ public enum CommuteMethod implements com.google.protobuf.ProtocolMessageEnum {
    * <code>TRANSIT = 2;</code>
    */
   TRANSIT(2),
+  /**
+   *
+   *
+   * <pre>
+   * Commute time is calculated based on walking time.
+   * </pre>
+   *
+   * <code>WALKING = 3;</code>
+   */
+  WALKING(3),
+  /**
+   *
+   *
+   * <pre>
+   * Commute time is calculated based on biking time.
+   * </pre>
+   *
+   * <code>CYCLING = 4;</code>
+   */
+  CYCLING(4),
+  /**
+   *
+   *
+   * <pre>
+   * Commute time is calculated based on public transit that is wheelchair
+   * accessible.
+   * </pre>
+   *
+   * <code>TRANSIT_ACCESSIBLE = 5;</code>
+   */
+  TRANSIT_ACCESSIBLE(5),
   UNRECOGNIZED(-1),
   ;
 
@@ -93,6 +125,37 @@ public enum CommuteMethod implements com.google.protobuf.ProtocolMessageEnum {
    * <code>TRANSIT = 2;</code>
    */
   public static final int TRANSIT_VALUE = 2;
+  /**
+   *
+   *
+   * <pre>
+   * Commute time is calculated based on walking time.
+   * </pre>
+   *
+   * <code>WALKING = 3;</code>
+   */
+  public static final int WALKING_VALUE = 3;
+  /**
+   *
+   *
+   * <pre>
+   * Commute time is calculated based on biking time.
+   * </pre>
+   *
+   * <code>CYCLING = 4;</code>
+   */
+  public static final int CYCLING_VALUE = 4;
+  /**
+   *
+   *
+   * <pre>
+   * Commute time is calculated based on public transit that is wheelchair
+   * accessible.
+   * </pre>
+   *
+   * <code>TRANSIT_ACCESSIBLE = 5;</code>
+   */
+  public static final int TRANSIT_ACCESSIBLE_VALUE = 5;
 
   public final int getNumber() {
     if (this == UNRECOGNIZED) {
@@ -124,6 +187,12 @@ public static CommuteMethod forNumber(int value) {
         return DRIVING;
       case 2:
         return TRANSIT;
+      case 3:
+        return WALKING;
+      case 4:
+        return CYCLING;
+      case 5:
+        return TRANSIT_ACCESSIBLE;
       default:
         return null;
     }

proto-google-cloud-talent-v4/src/main/java/com/google/cloud/talent/v4/Job.java

@@ -4544,6 +4544,14 @@ public com.google.protobuf.ByteString getDescriptionBytes() {
    * be preserved, a custom field should be used for storage. It is also
    * suggested to group the locations that close to each other in the same job
    * for better 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.
    * The maximum number of allowed characters is 500.
    * </pre>
    *
@@ -4570,6 +4578,14 @@ public com.google.protobuf.ProtocolStringList getAddressesList() {
    * be preserved, a custom field should be used for storage. It is also
    * suggested to group the locations that close to each other in the same job
    * for better 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.
    * The maximum number of allowed characters is 500.
    * </pre>
    *
@@ -4596,6 +4612,14 @@ public int getAddressesCount() {
    * be preserved, a custom field should be used for storage. It is also
    * suggested to group the locations that close to each other in the same job
    * for better 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.
    * The maximum number of allowed characters is 500.
    * </pre>
    *
@@ -4623,6 +4647,14 @@ public java.lang.String getAddresses(int index) {
    * be preserved, a custom field should be used for storage. It is also
    * suggested to group the locations that close to each other in the same job
    * for better 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.
    * The maximum number of allowed characters is 500.
    * </pre>
    *
@@ -7880,6 +7912,14 @@ private void ensureAddressesIsMutable() {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -7906,6 +7946,14 @@ public com.google.protobuf.ProtocolStringList getAddressesList() {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -7932,6 +7980,14 @@ public int getAddressesCount() {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -7959,6 +8015,14 @@ public java.lang.String getAddresses(int index) {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -7986,6 +8050,14 @@ public com.google.protobuf.ByteString getAddressesBytes(int index) {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -8020,6 +8092,14 @@ public Builder setAddresses(int index, java.lang.String value) {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -8053,6 +8133,14 @@ public Builder addAddresses(java.lang.String value) {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -8083,6 +8171,14 @@ public Builder addAllAddresses(java.lang.Iterable<java.lang.String> values) {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *
@@ -8112,6 +8208,14 @@ public Builder clearAddresses() {
      * be preserved, a custom field should be used for storage. It is also
      * suggested to group the locations that close to each other in the same job
      * for better 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.
      * The maximum number of allowed characters is 500.
      * </pre>
      *