.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Net::Amazon::Request::BrowseNode 3pm" .TH Net::Amazon::Request::BrowseNode 3pm "2021-01-02" "perl v5.32.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Net::Amazon::Request::BrowseNode \- request class for browse node search .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 2 \& use Net::Amazon; \& use Net::Amazon::Request::BrowseNode; \& \& my $ua = Net::Amazon\->new( \& token => \*(AqYOUR_AMZN_TOKEN\*(Aq \& ); \& \& my $req = Net::Amazon::Request::BrowseNode\->new( \& browsenode => 30, \& mode => \*(Aqbooks\*(Aq \& ); \& \& # Response is of type Net::Amazon::Response::BrowseNode \& my $resp = $ua\->request($req); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\f(CW\*(C`Net::Amazon::Request::BrowseNode\*(C'\fR is a class used to submit node search requests to the Amazon web service. .PP The node to search for is specified in the \f(CW\*(C`browsenode\*(C'\fR parameter. The browse node \s-1ID\s0 is a number that corresponds to a general subject area of Amazon.com. .PP To find browse node IDs, the best way is to visit the \*(L"browse\*(R" area of the various product lines at Amazon.com. When you find a subject area that you would like to generate \s-1XML\s0 for, look at the web page \s-1URL.\s0 The browse \s-1ID\s0 should appear after the string \*(L"/tg/browse/\-/\*(R". Here are some examples of URLs that contain browse IDs: .IP "http://www.amazon.com/exec/obidos/tg/browse/\-/30 (In this example, the browse \s-1ID\s0 = 30)" 8 .IX Item "http://www.amazon.com/exec/obidos/tg/browse/-/30 (In this example, the browse ID = 30)" .PD 0 .IP "http://www.amazon.com/exec/obidos/tg/browse/\-/467970 (In this example, the browse \s-1ID\s0 = 467970)" 8 .IX Item "http://www.amazon.com/exec/obidos/tg/browse/-/467970 (In this example, the browse ID = 467970)" .IP "http://www.amazon.com/exec/obidos/tg/browse/\-/602314 (In this example, the browse \s-1ID\s0 = 60231" 8 .IX Item "http://www.amazon.com/exec/obidos/tg/browse/-/602314 (In this example, the browse ID = 60231" .PD .PP Please be aware that some nodes cannot be used with a BrowseNodeSearch. (The vast majority of them can, but you may run across a few that simply will not work). It is also important to point out that from time to time, some browse nodes are deprecated or are changed without notice. .PP The catalog to search in is specified in the \f(CW\*(C`mode\*(C'\fR parameter, typical values are \f(CW\*(C`books\*(C'\fR, \f(CW\*(C`music\*(C'\fR, \f(CW\*(C`classical\*(C'\fR or \f(CW\*(C`electronics\*(C'\fR. .PP An optional \f(CW\*(C`keywords\*(C'\fR parameter may be added to filter the results by that keyword. .PP Upon success, the responses' \f(CW\*(C`properties()\*(C'\fR method will return a list of \&\f(CW\*(C`Net::Amazon::Properties::*\*(C'\fR objects. .SS "\s-1METHODS\s0" .IX Subsection "METHODS" .ie n .IP "new( browsenode => $nodeID, mode => $mode [, keywords => $keywords] )" 4 .el .IP "new( browsenode => \f(CW$nodeID\fR, mode => \f(CW$mode\fR [, keywords => \f(CW$keywords\fR] )" 4 .IX Item "new( browsenode => $nodeID, mode => $mode [, keywords => $keywords] )" Constructs a new \f(CW\*(C`Net::Amazon::Request::BrowseNode\*(C'\fR object, used to query the Amazon web service for items in a particular category (node) in the mode (catalog) specified. .PP Check Net::Amazon::Request for common request parameters not listed here. .SH "AUTHOR" .IX Header "AUTHOR" Net::Amazon framework by Mike Schilli, .PP BrowseNode.pm by Jackie Hamilton, .SH "LICENSE" .IX Header "LICENSE" This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.