SelectionRule

brands

array of string

The list of brands in the seller's inventory to include in the promotion.

This field is applicable only when categoryScope is set to MARKETPLACE.

categoryIds

array of string

Each selectionRules container can specify only a single category ID to include in the promotion. The ID can be either an eBay category ID or a seller's store category ID.

Marketplace (eBay) category IDs
While we do not publish a list of eBay category IDs, you can retrieve the list of IDs as follows:

• Get the category ID from the marketplace site:
  1. Use the Taxonomy API to retrieve a list of category IDs for any marketplace.
  2. For any marketplace, add /sch/allcategories/all-categories to the URL of the marketplace and navigate to that page.
     For example: http://www.ebay.com.au/sch/allcategories/all-categories
  3. Navigate to the category that you want and copy the ID from the URL.
• For the US: See Category Changes for the latest list of category IDs.

Store category IDs
Store category IDs are unique to each seller, so the service cannot provide a list of them. To retrieve a list of seller Store category IDs:

1. Go to Seller Hub > Marketing.
2. Click Manage store categories.
   You will see a list of your store categories.
3. At the bottom of the list, click All Categories.
   A complete list of your Store categories and their associated Store category IDs displays.

Note: You must always specify both categoryIds and categoryScope fields in each selectionRules container. If you specify multiple selectionRules containers, the categoryScope in each must match (they must all be either MARKETPLACE or STORE).

Required if inventoryCriterionType is set to INVENTORY_BY_RULE.

categoryScope

The type of the category ID for the item(s) to be included in the promotion. You must always supply both categoryIds and categoryScope. Note: A request can have only one categoryScope.

Required: When inventoryCriterionType is set to INVENTORY_BY_RULE.

listingConditionIds

array of string

A list of IDs that describe the condition of the items included in the promotion. For more information, see Item condition ID and name values.

Note: This value is not currently returned in the response.

maxPrice

This sets the maximum value of the price range for the items included in the promotion. Only items whose price is equal to or less than maxPrice are included in the promotion.

Important: You must set minPrice if you set maxPrice.

minPrice

This sets the minimum value of the price range for the items included in the promotion. Only items whose price is equal to or greater than minPrice are included in the promotion.

Important: You must set maxPrice if you set minPrice.