CatalogAttribute(mapping=None, *, ignore_unknown_fields=False, **kwargs)
Catalog level attribute config for an attribute. For example, if customers want to enable/disable facet for a specific attribute.
Attributes
Name | Description |
key |
str
Required. Attribute name. For example: ``color``, ``brands``, ``attributes.custom_attribute``, such as ``attributes.xyz``. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named ``attributes.abc_xyz`` can be indexed, but an attribute named ``attributes.abc-xyz`` cannot be indexed. |
in_use |
bool
Output only. Indicates whether this attribute has been used by any products. ``True`` if at least one Product is using this attribute in Product.attributes. Otherwise, this field is ``False``. CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, [CatalogService.ImportCatalogAttributes][], or CatalogService.UpdateAttributesConfig APIs. This field is ``False`` for pre-loaded CatalogAttributes. Only pre-loaded CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined cannot be deleted; however, their configuration properties will reset to default values upon removal request. After catalog changes, it takes about 10 minutes for this field to update. |
type_ |
google.cloud.retail_v2beta.types.CatalogAttribute.AttributeType
Output only. The type of this attribute. This is derived from the attribute in Product.attributes. |
indexable_option |
google.cloud.retail_v2beta.types.CatalogAttribute.IndexableOption
When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search. |
dynamic_facetable_option |
google.cloud.retail_v2beta.types.CatalogAttribute.DynamicFacetableOption
If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. |
searchable_option |
google.cloud.retail_v2beta.types.CatalogAttribute.SearchableOption
When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search. If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes. |
recommendations_filtering_option |
google.cloud.retail_v2beta.types.RecommendationsFilteringOption
When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if RECOMMENDATIONS_FILTERING_ENABLED, attribute values are filterable for recommendations. This option works for categorical features only, does not work for numerical features, inventory filtering. |
exact_searchable_option |
google.cloud.retail_v2beta.types.CatalogAttribute.ExactSearchableOption
If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable. |
Inheritance
builtins.object > proto.message.Message > CatalogAttributeClasses
AttributeType
AttributeType(value)
The type of an attribute.
DynamicFacetableOption
DynamicFacetableOption(value)
The status of the dynamic facetable option of a catalog attribute.
ExactSearchableOption
ExactSearchableOption(value)
The status of the exact-searchable option of a catalog attribute.
IndexableOption
IndexableOption(value)
The status of the indexable option of a catalog attribute.
SearchableOption
SearchableOption(value)
The status of the searchable option of a catalog attribute.