RecommendationValidationRulesType

Defines rules for recommended Item Specifics. The rules apply when the Item Specific is subsequently used in AddItem and related calls.

Types that use RecommendationValidationRulesType:

Calls that use one or more fields of RecommendationValidationRulesType:

Fields

Confidence ( int )
MaxValues ( int )
MinValues ( int )
Relationship ( NameValueRelationshipType )
SelectionMode ( SelectionModeCodeType )
ValueFormat ( ValueFormatCodeType )
ValueType ( ValueTypeCodeType )
VariationPicture ( VariationPictureRuleCodeType )
VariationSpecifics ( VariationSpecificsRuleCodeType )

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).

For example, in GetItemRecommendations, if your request includes a title with words like "Blue T-Shirt", then Color=Blue is likely to have a higher confidence score than Color=Red in the response. If the title does not include a recognized color value, then Color may still have a high confidence score (based on historical item data in the category), but the scores for Blue and Red may have a more even distribution.

Only returned when IncludeConfidence is true in the request. Not returned when SelectionMode is Prefilled.
See the Field Index to learn which calls use Confidence.

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 1 or more, it means this Item Specfic is required in listing requests (in the specified category). (Your listing request will return errors if the Item Specific is not present.) If Relationship 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.

Relationship ( NameValueRelationshipType ) [0..*]
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 ( see SelectionModeCodeType for possible values ) [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.

ValueFormat ( see ValueFormatCodeType for possible values ) [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 ( see ValueTypeCodeType for possible values ) [0..1]
The data type (e.g., decimal) 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.
See the Field Index to learn which calls use ValueType.

VariationPicture ( see VariationPictureRuleCodeType for possible values ) [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 ( see VariationSpecificsRuleCodeType for possible values ) [0..1]
Indicates whether the recommended name/value pair can be used in Item.Variations in AddFixedPriceItem and related calls. 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.

Copyright © 2005–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.