Input only.
The Request body of the SearchJobs
call.
Optional. Mode of a search. Defaults to [SearchMode.JOB_SEAR CH][google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode.J OB_SEARCH].
Optional. Query used to search against jobs, such as keyword, location filters, etc.
Optional. 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.
Optional. 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.
Optional. 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.
Optional. 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].Optional. Controls over how job documents get ranked on top of existing relevance score (determined by API algorithm).
Classes
CustomRankingInfo
Input only.
Custom ranking information for SearchJobsRequest.
Required. Controls over how job documents get ranked on top of existing relevance score (determined by API algorithm). The product of 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_attributes][goog le.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. Sample ranking expression (year + 25) * 0.25 - (freshness / 0.5)