Object::eBay::Item(3)

NAME
Object::eBay::Item - Represents an item listed on eBay

SYNOPSIS
    # assuming that Object::eBay has already been initialized
    use Object::eBay::Item;
    my $item = Object::eBay::Item->new({ item_id => 12345678 });

    print "The item is titled '", $item->title(), "'\n";

DESCRIPTION
An Object::eBay::Item object represents an item that has been listed for sale on eBay.

METHODS

  new
A single 'item_id' argument is required. The value of the argument should be the eBay item ID of the item you want to represent.

  attributes
Returns an Object::eBay::Attributes object representing all the attributes about this item. If you plan to use this method, you must specify 'attribute_set_array' (sorry) in the "needs_methods" list when creating the object (see "new" in Object::eBay). If you don't specify "needs_methods" correctly, this method will return incorrect results.

  buy_it_now_price
Returns an Object::eBay::Currency object indicating the "Buy It Now" price for this item. If the item has no Buy It Now price, a price of "0" is returned. Although this may not be optimal behavior, it adhere's to eBay's usage.

  condition
Returns an Object::eBay::Condition object representing this item's condition. If condition information is not available, returns "undef".

  country
Returns a code indicating the item's country. This method may need to be deprecated because the docs on eBay are contradictory. Use it with caution.

  description
Returns the HTML text of the item's description. If you plan to use this method, please specify 'description' in the "needs_methods" list when creating the object (see "new" in Object::eBay). If you don't specify "needs_methods" correctly, this method will return incorrect results.

  is_ended
Returns an Object::eBay::Boolean true value if the eBay auction for this item has ended. Otherwise, it returns a false object.

  item_id
Returns the eBay item ID for this auction. This is the same as the "item_id" argument to "new". This method also provides the value when an Item object is used in string context.

  listing_details
Returns a Object::eBay::ListingDetails object.

  pictures
Returns a list of URLs for the pictures associated with this item. The eBay API defines multiple ways in which images can be associated with a particular item. This method searches each of those ways and returns a list of all the image URLs that it found. If no images are found, an empty list is returned. At this time, the URLs are simple scalars and not objects, however that may change. If the return value changes, the string context will still represent the URL as it does now.

  quantity
Returns the quantity for sale with this item.

  seller
Returns a Object::eBay::User object representing the item's seller. Not all methods of Object::eBay::User are necessarily available.

  selling_status
Returns a Object::eBay::SellingStatus object

  title
Returns the title of the item.

  watch_count
Returns the number of watches that have been place on this item via "My eBay" If you plan to use this method on an Object::eBay::Item object, please specify 'watch_count' in the "needs_methods" list when creating the object (see "new"). If you don't specify "needs_methods" correctly, this method will not be available.

DIAGNOSTICS
None

CONFIGURATION AND ENVIRONMENT
Object::eBay::Item requires no configuration files or environment variables.

DEPENDENCIES

•   Class::Std

•   Object::eBay

INCOMPATIBILITIES
None known.

BUGS AND LIMITATIONS
Please report any bugs or feature requests to "bug-object-ebay-item at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Object-eBay>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT
You can find documentation for this module with the perldoc command.

    perldoc Object::eBay

You can also look for information at:

•   AnnoCPAN: Annotated CPAN documentation

    <http://annocpan.org/dist/Object-eBay>

•   CPAN Ratings

    <http://cpanratings.perl.org/d/Object-eBay>

•   RT: CPAN's request tracker

    <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Object-eBay>

•   Search CPAN

    <http://search.cpan.org/dist/Object-eBay>

ACKNOWLEDGEMENTS

AUTHOR
Michael Hendricks <michael@ndrix.org>

LICENSE AND COPYRIGHT
Copyright (c) 2006 Michael Hendricks (<michael@ndrix.org>). All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.