eBay::API::XML::DataType::PromotedItemType(3)

NAME
eBay::API::XML::DataType::PromotedItemType

DESCRIPTION
Contains the data describing one cross-promoted item.

SYNOPSIS

INHERITANCE
eBay::API::XML::DataType::PromotedItemType inherits from the eBay::API::XML::BaseDataType class

Subroutines:

  setItemID()
The unique ID of the item for which there is a promotion.

MaxLength: 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits)

# Argument: 'ns:ItemIDType'

  getItemID()
  Calls: GetPromotionRules
  Returned: Conditionally

  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always

# Returns: 'ns:ItemIDType'

  setListingType()
The listing type under which the cross-promoted item is being offered.<br> <br> <span class="tablenote"><b>Note:</b> Lead generated items are only cross-promoted if they are in the classified ad format (ListingSubtype=ClassifiedAd).</span>

# Argument: 'ns:ListingTypeCodeType'

  getListingType()
  Calls: GetItem
  Returned: Conditionally
  AllValuesExcept: Unknown, Live, Auction, PersonalOffer,
                                                        Half, Express
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always
  AllValuesExcept: Unknown, Live, Auction, PersonalOffer,
                                                        Half, Express

# Returns: 'ns:ListingTypeCodeType'

  setPictureURL()
URL for an image hosted by eBay Picture Services (EPS) or self-hosted for the promoted item, if any.

# Argument: 'xs:string'

  getPictureURL()
  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

# Returns: 'xs:string'

  setPosition()
The ordinal position of the cross-promoted item in the display. If the display is from top to bottom, 1 is at top. If the display is from left to right, 1 is at left.

# Argument: 'xs:int'

  getPosition()
  Calls: GetPromotionRules
  Returned: Conditionally

  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always

# Returns: 'xs:int'

  setPromotionDetails()
Contains the details about the promoted item for a given PromotionPriceType. Output only. Returned with request versions 485 or higher.

# Argument: reference to an array
                      of 'ns:PromotionDetailsType'

  getPromotionDetails()
  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always

# Returns: reference to an array
                      of 'ns:PromotionDetailsType'

  setSelectionType()
The manner in which the cross-promoted item was chosen to be associated with the referring item. Output only.

# Argument: 'ns:PromotionItemSelectionCodeType'

  getSelectionType()
  Calls: GetPromotionRules
  Returned: Conditionally

  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always

# Returns: 'ns:PromotionItemSelectionCodeType'

  setTimeLeft()
Time left before the listing for the cross-promoted item ends. Output only. The duration is represented in the ISO 8601 duration format (PnYnMnDTnHnMnS). See Data Types in the eBay Web Services guide for information about this format. For ended listings, the time left is PT0S (zero seconds).

# Argument: 'xs:duration'

  getTimeLeft()
  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always

# Returns: 'xs:duration'

  setTitle()
The title of the promoted item for display in the referring item's page. Output only.

# Argument: 'xs:string'

  getTitle()
  Calls: GetItem
  Returned: Conditionally
  Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

  Calls: GetCrossPromotions
  Returned: Always

# Returns: 'xs:string'