The Request body of the SearchJobs call.
Mode of a search. Defaults to [SearchMode.JOB_SEARCH][google .cloud.talent.v4beta1.SearchJobsRequest.SearchMode.JOB_SEARCH ].
Query used to search against jobs, such as keyword, location filters, etc.
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.
The desired job attributes returned for jobs in the search response. Defaults to [JobView.JOB_VIEW_SMALL][google.cloud. talent.v4beta1.JobView.JOB_VIEW_SMALL] if no value is specified.
A limit on the number of jobs returned in the search results. Increasing this value above the default value of 10 can increase search response time. The value can be between 1 and 100.
The criteria determining how search results are sorted.
Default is "relevance desc". Supported options are: -
"relevance desc": By relevance descending, as determined
by the API algorithms. Relevance thresholding of query
results is only available with this ordering. -
"posting_publish_time desc": By [Job.posting_publish_
time][google.cloud.talent.v4beta1.Job.posting_publish_time]
descending. - "posting_update_time desc": By [Job.post
ing_update_time][google.cloud.talent.v4beta1.Job.posting_up
date_time] descending. - "title": By
Job.title
ascending. - "title desc": By
Job.title descending.
"annualized_base_compensation": By job's [Compensati onInfo.annualized_base_compensation_range][google.cloud.tal ent.v4beta1.CompensationInfo.annualized_base_compensation_r ange] ascending. Jobs whose annualized base compensation is unspecified are put at the end of search results. -"annualized_base_compensation desc": By job's [Compensa tionInfo.annualized_base_compensation_range][google.cloud.t alent.v4beta1.CompensationInfo.annualized_base_compensation _range] descending. Jobs whose annualized base compensation is unspecified are put at the end of search results. -"annualized_total_compensation": By job's [Compensation Info.annualized_total_compensation_range][google.cloud.tale nt.v4beta1.CompensationInfo.annualized_total_compensation_r ange] ascending. Jobs whose annualized base compensation is unspecified are put at the end of search results. -"annualized_total_compensation desc": By job's [Compens ationInfo.annualized_total_compensation_range][google.cloud .talent.v4beta1.CompensationInfo.annualized_total_compensati on_range] descending. Jobs whose annualized base compensation is unspecified are put at the end of search results. -"custom_ranking desc": By the relevance score adjusted to the [SearchJobsRequest.CustomRankingInfo.rankin g_expression][google.cloud.talent.v4beta1.SearchJobsRequest.C ustomRankingInfo.ranking_expression] with weight factor assigned by [SearchJobsRequest.CustomRankingInfo.importance _level][google.cloud.talent.v4beta1.SearchJobsRequest.CustomR ankingInfo.importance_level] in descending order. - Location sorting: Use the special syntax to order jobs by distance:"distance_from('Hawaii')": Order by distance from Hawaii."distance_from(19.89, 155.5)": Order by distance from a coordinate."distance_from('Hawaii'), distance_from('Puerto Rico')": Order by multiple locations. See details below."distance_from('Hawaii'), distance_from(19.89, 155.5)": Order by multiple locations. See details below. The string can have a maximum of 256 characters. When multiple distance centers are provided, a job that is close to any of the distance centers would have a high rank. When a job has multiple locations, the job location closest to one of the distance centers will be used. Jobs that don't have locations will be ranked at the bottom. Distance is calculated with a precision of 11.3 meters (37.4 feet). Diversification strategy is still applied unless explicitly disabled in [diversification_level][google.cloud.talent.v4beta1.SearchJob sRequest.diversification_level].Controls over how job documents get ranked on top of existing relevance score (determined by API algorithm).
Classes
CustomRankingInfo
Custom ranking information for SearchJobsRequest.
Required. Controls over how job documents get ranked on top of existing relevance score (determined by API algorithm). A combination of the ranking expression and relevance score is used to determine job's final ranking position. The syntax for this expression is a subset of Google SQL syntax. Supported operators are: +, -, *, /, where the left and right side of the operator is either a numeric [Job.custom_attribut es][google.cloud.talent.v4beta1.Job.custom_attributes] key, integer/double value or an expression that can be evaluated to a number. Parenthesis are supported to adjust calculation precedence. The expression must be < 100 characters in length. The expression is considered invalid for a job if the expression references custom attributes that are not populated on the job or if the expression results in a divide by zero. If an expression is invalid for a job, that job is demoted to the end of the results. Sample ranking expression (year + 25) * 0.25 - (freshness / 0.5)