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'