This container is used to define the product details, such as product title, product description, product identifiers (eBay Product ID, GTIN, or Brand/MPN pair), product aspects/item specifics, and product images. Note that an eBay Product ID (ePID) or a Global Trade Item Number (GTIN) value can be used in an attempt to find a matching product in the eBay Catalog. If a product match is found, the inventory item record will automatically pick up all product details associated with the eBay Catalog product.
Many eBay categories will require at least one product identifier (a GTIN or a Brand/MPN pair). To discover which product identifier(s) that an eBay category might require or support, use the getItemAspectsForCategory
method in the Taxonomy API. In the getItemAspectsForCategory
response, look for product identifier names (
) in the localizedAspectName
fields, and then look for the correspondinng aspectRequired
boolean fields as well as the corresponding aspectUsage
field, which will indicate if the aspect is required, recommended, or optional. In some cases, a product identifier type may be required, but not known/applicable for a product. If this is the case, the seller must still include the corresponding field in the inventory item record, but pass in a default text string. This text string can vary by site, so the seller should use the GeteBayDetails
call of the Trading API to get this string value. In the GeteBayDetails
call, the seller should include a DetailName
field with its value set to
. In the response of the call, the seller can see the default string value in the ProductDetails.ProductIdentifierUnavailableText
field. The seller will use this value in one or more of the product identifier fields (ean
, or mpn
) if a product ID isn't known or applicable.
This container is not initially required, but it is required before an inventory item can be published as an offer, and/or if an inventory item is being updated and product data already exists for that inventory item.
This container is always returned for published offers in the getInventoryItem
, and getInventoryItems
calls since product data must be defined for published offers, but for unpublished inventory items, this container will only be returned if product details have been defined for the inventory item.