Net::Amazon::Property(3)

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