Developers Program

Using ReviseItem to change the Description of an Item

Published: January 22 2007, 2:30:00 PMยทUpdated: July 29 2022, 12:18:23 AM

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 DescriptionReviseMode element is used to indicate what action you want to take.
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.
Additional Resources
Additional Comments
How well did this answer your question?