Class Control (2.5.0)
Note: Some or all of the information on this page might not apply
to Trusted Cloud. For a list of services that are available in
Trusted Cloud, see Services available for
Trusted Cloud .
Version latestkeyboard_arrow_down
Control ( mapping = None , * , ignore_unknown_fields = False , ** kwargs )
Attributes
Name
Description
rule
google.cloud.retail_v2.types.Rule
A rule control - a condition-action pair.
Enacts a set action when the condition is
triggered. For example: Boost "gShoe" when query
full matches "Running Shoes".
This field is a member of oneof
_ control
.
name
str
Immutable. Fully qualified name
projects/*/locations/global/catalogs/*/controls/*
display_name
str
Required. The human readable control display name. Used in
Retail UI.
This field must be a UTF-8 encoded string with a length
limit of 128 characters. Otherwise, an INVALID_ARGUMENT
error is thrown.
associated_serving_config_ids
MutableSequence[str]
Output only. List of [serving
config][google.cloud.retail.v2.ServingConfig] ids that are
associated with this control in the same
Catalog .
Note the association is managed via the
ServingConfig , this
is an output only denormalized view.
solution_types
MutableSequence[google.cloud.retail_v2.types.SolutionType ]
Required. Immutable. The solution types that the control is
used for. Currently we support setting only one type of
solution at creation time.
Only SOLUTION_TYPE_SEARCH
value is supported at the
moment. If no solution type is provided at creation time,
will default to
SOLUTION_TYPE_SEARCH .
search_solution_use_case
MutableSequence[google.cloud.retail_v2.types.SearchSolutionUseCase ]
Specifies the use case for the control. Affects what
condition fields can be set. Only settable by search
controls. Will default to
SEARCH_SOLUTION_USE_CASE_SEARCH
if not specified. Currently only allow one
search_solution_use_case per control.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["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 Control (2.5.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.5.0 (latest)](/python/docs/reference/retail/latest/google.cloud.retail_v2.types.Control)\n- [2.4.0](/python/docs/reference/retail/2.4.0/google.cloud.retail_v2.types.Control)\n- [2.3.0](/python/docs/reference/retail/2.3.0/google.cloud.retail_v2.types.Control)\n- [2.2.0](/python/docs/reference/retail/2.2.0/google.cloud.retail_v2.types.Control)\n- [2.1.0](/python/docs/reference/retail/2.1.0/google.cloud.retail_v2.types.Control)\n- [2.0.0](/python/docs/reference/retail/2.0.0/google.cloud.retail_v2.types.Control)\n- [1.25.0](/python/docs/reference/retail/1.25.0/google.cloud.retail_v2.types.Control)\n- [1.24.0](/python/docs/reference/retail/1.24.0/google.cloud.retail_v2.types.Control)\n- [1.23.1](/python/docs/reference/retail/1.23.1/google.cloud.retail_v2.types.Control)\n- [1.22.0](/python/docs/reference/retail/1.22.0/google.cloud.retail_v2.types.Control)\n- [1.21.2](/python/docs/reference/retail/1.21.2/google.cloud.retail_v2.types.Control)\n- [1.20.1](/python/docs/reference/retail/1.20.1/google.cloud.retail_v2.types.Control)\n- [1.19.1](/python/docs/reference/retail/1.19.1/google.cloud.retail_v2.types.Control)\n- [1.18.0](/python/docs/reference/retail/1.18.0/google.cloud.retail_v2.types.Control)\n- [1.17.0](/python/docs/reference/retail/1.17.0/google.cloud.retail_v2.types.Control)\n- [1.16.3](/python/docs/reference/retail/1.16.3/google.cloud.retail_v2.types.Control)\n- [1.15.1](/python/docs/reference/retail/1.15.1/google.cloud.retail_v2.types.Control)\n- [1.14.1](/python/docs/reference/retail/1.14.1/google.cloud.retail_v2.types.Control)\n- [1.13.0](/python/docs/reference/retail/1.13.0/google.cloud.retail_v2.types.Control)\n- [1.12.0](/python/docs/reference/retail/1.12.0/google.cloud.retail_v2.types.Control)\n- [1.11.0](/python/docs/reference/retail/1.11.0/google.cloud.retail_v2.types.Control)\n- [1.10.2](/python/docs/reference/retail/1.10.2/google.cloud.retail_v2.types.Control)\n- [1.9.0](/python/docs/reference/retail/1.9.0/google.cloud.retail_v2.types.Control)\n- [1.8.1](/python/docs/reference/retail/1.8.1/google.cloud.retail_v2.types.Control)\n- [1.7.0](/python/docs/reference/retail/1.7.0/google.cloud.retail_v2.types.Control)\n- [1.6.1](/python/docs/reference/retail/1.6.1/google.cloud.retail_v2.types.Control)\n- [1.5.0](/python/docs/reference/retail/1.5.0/google.cloud.retail_v2.types.Control)\n- [1.4.1](/python/docs/reference/retail/1.4.1/google.cloud.retail_v2.types.Control)\n- [1.3.0](/python/docs/reference/retail/1.3.0/google.cloud.retail_v2.types.Control)\n- [1.2.1](/python/docs/reference/retail/1.2.1/google.cloud.retail_v2.types.Control)\n- [1.1.0](/python/docs/reference/retail/1.1.0/google.cloud.retail_v2.types.Control)\n- [1.0.2](/python/docs/reference/retail/1.0.2/google.cloud.retail_v2.types.Control)\n- [0.4.2](/python/docs/reference/retail/0.4.2/google.cloud.retail_v2.types.Control)\n- [0.3.1](/python/docs/reference/retail/0.3.1/google.cloud.retail_v2.types.Control)\n- [0.2.0](/python/docs/reference/retail/0.2.0/google.cloud.retail_v2.types.Control)\n- [0.1.0](/python/docs/reference/retail/0.1.0/google.cloud.retail_v2.types.Control) \n\n Control(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nConfigures dynamic metadata that can be linked to a\nServingConfig and affect\nsearch or recommendation results at serving time.\n\n.. _oneof: \u003chttps://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields\u003e"]]