/// <summary>
/// <para>Performs the Listing Method:
/// Retrieves the latest listed items for the whole country or for a single region. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>LatestListings.</returns>
public LatestListings GetLatestListings()
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.GetLatestListings();
}
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieves the items with one dollar reserves for the whole country or for a single region. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>OneDollarListings.</returns>
public OneDollarListings GetOneDollarListings()
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.GetOneDollarListings();
}
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieves the items closing soon for the whole country or for a single region. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>ClosingSoonListings.</returns>
public ClosingSoonListings GetClosingSoonListings()
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.GetClosingSoonListings();
}
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieves the featured listings for the whole country or for a single region. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>FeaturedListings.</returns>
public FeaturedListings GetFeaturedListings()
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.GetFeaturedListings();
}
/// <summary>
/// <para>Performs the Listing Method:
/// Send an email regarding an auction to a friend.
/// </para><para>
/// Serializes the given EmailFriendRequest into xml.
/// Creates a query string using the listingId provided .
/// </para><para>
/// All the parameters are required.
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <param name="email">The object that will be serialized into xml and then sent in a POST message.</param>
/// <param name="listingId">The id of the listing you want to email about.</param>
/// <returns>XDocument.</returns>
public XDocument EmailFriend(EmailFriendRequest email, string listingId)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.EmailFriend(email, listingId);
}
/// <summary>
/// <para>Performs the Listing Method:
/// Send an email to the seller of a classified.
/// </para><para>
/// Serializes the given EmailRequest into xml.
/// Creates a query string using the listingId provided .
/// </para><para>
/// All the parameters are required.
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <param name="emailRequest">The object that will be serialized into xml and then sent in a POST message.</param>
/// <param name="listingId">The id of the listing that youwant to email about.</param>
/// <returns>XDocument.</returns>
public XDocument EmailSellerOfClassified(EmailRequest emailRequest, string listingId)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.EmailSellerOfClassified(emailRequest, listingId);
}
/// <summary>
/// <para>Performs the Listing Method:
/// Provide an answer for a specific question.
/// </para><para>
/// Serializes the given ListingAnswerQuestion into xml.
/// Creates a query string using the parameters provided.
/// </para><para>
/// All the parameters are required.
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <param name="answerQuestion">The object that will be serialized into xml and then sent in a POST message.</param>
/// <param name="listingId">The id of the listing that has the question being answered.</param>
/// <param name="questionId">The id of the question being answered.</param>
/// <returns>XDocument.</returns>
public XDocument AnswerSpecificQuestion(ListingAnswerQuestion answerQuestion, string listingId, string questionId)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.AnswerSpecificQuestion(answerQuestion, listingId, questionId);
}
/// <summary>
/// <para>Performs the Listing Method:
/// Post a comment on a listing.
/// </para><para>
/// Serializes the given ListingAddComment into xml.
/// Creates a query string using the listingId provided .
/// </para><para>
/// All the parameters are required.
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <param name="addComment">The object that will be serialized into xml and then sent in a POST message.</param>
/// <param name="listingId">The id of the listing the comment should be added to.</param>
/// <returns>XDocument.</returns>
public XDocument CommentOnListing(ListingAddComment addComment, string listingId)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.CommentOnListing(addComment, listingId);
}
// methods that DO require authentication:
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieve a list of unanswered questions for all listings belonging to a member,
/// Retrieve a list of unanswered questions on a single listing,
/// </para><para>
/// using the "query" string provided - should be the "Listings/questions/unansweredquestions.xml" part of the url.
/// It shouldn't include "http://api.trademe.co.nz/v1/".
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <param name="query">The query string that will be added to the base url and used to connect to the API.</param>
/// <returns>Questions.</returns>
public Questions UnansweredQuestionsByQueryString(string query)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.UnansweredQuestionsByQueryString(query);
}
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieve a list of unanswered questions for all listings belonging to a member,
/// Retrieve a list of unanswered questions on a single listing.
/// </para><para>
/// Creates a query string using the id parameter provided - the parameter should be null if the request is for all listings belonging to a member.
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <param name="listingId">The listing id.</param>
/// <returns>Questions.</returns>
public Questions UnansweredQuestionsById(string listingId)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.UnansweredQuestionsById(listingId);
}
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieves a list of all the unanswered questions for all live auctions of the authenticated user. GET
/// </para>
/// REQUIRES AUTHENTICATION.
/// </summary>
/// <returns>Questions.</returns>
public Questions UnansweredQuestionsAll()
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.UnansweredQuestionsAll();
}
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieve the details of a single listing.
/// </para><para>Creates a query string using the listing id parameter provided.
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <param name="id">The listing id.</param>
/// <returns>ListedItemDetail.</returns>
public ListedItemDetail ListingDetailById(string id)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.ListingDetailById(id);
}
// Listing Methods:
/// <summary>
/// <para>Performs the Listing Method:
/// Retrieve the details of a single listing
/// </para><para>using the "query" string provided - should be the "Listings/{listing_id}.xml" part of the url.
/// It shouldn't include "http://api.trademe.co.nz/v1/".
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <param name="query">The query string that will be added to the base url and used to connect to the API with.</param>
/// <returns>ListedItemDetail.</returns>
public ListedItemDetail ListingDetail(string query)
{
if (_listing == null)
{
_listing = new ListingMethods(_connection);
}
return _listing.ListingDetail(query);
}