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

NAME
eBay::API::XML::DataType::AdFormatLeadType

DESCRIPTION
Contains prospective buyer contact information and other details associated with a lead for an ad format listing.

SYNOPSIS

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

Subroutines:

  setAdditionalInformation()
Message sent from the prospective buyer to the seller. Same content as in the AdFormatLead.MemberMessage.MemberMessageExchange.Question.Body node (that is only displayed if IncludeMemberMessages = true is included in the request). The advantage of retrieving the MemberMessageExchange node, however, is that you retrieve the entire exchange between the seller and the lead.

# Argument: 'xs:string'

  getAdditionalInformation()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setAddress()
Address information for the prospective buyer. Not returned or returned self-closed if information is unavailable.

# Argument: 'ns:AddressType'

  getAddress()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'ns:AddressType'

  setAnswer1()
This field corresponds to a configurable question on the lead form in the View Item web page. The corresponding question is site-specific. To determine the question for a specific site, you must view the form in the web flow for the given site. This field applies to Classified Ad format listings in Motors categories only.

MaxLength: 1

# Argument: 'xs:boolean'

  isAnswer1()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:boolean'

  setAnswer2()
This field corresponds to a configurable question on the lead form in the View Item web page. The corresponding question is site-specific. To determine the question for a specific site, you must view the form in the web flow for the given site. This field applies to Classified Ad format listings in Motors categories only.

MaxLength: 1

# Argument: 'xs:boolean'

  isAnswer2()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:boolean'

  setBestTimeToCall()
The time of day when the prospective buyer prefers to be contacted by the seller. Not returned if information is unavailable.

# Argument: 'xs:string'

  getBestTimeToCall()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setEmail()
Email address for the prospective buyer. If the prospective buyer chooses to hide his email address when contacting the seller, this element contains two dashes (--) instead of an email address.

# Argument: 'xs:string'

  getEmail()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setExternalEmail()
Email address for the prospective buyer as entered in the lead form on the View Item page. Provides a way for sellers to contact prospective buyers who choose not to log in to eBay. This applies to only eBay Motors and eBay Motors categories.

MaxLength: 128

# Argument: 'xs:string'

  getExternalEmail()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setFinancingAnswer()
Prospective buyer answer whether or not the prospective buyer would like financing. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only. Financing response meanings: 0= no response,1= yes, 2= no.

MaxLength: 1

# Argument: 'xs:boolean'

  isFinancingAnswer()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:boolean'

  setItemID()
The ID of the item that the lead is for.

# Argument: 'ns:ItemIDType'

  getItemID()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'ns:ItemIDType'

  setItemTitle()
The title of the item that the lead is for.

# Argument: 'xs:string'

  getItemTitle()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setLeadFee()
The total fee from email and phone leads. Applies to the item specified in the request. LeadFee is part the pay-per-lead feature.

# Argument: 'ns:AmountType'

  getLeadFee()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'ns:AmountType'

  setMemberMessage()
Contains any mail message content shared between the seller and lead.

# Argument: 'ns:MemberMessageExchangeArrayType'

  getMemberMessage()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'ns:MemberMessageExchangeArrayType'

  setPurchaseTimeFrame()
Prospective buyer's time frame for purchasing a vehicle as entered in the Lead form on View Item page for eBay Motors and eBay Motors categories. Purchasing Time Frames include: <ul> <li> within next 3 days </li> <li> within a week </li> <li> within a month </li> <li> within three months </li> <li> in more than three months </li> <li> within an undecided time frame </li> </ul>

MaxLength: 255

# Argument: 'xs:string'

  getPurchaseTimeFrame()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setStatus()
Status of the lead.

# Argument: 'ns:AdFormatLeadStatusCodeType'

  getStatus()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'ns:AdFormatLeadStatusCodeType'

  setSubmittedTime()
Date and time (in GMT) that the lead was submitted.

# Argument: 'xs:dateTime'

  getSubmittedTime()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:dateTime'

  setTradeInMake()
The make of the vehicle the prospective buyer would like to trade in. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only.

MaxLength: 128

# Argument: 'xs:string'

  getTradeInMake()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setTradeInModel()
The model of the vehicle the prospective buyer would like to trade in. Entered on the lead form on the View Item page.Applies to eBay Motors and Motors categories only.

MaxLength: 128

# Argument: 'xs:string'

  getTradeInModel()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setTradeInYear()
The year of the vehicle the prospective buyer would like to trade in. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only.

MaxLength: 32

# Argument: 'xs:string'

  getTradeInYear()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'xs:string'

  setUserID()
The eBay ID of the user who is interested in the seller's item.

# Argument: 'ns:UserIDType'

  getUserID()
  Calls: GetAdFormatLeads
  Returned: Conditionally
  Details: DetailLevel: ReturnAll

# Returns: 'ns:UserIDType'