# Cloud Talent Solution V4beta1 API - Class Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo (v0.19.0)

0.19.0 (latest) 0.18.1 0.17.1 0.16.0 0.15.0 0.14.1 0.13.0 0.12.0 0.11.1 0.10.2 0.9.0 0.8.1 0.7.0 0.6.1 0.5.0 0.4.6 Reference documentation and code samples for the Cloud Talent Solution V4beta1 API class Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo.

Custom ranking information for
[SearchJobsRequest](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest "Google::Cloud::Talent::V4beta1::SearchJobsRequest (class)").

## Inherits

- Object

## Extended By

- Google::Protobuf::MessageExts::ClassMethods

## Includes

- Google::Protobuf::MessageExts

## Methods

### #importance_level

    def importance_level() -> ::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel

**Returns**

- ([::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest-CustomRankingInfo-ImportanceLevel)) --- Required. Controls over how important the score of [CustomRankingInfo.ranking_expression](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest-CustomRankingInfo#Google__Cloud__Talent__V4beta1__SearchJobsRequest__CustomRankingInfo_ranking_expression_instance_ "Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression (method)") gets applied to job's final ranking position.


  An error is thrown if not specified.

### #importance_level=

    def importance_level=(value) -> ::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel

**Parameter**

- **value** ([::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest-CustomRankingInfo-ImportanceLevel)) --- Required. Controls over how important the score of [CustomRankingInfo.ranking_expression](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest-CustomRankingInfo#Google__Cloud__Talent__V4beta1__SearchJobsRequest__CustomRankingInfo_ranking_expression_instance_ "Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression (method)") gets applied to job's final ranking position.


  An error is thrown if not specified.
**Returns**

- ([::Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest-CustomRankingInfo-ImportanceLevel)) --- Required. Controls over how important the score of [CustomRankingInfo.ranking_expression](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-SearchJobsRequest-CustomRankingInfo#Google__Cloud__Talent__V4beta1__SearchJobsRequest__CustomRankingInfo_ranking_expression_instance_ "Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression (method)") gets applied to job's final ranking position.


  An error is thrown if not specified.

### #ranking_expression

    def ranking_expression() -> ::String

**Returns**

- (::String) --- 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_attributes](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-Job#Google__Cloud__Talent__V4beta1__Job_custom_attributes_instance_ "Google::Cloud::Talent::V4beta1::Job#custom_attributes (method)")
  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 \< 200 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)

### #ranking_expression=

    def ranking_expression=(value) -> ::String

**Parameter**

- **value** (::String) --- 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_attributes](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-Job#Google__Cloud__Talent__V4beta1__Job_custom_attributes_instance_ "Google::Cloud::Talent::V4beta1::Job#custom_attributes (method)")
  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 \< 200 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)
**Returns**

- (::String) --- 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_attributes](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-talent-v4beta1/latest/Google-Cloud-Talent-V4beta1-Job#Google__Cloud__Talent__V4beta1__Job_custom_attributes_instance_ "Google::Cloud::Talent::V4beta1::Job#custom_attributes (method)")
  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 \< 200 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)