ExtendSiteHostedPictures

Note: This call is deprecated and will be decommissioned on April 28th, 2025.

By default, unpublished pictures uploaded to eBay Picture Services (EPS) via the UploadSiteHostedPictures call will be kept on the server for five days before being purged. The ExtendSiteHostedPictures call is used to extend this expiration date by the number of days specified in the call. This restricted call gives approved sellers the ability to extend the default expiration date of pictures uploaded to EPS but not immediately published in an eBay listing.

eBay considers the following criteria when deciding whether or not to grant access to this call to a third party:

• Commercial applications that create eBay listings from a database of stored product or item information (often provided by eBay sellers) are usually granted permission to extend picture lifetimes. This helps to ensure the URLs in the eBay picture servers do not become stale when associated with infrequently listed products.
• Applications (other than those that call the eBay listing APIs) that provide features for editing, uploading, and managing pictures for use on eBay by eBay sellers will be reviewed and granted permission, considering the following:
  • The application does not facilitate the use of eBay-hosted pictures for purposes other than supporting commerce on eBay. For example, the application does not directly support sellers using their eBay-hosted pictures on non-eBay web stores.
  • The application prevents non-eBay-registered users from using the eBay features provided by the application. The application does, however, allow access to registered eBay sellers who have provided permission to the application to access eBay on their behalf.
  • The application provides integration or data exchange with an eBay listing tool (or a Certified Provider listing tool) that uses EPS when creating eBay listings.

If you need permission to use this restricted call, file a Developer Technical Support request with the following information:

• Your AppID
• Your use case

Note: It can take up to 4 weeks for your application to be approved.

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<ExtendSiteHostedPicturesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <ExtensionInDays> int </ExtensionInDays>
  <PictureURL> anyURI </PictureURL>
  <!-- ... more PictureURL values allowed here ... -->
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</ExtendSiteHostedPicturesRequest>

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<ExtendSiteHostedPicturesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <PictureURL> anyURI </PictureURL>
  <!-- ... more PictureURL values allowed here ... -->
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</ExtendSiteHostedPicturesResponse>

Detail Controls

DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Extends the expiration date for an image uploaded to eBay Picture Services (EPS).

Description

The request contains the number of days to extend the expiration date (here, 10), and the URL of the picture whose expiration date you want to extend.

Input

XML format.

<?xml version="1.0" encoding="utf-8"?>
<ExtendSiteHostedPicturesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>
  </RequesterCredentials>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Version>967</Version>
  <ExtensionInDays>10</ExtensionInDays>
  <PictureURL>https://i*********.com/*********/***0.jpg</PictureURL>
</ExtendSiteHostedPicturesRequest>

Output

XML format.
<?xml version="1.0" encoding="utf-8"?>
<ExtendSiteHostedPicturesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2016-04-14T23:21:19.551Z</Timestamp>
  <Ack>Success</Ack>
  <Version>967</Version>
  <Build>E967_CORE_BUNDLED_10639415_R1</Build>
  <PictureURL>https://i*********.com/*********/***0.jpg</PictureURL>
</ExtendSiteHostedPicturesResponse>

Change History