google-cloud-talent-v4beta1 0.4.4 → 0.5.0

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

@@ -1,17 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/talent/v4beta1/filters.proto
 
+require 'google/protobuf'
+
 require 'google/api/field_behavior_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/protobuf/duration_pb'
-require 'google/protobuf/field_mask_pb'
-require 'google/protobuf/timestamp_pb'
-require 'google/protobuf/wrappers_pb'
-require 'google/type/date_pb'
 require 'google/type/latlng_pb'
 require 'google/type/timeofday_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/talent/v4beta1/filters.proto", :syntax => :proto3) do
@@ -31,24 +27,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :publish_time_range, :message, 12, "google.cloud.talent.v4beta1.TimestampRange"
       repeated :excluded_jobs, :string, 13
     end
-    add_message "google.cloud.talent.v4beta1.ProfileQuery" do
-      optional :query, :string, 1
-      repeated :location_filters, :message, 2, "google.cloud.talent.v4beta1.LocationFilter"
-      repeated :job_title_filters, :message, 3, "google.cloud.talent.v4beta1.JobTitleFilter"
-      repeated :employer_filters, :message, 4, "google.cloud.talent.v4beta1.EmployerFilter"
-      repeated :education_filters, :message, 5, "google.cloud.talent.v4beta1.EducationFilter"
-      repeated :skill_filters, :message, 6, "google.cloud.talent.v4beta1.SkillFilter"
-      repeated :work_experience_filter, :message, 7, "google.cloud.talent.v4beta1.WorkExperienceFilter"
-      repeated :time_filters, :message, 8, "google.cloud.talent.v4beta1.TimeFilter"
-      optional :hirable_filter, :message, 9, "google.protobuf.BoolValue"
-      repeated :application_date_filters, :message, 10, "google.cloud.talent.v4beta1.ApplicationDateFilter"
-      repeated :application_outcome_notes_filters, :message, 11, "google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter"
-      repeated :application_job_filters, :message, 13, "google.cloud.talent.v4beta1.ApplicationJobFilter"
-      optional :custom_attribute_filter, :string, 15
-      optional :candidate_availability_filter, :message, 16, "google.cloud.talent.v4beta1.CandidateAvailabilityFilter"
-      repeated :availability_filters, :message, 18, "google.cloud.talent.v4beta1.AvailabilityFilter"
-      repeated :person_name_filters, :message, 17, "google.cloud.talent.v4beta1.PersonNameFilter"
-    end
     add_message "google.cloud.talent.v4beta1.LocationFilter" do
       optional :address, :string, 1
       optional :region_code, :string, 2
@@ -61,6 +39,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TELECOMMUTE_PREFERENCE_UNSPECIFIED, 0
       value :TELECOMMUTE_EXCLUDED, 1
       value :TELECOMMUTE_ALLOWED, 2
+      value :TELECOMMUTE_JOBS_EXCLUDED, 3
     end
     add_message "google.cloud.talent.v4beta1.CompensationFilter" do
       optional :type, :enum, 1, "google.cloud.talent.v4beta1.CompensationFilter.FilterType"
@@ -90,69 +69,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TRAFFIC_FREE, 1
       value :BUSY_HOUR, 2
     end
-    add_message "google.cloud.talent.v4beta1.JobTitleFilter" do
-      optional :job_title, :string, 1
-      optional :negated, :bool, 2
-    end
-    add_message "google.cloud.talent.v4beta1.SkillFilter" do
-      optional :skill, :string, 1
-      optional :negated, :bool, 2
-    end
-    add_message "google.cloud.talent.v4beta1.EmployerFilter" do
-      optional :employer, :string, 1
-      optional :mode, :enum, 2, "google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode"
-      optional :negated, :bool, 3
-    end
-    add_enum "google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode" do
-      value :EMPLOYER_FILTER_MODE_UNSPECIFIED, 0
-      value :ALL_EMPLOYMENT_RECORDS, 1
-      value :CURRENT_EMPLOYMENT_RECORDS_ONLY, 2
-      value :PAST_EMPLOYMENT_RECORDS_ONLY, 3
-    end
-    add_message "google.cloud.talent.v4beta1.EducationFilter" do
-      optional :school, :string, 1
-      optional :field_of_study, :string, 2
-      optional :degree_type, :enum, 3, "google.cloud.talent.v4beta1.DegreeType"
-      optional :negated, :bool, 6
-    end
-    add_message "google.cloud.talent.v4beta1.WorkExperienceFilter" do
-      optional :min_experience, :message, 1, "google.protobuf.Duration"
-      optional :max_experience, :message, 2, "google.protobuf.Duration"
-    end
-    add_message "google.cloud.talent.v4beta1.ApplicationDateFilter" do
-      optional :start_date, :message, 1, "google.type.Date"
-      optional :end_date, :message, 2, "google.type.Date"
-    end
-    add_message "google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter" do
-      optional :outcome_notes, :string, 1
-      optional :negated, :bool, 2
-    end
-    add_message "google.cloud.talent.v4beta1.ApplicationJobFilter" do
-      optional :job_requisition_id, :string, 2
-      optional :job_title, :string, 3
-      optional :negated, :bool, 4
-    end
-    add_message "google.cloud.talent.v4beta1.TimeFilter" do
-      optional :start_time, :message, 1, "google.protobuf.Timestamp"
-      optional :end_time, :message, 2, "google.protobuf.Timestamp"
-      optional :time_field, :enum, 3, "google.cloud.talent.v4beta1.TimeFilter.TimeField"
-    end
-    add_enum "google.cloud.talent.v4beta1.TimeFilter.TimeField" do
-      value :TIME_FIELD_UNSPECIFIED, 0
-      value :CREATE_TIME, 1
-      value :UPDATE_TIME, 2
-    end
-    add_message "google.cloud.talent.v4beta1.CandidateAvailabilityFilter" do
-      optional :negated, :bool, 1
-    end
-    add_message "google.cloud.talent.v4beta1.AvailabilityFilter" do
-      optional :signal_type, :enum, 1, "google.cloud.talent.v4beta1.AvailabilitySignalType"
-      optional :range, :message, 2, "google.cloud.talent.v4beta1.TimestampRange"
-      optional :required, :bool, 3
-    end
-    add_message "google.cloud.talent.v4beta1.PersonNameFilter" do
-      optional :person_name, :string, 1
-    end
   end
 end
 
@@ -161,27 +77,12 @@ module Google
     module Talent
       module V4beta1
         JobQuery = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.JobQuery").msgclass
-        ProfileQuery = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ProfileQuery").msgclass
         LocationFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.LocationFilter").msgclass
         LocationFilter::TelecommutePreference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference").enummodule
         CompensationFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.CompensationFilter").msgclass
         CompensationFilter::FilterType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.CompensationFilter.FilterType").enummodule
         CommuteFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.CommuteFilter").msgclass
         CommuteFilter::RoadTraffic = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.CommuteFilter.RoadTraffic").enummodule
-        JobTitleFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.JobTitleFilter").msgclass
-        SkillFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.SkillFilter").msgclass
-        EmployerFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.EmployerFilter").msgclass
-        EmployerFilter::EmployerFilterMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode").enummodule
-        EducationFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.EducationFilter").msgclass
-        WorkExperienceFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.WorkExperienceFilter").msgclass
-        ApplicationDateFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationDateFilter").msgclass
-        ApplicationOutcomeNotesFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter").msgclass
-        ApplicationJobFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationJobFilter").msgclass
-        TimeFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.TimeFilter").msgclass
-        TimeFilter::TimeField = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.TimeFilter.TimeField").enummodule
-        CandidateAvailabilityFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.CandidateAvailabilityFilter").msgclass
-        AvailabilityFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.AvailabilityFilter").msgclass
-        PersonNameFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.PersonNameFilter").msgclass
       end
     end
   end

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

@@ -1,7 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/talent/v4beta1/histogram.proto
 
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

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

@@ -1,13 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/talent/v4beta1/job.proto
 
+require 'google/protobuf'
+
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/type/postal_address_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/talent/v4beta1/job.proto", :syntax => :proto3) do

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

@@ -164,6 +164,7 @@ module Google
 
               @operations_client = Operations.new do |config|
                 config.credentials = credentials
+                config.quota_project = @quota_project_id
                 config.endpoint = @config.endpoint
               end
 
@@ -223,6 +224,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::CreateJobRequest.new
+            #
+            #   # Call the create_job method.
+            #   result = client.create_job request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4beta1::Job.
+            #   p result
+            #
             def create_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -299,6 +315,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::BatchCreateJobsRequest.new
+            #
+            #   # Call the batch_create_jobs method.
+            #   result = client.batch_create_jobs request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def batch_create_jobs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -378,6 +416,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::GetJobRequest.new
+            #
+            #   # Call the get_job method.
+            #   result = client.get_job request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4beta1::Job.
+            #   p result
+            #
             def get_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -459,6 +512,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::UpdateJobRequest.new
+            #
+            #   # Call the update_job method.
+            #   result = client.update_job request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4beta1::Job.
+            #   p result
+            #
             def update_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -550,6 +618,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest.new
+            #
+            #   # Call the batch_update_jobs method.
+            #   result = client.batch_update_jobs request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def batch_update_jobs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -631,6 +721,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::DeleteJobRequest.new
+            #
+            #   # Call the delete_job method.
+            #   result = client.delete_job request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -717,6 +822,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::BatchDeleteJobsRequest.new
+            #
+            #   # Call the batch_delete_jobs method.
+            #   result = client.batch_delete_jobs request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def batch_delete_jobs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -789,11 +909,14 @@ module Google
             #
             #     The fields eligible for filtering are:
             #
-            #     * `companyName` (Required)
+            #     * `companyName`
             #     * `requisitionId`
             #     * `status` Available values: OPEN, EXPIRED, ALL. Defaults to
             #     OPEN if no value is specified.
             #
+            #     At least one of `companyName` and `requisitionId` must present or an
+            #     INVALID_ARGUMENT error is thrown.
+            #
             #     Sample Query:
             #
             #     * companyName = "projects/foo/tenants/bar/companies/baz"
@@ -801,6 +924,8 @@ module Google
             #     requisitionId = "req-1"
             #     * companyName = "projects/foo/tenants/bar/companies/baz" AND
             #     status = "EXPIRED"
+            #     * requisitionId = "req-1"
+            #     * requisitionId = "req-1" AND status = "EXPIRED"
             #   @param page_token [::String]
             #     The starting point of a query result.
             #   @param page_size [::Integer]
@@ -823,6 +948,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::ListJobsRequest.new
+            #
+            #   # Call the list_jobs method.
+            #   result = client.list_jobs request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Talent::V4beta1::Job.
+            #     p response
+            #   end
+            #
             def list_jobs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -882,7 +1028,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search_jobs(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, require_precise_result_size: nil, histogram_queries: nil, job_view: nil, offset: nil, page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil)
+            # @overload search_jobs(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, require_precise_result_size: nil, histogram_queries: nil, job_view: nil, offset: nil, page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil, keyword_match_mode: nil)
             #   Pass arguments to `search_jobs` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -910,15 +1056,7 @@ module Google
             #
             #     Defaults to false.
             #   @param require_precise_result_size [::Boolean]
-            #     Controls if the search job request requires the return of a precise
-            #     count of the first 300 results. Setting this to `true` ensures
-            #     consistency in the number of results per page. Best practice is to set this
-            #     value to true if a client allows users to jump directly to a
-            #     non-sequential search results page.
-            #
-            #     Enabling this flag may adversely impact performance.
-            #
-            #     Defaults to false.
+            #     This field is deprecated.
             #   @param histogram_queries [::Array<::Google::Cloud::Talent::V4beta1::HistogramQuery, ::Hash>]
             #     An expression specifies a histogram request against matching jobs.
             #
@@ -931,6 +1069,8 @@ module Google
             #     * `count(numeric_histogram_facet, list of buckets)`: Count the number of
             #     matching entities within each bucket.
             #
+            #     A maximum of 200 histogram buckets are supported.
+            #
             #     Data types:
             #
             #     * Histogram facet: facet names with format `[a-zA-Z][a-zA-Z0-9_]+`.
@@ -957,6 +1097,9 @@ module Google
             #       "FULL_TIME", "PART_TIME".
             #     * company_size: histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
             #     "MEDIUM", "BIG".
+            #     * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
+            #       in days.
+            #       Must specify list of numeric buckets in spec.
             #     * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
             #       in months.
             #       Must specify list of numeric buckets in spec.
@@ -1010,7 +1153,7 @@ module Google
             #     bucket(100000, MAX)])`
             #     * `count(string_custom_attribute["some-string-custom-attribute"])`
             #     * `count(numeric_custom_attribute["some-numeric-custom-attribute"],
-            #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])`
+            #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
             #   @param job_view [::Google::Cloud::Talent::V4beta1::JobView]
             #     The desired job attributes returned for jobs in the search response.
             #     Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
@@ -1098,6 +1241,14 @@ module Google
             #     Controls over how job documents get ranked on top of existing relevance
             #     score (determined by API algorithm).
             #   @param disable_keyword_match [::Boolean]
+            #     This field is deprecated. Please use
+            #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
+            #
+            #     To migrate, disable_keyword_match set to false maps to
+            #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
+            #     true maps to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
+            #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
+            #
             #     Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
             #     {::Google::Cloud::Talent::V4beta1::Job#description Job.description}, {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
             #     {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
@@ -1117,6 +1268,11 @@ module Google
             #     requests.
             #
             #     Defaults to false.
+            #   @param keyword_match_mode [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode]
+            #     Controls what keyword match options to use.
+            #
+            #     Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
+            #     is specified.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Talent::V4beta1::SearchJobsResponse]
@@ -1126,6 +1282,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::SearchJobsRequest.new
+            #
+            #   # Call the search_jobs method.
+            #   result = client.search_jobs request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4beta1::SearchJobsResponse.
+            #   p result
+            #
             def search_jobs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1189,7 +1360,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search_jobs_for_alert(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, require_precise_result_size: nil, histogram_queries: nil, job_view: nil, offset: nil, page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil)
+            # @overload search_jobs_for_alert(parent: nil, search_mode: nil, request_metadata: nil, job_query: nil, enable_broadening: nil, require_precise_result_size: nil, histogram_queries: nil, job_view: nil, offset: nil, page_size: nil, page_token: nil, order_by: nil, diversification_level: nil, custom_ranking_info: nil, disable_keyword_match: nil, keyword_match_mode: nil)
             #   Pass arguments to `search_jobs_for_alert` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1217,15 +1388,7 @@ module Google
             #
             #     Defaults to false.
             #   @param require_precise_result_size [::Boolean]
-            #     Controls if the search job request requires the return of a precise
-            #     count of the first 300 results. Setting this to `true` ensures
-            #     consistency in the number of results per page. Best practice is to set this
-            #     value to true if a client allows users to jump directly to a
-            #     non-sequential search results page.
-            #
-            #     Enabling this flag may adversely impact performance.
-            #
-            #     Defaults to false.
+            #     This field is deprecated.
             #   @param histogram_queries [::Array<::Google::Cloud::Talent::V4beta1::HistogramQuery, ::Hash>]
             #     An expression specifies a histogram request against matching jobs.
             #
@@ -1238,6 +1401,8 @@ module Google
             #     * `count(numeric_histogram_facet, list of buckets)`: Count the number of
             #     matching entities within each bucket.
             #
+            #     A maximum of 200 histogram buckets are supported.
+            #
             #     Data types:
             #
             #     * Histogram facet: facet names with format `[a-zA-Z][a-zA-Z0-9_]+`.
@@ -1264,6 +1429,9 @@ module Google
             #       "FULL_TIME", "PART_TIME".
             #     * company_size: histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
             #     "MEDIUM", "BIG".
+            #     * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
+            #       in days.
+            #       Must specify list of numeric buckets in spec.
             #     * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
             #       in months.
             #       Must specify list of numeric buckets in spec.
@@ -1317,7 +1485,7 @@ module Google
             #     bucket(100000, MAX)])`
             #     * `count(string_custom_attribute["some-string-custom-attribute"])`
             #     * `count(numeric_custom_attribute["some-numeric-custom-attribute"],
-            #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])`
+            #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
             #   @param job_view [::Google::Cloud::Talent::V4beta1::JobView]
             #     The desired job attributes returned for jobs in the search response.
             #     Defaults to {::Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView.JOB_VIEW_SMALL} if no value is specified.
@@ -1405,6 +1573,14 @@ module Google
             #     Controls over how job documents get ranked on top of existing relevance
             #     score (determined by API algorithm).
             #   @param disable_keyword_match [::Boolean]
+            #     This field is deprecated. Please use
+            #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
+            #
+            #     To migrate, disable_keyword_match set to false maps to
+            #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
+            #     true maps to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
+            #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
+            #
             #     Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
             #     {::Google::Cloud::Talent::V4beta1::Job#description Job.description}, {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
             #     {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
@@ -1424,6 +1600,11 @@ module Google
             #     requests.
             #
             #     Defaults to false.
+            #   @param keyword_match_mode [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode]
+            #     Controls what keyword match options to use.
+            #
+            #     Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
+            #     is specified.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Talent::V4beta1::SearchJobsResponse]
@@ -1433,6 +1614,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4beta1::JobService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4beta1::SearchJobsRequest.new
+            #
+            #   # Call the search_jobs_for_alert method.
+            #   result = client.search_jobs_for_alert request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4beta1::SearchJobsResponse.
+            #   p result
+            #
             def search_jobs_for_alert request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?