google-cloud-talent 0.5.0 → 0.6.0

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

@@ -23,10 +23,8 @@ module Google
         #     Required. Resource name of the tenant under which the company is created.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenant/foo".
-        #
-        #     Tenant id is optional and a default tenant is created if unspecified, for
-        #     example, "projects/api-test-project".
+        #     "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+        #     is created, for example, "projects/foo".
         # @!attribute [rw] company
         #   @return [Google::Cloud::Talent::V4beta1::Company]
         #     Required. The company to be created.
@@ -41,7 +39,7 @@ module Google
         #     "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
         #     example, "projects/api-test-project/tenants/foo/companies/bar".
         #
-        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     If tenant id is unspecified, the default tenant is used, for
         #     example, "projects/api-test-project/companies/bar".
         class GetCompanyRequest; end
 
@@ -52,8 +50,7 @@ module Google
         #     system.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
-        #     Optional but strongly recommended for the best service
-        #     experience.
+        #     Strongly recommended for the best service experience.
         #
         #     If
         #     {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#update_mask update_mask}
@@ -73,10 +70,10 @@ module Google
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-        #     example, "projects/api-test-project/tenants/foo/companies/bar".
+        #     example, "projects/foo/tenants/bar/companies/baz".
         #
-        #     Tenant id is optional and the default tenant is used if unspecified, for
-        #     example, "projects/api-test-project/companies/bar".
+        #     If tenant id is unspecified, the default tenant is used, for
+        #     example, "projects/foo/companies/bar".
         class DeleteCompanyRequest; end
 
         # List companies for which the client has ACL visibility.
@@ -85,20 +82,20 @@ module Google
         #     Required. Resource name of the tenant under which the company is created.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenant/foo".
+        #     "projects/foo/tenant/bar".
         #
-        #     Tenant id is optional and the default tenant is used if unspecified, for
-        #     example, "projects/api-test-project".
+        #     If tenant id is unspecified, the default tenant will be used, for
+        #     example, "projects/foo".
         # @!attribute [rw] page_token
         #   @return [String]
-        #     Optional. The starting indicator from which to return results.
+        #     The starting indicator from which to return results.
         # @!attribute [rw] page_size
         #   @return [Integer]
-        #     Optional. The maximum number of companies to be returned, at most 100.
+        #     The maximum number of companies to be returned, at most 100.
         #     Default is 100 if a non-positive number is provided.
         # @!attribute [rw] require_open_jobs
         #   @return [true, false]
-        #     Optional. Set to true if the companies requested must have open jobs.
+        #     Set to true if the companies requested must have open jobs.
         #
         #     Defaults to false.
         #
@@ -107,8 +104,6 @@ module Google
         #     companies are fetched, among which only those with open jobs are returned.
         class ListCompaniesRequest; end
 
-        # Output only.
-        #
         # The List companies response object.
         # @!attribute [rw] companies
         #   @return [Array<Google::Cloud::Talent::V4beta1::Company>]

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

@@ -17,18 +17,16 @@ module Google
   module Cloud
     module Talent
       module V4beta1
-        # Input only.
-        #
         # Auto-complete parameters.
         # @!attribute [rw] parent
         #   @return [String]
         #     Required. Resource name of tenant the completion is performed within.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenant/foo".
+        #     "projects/foo/tenant/bar".
         #
-        #     Tenant id is optional and the default tenant is used if unspecified, for
-        #     example, "projects/api-test-project".
+        #     If tenant id is unspecified, the default tenant is used, for
+        #     example, "projects/foo".
         # @!attribute [rw] query
         #   @return [String]
         #     Required. The query used to generate suggestions.
@@ -36,7 +34,7 @@ module Google
         #     The maximum number of allowed characters is 255.
         # @!attribute [rw] language_codes
         #   @return [Array<String>]
-        #     Optional. The list of languages of the query. This is
+        #     The list of languages of the query. This is
         #     the BCP-47 language code, such as "en-US" or "sr-Latn".
         #     For more information, see
         #     [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
@@ -69,21 +67,21 @@ module Google
         #     The maximum allowed page size is 10.
         # @!attribute [rw] company
         #   @return [String]
-        #     Optional. If provided, restricts completion to specified company.
+        #     If provided, restricts completion to specified company.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-        #     example, "projects/api-test-project/tenants/foo/companies/bar".
+        #     example, "projects/foo/tenants/bar/companies/baz".
         #
-        #     Tenant id is optional and the default tenant is used if unspecified, for
-        #     example, "projects/api-test-project/companies/bar".
+        #     If tenant id is unspecified, the default tenant is used, for
+        #     example, "projects/foo".
         # @!attribute [rw] scope
         #   @return [Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope]
-        #     Optional. The scope of the completion. The defaults is
+        #     The scope of the completion. The defaults is
         #     {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope::PUBLIC CompletionScope::PUBLIC}.
         # @!attribute [rw] type
         #   @return [Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType]
-        #     Optional. The completion topic. The default is
+        #     The completion topic. The default is
         #     {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}.
         class CompleteQueryRequest
           # Enum to specify the scope of completion.
@@ -115,8 +113,6 @@ module Google
           end
         end
 
-        # Output only.
-        #
         # Response of auto-complete query.
         # @!attribute [rw] completion_results
         #   @return [Array<Google::Cloud::Talent::V4beta1::CompleteQueryResponse::CompletionResult>]
@@ -126,8 +122,6 @@ module Google
         #     Additional information for the API invocation, such as the request
         #     tracking id.
         class CompleteQueryResponse
-          # Output only.
-          #
           # Resource that represents completion results.
           # @!attribute [rw] suggestion
           #   @return [String]

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

@@ -24,7 +24,7 @@ module Google
         # with other calls, such as job searches, issued to the service by the client.
         # @!attribute [rw] request_id
         #   @return [String]
-        #     Optional but highly recommended.
+        #     Strongly recommended for the best service experience.
         #
         #     A unique ID generated in the API responses. It can be found in
         #     {Google::Cloud::Talent::V4beta1::ResponseMetadata#request_id ResponseMetadata#request_id}.
@@ -44,8 +44,8 @@ module Google
         #     that implements Cloud Talent Solution.
         # @!attribute [rw] event_notes
         #   @return [String]
-        #     Optional. Notes about the event provided by recruiters or other users, for
-        #     example, feedback on why a profile was bookmarked.
+        #     Notes about the event provided by recruiters or other users, for example,
+        #     feedback on why a profile was bookmarked.
         class ClientEvent; end
 
         # An event issued when a job seeker interacts with the application that
@@ -66,15 +66,15 @@ module Google
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-        #     example, "projects/api-test-project/tenants/foo/jobs/1234".
+        #     example, "projects/foo/tenants/bar/jobs/baz".
         # @!attribute [rw] profile
         #   @return [String]
-        #     Optional. The {Google::Cloud::Talent::V4beta1::Profile#name profile name}
-        #     associated with this client event.
+        #     The {Google::Cloud::Talent::V4beta1::Profile#name profile name} associated
+        #     with this client event.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-        #     for example, "projects/api-test-project/tenants/foo/profiles/bar".
+        #     for example, "projects/foo/tenants/bar/profiles/baz".
         class JobEvent
           # An enumeration of an event attributed to the behavior of the end user,
           # such as a job seeker.
@@ -189,16 +189,15 @@ module Google
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-        #     for example, "projects/api-test-project/tenants/foo/profiles/bar".
+        #     for example, "projects/foo/tenants/bar/profiles/baz".
         # @!attribute [rw] jobs
         #   @return [Array<String>]
-        #     Optional. The {Google::Cloud::Talent::V4beta1::Job#name job name(s)}
-        #     associated with this client event. Leave it empty if the event isn't
-        #     associated with a job.
+        #     The {Google::Cloud::Talent::V4beta1::Job#name job name(s)} associated with
+        #     this client event. Leave it empty if the event isn't associated with a job.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-        #     example, "projects/api-test-project/tenants/foo/jobs/1234".
+        #     example, "projects/foo/tenants/bar/jobs/baz".
         class ProfileEvent
           # The enum represents types of client events for a candidate profile.
           module ProfileEventType

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

@@ -23,10 +23,8 @@ module Google
         #     Required. Resource name of the tenant under which the event is created.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenant/foo".
-        #
-        #     Tenant id is optional and a default tenant is created if unspecified, for
-        #     example, "projects/api-test-project".
+        #     "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+        #     is created, for example, "projects/foo".
         # @!attribute [rw] client_event
         #   @return [Google::Cloud::Talent::V4beta1::ClientEvent]
         #     Required. Events issued when end user interacts with customer's application

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

@@ -17,18 +17,16 @@ module Google
   module Cloud
     module Talent
       module V4beta1
-        # Input only.
-        #
         # The query required to perform a search query.
         # @!attribute [rw] query
         #   @return [String]
-        #     Optional. The query string that matches against the job title, description,
-        #     and location fields.
+        #     The query string that matches against the job title, description, and
+        #     location fields.
         #
         #     The maximum number of allowed characters is 255.
         # @!attribute [rw] companies
         #   @return [Array<String>]
-        #     Optional. This filter specifies the company entities to search against.
+        #     This filter specifies the company entities to search against.
         #
         #     If a value isn't specified, jobs are searched for against all
         #     companies.
@@ -37,16 +35,16 @@ module Google
         #     companies specified.
         #
         #     The format is
-        #     "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-        #     example, "projects/api-test-project/tenants/foo/companies/bar".
+        #     "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". For
+        #     example, "projects/foo/tenants/bar/companies/baz".
         #
-        #     Tenant id is optional and the default tenant is used if unspecified, for
-        #     example, "projects/api-test-project/companies/bar".
+        #     If tenant id is unspecified, the default tenant is used. For
+        #     example, "projects/foo/companies/bar".
         #
         #     At most 20 company filters are allowed.
         # @!attribute [rw] location_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::LocationFilter>]
-        #     Optional. The location filter specifies geo-regions containing the jobs to
+        #     The location filter specifies geo-regions containing the jobs to
         #     search against. See
         #     {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more
         #     information.
@@ -62,9 +60,9 @@ module Google
         #     At most 5 location filters are allowed.
         # @!attribute [rw] job_categories
         #   @return [Array<Google::Cloud::Talent::V4beta1::JobCategory>]
-        #     Optional. The category filter specifies the categories of jobs to search
-        #     against. See {Google::Cloud::Talent::V4beta1::JobCategory JobCategory} for
-        #     more information.
+        #     The category filter specifies the categories of jobs to search against.
+        #     See {Google::Cloud::Talent::V4beta1::JobCategory JobCategory} for more
+        #     information.
         #
         #     If a value isn't specified, jobs from any category are searched against.
         #
@@ -72,8 +70,7 @@ module Google
         #     categories are searched against.
         # @!attribute [rw] commute_filter
         #   @return [Google::Cloud::Talent::V4beta1::CommuteFilter]
-        #     Optional. Allows filtering jobs by commute time with different travel
-        #     methods (for
+        #     Allows filtering jobs by commute time with different travel methods (for
         #      example, driving or public transit).
         #
         #     Note: This only works when you specify a
@@ -84,7 +81,7 @@ module Google
         #      Currently we don't support sorting by commute time.
         # @!attribute [rw] company_display_names
         #   @return [Array<String>]
-        #     Optional. This filter specifies the exact company
+        #     This filter specifies the exact company
         #     {Google::Cloud::Talent::V4beta1::Company#display_name Company#display_name} of
         #     the jobs to search against.
         #
@@ -97,14 +94,14 @@ module Google
         #     At most 20 company display name filters are allowed.
         # @!attribute [rw] compensation_filter
         #   @return [Google::Cloud::Talent::V4beta1::CompensationFilter]
-        #     Optional. This search filter is applied only to
+        #     This search filter is applied only to
         #     {Google::Cloud::Talent::V4beta1::Job#compensation_info Job#compensation_info}.
         #     For example, if the filter is specified as "Hourly job with per-hour
         #     compensation > $15", only jobs meeting these criteria are searched. If a
         #     filter isn't defined, all open jobs are searched.
         # @!attribute [rw] custom_attribute_filter
         #   @return [String]
-        #     Optional. This filter specifies a structured syntax to match against the
+        #     This filter specifies a structured syntax to match against the
         #     {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}
         #     marked as `filterable`.
         #
@@ -129,15 +126,15 @@ module Google
         #     driving_years > 10`
         # @!attribute [rw] disable_spell_check
         #   @return [true, false]
-        #     Optional. This flag controls the spell-check feature. If false, the
+        #     This flag controls the spell-check feature. If false, the
         #     service attempts to correct a misspelled query,
         #     for example, "enginee" is corrected to "engineer".
         #
         #     Defaults to false: a spell check is performed.
         # @!attribute [rw] employment_types
         #   @return [Array<Google::Cloud::Talent::V4beta1::EmploymentType>]
-        #     Optional. The employment type filter specifies the employment type of jobs
-        #     to search against, such as
+        #     The employment type filter specifies the employment type of jobs to
+        #     search against, such as
         #     {Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME EmploymentType::FULL_TIME}.
         #
         #     If a value isn't specified, jobs in the search results includes any
@@ -147,7 +144,7 @@ module Google
         #     any of the specified employment types.
         # @!attribute [rw] language_codes
         #   @return [Array<String>]
-        #     Optional. This filter specifies the locale of jobs to search against,
+        #     This filter specifies the locale of jobs to search against,
         #     for example, "en-US".
         #
         #     If a value isn't specified, the search results can contain jobs in any
@@ -161,12 +158,11 @@ module Google
         #     At most 10 language code filters are allowed.
         # @!attribute [rw] publish_time_range
         #   @return [Google::Cloud::Talent::V4beta1::TimestampRange]
-        #     Optional. Jobs published within a range specified by this filter are
-        #     searched against.
+        #     Jobs published within a range specified by this filter are searched
+        #     against.
         # @!attribute [rw] excluded_jobs
         #   @return [Array<String>]
-        #     Optional. This filter specifies a list of job names to be excluded during
-        #     search.
+        #     This filter specifies a list of job names to be excluded during search.
         #
         #     At most 400 excluded job names are allowed.
         class JobQuery; end
@@ -174,32 +170,50 @@ module Google
         # Filters to apply when performing the search query.
         # @!attribute [rw] query
         #   @return [String]
-        #     Optional. Keywords to match any text fields of profiles.
+        #     Keywords to match any text fields of profiles.
         #
         #     For example, "software engineer in Palo Alto".
         # @!attribute [rw] location_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::LocationFilter>]
-        #     Optional. The location filter specifies geo-regions containing the profiles
-        #     to search against. It filters against all of a profile's
+        #     The location filter specifies geo-regions containing the profiles to
+        #     search against.
+        #
+        #     One of
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter#address}
+        #     or
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng LocationFilter#lat_lng}
+        #     must be provided or an error is thrown. If both
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter#address}
+        #     and
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng LocationFilter#lat_lng}
+        #     are provided, an error is thrown.
+        #
+        #     The following logic is used to determine which locations in
+        #     the profile to filter against:
+        #     1. All of the profile's geocoded
         #     {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
+        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is true.
+        #     2. If the above set of locations is empty, all of the profile's geocoded
+        #     {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} where
+        #     {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
+        #     3. If the above set of locations is empty, all of the profile's geocoded
+        #     {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} where
+        #     {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is PERSONAL or
         #     CONTACT_INFO_USAGE_UNSPECIFIED and
-        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is false or
-        #     not set.
+        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is not set.
+        #
+        #     This means that any profiles without any
+        #     {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} that
+        #     match any of the above criteria will not be included in a search with
+        #     location filter. Furthermore, any
+        #     {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} where
+        #     {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is WORK or
+        #     SCHOOL or where
+        #     {Google::Cloud::Talent::V4beta1::Address#current Address#current} is false are
+        #     not considered for location filter.
         #
         #     If a location filter isn't specified, profiles fitting the other search
         #     criteria are retrieved regardless of where they're located.
@@ -215,7 +229,7 @@ module Google
         #     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.
+        #     cannot be geocoded, the filter falls back to keyword search.
         #
         #     If the detected
         #     {Google::Cloud::Talent::V4beta1::Location::LocationType LocationType} is
@@ -223,31 +237,46 @@ module Google
         #     {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 +
+        #     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 of 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.
+        #
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter#address}
+        #     is provided,
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     is the additional radius on top of the radius of the location geocoded from
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address LocationFilter#address}.
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng LocationFilter#lat_lng}
+        #     is provided,
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     is the only radius that is used.
+        #
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     is 10 by default. Note that the value of
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     is 0 if it is unset, so the server does not differentiate
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     that is explicitly set to 0 and
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     that is not set. Which means that if
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     is explicitly set to 0, the server will use the default value of
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     which is 10. To work around this and effectively set
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     to 0, we recommend setting
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     to a very small decimal number (such as 0.00001).
+        #
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     is negative, an error is thrown.
         # @!attribute [rw] job_title_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::JobTitleFilter>]
-        #     Optional. Job title filter specifies job titles of profiles to match on.
+        #     Job title filter specifies job titles of profiles to match on.
         #
         #     If a job title isn't specified, profiles with any titles are retrieved.
         #
@@ -261,7 +290,7 @@ module Google
         #     For example, search for profiles with a job title "Product Manager".
         # @!attribute [rw] employer_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::EmployerFilter>]
-        #     Optional. Employer filter specifies employers of profiles to match on.
+        #     Employer filter specifies employers of profiles to match on.
         #
         #     If an employer filter isn't specified, profiles with any employers are
         #     retrieved.
@@ -277,7 +306,7 @@ module Google
         #     LLC".
         # @!attribute [rw] education_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::EducationFilter>]
-        #     Optional. Education filter specifies education of profiles to match on.
+        #     Education filter specifies education of profiles to match on.
         #
         #     If an education filter isn't specified, profiles with any education are
         #     retrieved.
@@ -292,7 +321,7 @@ module Google
         #     For example, search for profiles with a master degree.
         # @!attribute [rw] skill_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::SkillFilter>]
-        #     Optional. Skill filter specifies skill of profiles to match on.
+        #     Skill filter specifies skill of profiles to match on.
         #
         #     If a skill filter isn't specified, profiles with any skills are retrieved.
         #
@@ -306,8 +335,8 @@ module Google
         #     list.
         # @!attribute [rw] work_experience_filter
         #   @return [Array<Google::Cloud::Talent::V4beta1::WorkExperienceFilter>]
-        #     Optional. Work experience filter specifies the total working experience of
-        #     profiles to match on.
+        #     Work experience filter specifies the total working experience of profiles
+        #     to match on.
         #
         #     If a work experience filter isn't specified, profiles with any
         #     professional experience are retrieved.
@@ -318,29 +347,26 @@ module Google
         #     For example, search for profiles with 10 years of work experience.
         # @!attribute [rw] time_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::TimeFilter>]
-        #     Optional. Time filter specifies the create/update timestamp of the profiles
-        #     to match on.
+        #     Time filter specifies the create/update timestamp of the profiles to match
+        #     on.
         #
         #     For example, search for profiles created since "2018-1-1".
         # @!attribute [rw] hirable_filter
         #   @return [Google::Protobuf::BoolValue]
-        #     Optional. The hirable filter specifies the profile's hirable status to
-        #     match on.
+        #     The hirable filter specifies the profile's hirable status to match on.
         # @!attribute [rw] application_date_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::ApplicationDateFilter>]
-        #     Optional. The application date filters specify application date ranges to
-        #     match on.
+        #     The application date filters specify application date ranges to match on.
         # @!attribute [rw] application_outcome_notes_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::ApplicationOutcomeNotesFilter>]
-        #     Optional. The application outcome notes filters specify the notes for the
-        #     outcome of the job application.
+        #     The application outcome notes filters specify the notes for the outcome of
+        #     the job application.
         # @!attribute [rw] application_job_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::ApplicationJobFilter>]
-        #     Optional. The application job filters specify the job applied for in the
-        #     application.
+        #     The application job filters specify the job applied for in the application.
         # @!attribute [rw] custom_attribute_filter
         #   @return [String]
-        #     Optional. This filter specifies a structured syntax to match against the
+        #     This filter specifies a structured syntax to match against the
         #     {Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile#custom_attributes}
         #     that are marked as `filterable`.
         #
@@ -367,8 +393,10 @@ module Google
         #     (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1))
         # @!attribute [rw] candidate_availability_filter
         #   @return [Google::Cloud::Talent::V4beta1::CandidateAvailabilityFilter]
-        #     Optional. The candidate availability filter which filters based on
-        #     availability signals.
+        #     Deprecated. Use availability_filters instead.
+        #
+        #     The candidate availability filter which filters based on availability
+        #     signals.
         #
         #     Signal 1: Number of days since most recent job application.  See
         #     {Google::Cloud::Talent::V4beta1::Availability::JobApplicationAvailabilitySignal Availability::JobApplicationAvailabilitySignal}
@@ -383,9 +411,27 @@ 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] availability_filters
+        #   @return [Array<Google::Cloud::Talent::V4beta1::AvailabilityFilter>]
+        #     The availability filter which filters based on
+        #     {Google::Cloud::Talent::V4beta1::Profile#availability_signals Profile#availability_signals}.
+        #
+        #     The availability filter helps a recruiter understand if a
+        #     specific candidate is likely to be actively seeking new job opportunities
+        #     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.
+        #
+        #     There can be at most one
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} per
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter#signal_type signal_type}.
+        #     If there are multiple
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} for a
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter#signal_type signal_type},
+        #     an error is thrown.
         # @!attribute [rw] person_name_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::PersonNameFilter>]
-        #     Optional. Person name filter specifies person name of profiles to match on.
+        #     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.
@@ -393,17 +439,15 @@ module Google
         #     For example, search for profiles of candidates with name "John Smith".
         class ProfileQuery; end
 
-        # Input only.
-        #
         # Geographic region of the search.
         # @!attribute [rw] address
         #   @return [String]
-        #     Optional. The address name, such as "Mountain View" or "Bay Area".
+        #     The address name, such as "Mountain View" or "Bay Area".
         # @!attribute [rw] region_code
         #   @return [String]
-        #     Optional. 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".
+        #     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
@@ -415,16 +459,16 @@ 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 to search
-        #     from. This field is ignored if `address` is provided.
+        #     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. This field is ignored if the
-        #     location being searched for is a state or larger.
+        #     The distance_in_miles is applied when the location being searched 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
+        #     Allows the client to return jobs without a
         #     set location, specifically, telecommuting jobs (telecommuting is considered
         #     by the service as a special location.
         #     {Google::Cloud::Talent::V4beta1::Job#posting_region Job#posting_region}
@@ -447,8 +491,8 @@ module Google
         #     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
-        #     filter are excluded.
+        #     Whether to apply negation to the filter so profiles matching the filter
+        #     are excluded.
         #
         #     Currently only supported in profile search.
         class LocationFilter
@@ -465,8 +509,6 @@ module Google
           end
         end
 
-        # Input only.
-        #
         # Filter on job compensation type and amount.
         # @!attribute [rw] type
         #   @return [Google::Cloud::Talent::V4beta1::CompensationFilter::FilterType]
@@ -477,11 +519,11 @@ module Google
         #     {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo::CompensationUnit}.
         # @!attribute [rw] range
         #   @return [Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationRange]
-        #     Optional. Compensation range.
+        #     Compensation range.
         # @!attribute [rw] include_jobs_with_unspecified_compensation_range
         #   @return [true, false]
-        #     Optional. If set to true, jobs with unspecified compensation range fields
-        #     are included.
+        #     If set to true, jobs with unspecified compensation range fields are
+        #     included.
         class CompensationFilter
           # Specify the type of filtering.
           module FilterType
@@ -530,37 +572,32 @@ module Google
           end
         end
 
-        # Input only.
-        #
         # Parameters needed for commute search.
         # @!attribute [rw] commute_method
         #   @return [Google::Cloud::Talent::V4beta1::CommuteMethod]
-        #     Required. The method of transportation for which to calculate the commute
-        #     time.
+        #     Required. The method of transportation to calculate the commute time for.
         # @!attribute [rw] start_coordinates
         #   @return [Google::Type::LatLng]
-        #     Required. The latitude and longitude of the location from which to
-        #     calculate the commute time.
+        #     Required. The latitude and longitude of the location to calculate the
+        #     commute time from.
         # @!attribute [rw] travel_duration
         #   @return [Google::Protobuf::Duration]
         #     Required. The maximum travel time in seconds. The maximum allowed value is
         #     `3600s` (one hour). Format is `123s`.
         # @!attribute [rw] allow_imprecise_addresses
         #   @return [true, false]
-        #     Optional. If `true`, jobs without street level addresses may also be
-        #     returned. For city level addresses, the city center is used. For state and
-        #     coarser level addresses, text matching is used. If this field is set to
-        #     `false` or isn't specified, only jobs that include street level addresses
-        #     will be returned by commute search.
+        #     If `true`, jobs without street level addresses may also be returned.
+        #     For city level addresses, the city center is used. For state and coarser
+        #     level addresses, text matching is used.
+        #     If this field is set to `false` or isn't specified, only jobs that include
+        #     street level addresses will be returned by commute search.
         # @!attribute [rw] road_traffic
         #   @return [Google::Cloud::Talent::V4beta1::CommuteFilter::RoadTraffic]
-        #     Optional. Specifies the traffic density to use when calculating commute
-        #     time.
+        #     Specifies the traffic density to use when calculating commute time.
         # @!attribute [rw] departure_time
         #   @return [Google::Type::TimeOfDay]
-        #     Optional. The departure time used to calculate traffic impact,
-        #     represented as {Google::Type::TimeOfDay} in local
-        #     time zone.
+        #     The departure time used to calculate traffic impact, represented as
+        #     {Google::Type::TimeOfDay} in local time zone.
         #
         #     Currently traffic model is restricted to hour level resolution.
         class CommuteFilter
@@ -577,40 +614,34 @@ module Google
           end
         end
 
-        # Input only.
-        #
         # Job title of the search.
         # @!attribute [rw] job_title
         #   @return [String]
-        #     Required. The job title, for example, "Software engineer", or "Product
+        #     Required. The job title. For example, "Software engineer", or "Product
         #     manager".
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. Whether to apply negation to the filter so profiles matching the
-        #     filter are excluded.
+        #     Whether to apply negation to the filter so profiles matching the filter
+        #     are excluded.
         class JobTitleFilter; end
 
-        # Input only.
-        #
         # Skill filter of the search.
         # @!attribute [rw] skill
         #   @return [String]
         #     Required. The skill name. For example, "java", "j2ee", and so on.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. Whether to apply negation to the filter so profiles matching the
-        #     filter are excluded.
+        #     Whether to apply negation to the filter so profiles matching the filter
+        #     are excluded.
         class SkillFilter; end
 
-        # Input only.
-        #
         # Employer filter of the search.
         # @!attribute [rw] employer
         #   @return [String]
         #     Required. The name of the employer, for example "Google", "Alphabet".
         # @!attribute [rw] mode
         #   @return [Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode]
-        #     Optional. Define set of
+        #     Define set of
         #     {Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord}s to search
         #     against.
         #
@@ -618,8 +649,8 @@ module Google
         #     {Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode::ALL_EMPLOYMENT_RECORDS EmployerFilterMode::ALL_EMPLOYMENT_RECORDS}.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. Whether to apply negation to the filter so profiles matching the
-        #     filter is excluded.
+        #     Whether to apply negation to the filter so profiles matching the filter
+        #     is excluded.
         class EmployerFilter
           # Enum indicating which set of
           # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}
@@ -642,31 +673,26 @@ module Google
           end
         end
 
-        # Input only.
-        #
         # Education filter of the search.
         # @!attribute [rw] school
         #   @return [String]
-        #     Optional. The school name. For example "MIT", "University of California,
-        #     Berkeley".
+        #     The school name. For example "MIT", "University of California, Berkeley".
         # @!attribute [rw] field_of_study
         #   @return [String]
-        #     Optional. The field of study. This is to search against value provided in
+        #     The field of study. This is to search against value provided in
         #     {Google::Cloud::Talent::V4beta1::Degree#fields_of_study Degree#fields_of_study}.
         #     For example "Computer Science", "Mathematics".
         # @!attribute [rw] degree_type
         #   @return [Google::Cloud::Talent::V4beta1::DegreeType]
-        #     Optional. Education degree in ISCED code. Each value in degree covers a
-        #     specific level of education, without any expansion to upper nor lower
-        #     levels of education degree.
+        #     Education degree in ISCED code. Each value in degree covers a specific
+        #     level of education, without any expansion to upper nor lower levels of
+        #     education degree.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. Whether to apply negation to the filter so profiles matching the
-        #     filter is excluded.
+        #     Whether to apply negation to the filter so profiles matching the filter
+        #     is excluded.
         class EducationFilter; end
 
-        # Input only.
-        #
         # Work experience filter.
         #
         # This filter is used to search for profiles with working experience length
@@ -676,14 +702,12 @@ module Google
         # {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#max_experience max_experience}.
         # @!attribute [rw] min_experience
         #   @return [Google::Protobuf::Duration]
-        #     Optional. The minimum duration of the work experience (inclusive).
+        #     The minimum duration of the work experience (inclusive).
         # @!attribute [rw] max_experience
         #   @return [Google::Protobuf::Duration]
-        #     Optional. The maximum duration of the work experience (exclusive).
+        #     The maximum duration of the work experience (exclusive).
         class WorkExperienceFilter; end
 
-        # Input only.
-        #
         # Application Date Range Filter.
         #
         # The API matches profiles with
@@ -695,16 +719,14 @@ module Google
         # are missing.
         # @!attribute [rw] start_date
         #   @return [Google::Type::Date]
-        #     Optional. Start date. If it's missing, The API matches profiles with
-        #     application date not after the end date.
+        #     Start date. If it's missing, The API matches profiles with application date
+        #     not after the end date.
         # @!attribute [rw] end_date
         #   @return [Google::Type::Date]
-        #     Optional. End date. If it's missing, The API matches profiles with
-        #     application date not before the start date.
+        #     End date. If it's missing, The API matches profiles with application date
+        #     not before the start date.
         class ApplicationDateFilter; end
 
-        # Input only.
-        #
         # Outcome Notes Filter.
         # @!attribute [rw] outcome_notes
         #   @return [String]
@@ -714,48 +736,43 @@ module Google
         #     in profiles.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. If true, The API excludes all candidates with any
+        #     If true, The API excludes all candidates with any
         #     {Google::Cloud::Talent::V4beta1::Application#outcome_notes Application#outcome_notes}
         #     matching the outcome reason specified in the filter.
         class ApplicationOutcomeNotesFilter; end
 
-        # Input only.
-        #
         # Filter on the job information of Application.
         # @!attribute [rw] job_requisition_id
         #   @return [String]
-        #     Optional. The job requisition id in the application. The API does an exact
-        #     match on the
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id} of
+        #     The job requisition id in the application. The API does an exact match on
+        #     the {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id} of
         #     {Google::Cloud::Talent::V4beta1::Application#job Application#job} in profiles.
         # @!attribute [rw] job_title
         #   @return [String]
-        #     Optional. The job title in the application. The API does an exact match on
-        #     the {Google::Cloud::Talent::V4beta1::Job#title Job#title} of
+        #     The job title in the application. The API does an exact match on the
+        #     {Google::Cloud::Talent::V4beta1::Job#title Job#title} of
         #     {Google::Cloud::Talent::V4beta1::Application#job Application#job} in profiles.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. If true, the API excludes all profiles with any
+        #     If true, the API excludes all profiles with any
         #     {Google::Cloud::Talent::V4beta1::Application#job Application#job} matching the
         #     filters.
         class ApplicationJobFilter; end
 
-        # Input only.
-        #
         # Filter on create timestamp or update timestamp of profiles.
         # @!attribute [rw] start_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Optional. Start timestamp, matching profiles with the start time. If this
-        #     field missing, The API matches profiles with create / update timestamp
-        #     before the end timestamp.
+        #     Start timestamp, matching profiles with the start time. If this field
+        #     missing, The API matches profiles with create / update timestamp before the
+        #     end timestamp.
         # @!attribute [rw] end_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Optional. End timestamp, matching profiles with the end time. If this field
+        #     End timestamp, matching profiles with the end time. If this field
         #     missing, The API matches profiles with create / update timestamp after the
         #     start timestamp.
         # @!attribute [rw] time_field
         #   @return [Google::Cloud::Talent::V4beta1::TimeFilter::TimeField]
-        #     Optional. Specifies which time field to filter profiles.
+        #     Specifies which time field to filter profiles.
         #
         #     Defaults to
         #     {Google::Cloud::Talent::V4beta1::TimeFilter::TimeField::CREATE_TIME TimeField::CREATE_TIME}.
@@ -773,17 +790,33 @@ module Google
           end
         end
 
-        # Input only
+        # Deprecated. Use AvailabilityFilter instead.
         #
         # Filter on availability signals.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional. It is false by default. If true, API excludes all the potential
-        #     available profiles.
+        #     It is false by default. If true, API excludes all the potential available
+        #     profiles.
         class CandidateAvailabilityFilter; end
 
-        # Input only.
-        #
+        # Filter on availability signals.
+        # @!attribute [rw] signal_type
+        #   @return [Google::Cloud::Talent::V4beta1::AvailabilitySignalType]
+        #     Required. Type of signal to apply filter on.
+        # @!attribute [rw] range
+        #   @return [Google::Cloud::Talent::V4beta1::TimestampRange]
+        #     Required. Range of times to filter candidate signals by.
+        # @!attribute [rw] required
+        #   @return [true, false]
+        #     If multiple
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} are
+        #     provided, the default behavior is to OR all filters, but if this field is
+        #     set to true, this particular
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} will
+        #     be AND'ed against other
+        #     {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter}.
+        class AvailabilityFilter; end
+
         # Filter on person name.
         # @!attribute [rw] person_name
         #   @return [String]