/ 
Object-eBay-0.1.0
River stage zero No dependents
/ Object::eBay::Item

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.

buy_it_now_price

Returns a 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.

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 on an Object::eBay::Item object, please specify 'description' 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.

is_ended

Returns true if the eBay auction for this item has ended. Otherwise, it returns false.

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:

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.