Boost applies to documents which match a condition.
Attributes
Name
Description
condition
str
An expression which specifies a boost condition. The syntax
and supported fields are the same as a filter expression.
See
SearchRequest.filter
for detail syntax and limitations.
Examples:
- To boost documents with document ID "doc_1" or "doc_2",
and color "Red" or "Blue":
(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))
boost
float
Strength of the condition boost, which should be in [-1, 1].
Negative boost means demotion. Default is 0.0.
Setting to 1.0 gives the document a big promotion. However,
it does not necessarily mean that the boosted document will
be the top result at all times, nor that other documents
will be excluded. Results could still be shown even when
none of them matches the condition. And results that are
significantly more relevant to the search query can still
trump your heavily favored but irrelevant documents.
Setting to -1.0 gives the document a big demotion. However,
results that are deeply relevant might still be shown. The
document will have an upstream battle to get a fairly high
ranking, but it is not blocked out completely.
Setting to 0.0 means no boost applied. The boosting
condition is ignored. Only one of the (condition, boost)
combination or the boost_control_spec below are set. If both
are set then the global boost is ignored and the more
fine-grained boost_control_spec is applied.
Specification for custom ranking based on customer specified
attribute value. It provides more controls for customized
ranking than the simple (condition, boost) combination above.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[],null,["# Class ConditionBoostSpec (0.13.11)\n\nVersion latestkeyboard_arrow_down\n\n- [0.13.11 (latest)](/python/docs/reference/discoveryengine/latest/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.13.10](/python/docs/reference/discoveryengine/0.13.10/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.12.3](/python/docs/reference/discoveryengine/0.12.3/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.11.14](/python/docs/reference/discoveryengine/0.11.14/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.10.0](/python/docs/reference/discoveryengine/0.10.0/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.9.1](/python/docs/reference/discoveryengine/0.9.1/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.8.1](/python/docs/reference/discoveryengine/0.8.1/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.7.0](/python/docs/reference/discoveryengine/0.7.0/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.6.0](/python/docs/reference/discoveryengine/0.6.0/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.5.0](/python/docs/reference/discoveryengine/0.5.0/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.4.1](/python/docs/reference/discoveryengine/0.4.1/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.3.1](/python/docs/reference/discoveryengine/0.3.1/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.2.1](/python/docs/reference/discoveryengine/0.2.1/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec)\n- [0.1.1](/python/docs/reference/discoveryengine/0.1.1/google.cloud.discoveryengine_v1.types.SearchRequest.BoostSpec.ConditionBoostSpec) \n\n ConditionBoostSpec(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nBoost applies to documents which match a condition.\n\nClasses\n-------\n\n### BoostControlSpec\n\n BoostControlSpec(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nSpecification for custom ranking based on customer specified\nattribute value. It provides more controls for customized\nranking than the simple (condition, boost) combination above."]]