google-cloud-talent 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4240a9b4a6731603514cb9f8f2a34e0f6481f41fd7482db81adea356e002039
-  data.tar.gz: 785e8fa1983f0ff3aba1bdaa89ed0f6a93b82b3b0a6a78bf5e2a0c509fe2edca
+  metadata.gz: 67e8fdd557ba658880dff6da7b8256c04f1756cacc3b09ae1e10212c746a3544
+  data.tar.gz: 3163e6199676c0da144b31bd4c63fadc368c8672623b4124542fadff6a4bee2f
 SHA512:
-  metadata.gz: 1dcb7f63d1ef2af26b3f3988197ab9297c3205957a861d6df125cf615f0a00bbd05bed42cd3cc84dde79019689afee2a371b4f90d453653e59eb13bc29949255
-  data.tar.gz: 65269a50cd272863dc22ffd153ca27b8695b4d7dbfa41f38a600fb14f9aa191b870d1cd8fa533ddbcfaa6285822bb90f55b6abf8873ae93d52abc0a29923690e
+  metadata.gz: c595609ef157a40bb4664cf306edd24efefcc846be9779f4a0f521326ede8bbd002c0c6ce16a759a61e7b0651d35f343dbd018b35be0a1f449c5e4165ddc2099
+  data.tar.gz: 412f771c9b5e8a0345242838c5175eadde38845ad3dffe175d73649e84c491f69ecd470809ca5eae2483eee0c21df942e87fe09818be6e811623e257aeb01528

data/README.md

@@ -13,7 +13,7 @@ steps:
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
 3. [Enable the Cloud Talent Solution API.](https://console.cloud.google.com/apis/library/talent.googleapis.com)
-4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-talent/latest/file.AUTHENTICATION.html)
 
 ### Installation
 ```
@@ -28,14 +28,14 @@ $ gem install google-cloud-talent
 - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
   to see the full list of Cloud APIs that we cover.
 
-[Client Library Documentation]: https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-talent/latest/google/cloud/talent/v4beta1
+[Client Library Documentation]: https://googleapis.dev/ruby/google-cloud-talent/latest
 [Product Documentation]: https://cloud.google.com/talent-solution
 
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

data/lib/google/cloud/talent.rb

@@ -35,7 +35,7 @@ module Google
     # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
     # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
     # 3. [Enable the Cloud Talent Solution API.](https://console.cloud.google.com/apis/library/talent.googleapis.com)
-    # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-talent/latest/file.AUTHENTICATION.html)
     #
     # ### Installation
     # ```
@@ -54,7 +54,7 @@ module Google
     #
     # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
     # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-    # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
     # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
     # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
     #

data/lib/google/cloud/talent/v4beta1.rb

@@ -43,7 +43,7 @@ module Google
       # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
       # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
       # 3. [Enable the Cloud Talent Solution API.](https://console.cloud.google.com/apis/library/talent.googleapis.com)
-      # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-talent/latest/file.AUTHENTICATION.html)
       #
       # ### Installation
       # ```
@@ -62,7 +62,7 @@ module Google
       #
       # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
       # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
       # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
       # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
       #

data/lib/google/cloud/talent/v4beta1/application_service_client_config.json

@@ -21,27 +21,27 @@
       },
       "methods": {
         "CreateApplication": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "GetApplication": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "UpdateApplication": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "DeleteApplication": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "ListApplications": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         }

data/lib/google/cloud/talent/v4beta1/company_service_client.rb

@@ -75,6 +75,18 @@ module Google
 
           private_constant :COMPANY_PATH_TEMPLATE
 
+          COMPANY_WITHOUT_TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/companies/{company}"
+          )
+
+          private_constant :COMPANY_WITHOUT_TENANT_PATH_TEMPLATE
+
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}"
+          )
+
+          private_constant :PROJECT_PATH_TEMPLATE
+
           TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/tenants/{tenant}"
           )
@@ -94,6 +106,26 @@ module Google
             )
           end
 
+          # Returns a fully-qualified company_without_tenant resource name string.
+          # @param project [String]
+          # @param company [String]
+          # @return [String]
+          def self.company_without_tenant_path project, company
+            COMPANY_WITHOUT_TENANT_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"company" => company
+            )
+          end
+
+          # Returns a fully-qualified project resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
           # Returns a fully-qualified tenant resource name string.
           # @param project [String]
           # @param tenant [String]

data/lib/google/cloud/talent/v4beta1/company_service_client_config.json

@@ -21,27 +21,27 @@
       },
       "methods": {
         "CreateCompany": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "GetCompany": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "UpdateCompany": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "DeleteCompany": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "ListCompanies": {
-          "timeout_millis": 30000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         }

data/lib/google/cloud/talent/v4beta1/completion_client.rb

@@ -66,6 +66,18 @@ module Google
 
           private_constant :COMPANY_PATH_TEMPLATE
 
+          COMPANY_WITHOUT_TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/companies/{company}"
+          )
+
+          private_constant :COMPANY_WITHOUT_TENANT_PATH_TEMPLATE
+
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}"
+          )
+
+          private_constant :PROJECT_PATH_TEMPLATE
+
           TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/tenants/{tenant}"
           )
@@ -85,6 +97,26 @@ module Google
             )
           end
 
+          # Returns a fully-qualified company_without_tenant resource name string.
+          # @param project [String]
+          # @param company [String]
+          # @return [String]
+          def self.company_without_tenant_path project, company
+            COMPANY_WITHOUT_TENANT_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"company" => company
+            )
+          end
+
+          # Returns a fully-qualified project resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
           # Returns a fully-qualified tenant resource name string.
           # @param project [String]
           # @param tenant [String]

data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/common.rb

@@ -227,7 +227,7 @@ module Google
         #     `CASE_INSENSITIVE_MATCH`) search.
         #     For filterable `string_value`s, a maximum total number of 200 values
         #     is allowed, with each `string_value` has a byte size of no more than
-        #     255B. For unfilterable `string_values`, the maximum total byte size of
+        #     500B. For unfilterable `string_values`, the maximum total byte size of
         #     unfilterable `string_values` is 50KB.
         #
         #     Empty string isn't allowed.
@@ -968,6 +968,8 @@ module Google
           EXPERT = 5
         end
 
+        # Deprecated. All resources are only visible to the owner.
+        #
         # An enum that represents who has view access to the resource.
         module Visibility
           # Default value.

data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company.rb

@@ -35,7 +35,7 @@ module Google
         #     example, "projects/api-test-project/companies/bar".
         # @!attribute [rw] display_name
         #   @return [String]
-        #     Required. The display name of the company, for example, "Google, LLC".
+        #     Required. The display name of the company, for example, "Google LLC".
         # @!attribute [rw] external_id
         #   @return [String]
         #     Required. Client side company identifier, used to uniquely identify the

data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event.rb

@@ -207,80 +207,26 @@ module Google
 
             # Send this event when a
             # {Google::Cloud::Talent::V4beta1::ProfileEvent#profiles ProfileEvent#profiles}
-            # meets all of the following criteria:
-            # * Was sent as a part of a result set for a CTS API call.
-            # * Was rendered in the end user's UI (that is, the
-            #   {Google::Cloud::Talent::V4beta1::ProfileEvent#recruiter ProfileEvent#recruiter}).
-            # * That UI rendering was displayed in the end user's viewport for >=3
-            #   seconds.
-            #
-            # In other words, send this event when the end user of the CTS service
-            # actually saw a resulting profile in their viewport.
-            #
-            # To understand how to use this event, consider an example:
-            #
-            # * The customer's UI for interacting with CTS
-            #   result sets is accessed by the end user through a web browser.
-            # * The UI calls for a page size of 15 candidates (that is, 15 candidates
-            #   are rendered on each page of results).
-            # * However, the UI design calls for only 5 candidates to be shown at any
-            #   given time in the viewport (that is, the end user can only see 5 results
-            #   at any given time and needs to scroll up or down to view all 15 results).
-            #
-            # To render each page of results, the customer will send a
-            # request to CTS with a page size = 15.
-            #
-            # * User loads page #1 of results.
-            # * User scrolls down to expose results #1 - #5 and dwells on this view for
-            #   30 seconds.
-            # * Send an IMPRESSION event for result 1, 2, 3, 4, 5.
-            # * User scrolls down a bit, exposing results #2 - #6 in the viewport and
-            #   dwells on this view for 5 minutes.
-            # * Send an IMPRESSION event for result 6.
-            # * User scrolls to the bottom of the page, with results #7 - #15 shown in
-            #   the viewport for ~5 seconds each.
-            # * Specifically, NO IMPRESSION events are sent for result 7, 8, 9, 10, 11,
-            #   12, 13, 14, 15.
-            # * User clicks to the next page and loads page #2 of results.
-            # * Within 2 seconds, user scrolls to expose results #20 - #24 in the
-            #   viewport and dwells on this view for 20 mins.
-            # * Send an IMPRESSION event for result 20, 21, 22, 23, 24
-            # * User closes their browser window.
+            # was sent as a part of a result set for a CTS API call and was rendered in
+            # the end user's UI (that is, the
+            # {Google::Cloud::Talent::V4beta1::ProfileEvent#recruiter ProfileEvent#recruiter}).
             IMPRESSION = 1
 
-            # The VIEW event allows CTS to understand if a candidate's profile was
-            # viewed by an end user (that is, recruiter) of the system for >=3 seconds.
-            # This is critical to tracking product metrics and should be sent for every
-            # profile VIEW that happens in the customer's system.
-            #
-            # VIEW events should be sent whether an end user views a candidate's
-            # profile as a result of seeing that profile in the result set of a
-            # CTS API request or whether the end user
-            # views the profile for some other reason (that is, clicks to the
-            # candidate's profile in the ATS, and so on).
+            # The VIEW event records the action of a candidate's profile being
+            # viewed by an end user. This is critical to tracking product metrics and
+            # should be sent for every profile VIEW that happens in your system,
+            # whether the event is associated with an API call (for example, a
+            # recruiter making a request for a result set and clicking on a profile)
+            # or not (a recruiter using the system to view profile details without
+            # making a request).
             #
-            # For a VIEW that happens as a result of seeing the profile in
-            # a CTS API request's result set, the
+            # For a VIEW events associated with API calls, the
             # {Google::Cloud::Talent::V4beta1::ClientEvent#request_id ClientEvent#request_id}
-            # should be populated.  If the VIEW happens for some other reason, the
-            # [requestId] should not be populated.
+            # should be populated.  If the VIEW is not associated with an API call,
+            # {Google::Cloud::Talent::V4beta1::ClientEvent#request_id request_id} should
+            # not be populated.
             #
             # This event requires a valid recruiter and one valid ID in profiles.
-            #
-            # To understand how to use this event, consider 2 examples in which a VIEW
-            # event should be sent:
-            # * End user makes a request to the CTS API for a result set.
-            # * Results for the request are shown to the end user.
-            # * End user clicks on one of the candidates that are shown as part of the
-            #   results.
-            # * A VIEW event with the
-            #   {Google::Cloud::Talent::V4beta1::ClientEvent#request_id ClientEvent#request_id}
-            #   of the API call in the first step of this example is sent.
-            #
-            # * End user browses to a candidate's profile in the ATS.
-            # * A VIEW event without a
-            #   {Google::Cloud::Talent::V4beta1::ClientEvent#request_id ClientEvent#request_id}
-            #   is sent.
             VIEW = 2
 
             # The profile is bookmarked.

data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/filters.rb

@@ -122,7 +122,7 @@ module Google
         #     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 < 3000 bytes in length.
+        #     must be < 6000 bytes in length.
         #
         #     Sample Query:
         #     `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND
@@ -180,7 +180,26 @@ module Google
         # @!attribute [rw] location_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::LocationFilter>]
         #     Optional. The location filter specifies geo-regions containing the profiles
-        #     to search against.
+        #     to search against. It filters against all of a profile's
+        #     {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} where
+        #     {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is PERSONAL and
+        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is true. If
+        #     no such address exists, a fallback logic is applied in an attempt to
+        #     determine the profile's primary address.
+        #
+        #     The fallback logic selects an address from a profile's
+        #     {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} in the
+        #     following order of priority:
+        #     1. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is PERSONAL
+        #     and {Google::Cloud::Talent::V4beta1::Address#current Address#current} is false
+        #     or not set.
+        #     2. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is
+        #     CONTACT_INFO_USAGE_UNSPECIFIED and
+        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is true.
+        #     3. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is
+        #     CONTACT_INFO_USAGE_UNSPECIFIED and
+        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is false or
+        #     not set.
         #
         #     If a location filter isn't specified, profiles fitting the other search
         #     criteria are retrieved regardless of where they're located.
@@ -189,7 +208,43 @@ module Google
         #     {Google::Cloud::Talent::V4beta1::LocationFilter#negated 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
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter#address}
+        #     is provided, the
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType LocationType}, center
+        #     point (latitude and longitude), and radius are automatically detected by
+        #     the Google Maps Geocoding API and included as well. If
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter#address}
+        #     is not recognized as a location, the filter falls back to keyword search.
+        #
+        #     If the detected
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType LocationType} is
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::SUB_ADMINISTRATIVE_AREA LocationType::SUB_ADMINISTRATIVE_AREA},
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::ADMINISTRATIVE_AREA LocationType::ADMINISTRATIVE_AREA},
+        #     or
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::COUNTRY 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 +
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}.
+        #     3. If the detected
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType LocationType} is one of
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::SUB_LOCALITY LocationType::SUB_LOCALITY},
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::SUB_LOCALITY_2 LocationType::SUB_LOCALITY_2},
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::NEIGHBORHOOD LocationType::NEIGHBORHOOD},
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::POSTAL_CODE LocationType::POSTAL_CODE},
+        #     or
+        #     {Google::Cloud::Talent::V4beta1::Location::LocationType::STREET_ADDRESS 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.
         # @!attribute [rw] job_title_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::JobTitleFilter>]
         #     Optional. Job title filter specifies job titles of profiles to match on.
@@ -328,6 +383,14 @@ module Google
         #     based on an aggregated set of signals.  Specifically, the intent is NOT to
         #     indicate the candidate's potential qualification / interest / close ability
         #     for a specific job.
+        # @!attribute [rw] person_name_filters
+        #   @return [Array<Google::Cloud::Talent::V4beta1::PersonNameFilter>]
+        #     Optional. Person name filter specifies person name of profiles to match on.
+        #
+        #     If multiple person name filters are specified, profiles that match any
+        #     person name filters are retrieved.
+        #
+        #     For example, search for profiles of candidates with name "John Smith".
         class ProfileQuery; end
 
         # Input only.
@@ -342,8 +405,9 @@ module Google
         #     used to address ambiguity of the user-input location, for example,
         #     "Liverpool" against "Liverpool, NY, US" or "Liverpool, UK".
         #
-        #     Set this field if all the jobs to search against are from a same region,
-        #     or jobs are world-wide, but the job seeker is from a specific region.
+        #     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.
         #
         #     See http://cldr.unicode.org/ and
         #     http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
@@ -351,13 +415,13 @@ module Google
         #     Note that this filter is not applicable for Profile Search related queries.
         # @!attribute [rw] lat_lng
         #   @return [Google::Type::LatLng]
-        #     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.
         # @!attribute [rw] distance_in_miles
         #   @return [Float]
         #     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.
         # @!attribute [rw] telecommute_preference
         #   @return [Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference]
         #     Optional. Allows the client to return jobs without a
@@ -379,6 +443,8 @@ module Google
         #     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.
         # @!attribute [rw] negated
         #   @return [true, false]
         #     Optional. Whether to apply negation to the filter so profiles matching the
@@ -386,7 +452,7 @@ module Google
         #
         #     Currently only supported in profile search.
         class LocationFilter
-          # Specify whether including telecommute jobs.
+          # Specify whether to include telecommute jobs.
           module TelecommutePreference
             # Default value if the telecommute preference isn't specified.
             TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0
@@ -715,6 +781,19 @@ module Google
         #     Optional. It is false by default. If true, API excludes all the potential
         #     available profiles.
         class CandidateAvailabilityFilter; end
+
+        # Input only.
+        #
+        # Filter on person name.
+        # @!attribute [rw] person_name
+        #   @return [String]
+        #     Required. The person name. For example, "John Smith".
+        #
+        #     Can be any combination of {PersonName#structured_name#given_name},
+        #     {PersonName#structured_name#middle_initial},
+        #     {PersonName#structured_name#family_name}, and
+        #     {Google::Cloud::Talent::V4beta1::PersonName#formatted_name PersonName#formatted_name}.
+        class PersonNameFilter; end
       end
     end
   end