From f6cc01ff6d13bda19ed717dfde6e92c593dfc590 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Fri, 16 Aug 2019 13:09:51 -0700 Subject: [PATCH] Synchronize new proto/yaml changes. PiperOrigin-RevId: 263831339 --- google/cloud/talent/BUILD.bazel | 1 + google/cloud/talent/v4beta1/common.proto | 4 ++ google/cloud/talent/v4beta1/filters.proto | 50 ++++++++++++++++--- google/cloud/talent/v4beta1/job.proto | 6 ++- google/cloud/talent/v4beta1/job_service.proto | 1 - .../talent/v4beta1/profile_service.proto | 4 +- 6 files changed, 55 insertions(+), 11 deletions(-) create mode 100644 google/cloud/talent/BUILD.bazel diff --git a/google/cloud/talent/BUILD.bazel b/google/cloud/talent/BUILD.bazel new file mode 100644 index 00000000..a87c57fe --- /dev/null +++ b/google/cloud/talent/BUILD.bazel @@ -0,0 +1 @@ +exports_files(glob(["*.yaml"])) diff --git a/google/cloud/talent/v4beta1/common.proto b/google/cloud/talent/v4beta1/common.proto index d364c112..6294f4a5 100644 --- a/google/cloud/talent/v4beta1/common.proto +++ b/google/cloud/talent/v4beta1/common.proto @@ -442,8 +442,12 @@ enum PostingRegion { TELECOMMUTE = 3; } +// Deprecated. All resources are only visible to the owner. +// // An enum that represents who has view access to the resource. enum Visibility { + option deprecated = true; + // Default value. VISIBILITY_UNSPECIFIED = 0; diff --git a/google/cloud/talent/v4beta1/filters.proto b/google/cloud/talent/v4beta1/filters.proto index 9ebd6c20..bc81003d 100644 --- a/google/cloud/talent/v4beta1/filters.proto +++ b/google/cloud/talent/v4beta1/filters.proto @@ -222,7 +222,43 @@ message ProfileQuery { // [LocationFilter.negated][google.cloud.talent.v4beta1.LocationFilter.negated] // is specified, the result doesn't contain profiles from that location. // - // For example, search for profiles with addresses in "New York City". + // If + // [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] + // is provided, the + // [LocationType][google.cloud.talent.v4beta1.Location.LocationType], center + // point (latitude and longitude), and radius are automatically detected by + // the Google Maps Geocoding API and included as well. If + // [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] + // is not recognized as a location, the filter falls back to keyword search. + // + // If the detected + // [LocationType][google.cloud.talent.v4beta1.Location.LocationType] is + // [LocationType.SUB_ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.Location.LocationType.SUB_ADMINISTRATIVE_AREA], + // [LocationType.ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.Location.LocationType.ADMINISTRATIVE_AREA], + // or + // [LocationType.COUNTRY][google.cloud.talent.v4beta1.Location.LocationType.COUNTRY], + // or location is recognized but a radius can not be determined by the + // geo-coder, the filter is performed against the detected location name + // (using exact text matching). Otherwise, the filter is performed against the + // detected center point and a radius. The largest value from among the + // following options is automatically set as the radius value: + // 1. 10 miles. + // 2. Detected location radius + + // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles]. + // 3. If the detected + // [LocationType][google.cloud.talent.v4beta1.Location.LocationType] is one of + // [LocationType.SUB_LOCALITY][google.cloud.talent.v4beta1.Location.LocationType.SUB_LOCALITY], + // [LocationType.SUB_LOCALITY_2][google.cloud.talent.v4beta1.Location.LocationType.SUB_LOCALITY_2], + // [LocationType.NEIGHBORHOOD][google.cloud.talent.v4beta1.Location.LocationType.NEIGHBORHOOD], + // [LocationType.POSTAL_CODE][google.cloud.talent.v4beta1.Location.LocationType.POSTAL_CODE], + // or + // [LocationType.STREET_ADDRESS][google.cloud.talent.v4beta1.Location.LocationType.STREET_ADDRESS], + // the following two values are calculated and the larger of the two is + // compared to #1 and #2, above: + // - Calculated radius of the city (from the city center) that contains the + // geo-coded location. + // - Distance from the city center (of the city containing the geo-coded + // location) to the detected location center + 0.5 miles. repeated LocationFilter location_filters = 2; // Optional. Job title filter specifies job titles of profiles to match on. @@ -376,7 +412,7 @@ message ProfileQuery { // // Geographic region of the search. message LocationFilter { - // Specify whether including telecommute jobs. + // Specify whether to include telecommute jobs. enum TelecommutePreference { // Default value if the telecommute preference isn't specified. TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0; @@ -405,13 +441,13 @@ message LocationFilter { // Note that this filter is not applicable for Profile Search related queries. string region_code = 2; - // Optional. The latitude and longitude of the geographic center from which to - // search. This field's ignored if `address` is provided. + // Optional. The latitude and longitude of the geographic center to search + // from. This field is ignored if `address` is provided. google.type.LatLng lat_lng = 3; // Optional. The distance_in_miles is applied when the location being searched - // for is identified as a city or smaller. When the location being searched - // for is a state or larger, this field is ignored. + // for is identified as a city or smaller. This field is ignored if the + // location being searched for is a state or larger. double distance_in_miles = 4; // Optional. Allows the client to return jobs without a @@ -433,6 +469,8 @@ message LocationFilter { // such as "Mountain View" or "telecommuting" jobs. However, when used in // combination with other location filters, telecommuting jobs can be // treated as less relevant than other jobs in the search response. + // + // This field is only used for job search requests. TelecommutePreference telecommute_preference = 5; // Optional. Whether to apply negation to the filter so profiles matching the diff --git a/google/cloud/talent/v4beta1/job.proto b/google/cloud/talent/v4beta1/job.proto index b851d796..5c0837d0 100644 --- a/google/cloud/talent/v4beta1/job.proto +++ b/google/cloud/talent/v4beta1/job.proto @@ -285,12 +285,14 @@ message Job { // the same location level as this field is strongly recommended. PostingRegion posting_region = 20; - // Optional. The visibility of the job. + // Deprecated. The job is only visible to the owner. + // + // The visibility of the job. // // Defaults to // [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4beta1.Visibility.ACCOUNT_ONLY] // if not specified. - Visibility visibility = 21; + Visibility visibility = 21 [deprecated = true]; // Optional. The start timestamp of the job in UTC time zone. Typically this // field is used for contracting engagements. Invalid timestamps are ignored. diff --git a/google/cloud/talent/v4beta1/job_service.proto b/google/cloud/talent/v4beta1/job_service.proto index a79dcc50..4b5d9204 100644 --- a/google/cloud/talent/v4beta1/job_service.proto +++ b/google/cloud/talent/v4beta1/job_service.proto @@ -19,7 +19,6 @@ package google.cloud.talent.v4beta1; import "google/api/annotations.proto"; import "google/api/client.proto"; -import "google/cloud/talent/v4beta1/batch.proto"; import "google/cloud/talent/v4beta1/common.proto"; import "google/cloud/talent/v4beta1/filters.proto"; import "google/cloud/talent/v4beta1/histogram.proto"; diff --git a/google/cloud/talent/v4beta1/profile_service.proto b/google/cloud/talent/v4beta1/profile_service.proto index 111a9f81..67483ce1 100644 --- a/google/cloud/talent/v4beta1/profile_service.proto +++ b/google/cloud/talent/v4beta1/profile_service.proto @@ -281,11 +281,11 @@ message SearchProfilesRequest { // // * "relevance desc": By descending relevance, as determined by the API // algorithms. - // * "update_time desc": Sort by + // * "update_date desc": Sort by // [Profile.update_time][google.cloud.talent.v4beta1.Profile.update_time] in // descending order // (recently updated profiles first). - // * "create_time desc": Sort by + // * "create_date desc": Sort by // [Profile.create_time][google.cloud.talent.v4beta1.Profile.create_time] in // descending order // (recently created profiles first).