Using ReviseItem to change the Description of an Item
Find the answer to your question
Please enter a search keyword.
Advanced Search
Products
Question
What is the best way to go about changing the Description of an Item?
Answer
Summary
The ReviseItem call has a way to change the description by indicating exactly what you want to do with the data you send in the Description element of the ReviseItem call.
The following 3 actions can be taken:
- Replace
By specifying <DescriptionReviseMode>Replace</DescriptionReviseMode> in your ReviseItem call, the data you send in the Description element will completely replace the existing Description. Please note that this is a complete and non reversible action. Once the call is made, the item description will be the data that you sent in the Description element. As an example, if the following ReviseItem call is made, the item's entire description will then be "data".
<?xml version="1.0" encoding="utf-8"?>
<ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>1267</Version>
<ErrorLanguage>en_US</ErrorLanguage>
<WarningLevel>High</WarningLevel>
<Item>
<ItemID>123</ItemID>
<Description>data</Description>
<DescriptionReviseMode>Replace</DescriptionReviseMode>
</Item>
<RequesterCredentials>
<eBayAuthToken>token</eBayAuthToken>
</RequesterCredentials>
</ReviseItemRequest>
- Prepend
By specifying <DescriptionReviseMode>Prepend</DescriptionReviseMode> in your ReviseItem call, the data you send in the Description element will be prepended to the existing Description. Once the call is made, the item description will be the data that you sent in the Description element followed by the previously existing description.
- Append
By specifying <DescriptionReviseMode>Append</DescriptionReviseMode> in your ReviseItem call, the data you send in the Description element will be appended to the existing Description. Once the call is made, the item description will be the previously existing description followed by the data that you sent in the Description element.
- Documentation: ReviseItem
Additional Comments