/// <summary>
/// Retrieves Best Offers.
/// </summary>
///
/// <param name="ItemID">
/// The ID of the listing for which Best Offer information is to be returned.
/// See the description of GetBestOffers
/// for details related to who makes the request and how
/// ItemID and BestOfferID can be omitted.
/// </param>
///
/// <param name="BestOfferID">
/// The ID of the Best Offer for which information is to be returned.
/// See the description of GetBestOffers
/// for details related to who makes the request and how
/// ItemID and BestOfferID can be omitted.
/// </param>
///
/// <param name="BestOfferStatus">
/// This optional filter controls whether only active Best Offers are retrieved or
/// all Best Offers (even Best Offers that were declined or all no longer the "best
/// offer"). The "All" value can only be specified if an <b>ItemID</b>
/// value is also supplied in the request.
/// </param>
///
/// <param name="Pagination">
/// Specifies how to create virtual pages in the returned list (such as total
/// number of entries and total number of pages to return).
/// </param>
///
public BestOfferTypeCollection GetBestOffers(string ItemID, string BestOfferID, BestOfferStatusCodeType BestOfferStatus, PaginationType Pagination)
{
this.ItemID = ItemID;
this.BestOfferID = BestOfferID;
this.BestOfferStatus = BestOfferStatus;
this.Pagination = Pagination;
Execute();
return ApiResponse.BestOfferArray;
}
/// <summary>
/// This is the base request type of the <b>GetBestOffers</b> call. Depending on the input parameters that are used, this call can be used by a seller to retrieve all active Best Offers, all Best Offers on a specific listing, a specific Best Offer for a specific listing, or Best Offers in a specific state.
/// <br/><br/>
/// <span class="tablenote"><b>Note: </b>
/// The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing.
/// </span>
/// </summary>
///
/// <param name="ItemID">
/// The unique identifier of an eBay listing. If an <b>ItemID</b> is used by itself in the call request, all Best Offers in all states are retrieved for this listing. However, the seller can also combine <b>ItemID</b> and a <b>BestOfferStatus</b> value if that seller only wants to see Best Offers in a specific state. If a <b>BestOfferID</b> field is included in the call request, any <b>ItemID</b> value will be ignored since eBay will only search for and return the Best Offer identified in the <b>BestOfferID</b> field.
/// </param>
///
/// <param name="BestOfferID">
/// The unique identifier of a Best Offer. An identifier for a Best Offer is automatically created by eBay once a prospective buyer makes a Best Offer on a Best Offer-enabled listing. If a <b>BestOfferID</b> value is supplied in the call request, any <b>ItemID</b> or <b>BestOfferStatus</b> values will be ignored. Only the Best Offer identified by the <b>BestOfferID</b> value will be returned.
/// </param>
///
/// <param name="BestOfferStatus">
/// This field can be used if the seller wants to retrieve Best Offers in a specific state. The typical use case for this field is when the seller wants to retrieve Best Offers in all states for a specific listing. In fact, the <b>All</b> value can only be used if an <b>ItemID</b> value is also supplied in the call request. If a <b>BestOfferID</b> field is included in the call request, any <b>BestOfferStatus</b> value will be ignored since eBay will only search for and return the Best Offer identified in the <b>BestOfferID</b> field.
/// </param>
///
/// <param name="Pagination">
/// This container can be used if the seller is expecting that the <b>GetBestOffers</b> call will retrieve a large number of results, so that seller wishes to view just a subset (one page of multiple pages) of those results at a time. See this container's child fields for more information on how pagination is used.
/// </param>
///
public BestOfferTypeCollection GetBestOffers(string ItemID, string BestOfferID, BestOfferStatusCodeType BestOfferStatus, PaginationType Pagination)
{
this.ItemID = ItemID;
this.BestOfferID = BestOfferID;
this.BestOfferStatus = BestOfferStatus;
this.Pagination = Pagination;
Execute();
return(ApiResponse.BestOfferArray);
}
