Component 
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API

complexType "ns:PictureDetailsType"
Namespace:
Content:
complex, 8 elements, elem. wildcard
Defined:
globally in Schema in ebaySvc.wsdl; see XML source
Includes:
definitions of 8 elements, elem. wildcard
Used:
Component Diagram
XML Representation Summary
<...>
   
Content: 
</...>
All Direct / Indirect Based Elements (1):
Known Usage Locations
Annotation
Contains the data for the pictures associated with an item.
XML Source (w/o annotations (9); see within schema source)
<xs:complexType name="PictureDetailsType">
<xs:sequence>
<xs:element minOccurs="0" name="GalleryType" type="ns:GalleryTypeCodeType"/>
<xs:element minOccurs="0" name="PhotoDisplay" type="ns:PhotoDisplayCodeType"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="PictureURL" type="xs:anyURI"/>
<xs:element minOccurs="0" name="PictureSource" type="ns:PictureSourceCodeType"/>
<xs:element minOccurs="0" name="GalleryStatus" type="ns:GalleryStatusCodeType"/>
<xs:element minOccurs="0" name="GalleryErrorInfo" type="xs:string"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="ExternalPictureURL" type="xs:anyURI"/>
<xs:element maxOccurs="1" minOccurs="0" name="ExtendedPictureDetails" type="ns:ExtendedPictureDetailsType"/>
<xs:any maxOccurs="unbounded" minOccurs="0" processContents="lax"/>
</xs:sequence>
</xs:complexType>
Content Element Detail (all declarations defined in this component; 9/9)
ns:ExtendedPictureDetails
Type:
This container returns the URLs of the seller's self-hosted (hosted outside of eBay) pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the self-hosted picture was uploaded.
Component Diagram
XML Representation Summary
<ns:ExtendedPictureDetails>
   
Content: 
</ns:ExtendedPictureDetails>
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="1" minOccurs="0" name="ExtendedPictureDetails" type="ns:ExtendedPictureDetailsType"/>

ns:ExternalPictureURL
Type:
xs:anyURI, predefined, simple content
When returned this contains the original URL of a self-hosted pictures, associated with the item when the item was listed.
XML Representation Summary
<ns:ExternalPictureURL>
   
Content: 
{ xs:anyURI }
</ns:ExternalPictureURL>
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" name="ExternalPictureURL" type="xs:anyURI"/>

ns:GalleryErrorInfo
Type:
xs:string, predefined, simple content
Indicates the reason the gallery generation failed, such as, URL for the image is not valid. This field is returned when GalleryStatus field is returned and does not appear when the gallery generation is successful.
XML Representation Summary
<ns:GalleryErrorInfo>
   
Content: 
{ xs:string }
</ns:GalleryErrorInfo>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="GalleryErrorInfo" type="xs:string"/>

ns:GalleryStatus
Type:
ns:GalleryStatusCodeType, simple content
Indicates if the gallery image upload failed and gives a reason for the failure, such as 'InvalidUrl' or 'ServerDown'. It is not returned if the gallery image is uploaded successfully.
XML Representation Summary
<ns:GalleryStatus>
   
Content: 
{ enumeration of xs:token }
</ns:GalleryStatus>
Simple Content
Enumeration:
"Success"
 - 
The Gallery image was successfully generated.
"Pending"
 - 
The Gallery image has not yet been generated.
"InvalidUrl"
 - 
The URL for the image file is not valid.
"InvalidProtocol"
 - 
The URL does not start with http:// or https:// .
"InvalidFile"
 - 
There is a problem with the image file.
"ServerDown"
 - 
The server containing the image file was unavailable.
"ImageNonExistent"
 - 
The image file could not be found.
"ImageReadTimeOut"
 - 
The image file failed to transfer.
"InvalidFileFormat"
 - 
The image file is not in JPG, BMP, GIF, TIF, or PNG format.
"ImageProcessingError"
 - 
We were not able to process the image file.
"CustomCode"
 - 
Reserved for internal only.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="GalleryStatus" type="ns:GalleryStatusCodeType"/>

ns:GalleryType
Type:
ns:GalleryTypeCodeType, simple content
This field is used to specify the type of picture gallery to use for the listing. If this field is omitted, a standard picture gallery is used for the listing. There is no listing fee for a standard picture gallery.

To use the Gallery Plus feature, you must include this field and set its value to Plus.

The Gallery image will be the first URL passed into the first PictureURL field, so if you want a specific picture to be the Gallery image, you should make sure you pass the URL for this picture in the first PictureURL field.

When revising a listing, if you disable the Gallery Plus or Featured Gallery feature by including the GalleryType and setting its value to Gallery, the original feature fee for either of these features will not be credited to the seller.
XML Representation Summary
<ns:GalleryType>
   
Content: 
{ enumeration of xs:token }
</ns:GalleryType>
Simple Content
Enumeration:
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="GalleryType" type="ns:GalleryTypeCodeType"/>

ns:PhotoDisplay
Type:
ns:PhotoDisplayCodeType, simple content
Specifies the type of image display used in a listing. Some options are only available if images are hosted through eBay Picture Services (EPS). eBay determines this by parsing the associated PictureURL.

Some PhotoDisplay options can result in listing fees, even when the item is relisted. If you are relisting an item that was originally listed with a PhotoDisplay option, and you do not want that PhotoDisplay enhancement in your relisted item, you need to specifically remove PhotoDisplay in your RelistItem call (or RelistFixedPriceItem, as applicable) by setting PhotoDisplay to None. Use VerifyRelistItem to review your listing fees before you relist an item.
XML Representation Summary
<ns:PhotoDisplay>
   
Content: 
{ enumeration of xs:token }
</ns:PhotoDisplay>
Simple Content
Enumeration:
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="PhotoDisplay" type="ns:PhotoDisplayCodeType"/>

ns:PictureSource
Type:
ns:PictureSourceCodeType, simple content
The service hosting the pictures in PictureURL, if any. This information is primarily useful for Picture Manager subscribers, who pay a flat subscription fee instead of individual picture fees per listing. Only returned when PictureURL is returned.
XML Representation Summary
<ns:PictureSource>
   
Content: 
{ enumeration of xs:token }
</ns:PictureSource>
Simple Content
Enumeration:
"EPS"
 - 
This value indicates that the image(s) specified in the PictureURL field(s) are hosted by eBay Picture Services.
"PictureManager"
 - 
This value is deprecated.
"Vendor"
 - 
This value indicates that the image(s) specified in the PictureURL field(s) are hosted by a third-party vendor. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol.
"CustomCode"
 - 
(out) Reserved for internal or future use.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="PictureSource" type="ns:PictureSourceCodeType"/>

ns:PictureURL
Type:
xs:anyURI, predefined, simple content
Contains the URL for a picture of the item. The URL can be from the eBay Picture Services (images previously uploaded) or from a server outside of eBay (self-hosted). You can pass in up to 12 picture URLs (for most categories and marketplaces) for each listing, but you cannot mix self-hosted and EPS-hosted URLs in the same listing. The UploadSiteHostedPictures call can be used to upload pictures to EPS. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. URLs using the 'http' protocol will not be allowed.

Note: If a URL contains spaces, those spaces can be replaced with %20. For example, https://example.com/my image.jpg must be submitted as https://example.com/my%20image.jpg to replace the space in the image file name. However, a semicolon character (;) cannot be replaced with %20, so a semicolon cannot be a part of the URL, as an error will occur. On the US and Canada eBay Motors sites (for all vehicle listings) a listing can contain up to 24 pictures. The Gallery image will be the first PictureURL in the array of PictureURL fields.

Note: All images, whether they are hosted by EPS or self-hosted, must comply with eBay picture requirements, including the requirement that all images must be at least 500 pixels on its longest side. If the image does not satisfy the 500 pixels requirement, the listing may be blocked. For more information about other requirements and tips for adding pictures to listings, see the Adding pictures to your listings help page. To specify multiple pictures, send each URL in a separate, PictureDetails.PictureURL element. The first URL passed in defaults to be the 'gallery image', and will be the first picture that is shown when a user lands on the View Item page.

If a listing uses a single, self-hosted picture (except in the case of a multiple-variation listing), the picture will be copied to eBay Picture Services (EPS) and the PictureDetails.PictureURL value returned by GetItem will be an EPS URL.

For VerifyAddItem only: You must include a picture even when using VerifyAddItem. If you don't have a image file, you can use the following fake eBay Picture Services URL (https://i2.ebayimg.com/abc/M28/dummy.jpg) with this call.

For ReviseItem and RelistItem only: To remove a picture when revising or relisting an item, specify PictureDetails with all the pictures that you want the listing to include. That is, you need to completely replace the original set of URLs with the revised set. You cannot remove all the PictureURL fields from a listing because each listing requires at least one picture.

Remember: The 'gallery image' will be the first PictureURL in the array of PictureURL fields. So, if the first image passed in when relisting/revising is different from when the listing was created, the 'gallery image' will be changed.

Note: For some large merchants, there are no limitations on when pictures can be added or removed from a fixed-price listing, even when the listing has had transactions or is set to end within 12 hours.
XML Representation Summary
<ns:PictureURL>
   
Content: 
{ xs:anyURI }
</ns:PictureURL>
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" name="PictureURL" type="xs:anyURI"/>

{any element from any namespace}
XML Source (see within schema source)
<xs:any maxOccurs="unbounded" minOccurs="0" processContents="lax"/>

 Component 
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API

WSDL documentation generated with FlexDoc/XML 1.13 using FlexDoc/XML WSDLDoc 1.2.5 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.