Michael Schilli > Net-Amazon-0.35 > Net::Amazon::Property

Download:
Net-Amazon-0.35.tar.gz

Dependencies

Annotate this POD (1)

CPAN RT

New  5
Open  2
View/Report Bugs
Source   Latest Release: Net-Amazon-0.62

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

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

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.

ThirdPartyNewPrice()

Lowest price in "Third Party New" category.

ThirdPartyNewCount()

Number of offerings in "Third Party New" category.

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.

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.

syntax highlighting: