UploadSiteHostedPicturesRequestType

Uploads a picture for a listing and returns a URL for the picture.

Fields

ExtensionInDays ( int )
ExternalPictureURL ( anyURI )
PictureData ( Base64BinaryType (base64Binary) )
PictureName ( string )
PictureSet ( PictureSetCodeType )
PictureSystemVersion ( int )
PictureUploadPolicy ( PictureUploadPolicyCodeType )
PictureWatermark ( PictureWatermarkCodeType )

ExtensionInDays ( int ) [0..1]
The number of days to extend the expiration date for the specified image, after a listing has ended. This call is restricted to applications that have been granted permission to use it by eBay Developer Technical Support.

This call is not needed for active listings - it is meant to be used only when a photo needs to be hosted longer than the normal listing duration.

The maximum number of days allowed for this field is 30.
See the Field Index to learn which calls use ExtensionInDays.

ExternalPictureURL ( anyURI ) [0..1]
Include the URL for a picture that you want to include in your listing. You can only include one ExternalPictureURL field per call.

Note: If a URI contains spaces, replace them with %20. For example, http://example.com/my image.jpg must be submitted as http://example.com/my%20image.jpg to replace the space in the image file name.

This field allows the eBay server to retrieve a picture from a URL on an external web server. Once retrieved, the picture will be copied to eBay Picture Services (EPS), and retained for 90 days, plus the length of your listing duration.

Note: The ExternalPictureURL field is required when using eBay Large Merchant Services.
See the Field Index to learn which calls use ExternalPictureURL.

PictureData ( Base64BinaryType (base64Binary) ) [0..1]
An optional reference ID to the binary attachment. The PictureData field does not contain the binary attachment. The binary attachment is image data, including headers, from a JPG, GIF, PNG, BMP, or TIF format image file. The binary attachment must be sent as a MIME attachment, in your POST request, after the XML input.

Note: Not applicable for eBay Large Merchant Services. Use the ExternalPictureURL field instead.
See the Field Index to learn which calls use PictureData.

PictureName ( string ) [0..1]
A name you provide for the picture. Returned as SiteHostedPictureDetails.PictureName in the call response.
See the Field Index to learn which calls use PictureName.

PictureSet ( see PictureSetCodeType for possible values ) [0..1]
The image sizes that will be generated.
See the Field Index to learn which calls use PictureSet.

PictureSystemVersion ( int ) [0..1]
Specifies the picture system version. Only version 2 is valid. Available to support future changes in the picture system version.
See the Field Index to learn which calls use PictureSystemVersion.

PictureUploadPolicy ( see PictureUploadPolicyCodeType for possible values ) [0..1]
When the My Picture Uploads feature is available (see the Trading API Release Notes), applications (including non-listing apps, such as photo-editors and digital-camera software) will be able to use the PictureUploadPolicy field to specify that an uploaded picture is available to a seller on the eBay site. When you use PictureUploadPolicy, you are specifying that the picture you uploaded (and its URL) is stored for 48 hours on the eBay site. (If, within 48 hours, the picture is associated with an item, then it persists on the eBay site for the same time length as other pictures uploaded using the UploadSiteHostedPictures call). As a result of the storage on the eBay site, the picture is available to the seller on the My Picture Uploads tab within the Sell Your Item (SYI) pages. A maximum of 25 URLs can be stored.
See the Field Index to learn which calls use PictureUploadPolicy.

PictureWatermark ( see PictureWatermarkCodeType for possible values ) [0..*]
This is the type of watermark that should be applied to the pictures hosted by the eBay Picture Services. Please note that watermarks are applied only to pictures that are greater than an EPS configured size. The possible values are: None, Both, Icon, or SellerId.
See the Field Index to learn which calls use PictureWatermark.

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.