Retail v2 API - Class CatalogAttribute (2.4.0)

public sealed class CatalogAttribute : IMessage<CatalogAttribute>, IEquatable<CatalogAttribute>, IDeepCloneable<CatalogAttribute>, IBufferMessage, IMessage

Reference documentation and code samples for the Retail v2 API class CatalogAttribute.

Catalog level attribute config for an attribute. For example, if customers want to enable/disable facet for a specific attribute.

Inheritance

Object > CatalogAttribute

Implements

IMessage<CatalogAttribute>, IEquatable<CatalogAttribute>, IDeepCloneable<CatalogAttribute>, IBufferMessage, IMessage

Inherited Members

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ToString()

Namespace

Google.Cloud.Retail.V2

Assembly

Google.Cloud.Retail.V2.dll

Constructors

CatalogAttribute()

public CatalogAttribute()

CatalogAttribute(CatalogAttribute)

public CatalogAttribute(CatalogAttribute other)

Parameter
Name	Description
`other`	`CatalogAttribute`

Properties

DynamicFacetableOption

public CatalogAttribute.Types.DynamicFacetableOption DynamicFacetableOption { get; set; }

If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.

Must be specified, otherwise throws INVALID_FORMAT error.

Property Value
Type	Description
`CatalogAttribute.Types.DynamicFacetableOption`

ExactSearchableOption

public CatalogAttribute.Types.ExactSearchableOption ExactSearchableOption { get; set; }

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.

Property Value
Type	Description
`CatalogAttribute.Types.ExactSearchableOption`

IndexableOption

public CatalogAttribute.Types.IndexableOption IndexableOption { get; set; }

When [AttributesConfig.attribute_config_level][google.cloud.retail.v2.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][google.cloud.retail.v2.SearchService.Search].

Must be specified, otherwise throws INVALID_FORMAT error.

Property Value
Type	Description
`CatalogAttribute.Types.IndexableOption`

InUse

public bool InUse { get; set; }

Output only. Indicates whether this attribute has been used by any products. True if at least one [Product][google.cloud.retail.v2.Product] is using this attribute in [Product.attributes][google.cloud.retail.v2.Product.attributes]. Otherwise, this field is False.

[CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] can be pre-loaded by using [CatalogService.AddCatalogAttribute][google.cloud.retail.v2.CatalogService.AddCatalogAttribute], [CatalogService.ImportCatalogAttributes][], or [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2.CatalogService.UpdateAttributesConfig] APIs. This field is False for pre-loaded [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s.

Only pre-loaded [catalog attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in use by products nor predefined can be deleted. [Catalog attributes][google.cloud.retail.v2.CatalogAttribute] that are either in use by products or are predefined attributes 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.

Property Value
Type	Description
`Boolean`

Key

public string Key { get; set; }

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.

Property Value
Type	Description
`String`

RetrievableOption

public CatalogAttribute.Types.RetrievableOption RetrievableOption { get; set; }

If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results.

Property Value
Type	Description
`CatalogAttribute.Types.RetrievableOption`

SearchableOption

public CatalogAttribute.Types.SearchableOption SearchableOption { get; set; }

When [AttributesConfig.attribute_config_level][google.cloud.retail.v2.AttributesConfig.attribute_config_level] is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in [SearchService.Search][google.cloud.retail.v2.SearchService.Search].

If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as there are no text values associated to numerical attributes.

Must be specified, otherwise throws INVALID_FORMAT error.

Property Value
Type	Description
`CatalogAttribute.Types.SearchableOption`

Type

public CatalogAttribute.Types.AttributeType Type { get; set; }

Output only. The type of this attribute. This is derived from the attribute in [Product.attributes][google.cloud.retail.v2.Product.attributes].

Property Value
Type	Description
`CatalogAttribute.Types.AttributeType`