eBay Trading APIVersion 1145


This type is used by the ValidationRules containers returned in the GetCategorySpecifics response, which contains some rules and limits for the recommended Item Specific name (specified in the NameRecommendation.Name field) and corresponding value(s) (specified in the ValueRecommendation.Value field). These rules and limits will apply when the recommended Item Specific is subsequently used in an Add/Revise/Relist call.

Types that use RecommendationValidationRulesType:

Call that uses RecommendationValidationRulesType:


AspectUsage ( AspectUsageCodeType ) [0..1]
The value returned in this field will indicate if the item specific value 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.

Note: Currently, the AspectUsage field will only be returned for some item/instance aspects (and not product aspects). Examples of common instance aspects that are shared by many eBay categories include 'Custom Bundle', 'Bundle Description', 'Modified Item', 'Modification Description', and 'California Prop 65 Warning'. Many instance aspect values are allowed more characters than the standard 65 max character threshold, and sellers can look at the corresponding MaxValueLength field to get the maximum number of characters allowed for that particular instance aspect value.
See the Field Index to learn which calls use AspectUsage.

Confidence ( int ) [0..1]
Indicates eBay's confidence that this is the right name or value, given the data you specified your request. The confidence is based on historical items in the same category, with similar titles (if specified).

This field is only returned when IncludeConfidence is included in the request and set to true. This field is not returned when SelectionMode is set to Prefilled.
See the Field Index to learn which calls use Confidence.

MaxValueLength ( int ) [0..1]
This integer value will state the maximum length of the instance aspect's value. The seller must make sure not to exceed this value when setting instance aspects on a listing. This field is only returned for instance aspects (AspectUsage=Instance). The standard maximum length for an item specific value is 65 characters.
See the Field Index to learn which calls use MaxValueLength.

MaxValues ( int ) [0..1]
Maximum number of values that you can specify for this Item Specific in listing requests (like AddItem) in the specified category.

Most Item Specifics can only have one value. When this is greater than 1, your application can present the value recommendations (if any) as a multi-select list to the seller. (See SelectionMode to determine whether the seller needs to choose from eBay's recommendations or not.)
See the Field Index to learn which calls use MaxValues.

MinValues ( int ) [0..1]
Minimum number of values that you can specify for this Item Specific in listing requests. Not returned if zero (0).

If this field is returned, it indicates that the Item Specific is required in listing requests in the corresponding category. If the Relationship field is also present, it means this Item Specific is required when you specify its parent value in listing requests.
See the Field Index to learn which calls use MinValues.

ProductRequired ( ProductRequiredCodeType ) [0..1]
The enumeration value returned in this field will indicate whether or not the corresponding product brand requires listings within that category to be associated with an eBay catalog product. To create a listing that is associated with an eBay catalog product, the seller uses the ProductListingDetails container of the AddItem call. To find a matching product in the eBay catalog, the seller can use the new eBay Catalog API or FindProducts call of the eBay Shopping API.

This field is only returned for the 'Brand' NameRecommendation container, and only if that particular product brand within that Product-Based Shopping Experience-enabled category requires a catalog product.

Note: Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories (and brands within those categories), the ValidationRules.ProductRequired field will not get returned for any brands within any eBay category. Due to this fact, the ProductRequired field is currently not applicable.
See the Field Index to learn which calls use ProductRequired.

Indicates the Item Specific's logical dependency on another Item Specific, if any.

For example, in a clothing category, Size Type could be recommended as a parent of Size, because Size=XL would mean something different to buyers when Size Type=Juniors or Size Type=Regular.

Or in the US (in the future), a list of cities can vary depending on the state, so State could be recommended as a parent of City.

Currently, categories only recommend a maximum of one parent for an Item Specific. For example, Size=XL could have a Size Type=Juniors parent in a Juniors clothing category. In the future, some categories may recommend multiple parents. For example, City=Mountain View could have parents like State=California, State=New York, and State=North Carolina.

If an Item Specific has value dependencies (i.e., if it has value recommendations that contain Relationship), then all of its value recommendations are returned (regardless of the number you specified in MaxValuesPerName).
See the Field Index to learn which calls use Relationship.

SelectionMode ( SelectionModeCodeType ) [0..1]
Controls whether you can specify your own name and value in listing requests, or if you need to use a name and/or value that eBay has defined.
See the Field Index to learn which calls use SelectionMode.

UsageConstraint ( UsageConstraintCodeType ) [0..1]
This field is returned for each item specific that is returned in the response. The enumeration value returned will indicate whether the item specific is required, recommended, or optional.

Note: Previously, returned item specifics were only 'marked' as required or optional. With the introduction of this new field, eBay is able to specify to sellers which item specifics are highly recommended, although not required. The item specifics that are recommended can possibly improve search results and/or sales conversion if the seller includes them in the listing.
See the Field Index to learn which calls use UsageConstraint.

ValueFormat ( ValueFormatCodeType ) [0..1]
The format of the data type (e.g., date format) that eBay expects the item specific's value to adhere to in listing requests. A data type identified by the ValueType field may have different representations, and ValueFormat specifies the precise format that is required.
See the Field Index to learn which calls use ValueFormat.

ValueType ( ValueTypeCodeType ) [0..1]
The data type (e.g., date) that eBay expects the value to adhere to in listing requests. Only returned if the data type is not Text. In some cases, more details about the data type are returned in the ValueFormat field.

As buyers may search on the value you specify in AddItem, the ISBN, UPC, or EAN should match the value that was specified by the publisher or manufacturer.

Note: The Numeric enumeration value is returned for whole integers (no decimal point), and the Decimal enumeration value is returned for numbers with decimals.
See the Field Index to learn which calls use ValueType.

VariationPicture ( VariationPictureRuleCodeType ) [0..1]
Indicates whether the name (e.g., Color) can (or must) be used to classify the variation pictures.
See the Field Index to learn which calls use VariationPicture.

VariationSpecifics ( VariationSpecificsRuleCodeType ) [0..1]
Indicates whether the recommended name/value pair can be used in an Item.Variations container in a fixed-price listing call. For example, a given category could disable a name like Brand in variation specifics (if Brand is only allowed in the item specifics at the Item level). The same category could enable a name like Size for variation specifics (in addition to recommending it for item specifics). If not returned, then the name/value can be used for both variation specifics and item specifics.
See the Field Index to learn which calls use VariationSpecifics.