Class SearchJobsRequest (0.4.0)

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). 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)