diff --git a/google/cloud/talent_v4/services/job_service/async_client.py b/google/cloud/talent_v4/services/job_service/async_client.py index fa14c796..2ea17bab 100644 --- a/google/cloud/talent_v4/services/job_service/async_client.py +++ b/google/cloud/talent_v4/services/job_service/async_client.py @@ -843,11 +843,14 @@ async def list_jobs( The fields eligible for filtering are: - - ``companyName`` (Required) + - ``companyName`` - ``requisitionId`` - ``status`` Available values: OPEN, EXPIRED, ALL. Defaults to OPEN if no value is specified. + At least one of ``companyName`` and ``requisitionId`` + must present or an INVALID_ARGUMENT error is thrown. + Sample Query: - companyName = @@ -858,6 +861,8 @@ async def list_jobs( - companyName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED" + - requisitionId = "req-1" + - requisitionId = "req-1" AND status = "EXPIRED" This corresponds to the ``filter`` field on the ``request`` instance; if ``request`` is provided, this diff --git a/google/cloud/talent_v4/services/job_service/client.py b/google/cloud/talent_v4/services/job_service/client.py index 5a4fcdb3..52e02fc3 100644 --- a/google/cloud/talent_v4/services/job_service/client.py +++ b/google/cloud/talent_v4/services/job_service/client.py @@ -1041,11 +1041,14 @@ def list_jobs( The fields eligible for filtering are: - - ``companyName`` (Required) + - ``companyName`` - ``requisitionId`` - ``status`` Available values: OPEN, EXPIRED, ALL. Defaults to OPEN if no value is specified. + At least one of ``companyName`` and ``requisitionId`` + must present or an INVALID_ARGUMENT error is thrown. + Sample Query: - companyName = @@ -1056,6 +1059,8 @@ def list_jobs( - companyName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED" + - requisitionId = "req-1" + - requisitionId = "req-1" AND status = "EXPIRED" This corresponds to the ``filter`` field on the ``request`` instance; if ``request`` is provided, this diff --git a/google/cloud/talent_v4/types/common.py b/google/cloud/talent_v4/types/common.py index 8db18e62..dbd4978b 100644 --- a/google/cloud/talent_v4/types/common.py +++ b/google/cloud/talent_v4/types/common.py @@ -194,10 +194,15 @@ class HtmlSanitization(proto.Enum): class CommuteMethod(proto.Enum): - r"""Method for commute.""" + r"""Method for commute. Walking, biking and wheelchair accessible + transit is still in the Preview stage. + """ COMMUTE_METHOD_UNSPECIFIED = 0 DRIVING = 1 TRANSIT = 2 + WALKING = 3 + CYCLING = 4 + TRANSIT_ACCESSIBLE = 5 class TimestampRange(proto.Message): diff --git a/google/cloud/talent_v4/types/filters.py b/google/cloud/talent_v4/types/filters.py index 1e046b5f..258a2dcf 100644 --- a/google/cloud/talent_v4/types/filters.py +++ b/google/cloud/talent_v4/types/filters.py @@ -142,7 +142,7 @@ class JobQuery(proto.Message): Boolean expressions (AND/OR/NOT) are supported up to 3 levels of nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum of 100 comparisons or functions are - allowed in the expression. The expression must be < 6000 + allowed in the expression. The expression must be < 10000 bytes in length. Sample Query: @@ -216,17 +216,24 @@ class LocationFilter(proto.Message): The address name, such as "Mountain View" or "Bay Area". region_code (str): - CLDR region code of the country/region of the address. This - is used to address ambiguity of the user-input location, for - example, "Liverpool" against "Liverpool, NY, US" or - "Liverpool, UK". - - Set this field to bias location resolution toward a specific - country or territory. If this field is not set, application - behavior is biased toward the United States by default. + CLDR region code of the country/region. This field may be + used in two ways: + + 1) If telecommute preference is not set, this field is used + address ambiguity of the user-input address. For example, + "Liverpool" may refer to "Liverpool, NY, US" or + "Liverpool, UK". This region code biases the address + resolution toward a specific country or territory. If + this field is not set, address resolution is biased + toward the United States by default. + + 2) If telecommute preference is set to TELECOMMUTE_ALLOWED, + the telecommute location filter will be limited to the + region specified in this field. If this field is not set, + the telecommute job locations will not be See - https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/territory_information.html for details. Example: "CH" for Switzerland. lat_lng (google.type.latlng_pb2.LatLng): The latitude and longitude of the geographic center to diff --git a/google/cloud/talent_v4/types/job.py b/google/cloud/talent_v4/types/job.py index 2acf9b72..8a2c0d32 100644 --- a/google/cloud/talent_v4/types/job.py +++ b/google/cloud/talent_v4/types/job.py @@ -107,6 +107,17 @@ class Job(proto.Message): 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. application_info (google.cloud.talent_v4.types.Job.ApplicationInfo): Job application information. diff --git a/google/cloud/talent_v4/types/job_service.py b/google/cloud/talent_v4/types/job_service.py index 90edb34d..91d1314e 100644 --- a/google/cloud/talent_v4/types/job_service.py +++ b/google/cloud/talent_v4/types/job_service.py @@ -148,18 +148,23 @@ class ListJobsRequest(proto.Message): The fields eligible for filtering are: - - ``companyName`` (Required) + - ``companyName`` - ``requisitionId`` - ``status`` Available values: OPEN, EXPIRED, ALL. Defaults to OPEN if no value is specified. + At least one of ``companyName`` and ``requisitionId`` must + present or an INVALID_ARGUMENT error is thrown. + Sample Query: - companyName = "projects/foo/tenants/bar/companies/baz" - companyName = "projects/foo/tenants/bar/companies/baz" AND requisitionId = "req-1" - companyName = "projects/foo/tenants/bar/companies/baz" - AND status = "EXPIRED". + AND status = "EXPIRED" + - requisitionId = "req-1" + - requisitionId = "req-1" AND status = "EXPIRED". page_token (str): The starting point of a query result. page_size (int): @@ -287,6 +292,9 @@ class SearchJobsRequest(proto.Message): - company_size: histogram by [CompanySize][google.cloud.talent.v4.CompanySize], for example, "SMALL", "MEDIUM", "BIG". + - publish_time_in_day: histogram by the + [Job.posting_publish_time][google.cloud.talent.v4.Job.posting_publish_time] + in days. Must specify list of numeric buckets in spec. - publish_time_in_month: histogram by the [Job.posting_publish_time][google.cloud.talent.v4.Job.posting_publish_time] in months. Must specify list of numeric buckets in spec. @@ -351,7 +359,7 @@ class SearchJobsRequest(proto.Message): - ``count(admin1)`` - ``count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])`` - ``count(string_custom_attribute["some-string-custom-attribute"])`` - - ``count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])`` + - ``count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`` job_view (google.cloud.talent_v4.types.JobView): The desired job attributes returned for jobs in the search response. Defaults to