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. Note: Lead generated items are only cross-promoted if they are in the classified ad format (ListingSubtype=ClassifiedAd).

# 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.