Changes since
the last release

com.ebay.sdk.call
Class GetAllBiddersCall

java.lang.Object
  extended by com.ebay.sdk.ApiCall
      extended by com.ebay.sdk.call.GetAllBiddersCall

public class GetAllBiddersCall
extends ApiCall

Wrapper class of the GetAllBidders call of eBay SOAP API.

Title: SOAP API wrapper library.

Description: Contains wrapper classes for eBay SOAP APIs.

Copyright: Copyright (c) 2009

Company: eBay Inc.


Input property: ItemID - This is the unique identifier of the auction listing for which bidders are being retrieved. This auction listing can be active or recently ended. However, to retrieve bidders for an active auction listing, the only CallMode enumeration value that can be used is ViewAll.
Input property: CallMode - The enumeration value that is passed into this field will control the set of bidders that will be retrieved in the response. To retrieve bidders from a recently-ended auction listing, any of the three values can be used. To retrieve bidders for an active auction listing, only the ViewAll enumeration value can be used. These values are discussed in GetAllBiddersModeCodeType.

Input property: IncludeBiddingSummary - The user must include this field and set its value to true if the user wishes to retrieve the BiddingSummary container for each bidder. The BiddingSummary container consists of more detailed bidding information on each bidder.
Output property: ReturnedBidArray - This container consists of an array of bids made on the specified auction listing. Each OfferType object represents the data for one bid.
Output property: ReturnedHighBidder - The eBay user ID for the user with the winning bid (if auction has ended) or current highest bid (if auction is still active). The seller should take note of or save this User ID as this user may be a a Second Chance Offer candidate.
Output property: ReturnedHighestBid - This is the dollar amount of the winning bid (if auction has ended) or dollar amount of the current highest bid (if auction is still active).
Output property: ReturnedListingStatus - This enumeration value indicates the listing status of the specified listing.

Version:
1.0
Author:
Ron Murphy

Field Summary
 
Fields inherited from class com.ebay.sdk.ApiCall
apiException, sendReqListeners
 
Constructor Summary
GetAllBiddersCall()
          Constructor.
GetAllBiddersCall(ApiContext apiContext)
          Constructor.
 
Method Summary
 OfferType[] getAllBidders()
          This is the base request type for the GetAllBidders call, which is used to retrieve bidders from an active or recently-ended auction listing.
 GetAllBiddersModeCodeType getCallMode()
          Gets the GetAllBiddersRequestType.callMode.
 java.lang.Boolean getIncludeBiddingSummary()
          Gets the GetAllBiddersRequestType.includeBiddingSummary.
 java.lang.String getItemID()
          Gets the GetAllBiddersRequestType.itemID.
 OfferType[] getReturnedBidArray()
          Valid after executing the API.
 java.lang.String getReturnedHighBidder()
          Valid after executing the API.
 AmountType getReturnedHighestBid()
          Valid after executing the API.
 ListingStatusCodeType getReturnedListingStatus()
          Valid after executing the API.
 void setCallMode(GetAllBiddersModeCodeType callMode)
          Sets the GetAllBiddersRequestType.callMode.
 void setIncludeBiddingSummary(java.lang.Boolean includeBiddingSummary)
          Sets the GetAllBiddersRequestType.includeBiddingSummary.
 void setItemID(java.lang.String itemID)
          Sets the GetAllBiddersRequestType.itemID.
 
Methods inherited from class com.ebay.sdk.ApiCall
addDetailLevel, addSendRequestListener, execute, executeByApiName, getApiContext, getApiException, getBotBlock, getCallRetry, getDetailLevel, getEnableCompression, getEndUserIP, getErrorHandling, getInvocationID, getMessageID, getOutputSelector, getRequestXml, getResponseObject, getResponseXml, getSite, getWarningLevel, hasError, hasWarning, isEnableoAuthTokenHTTPHeader, removeSendRequestListener, setApiContext, setBotBlock, setCallRetry, setDetailLevel, setEnableCompression, setEnableoAuthTokenHTTPHeader, setEndUserIP, setErrorHandling, setInvocationID, setMessageID, setOutputSelector, setSite, setWarningLevel
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GetAllBiddersCall

public GetAllBiddersCall()
Constructor.


GetAllBiddersCall

public GetAllBiddersCall(ApiContext apiContext)
Constructor.

Parameters:
apiContext - The ApiContext object to be used to make the call.
Method Detail

getAllBidders

public OfferType[] getAllBidders()
                          throws ApiException,
                                 SdkException,
                                 java.lang.Exception
This is the base request type for the GetAllBidders call, which is used to retrieve bidders from an active or recently-ended auction listing.

Returns:
The OfferType[] object.
Throws:
ApiException
SdkException
java.lang.Exception

getCallMode

public GetAllBiddersModeCodeType getCallMode()
Gets the GetAllBiddersRequestType.callMode.

Returns:
GetAllBiddersModeCodeType

setCallMode

public void setCallMode(GetAllBiddersModeCodeType callMode)
Sets the GetAllBiddersRequestType.callMode.

Parameters:
callMode - GetAllBiddersModeCodeType

getIncludeBiddingSummary

public java.lang.Boolean getIncludeBiddingSummary()
Gets the GetAllBiddersRequestType.includeBiddingSummary.

Returns:
Boolean

setIncludeBiddingSummary

public void setIncludeBiddingSummary(java.lang.Boolean includeBiddingSummary)
Sets the GetAllBiddersRequestType.includeBiddingSummary.

Parameters:
includeBiddingSummary - Boolean

getItemID

public java.lang.String getItemID()
Gets the GetAllBiddersRequestType.itemID.

Returns:
String

setItemID

public void setItemID(java.lang.String itemID)
Sets the GetAllBiddersRequestType.itemID.

Parameters:
itemID - String

getReturnedBidArray

public OfferType[] getReturnedBidArray()
Valid after executing the API. Gets the returned GetAllBiddersResponseType.returnedBidArray.

Returns:
OfferType[]

getReturnedHighBidder

public java.lang.String getReturnedHighBidder()
Valid after executing the API. Gets the returned GetAllBiddersResponseType.returnedHighBidder.

Returns:
String

getReturnedHighestBid

public AmountType getReturnedHighestBid()
Valid after executing the API. Gets the returned GetAllBiddersResponseType.returnedHighestBid.

Returns:
AmountType

getReturnedListingStatus

public ListingStatusCodeType getReturnedListingStatus()
Valid after executing the API. Gets the returned GetAllBiddersResponseType.returnedListingStatus.

Returns:
ListingStatusCodeType

Changes since
the last release

The information contained in this document is proprietary and confidential. Use of this information and the eBay API requires a Non-Disclosure Agreement (NDA) between the user and eBay Inc. For information regarding a qualifying NDA, contact Developer Relations: developer-relations@ebay.com
© 2004-2009 eBay Inc. All rights reserved.