table of contents
Net::Amazon::Property(3pm) | User Contributed Perl Documentation | Net::Amazon::Property(3pm) |
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.
2021-01-02 | perl v5.32.0 |