google-cloud-talent 0.3.0 → 0.4.0

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

@@ -20,9 +20,7 @@ module Google
         # The report event request.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     Resource name of the tenant under which the event is created.
+        #     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".
@@ -31,10 +29,8 @@ module Google
         #     example, "projects/api-test-project".
         # @!attribute [rw] client_event
         #   @return [Google::Cloud::Talent::V4beta1::ClientEvent]
-        #     Required.
-        #
-        #     Events issued when end user interacts with customer's application that
-        #     uses Cloud Talent Solution.
+        #     Required. Events issued when end user interacts with customer's application
+        #     that uses Cloud Talent Solution.
         class CreateClientEventRequest; end
       end
     end

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

@@ -22,17 +22,13 @@ module Google
         # 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.
+        #     Optional. 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.
+        #     Optional. This filter specifies the company entities to search against.
         #
         #     If a value isn't specified, jobs are searched for against all
         #     companies.
@@ -50,26 +46,25 @@ module Google
         #     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
-        #     search against. See {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more information.
+        #     Optional. The location filter specifies geo-regions containing the jobs to
+        #     search against. See
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more
+        #     information.
         #
         #     If a location value isn't specified, jobs fitting the other search
         #     criteria are retrieved regardless of where they're located.
         #
         #     If multiple values are specified, jobs are retrieved from any of the
         #     specified locations. If different values are specified for the
-        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles} parameter, the maximum provided
-        #     distance is used for all locations.
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
+        #     parameter, the maximum provided distance is used for all locations.
         #
         #     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 {Category} for more information.
+        #     Optional. 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.
         #
@@ -77,20 +72,21 @@ module Google
         #     categories are searched against.
         # @!attribute [rw] commute_filter
         #   @return [Google::Cloud::Talent::V4beta1::CommuteFilter]
-        #     Optional.
+        #     Optional. Allows filtering jobs by commute time with different travel
+        #     methods (for
+        #      example, driving or public transit).
         #
-        #      Allows filtering jobs by commute time with different travel methods (for
-        #      example, driving or public transit). Note: This only works with [COMMUTE
-        #      MODE][Mode#COMMUTE]. When specified, [JobQuery.location_filters] is
-        #      ignored.
+        #     Note: This only works when you specify a
+        #     {Google::Cloud::Talent::V4beta1::CommuteMethod CommuteMethod}. In this case,
+        #     {Google::Cloud::Talent::V4beta1::JobQuery#location_filters location_filters}
+        #     is ignored.
         #
         #      Currently we don't support sorting by commute time.
         # @!attribute [rw] company_display_names
         #   @return [Array<String>]
-        #     Optional.
-        #
-        #     This filter specifies the exact [company display
-        #     name][Company.display_name] of the jobs to search against.
+        #     Optional. This filter specifies the exact company
+        #     {Google::Cloud::Talent::V4beta1::Company#display_name Company#display_name} of
+        #     the jobs to search against.
         #
         #     If a value isn't specified, jobs within the search results are
         #     associated with any company.
@@ -101,19 +97,16 @@ 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
-        #     {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.
+        #     Optional. 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
-        #     {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes} marked as `filterable`.
+        #     Optional. This filter specifies a structured syntax to match against the
+        #     {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}
+        #     marked as `filterable`.
         #
         #     The syntax for this expression is a subset of SQL syntax.
         #
@@ -136,19 +129,16 @@ module Google
         #     driving_years > 10`
         # @!attribute [rw] disable_spell_check
         #   @return [true, false]
-        #     Optional.
-        #
-        #     This flag controls the spell-check feature. If false, the
+        #     Optional. 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 {Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME EmploymentType::FULL_TIME}.
+        #     Optional. 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
         #     employment type.
@@ -157,9 +147,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,
+        #     Optional. 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
@@ -173,15 +161,12 @@ 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.
+        #     Optional. 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.
+        #     Optional. This filter specifies a list of job names to be excluded during
+        #     search.
         #
         #     At most 400 excluded job names are allowed.
         class JobQuery; end
@@ -189,45 +174,39 @@ module Google
         # Filters to apply when performing the search query.
         # @!attribute [rw] query
         #   @return [String]
-        #     Optional.
-        #
-        #     Keywords to match any text fields of profiles.
+        #     Optional. 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.
+        #     Optional. The location filter specifies geo-regions containing the profiles
+        #     to search against.
         #
         #     If a location filter isn't specified, profiles fitting the other search
         #     criteria are retrieved regardless of where they're located.
         #
-        #     If {Google::Cloud::Talent::V4beta1::LocationFilter#negated LocationFilter#negated} is specified, the result doesn't contain
-        #     profiles from that location.
+        #     If
+        #     {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".
         # @!attribute [rw] job_title_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::JobTitleFilter>]
-        #     Optional.
-        #
-        #     Job title filter specifies job titles of profiles to match on.
+        #     Optional. Job title filter specifies job titles of profiles to match on.
         #
         #     If a job title isn't specified, profiles with any titles are retrieved.
         #
         #     If multiple values are specified, profiles are retrieved with any of the
         #     specified job titles.
         #
-        #     If {Google::Cloud::Talent::V4beta1::JobTitleFilter#negated JobTitleFilter#negated} is specified, the result won't contain
-        #     profiles with the job titles.
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::JobTitleFilter#negated JobTitleFilter#negated}
+        #     is specified, the result won't contain profiles with the job titles.
         #
         #     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.
+        #     Optional. Employer filter specifies employers of profiles to match on.
         #
         #     If an employer filter isn't specified, profiles with any employers are
         #     retrieved.
@@ -235,16 +214,15 @@ module Google
         #     If multiple employer filters are specified, profiles with any matching
         #     employers are retrieved.
         #
-        #     If {Google::Cloud::Talent::V4beta1::EmployerFilter#negated EmployerFilter#negated} is specified, the result won't contain
-        #     profiles that match the employers.
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::EmployerFilter#negated EmployerFilter#negated}
+        #     is specified, the result won't contain profiles that match the employers.
         #
         #     For example, search for profiles that have working experience at "Google
         #     LLC".
         # @!attribute [rw] education_filters
         #   @return [Array<Google::Cloud::Talent::V4beta1::EducationFilter>]
-        #     Optional.
-        #
-        #     Education filter specifies education of profiles to match on.
+        #     Optional. Education filter specifies education of profiles to match on.
         #
         #     If an education filter isn't specified, profiles with any education are
         #     retrieved.
@@ -252,32 +230,29 @@ module Google
         #     If multiple education filters are specified, profiles that match any
         #     education filters are retrieved.
         #
-        #     If {Google::Cloud::Talent::V4beta1::EducationFilter#negated EducationFilter#negated} is specified, the result won't contain
-        #     profiles that match the educations.
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::EducationFilter#negated EducationFilter#negated}
+        #     is specified, the result won't contain profiles that match the educations.
         #
         #     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.
+        #     Optional. Skill filter specifies skill of profiles to match on.
         #
         #     If a skill filter isn't specified, profiles with any skills are retrieved.
         #
         #     If multiple skill filters are specified, profiles that match any skill
         #     filters are retrieved.
         #
-        #     If {Google::Cloud::Talent::V4beta1::SkillFilter#negated SkillFilter#negated} is specified, the result won't contain profiles
-        #     that match the skills.
+        #     If {Google::Cloud::Talent::V4beta1::SkillFilter#negated SkillFilter#negated}
+        #     is specified, the result won't contain profiles that match the skills.
         #
         #     For example, search for profiles that have "Java" and "Python" in skill
         #     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.
+        #     Optional. 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.
@@ -288,39 +263,31 @@ 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.
+        #     Optional. 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.
+        #     Optional. 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.
+        #     Optional. 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.
+        #     Optional. 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.
+        #     Optional. 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
-        #     {Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile#custom_attributes} that are marked as `filterable`.
+        #     Optional. 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`.
         #
         #     The syntax for this expression is a subset of Google SQL syntax.
         #
@@ -343,6 +310,24 @@ module Google
         #
         #     Sample Query:
         #     (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.
+        #
+        #     Signal 1: Number of days since most recent job application.  See
+        #     {Google::Cloud::Talent::V4beta1::Availability::JobApplicationAvailabilitySignal Availability::JobApplicationAvailabilitySignal}
+        #     for the details of this signal.
+        #
+        #     Signal 2: Number of days since last profile update. See
+        #     {Google::Cloud::Talent::V4beta1::Availability::ProfileUpdateAvailabilitySignal Availability::ProfileUpdateAvailabilitySignal}
+        #     for the details of this signal.
+        #
+        #     The candidate 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.
         class ProfileQuery; end
 
         # Input only.
@@ -350,16 +335,12 @@ module Google
         # Geographic region of the search.
         # @!attribute [rw] address
         #   @return [String]
-        #     Optional.
-        #
-        #     The address name, such as "Mountain View" or "Bay Area".
+        #     Optional. 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".
+        #     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".
         #
         #     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.
@@ -367,33 +348,30 @@ module Google
         #     See http://cldr.unicode.org/ and
         #     http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
         #     for details. Example: "CH" for Switzerland.
+        #     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
+        #     Optional. The latitude and longitude of the geographic center from which to
         #     search. This field's 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.
+        #     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.
         # @!attribute [rw] telecommute_preference
         #   @return [Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference]
-        #     Optional.
-        #
-        #     Allows the client to return jobs without a
-        #     set location, specifically, telecommuting jobs (telecomuting is considered
+        #     Optional. 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} indicates if a job permits telecommuting.
-        #     If this field is set to {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference::TELECOMMUTE_ALLOWED},
-        #     telecommuting jobs are searched, and {Google::Cloud::Talent::V4beta1::LocationFilter#address address} and {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are
-        #     ignored. If not set or set to
-        #     {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference::TELECOMMUTE_EXCLUDED}, telecommute job are not
-        #     searched.
+        #     {Google::Cloud::Talent::V4beta1::Job#posting_region Job#posting_region}
+        #     indicates if a job permits telecommuting. If this field is set to
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference::TELECOMMUTE_ALLOWED},
+        #     telecommuting jobs are searched, and
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#address address} and
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are ignored.
+        #     If not set or set to
+        #     {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference::TELECOMMUTE_EXCLUDED},
+        #     telecommute job are not searched.
         #
         #     This filter can be used by itself to search exclusively for telecommuting
         #     jobs, or it can be combined with another location
@@ -403,10 +381,8 @@ module Google
         #     treated as less relevant than other jobs in the search response.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional.
-        #
-        #     Whether to apply negation to the filter so profiles matching the filter
-        #     are excluded.
+        #     Optional. Whether to apply negation to the filter so profiles matching the
+        #     filter are excluded.
         #
         #     Currently only supported in profile search.
         class LocationFilter
@@ -428,25 +404,18 @@ module Google
         # Filter on job compensation type and amount.
         # @!attribute [rw] type
         #   @return [Google::Cloud::Talent::V4beta1::CompensationFilter::FilterType]
-        #     Required.
-        #
-        #     Type of filter.
+        #     Required. Type of filter.
         # @!attribute [rw] units
         #   @return [Array<Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit>]
-        #     Required.
-        #
-        #     Specify desired `base compensation entry's`
+        #     Required. Specify desired `base compensation entry's`
         #     {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationInfo::CompensationUnit}.
         # @!attribute [rw] range
         #   @return [Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationRange]
-        #     Optional.
-        #
-        #     Compensation range.
+        #     Optional. Compensation range.
         # @!attribute [rw] include_jobs_with_unspecified_compensation_range
         #   @return [true, false]
-        #     Optional.
-        #
-        #     Whether to include jobs whose compensation range is unspecified.
+        #     Optional. If set to true, jobs with unspecified compensation range fields
+        #     are included.
         class CompensationFilter
           # Specify the type of filtering.
           module FilterType
@@ -455,30 +424,42 @@ module Google
 
             # Filter by `base compensation entry's` unit. A job is a match if and
             # only if the job contains a base CompensationEntry and the base
-            # CompensationEntry's unit matches provided {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
-            # Populate one or more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
+            # CompensationEntry's unit matches provided
+            # {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}. Populate
+            # one or more
+            # {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
             #
-            # See {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry} for definition of
-            # base compensation entry.
+            # See
+            # {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry}
+            # for definition of base compensation entry.
             UNIT_ONLY = 1
 
             # Filter by `base compensation entry's` unit and amount / range. A job
             # is a match if and only if the job contains a base CompensationEntry, and
-            # the base entry's unit matches provided {Compensation_units} and amount
-            # or range overlaps with provided {Compensation_range}.
+            # the base entry's unit matches provided
+            # {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationUnit CompensationUnit}
+            # and amount or range overlaps with provided
+            # {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationRange CompensationRange}.
             #
-            # See {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry} for definition of
-            # base compensation entry.
+            # See
+            # {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry}
+            # for definition of base compensation entry.
             #
-            # Set exactly one {Google::Cloud::Talent::V4beta1::CompensationFilter#units units} and populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range}.
+            # Set exactly one
+            # {Google::Cloud::Talent::V4beta1::CompensationFilter#units units} and
+            # populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range}.
             UNIT_AND_AMOUNT = 2
 
             # Filter by annualized base compensation amount and `base compensation
-            # entry's` unit. Populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
+            # entry's` unit. Populate
+            # {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or
+            # more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
             ANNUALIZED_BASE_AMOUNT = 3
 
             # Filter by annualized total compensation amount and `base compensation
-            # entry's` unit . Populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
+            # entry's` unit . Populate
+            # {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or
+            # more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
             ANNUALIZED_TOTAL_AMOUNT = 4
           end
         end
@@ -488,40 +469,32 @@ module Google
         # 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 for which to calculate the commute
+        #     time.
         # @!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 from which to
+        #     calculate the commute time.
         # @!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`.
+        #     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.
+        #     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.
         # @!attribute [rw] road_traffic
         #   @return [Google::Cloud::Talent::V4beta1::CommuteFilter::RoadTraffic]
-        #     Optional.
-        #
-        #     Specifies the traffic density to use when calculating commute time.
+        #     Optional. 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.
+        #     Optional. 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
@@ -543,15 +516,12 @@ module Google
         # Job title of the search.
         # @!attribute [rw] job_title
         #   @return [String]
-        #     Required.
-        #
-        #     The job title, for example, "Software engineer", or "Product manager".
+        #     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.
+        #     Optional. Whether to apply negation to the filter so profiles matching the
+        #     filter are excluded.
         class JobTitleFilter; end
 
         # Input only.
@@ -559,15 +529,11 @@ module Google
         # Skill filter of the search.
         # @!attribute [rw] skill
         #   @return [String]
-        #     Required.
-        #
-        #     The skill name. For example, "java", "j2ee", and so on.
+        #     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.
+        #     Optional. Whether to apply negation to the filter so profiles matching the
+        #     filter are excluded.
         class SkillFilter; end
 
         # Input only.
@@ -575,33 +541,33 @@ module Google
         # Employer filter of the search.
         # @!attribute [rw] employer
         #   @return [String]
-        #     Required.
-        #
-        #     The name of the employer, for example "Google", "Alphabet".
+        #     Required. The name of the employer, for example "Google", "Alphabet".
         # @!attribute [rw] mode
         #   @return [Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode]
-        #     Optional.
-        #
-        #     Define set of {Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord}s to search against.
+        #     Optional. Define set of
+        #     {Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord}s to search
+        #     against.
         #
-        #     Defaults to {Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode::ALL_EMPLOYMENT_RECORDS EmployerFilterMode::ALL_EMPLOYMENT_RECORDS}.
+        #     Defaults to
+        #     {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.
+        #     Optional. 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} to search
-          # against.
+          # Enum indicating which set of
+          # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}
+          # to search against.
           module EmployerFilterMode
             # Default value.
             EMPLOYER_FILTER_MODE_UNSPECIFIED = 0
 
-            # Apply to all employers in {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
+            # Apply to all employers in
+            # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
             ALL_EMPLOYMENT_RECORDS = 1
 
-            # Apply only to current employer in {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
+            # Apply only to current employer in
+            # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
             CURRENT_EMPLOYMENT_RECORDS_ONLY = 2
 
             # Apply only to past (not current) employers in
@@ -615,29 +581,22 @@ module Google
         # Education filter of the search.
         # @!attribute [rw] school
         #   @return [String]
-        #     Optional.
-        #
-        #     The school name. For example "MIT", "University of California, Berkeley".
+        #     Optional. 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
+        #     Optional. 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.
+        #     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.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional.
-        #
-        #     Whether to apply negation to the filter so profiles matching the filter
-        #     is excluded.
+        #     Optional. Whether to apply negation to the filter so profiles matching the
+        #     filter is excluded.
         class EducationFilter; end
 
         # Input only.
@@ -645,38 +604,37 @@ module Google
         # Work experience filter.
         #
         # This filter is used to search for profiles with working experience length
-        # between {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#min_experience min_experience} and {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#max_experience max_experience}.
+        # between
+        # {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#min_experience min_experience}
+        # and
+        # {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).
+        #     Optional. 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).
+        #     Optional. The maximum duration of the work experience (exclusive).
         class WorkExperienceFilter; end
 
         # Input only.
         #
         # Application Date Range Filter.
         #
-        # The API matches profiles with {Google::Cloud::Talent::V4beta1::Application#application_date Application#application_date} between
-        # start date and end date (both boundaries are inclusive). The filter is
-        # ignored if both {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#start_date start_date} and {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#end_date end_date} are missing.
+        # The API matches profiles with
+        # {Google::Cloud::Talent::V4beta1::Application#application_date Application#application_date}
+        # between start date and end date (both boundaries are inclusive). The filter
+        # is ignored if both
+        # {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#start_date start_date}
+        # and {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#end_date end_date}
+        # 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.
+        #     Optional. 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.
+        #     Optional. End date. If it's missing, The API matches profiles with
+        #     application date not before the start date.
         class ApplicationDateFilter; end
 
         # Input only.
@@ -684,17 +642,15 @@ module Google
         # Outcome Notes Filter.
         # @!attribute [rw] outcome_notes
         #   @return [String]
-        #     Required.
-        #
-        #     User entered or selected outcome reason. The API does an exact match on the
-        #     {Google::Cloud::Talent::V4beta1::Application#outcome_notes Application#outcome_notes} in profiles.
+        #     Required. User entered or selected outcome reason. The API does an exact
+        #     match on the
+        #     {Google::Cloud::Talent::V4beta1::Application#outcome_notes Application#outcome_notes}
+        #     in profiles.
         # @!attribute [rw] negated
         #   @return [true, false]
-        #     Optional.
-        #
-        #     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.
+        #     Optional. 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.
@@ -702,22 +658,20 @@ module Google
         # 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 {Job#requisistion_id} of {Google::Cloud::Talent::V4beta1::Application#job Application#job} in profiles.
+        #     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
+        #     {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 {Google::Cloud::Talent::V4beta1::Application#job Application#job} in profiles.
+        #     Optional. 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 {Google::Cloud::Talent::V4beta1::Application#job Application#job}
-        #     matching the filters.
+        #     Optional. 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.
@@ -725,25 +679,20 @@ module Google
         # 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.
+        #     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.
         # @!attribute [rw] end_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Optional.
-        #
-        #     End timestamp, matching profiles with the end time. If this field
+        #     Optional. 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.
+        #     Optional. Specifies which time field to filter profiles.
         #
-        #     Defaults to {Google::Cloud::Talent::V4beta1::TimeFilter::TimeField::CREATE_TIME TimeField::CREATE_TIME}.
+        #     Defaults to
+        #     {Google::Cloud::Talent::V4beta1::TimeFilter::TimeField::CREATE_TIME TimeField::CREATE_TIME}.
         class TimeFilter
           # Time fields can be used in TimeFilter.
           module TimeField
@@ -757,6 +706,15 @@ module Google
             UPDATE_TIME = 2
           end
         end
+
+        # Input only
+        #
+        # 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.
+        class CandidateAvailabilityFilter; end
       end
     end
   end