/// <summary>
/// <para>Performs the category method:
/// Retrieves a list of all motorbike makes. Can be used when searching. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>MotorbikeMakeCollection</returns>
public MotorbikeMakeCollection GetMotorbikeMakes()
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.GetMotorbikeMakes();
}
/// <summary>
/// <para>Performs the category method:
/// Searches the Trade Me DVD catalogue for movie titles. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <param name="search">The partial title to search for.</param>
/// <returns>MovieTitles</returns>
public MovieTitles SearchDvdCatalog(String search = "")
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.SearchDvdCatalog(search);
}
/// <summary>
/// <para>Performs the category method:
/// Retrieves a list of possible complaint subjects. This is used in conjunction with the send a complaint API. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>ComplaintSubject</returns>
public ComplaintSubjectCollection GetComplaintSubjects()
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.GetComplaintSubjects();
}
/// <summary>
/// <para>Performs the category method:
/// Returns a list of districts and suburbs as used by TradeMe travel. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>LocalityCollection</returns>
public LocalityCollection RetrieveTravelLocalities()
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveTravelLocalities();
}
/// <summary>
/// <para>Performs the category methods:
/// Retrieve a list of Trade Me Motors used car categories.
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>Category.</returns>
public Category RetrieveUsedCarCategories()
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveUsedCarCategories();
}
/// <summary>
/// <para>Performs the category method:
/// Retrieves the legal notice that the user is required to agree to before listing. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <param name="categoryNumber">The category number for which you wish to see the legal notice for.
/// The number of the category to retrieve the legal notice for. This must be a leaf category
/// (for example, you cannot view the legal notice for Business, Farming and Industry, but you can
/// for Business, Farming and Industry > Carbon credits).</param>
/// <returns>LegalNotice</returns>
public LegalNotice RetrieveLegalNoticeForCategory(string categoryNumber)
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveLegalNoticeForCategory(categoryNumber);
}
// Localites:
/// <summary>
/// <para>Performs the Localities methods:
/// three-tier locality dataset,
/// two-tier locality dataset,
/// </para><para>
/// using the "query" string provided - should be the "Localities.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>Localities.</returns>
public LocalityCollection RetrieveLocalities(string query)
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveLocalities(query);
}
/// <summary>
/// <para>Performs the category method:
/// Retrieve a list of Trade Me Jobs categories.
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>JobCategories.</returns>
public JobCategories RetrieveJobCategories()
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveJobCategories();
}
/// <summary>
/// <para>Performs the category method:
/// Retrieves a list of fees for a specific category. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <param name="categoryNumber">The number of the category to retrieve fees for.</param>
/// <returns>ListingFees</returns>
public ListingFees RetrieveFeesForCategory(string categoryNumber)
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveFeesForCategory(categoryNumber);
}
/// <summary>
/// <para>Performs the category method:
/// Returns a list of DVD catalogue ID numbers. You can use this list to validate the catalogue ID before listing a DVD. GET
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <returns>DvdValidations</returns>
public DvdValidations RetrieveDvdIds()
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveDvdIds();
}
// Methods that DO NOT require authentication:
// Catalogue Methods:
// Categories:
/// <summary>
/// <para>Performs the category methods:
/// Retrieve a list of all or part of our category tree,
/// Retrieve a list of Trade Me Motors used car categories,
/// Retrieve a list of Trade Me Motors motorbike categories,
/// using the "query" string provided - should be the "Categories/UsedCars.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>Category.</returns>
public Category RetrieveCategoriesByQueryString(string query)
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveCategoriesByQueryString(query);
}
/// <summary>
/// <para>Performs the category methods:
/// Retrieve a list of all or part of our category tree.
/// Does this by using the id string provided - should be the id of the category you wish to retrieve.
/// </para>
/// DOES NOT REQUIRE AUTHENTICATION.
/// </summary>
/// <param name="id">The id of the category you wish to retrieve.</param>
/// <returns>Category.</returns>
public Category RetrieveCategoriesById(string id)
{
if (_catalogue == null)
{
_catalogue = new CatalogueMethods(_connection);
}
return _catalogue.RetrieveCategoriesById(id);
}
