Metadata that is used to define a condition that triggers an action.
A valid condition must specify at least one of 'query_terms' or
'products_filter'. If multiple fields are specified, the condition
is met if all the fields are satisfied e.g. if a set of query terms
and product_filter are set, then only items matching the
product_filter for requests with a query matching the query terms
wil get boosted.
Attributes
Name
Description
query_terms
MutableSequence[google.cloud.retail_v2.types.Condition.QueryTerm]
A list (up to 10 entries) of terms to match
the query on. If not specified, match all
queries. If many query terms are specified, the
condition is matched if any of the terms is a
match (i.e. using the OR operator).
MutableSequence[str]
Used to support browse uses cases. A list (up to 10 entries)
of categories or departments. The format should be the same
as
UserEvent.page_categories;
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class Condition (2.5.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.5.0 (latest)](/python/docs/reference/retail/latest/google.cloud.retail_v2.types.Condition)\n- [2.4.0](/python/docs/reference/retail/2.4.0/google.cloud.retail_v2.types.Condition)\n- [2.3.0](/python/docs/reference/retail/2.3.0/google.cloud.retail_v2.types.Condition)\n- [2.2.0](/python/docs/reference/retail/2.2.0/google.cloud.retail_v2.types.Condition)\n- [2.1.0](/python/docs/reference/retail/2.1.0/google.cloud.retail_v2.types.Condition)\n- [2.0.0](/python/docs/reference/retail/2.0.0/google.cloud.retail_v2.types.Condition)\n- [1.25.0](/python/docs/reference/retail/1.25.0/google.cloud.retail_v2.types.Condition)\n- [1.24.0](/python/docs/reference/retail/1.24.0/google.cloud.retail_v2.types.Condition)\n- [1.23.1](/python/docs/reference/retail/1.23.1/google.cloud.retail_v2.types.Condition)\n- [1.22.0](/python/docs/reference/retail/1.22.0/google.cloud.retail_v2.types.Condition)\n- [1.21.2](/python/docs/reference/retail/1.21.2/google.cloud.retail_v2.types.Condition)\n- [1.20.1](/python/docs/reference/retail/1.20.1/google.cloud.retail_v2.types.Condition)\n- [1.19.1](/python/docs/reference/retail/1.19.1/google.cloud.retail_v2.types.Condition)\n- [1.18.0](/python/docs/reference/retail/1.18.0/google.cloud.retail_v2.types.Condition)\n- [1.17.0](/python/docs/reference/retail/1.17.0/google.cloud.retail_v2.types.Condition)\n- [1.16.3](/python/docs/reference/retail/1.16.3/google.cloud.retail_v2.types.Condition)\n- [1.15.1](/python/docs/reference/retail/1.15.1/google.cloud.retail_v2.types.Condition)\n- [1.14.1](/python/docs/reference/retail/1.14.1/google.cloud.retail_v2.types.Condition)\n- [1.13.0](/python/docs/reference/retail/1.13.0/google.cloud.retail_v2.types.Condition)\n- [1.12.0](/python/docs/reference/retail/1.12.0/google.cloud.retail_v2.types.Condition)\n- [1.11.0](/python/docs/reference/retail/1.11.0/google.cloud.retail_v2.types.Condition)\n- [1.10.2](/python/docs/reference/retail/1.10.2/google.cloud.retail_v2.types.Condition)\n- [1.9.0](/python/docs/reference/retail/1.9.0/google.cloud.retail_v2.types.Condition)\n- [1.8.1](/python/docs/reference/retail/1.8.1/google.cloud.retail_v2.types.Condition)\n- [1.7.0](/python/docs/reference/retail/1.7.0/google.cloud.retail_v2.types.Condition)\n- [1.6.1](/python/docs/reference/retail/1.6.1/google.cloud.retail_v2.types.Condition)\n- [1.5.0](/python/docs/reference/retail/1.5.0/google.cloud.retail_v2.types.Condition)\n- [1.4.1](/python/docs/reference/retail/1.4.1/google.cloud.retail_v2.types.Condition)\n- [1.3.0](/python/docs/reference/retail/1.3.0/google.cloud.retail_v2.types.Condition)\n- [1.2.1](/python/docs/reference/retail/1.2.1/google.cloud.retail_v2.types.Condition)\n- [1.1.0](/python/docs/reference/retail/1.1.0/google.cloud.retail_v2.types.Condition)\n- [1.0.2](/python/docs/reference/retail/1.0.2/google.cloud.retail_v2.types.Condition)\n- [0.4.2](/python/docs/reference/retail/0.4.2/google.cloud.retail_v2.types.Condition)\n- [0.3.1](/python/docs/reference/retail/0.3.1/google.cloud.retail_v2.types.Condition)\n- [0.2.0](/python/docs/reference/retail/0.2.0/google.cloud.retail_v2.types.Condition)\n- [0.1.0](/python/docs/reference/retail/0.1.0/google.cloud.retail_v2.types.Condition) \n\n Condition(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nMetadata that is used to define a condition that triggers an action.\nA valid condition must specify at least one of 'query_terms' or\n'products_filter'. If multiple fields are specified, the condition\nis met if all the fields are satisfied e.g. if a set of query terms\nand product_filter are set, then only items matching the\nproduct_filter for requests with a query matching the query terms\nwil get boosted.\n\nClasses\n-------\n\n### QueryTerm\n\n QueryTerm(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nQuery terms that we want to match on.\n\n### TimeRange\n\n TimeRange(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nUsed for time-dependent conditions.\nExample: Want to have rule applied for week long sale."]]
