com.ebay.sdk.call.GetAllBiddersCall Maven / Gradle / Ivy
/*
Copyright (c) 2013 eBay, Inc.
This program is licensed under the terms of the eBay Common Development and
Distribution License (CDDL) Version 1.0 (the "License") and any subsequent version
thereof released by eBay. The then-current version of the License can be found
at http://www.opensource.org/licenses/cddl1.php and in the eBaySDKLicense file that
is under the eBay SDK ../docs directory.
*/
package com.ebay.sdk.call;
import java.lang.Boolean;
import com.ebay.sdk.*;
import com.ebay.soap.eBLBaseComponents.*;
/**
* 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.
*
* @author Ron Murphy
* @version 1.0
*/
public class GetAllBiddersCall extends com.ebay.sdk.ApiCall
{
private String itemID = null;
private GetAllBiddersModeCodeType callMode = null;
private Boolean includeBiddingSummary = null;
private OfferType[] returnedBidArray=null;
private String returnedHighBidder=null;
private AmountType returnedHighestBid=null;
private ListingStatusCodeType returnedListingStatus=null;
/**
* Constructor.
*/
public GetAllBiddersCall() {
}
/**
* Constructor.
* @param apiContext The ApiContext object to be used to make the call.
*/
public GetAllBiddersCall(ApiContext apiContext) {
super(apiContext);
}
/**
* This is the base request type for the GetAllBidders call, which is used to retrieve bidders from an active or recently-ended auction listing.
*
*
* @throws ApiException
* @throws SdkException
* @throws Exception
* @return The OfferType[] object.
*/
public OfferType[] getAllBidders()
throws com.ebay.sdk.ApiException, com.ebay.sdk.SdkException, java.lang.Exception
{
GetAllBiddersRequestType req;
req = new GetAllBiddersRequestType();
req.setDetailLevel(this.getDetailLevel());
if (this.itemID != null)
req.setItemID(this.itemID);
if (this.callMode != null)
req.setCallMode(this.callMode);
if (this.includeBiddingSummary != null)
req.setIncludeBiddingSummary(this.includeBiddingSummary);
GetAllBiddersResponseType resp = (GetAllBiddersResponseType) execute(req);
this.returnedBidArray = (resp.getBidArray() == null? null: resp.getBidArray().getOffer());
this.returnedHighBidder = resp.getHighBidder();
this.returnedHighestBid = resp.getHighestBid();
this.returnedListingStatus = resp.getListingStatus();
return this.getReturnedBidArray();
}
/**
* Gets the GetAllBiddersRequestType.callMode.
* @return GetAllBiddersModeCodeType
*/
public GetAllBiddersModeCodeType getCallMode()
{
return this.callMode;
}
/**
* Sets the GetAllBiddersRequestType.callMode.
* @param callMode GetAllBiddersModeCodeType
*/
public void setCallMode(GetAllBiddersModeCodeType callMode)
{
this.callMode = callMode;
}
/**
* Gets the GetAllBiddersRequestType.includeBiddingSummary.
* @return Boolean
*/
public Boolean getIncludeBiddingSummary()
{
return this.includeBiddingSummary;
}
/**
* Sets the GetAllBiddersRequestType.includeBiddingSummary.
* @param includeBiddingSummary Boolean
*/
public void setIncludeBiddingSummary(Boolean includeBiddingSummary)
{
this.includeBiddingSummary = includeBiddingSummary;
}
/**
* Gets the GetAllBiddersRequestType.itemID.
* @return String
*/
public String getItemID()
{
return this.itemID;
}
/**
* Sets the GetAllBiddersRequestType.itemID.
* @param itemID String
*/
public void setItemID(String itemID)
{
this.itemID = itemID;
}
/**
* Valid after executing the API.
* Gets the returned GetAllBiddersResponseType.returnedBidArray.
*
* @return OfferType[]
*/
public OfferType[] getReturnedBidArray()
{
return this.returnedBidArray;
}
/**
* Valid after executing the API.
* Gets the returned GetAllBiddersResponseType.returnedHighBidder.
*
* @return String
*/
public String getReturnedHighBidder()
{
return this.returnedHighBidder;
}
/**
* Valid after executing the API.
* Gets the returned GetAllBiddersResponseType.returnedHighestBid.
*
* @return AmountType
*/
public AmountType getReturnedHighestBid()
{
return this.returnedHighestBid;
}
/**
* Valid after executing the API.
* Gets the returned GetAllBiddersResponseType.returnedListingStatus.
*
* @return ListingStatusCodeType
*/
public ListingStatusCodeType getReturnedListingStatus()
{
return this.returnedListingStatus;
}
}