Skip to main content

This type contains information about the formatting, occurrence, and support of an aspect.

Type that uses AspectConstraint

Aspect

Calls that use AspectConstraint

Fields

Field
Type
Description
aspectApplicableTo
This value indicate if the aspect identified by the aspects.localizedAspectName field is a product aspect (relevant to catalog products in the category) or an item/instance aspect, which is an aspect whose value will vary based on a particular instance of the product.
aspectDataType
The data type of this aspect.
aspectEnabledForVariations
A value of true indicates that this aspect can be used to help identify item variations.
aspectFormat
Returned only if the value of aspectDataType identifies a data type that requires specific formatting. Currently, this field provides formatting hints as follows:
  • DATE: YYYY, YYYYMM, YYYYMMDD
  • NUMBER: int32, double
aspectMaxLength
The maximum length of the item/instance aspect's value. The seller must make sure not to exceed this length when specifying the instance aspect's value for a product. This field is only returned for instance aspects.
aspectMode
The manner in which values of this aspect must be specified by the seller (as free text or by selecting from available options).
aspectRequired
A value of true indicates that this aspect is required when offering items in the specified category.
aspectUsage
The enumeration value returned in this field will indicate if the corresponding aspect is recommended or optional.

Note: This field is always returned, even for hard-mandated/required aspects (where aspectRequired: true). The value returned for required aspects will be RECOMMENDED, but they are actually required and a seller will be blocked from listing or revising an item without these aspects.
expectedRequiredByDate
The expected date after which the aspect will be required.

Note: The value returned in this field specifies only an approximate date, which may not reflect the actual date after which the aspect is required.
itemToAspectCardinality
Indicates whether this aspect can accept single or multiple values for items in the specified category.

Note: Up to 30 values can be supplied for aspects that accept multiple values.

Got thoughts? Click the feedback button – your insights help us improve!