Class SearchResult (1.10.0)

SearchResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Represents the search results.

Attributes

NameDescription
id str
Product.id of the searched Product.
product google.cloud.retail_v2.types.Product
The product data snippet in the search response. Only Product.name is guaranteed to be populated. Product.variants contains the product variants that match the search query. If there are multiple product variants matching the query, top 5 most relevant product variants are returned and ordered by relevancy. If relevancy can be deternmined, use matching_variant_fields to look up matched product variants fields. If relevancy cannot be determined, e.g. when searching "shoe" all products in a shoe product can be a match, 5 product variants are returned but order is meaningless.
matching_variant_count int
The count of matched variant Products.
matching_variant_fields Mapping[str, google.protobuf.field_mask_pb2.FieldMask]
If a variant Product matches the search query, this map indicates which Product fields are matched. The key is the Product.name, the value is a field mask of the matched Product fields. If matched attributes cannot be determined, this map will be empty. For example, a key "sku1" with field mask "products.color_info" indicates there is a match between "sku1" ColorInfo and the query.
variant_rollup_values Mapping[str, google.protobuf.struct_pb2.Value]
The rollup matching variant Product attributes. The key is one of the SearchRequest.variant_rollup_keys. The values are the merged and de-duplicated Product attributes. Notice that the rollup values are respect filter. For example, when filtering by "colorFamilies:ANY("red")" and rollup "colorFamilies", only "red" is returned. For textual and numerical attributes, the rollup values is a list of string or double values with type `google.protobuf.ListValue][google.protobuf.ListValue]`. For example, if there are two variants with colors "red" and "blue", the rollup values are :: { key: "colorFamilies" value { list_value { values { string_value: "red" } values { string_value: "blue" } } } } For FulfillmentInfo, the rollup values is a double value with type `google.protobuf.Value][google.protobuf.Value]`. For example, ``{key: "pickupInStore.store1" value { number_value: 10 }}`` means a there are 10 variants in this product are available in the store "store1".
personal_labels Sequence[str]
Specifies previous events related to this product for this user based on UserEvent with same SearchRequest.visitor_id or UserInfo.user_id. This is set only when SearchRequest.PersonalizationSpec.mode is SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: - ``purchased``: Indicates that this product has been purchased before.

Inheritance

builtins.object > proto.message.Message > SearchResult

Classes

MatchingVariantFieldsEntry

MatchingVariantFieldsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters
NameDescription
kwargs dict

Keys and values corresponding to the fields of the message.

mapping Union[dict, `.Message`]

A dictionary or message to be used to determine the values for this message.

ignore_unknown_fields Optional(bool)

If True, do not raise errors for unknown fields. Only applied if mapping is a mapping type or there are keyword parameters.

VariantRollupValuesEntry

VariantRollupValuesEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters
NameDescription
kwargs dict

Keys and values corresponding to the fields of the message.

mapping Union[dict, `.Message`]

A dictionary or message to be used to determine the values for this message.

ignore_unknown_fields Optional(bool)

If True, do not raise errors for unknown fields. Only applied if mapping is a mapping type or there are keyword parameters.