NAME

Net::Amazon::Property - Baseclass for products on amazon.com

SYNOPSIS

  use Net::Amazon;

  # ...

  if($resp->is_success()) {
      for my $prop ($resp->properties) {
          print $_->ProductName(), " ",
                $_->Manufacturer(), " ",
                $_->OurPrice(), "\n";

DESCRIPTION

"Net::Amazon::Property" is the baseclass for results returned from Amazon web service queries. The term 'properties' is used as a generic description for an item on amazon.com.

Typically, the "properties()" method of a "Net::Amazon::Response::*" object will return one or more objects of class "Net::Amazon::Property" or one of its subclasses, e.g. "Net::Amazon::Property::Book" or "Net::Amazon::Property::CD".

While "Net::Amazon::Property" objects expose accessors for all fields returned in the XML response (like "OurPrice()", "ListPrice()", "Manufacturer()", "Asin()", "Catalog()", "ProductName()", subclasses might define their own accessors to more class-specific fields (like the i"Net::Amazon::Property::Book"'s "authors()" method returning a list of authors, while "Net::Amazon::Property"'s "Authors()" method will return a reference to a sub-hash containing a "Author" field, just like the response's XML contained it).

METHODS

Methods vary, depending on the item returned from a query. Here's the most common ones. They're all accessors, meaning they can be used like "Method()" to retrieve the value or like "Method($value)" to set the value of the field.

Asin(): The item's ASIN number. This option is deprecated, please use ASIN.
ASIN(): The item's ASIN number.
ProductName(): Book title, CD album name or item name. This option is actually an alias for the method title, and is actually dependent upon the type of item returned.
Availability(): Text string describing if the item is available. Examples: "Usually ships within 24 hours" or "Out of Print--Limited Availability".
Catalog(): Shows the catalog the item was found in: "Book", "Music", "Classical", "Electronics" etc.
Authors(): Returns a sub-hash with a "Author" key, which points to either a single $scalar or to a reference of an array containing author names as scalars.
ReleaseDate(): Item's release date, format is "NN Monthname, Year".
Manufacturer(): Music label, publishing company or manufacturer
ImageUrlSmall(): URL to a small (thumbnail) image of the item
ImageUrlMedium(): URL to a medium-size image of the item
ImageUrlLarge(): URL to a large image of the item
ListPrice(): List price of the item
OurPrice(): Amazon price of the item
UsedPrice(): Used price of the item
RawListPrice(): Unformatted list price as an integer, without currency symbol.
CurrencyCode(): The currency code for the "ListPrice()", e.g. "USD".
SalesRank(): Sales rank of the item (contains digits and commas, like 1,000,001)
Media(): Type of media (Paperback, etc.).
NumMedia(): Number of media the item carries (1,2 CDs etc.).
ProductDescription(): Lengthy textual description of the product.
CollectiblePrice(): Lowest price in "Collectible" category.
CollectibleCount(): Number of offerings in "Collectible" category.
NumberOfOfferings(): Total number of offerings in all categories.
UsedCount(): Number of offerings in "Used" category.
TotalOffers(): Number of offerings of the product.
ThirdPartyNewPrice(): Lowest price in "Third Party New" category.
ThirdPartyNewCount(): Number of offerings in "Third Party New" category.
SmallImageWidth(): Return the width of the small image in pixels.
SmallImageHeight(): Return the height of the small image in pixels.
MediumImageWidth(): Return the width of the medium image in pixels.
MediumImageHeight(): Return the height of the medium image in pixels.
LargeImageWidth(): Return the width of the large image in pixels.
LargeImageHeight(): Return the height of the large image in pixels.
SuperSaverShipping(): Boolean value that indicates if the product is eligible for super saver shipping.
year(): The release year extracted from ReleaseDate().
browse_nodes(): Returns a list of browse nodes (text string categories) for this item.
similar_asins(): Returns a list of ASINs of similar items for this item.
SimilarProducts(): Returns a list of ASINs and titles of similar items for this item.

Please check the subclasses of "Net::Amazon::Property" for specialized methods.

AUTHOR

Mike Schilli, <m@perlmeister.com>

COPYRIGHT AND LICENSE

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