1Net::Amazon::Property(3U)ser Contributed Perl DocumentatiNoent::Amazon::Property(3)
2
3
4
6 Net::Amazon::Property - Baseclass for products on amazon.com
7
9 use Net::Amazon;
10
11 # ...
12
13 if($resp->is_success()) {
14 for my $prop ($resp->properties) {
15 print $_->ProductName(), " ",
16 $_->Manufacturer(), " ",
17 $_->OurPrice(), "\n";
18
20 "Net::Amazon::Property" is the baseclass for results returned from
21 Amazon web service queries. The term 'properties' is used as a generic
22 description for an item on amazon.com.
23
24 Typically, the "properties()" method of a "Net::Amazon::Response::*"
25 object will return one or more objects of class "Net::Amazon::Property"
26 or one of its subclasses, e.g. "Net::Amazon::Property::Book" or
27 "Net::Amazon::Property::CD".
28
29 While "Net::Amazon::Property" objects expose accessors for all fields
30 returned in the XML response (like "OurPrice()", "ListPrice()",
31 "Manufacturer()", "Asin()", "Catalog()", "ProductName()", subclasses
32 might define their own accessors to more class-specific fields (like
33 the i"Net::Amazon::Property::Book"'s "authors()" method returning a
34 list of authors, while "Net::Amazon::Property"'s "Authors()" method
35 will return a reference to a sub-hash containing a "Author" field, just
36 like the response's XML contained it).
37
38 METHODS
39 Methods vary, depending on the item returned from a query. Here's the
40 most common ones. They're all accessors, meaning they can be used like
41 "Method()" to retrieve the value or like "Method($value)" to set the
42 value of the field.
43
44 Asin()
45 The item's ASIN number. This option is deprecated, please use
46 ASIN.
47
48 ASIN()
49 The item's ASIN number.
50
51 ProductName()
52 Book title, CD album name or item name. This option is actually an
53 alias for the method title, and is actually dependent upon the type
54 of item returned.
55
56 Availability()
57 Text string describing if the item is available. Examples: "Usually
58 ships within 24 hours" or "Out of Print--Limited Availability".
59
60 Catalog()
61 Shows the catalog the item was found in: "Book", "Music",
62 "Classical", "Electronics" etc.
63
64 Authors()
65 Returns a sub-hash with a "Author" key, which points to either a
66 single $scalar or to a reference of an array containing author
67 names as scalars.
68
69 ReleaseDate()
70 Item's release date, format is "NN Monthname, Year".
71
72 Manufacturer()
73 Music label, publishing company or manufacturer
74
75 ImageUrlSmall()
76 URL to a small (thumbnail) image of the item
77
78 ImageUrlMedium()
79 URL to a medium-size image of the item
80
81 ImageUrlLarge()
82 URL to a large image of the item
83
84 ListPrice()
85 List price of the item
86
87 OurPrice()
88 Amazon price of the item
89
90 UsedPrice()
91 Used price of the item
92
93 RawListPrice()
94 Unformatted list price as an integer, without currency symbol.
95
96 CurrencyCode()
97 The currency code for the "ListPrice()", e.g. "USD".
98
99 SalesRank()
100 Sales rank of the item (contains digits and commas, like 1,000,001)
101
102 Media()
103 Type of media (Paperback, etc.).
104
105 NumMedia()
106 Number of media the item carries (1,2 CDs etc.).
107
108 ProductDescription()
109 Lengthy textual description of the product.
110
111 CollectiblePrice()
112 Lowest price in "Collectible" category.
113
114 CollectibleCount()
115 Number of offerings in "Collectible" category.
116
117 NumberOfOfferings()
118 Total number of offerings in all categories.
119
120 UsedCount()
121 Number of offerings in "Used" category.
122
123 TotalOffers()
124 Number of offerings of the product.
125
126 ThirdPartyNewPrice()
127 Lowest price in "Third Party New" category.
128
129 ThirdPartyNewCount()
130 Number of offerings in "Third Party New" category.
131
132 SmallImageWidth()
133 Return the width of the small image in pixels.
134
135 SmallImageHeight()
136 Return the height of the small image in pixels.
137
138 MediumImageWidth()
139 Return the width of the medium image in pixels.
140
141 MediumImageHeight()
142 Return the height of the medium image in pixels.
143
144 LargeImageWidth()
145 Return the width of the large image in pixels.
146
147 LargeImageHeight()
148 Return the height of the large image in pixels.
149
150 SuperSaverShipping()
151 Boolean value that indicates if the product is eligible for super
152 saver shipping.
153
154 year()
155 The release year extracted from ReleaseDate().
156
157 browse_nodes()
158 Returns a list of browse nodes (text string categories) for this
159 item.
160
161 similar_asins()
162 Returns a list of ASINs of similar items for this item.
163
164 SimilarProducts()
165 Returns a list of ASINs and titles of similar items for this item.
166
167 Please check the subclasses of "Net::Amazon::Property" for specialized
168 methods.
169
171 Mike Schilli, <m@perlmeister.com>
172
174 Copyright 2003 by Mike Schilli <m@perlmeister.com>
175
176 This library is free software; you can redistribute it and/or modify it
177 under the same terms as Perl itself.
178
179
180
181perl v5.28.0 2011-10-29 Net::Amazon::Property(3)