Object::eBay::Item - Represents an item listed on eBay
# 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";
An Object::eBay::Item object represents an item that has been listed for sale on eBay.
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.
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.
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.
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.
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.
Returns an Object::eBay::Boolean true value if the eBay auction for this item has ended. Otherwise, it returns a false object.
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.
Returns a Object::eBay::ListingDetails object.
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.
Returns the quantity for sale with this item.
Returns a Object::eBay::User object representing the item's seller. Not all methods of Object::eBay::User are necessarily available.
Returns a Object::eBay::SellingStatus object
Returns the title of the item.
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.
None
Object::eBay::Item requires no configuration files or environment variables.
None known.
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.
You can find documentation for this module with the perldoc command.
perldoc Object::eBay
You can also look for information at:
Michael Hendricks <michael@ndrix.org>
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.
