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 iNet::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.

ProductName()

Book title, CD album name or item name

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

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

SEE ALSO

AUTHOR

Mike Schilli, <m@perlmeister.com>

COPYRIGHT AND LICENSE

Copyright 2003 by Mike Schilli <m@perlmeister.com>

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