Amazon Product Advertising API Скачать руководство пользователя страница 261

Страница: 261 / 484

<Item>

</LowestNewPrice>

</LowestUsedPrice>

</LowestCollectiblePrice>

</OfferSummary>

<Offer>

<Name>Amazon.com</Name>

</Merchant>

</OfferAttributes>

<OfferListingId>cMVuIFx8kiYSgRIJXiCzKZZyyl

wztVSAYV8vCo2OxHS8L9SB7lwho8fK6CxYkmdDPy8thFzm30Y%3D</OfferListingId>

<Price>

</Price>

<Availability>Usually ships in 24 hours</Availability>

</OfferListing>

</Offer>

</Offers>

</Item>

OfferListings

The

OfferListings

response group returns the

OfferListings

for items returned in the response.

The values returned are similar to those returned by the

Offers

response group minus the values returned

by the

OfferSummary

response group. OfferListings returns shipping options, including

IsEligibleForSuperSavingShipping

which specifies whether the item qualifies for super saver

shipping.

API Version 2011-08-01

254

Product Advertising API Developer Guide

OfferListings

Содержание Product Advertising API

Страница 1: ...Product Advertising API Developer Guide API Version 2011 08 01...

Страница 3: ...d Basic Concepts 22 The Marketplace 22 What Is the Product Advertising API 23 How Do I Make Money Using the Product Advertising API 23 International Locales 23 Items for Sale 24 Summary of Product Adv...

Страница 4: ...T Requests 61 Authenticating SOAP Requests 66 Using SOAP with WS Security 66 Using SOAP without WS Security 71 Batch Requests 72 Batch Requests 72 Parameters That Differ 73 Shared Parameters 74 Perfor...

Страница 5: ...the Same Item 116 Top Sellers 119 Getting Top Sellers From the Shopping Cart 121 New Releases 122 Sorting by Popularity Price or Condition 123 Returning Price and Availability Information 125 Returni...

Страница 6: ...73 CartCreate 175 CartGet 181 CartModify 185 ItemLookup 189 ItemSearch 196 SimilarityLookup 206 Common Request Parameters 210 Response Groups 213 Accessories Response Group 213 AlternateVersions Respo...

Страница 7: ...Sort Values for FR 344 Sort Values for IT 354 Sort Values for JP 359 Sort Values for UK 370 Sort Values for US 382 Search Index and ItemSearch Parameter Combinations 398 SearchIndex ItemSearch Paramet...

Страница 8: ...e commerce storefronts Required Knowledge and Skills Use of this guide assumes you are familiar with the following XML For an overview go to the W3 Schools XML Tutorial Basic understanding of web serv...

Страница 9: ...es Product Advertising API Release Notes A central starting point find documentation code samples release notes and other information to help you build innovative applications with the Product Adverti...

Страница 10: ...t Advertising API Product Advertising API information for IT The primary JP web page for information about Product Advertising API Product Advertising API information for JP The primary UK web page fo...

Страница 11: ...tplace was added New Marketplace 1 August 2011 The IT Italy and CN China marketplaces were added New Marketplace 26 July 2011 As part of our efforts to streamline the Product Advertising API we will b...

Страница 12: ...to Amazon s databases so that you can take advantage of Amazon s sophisticated e commerce data and functionality Build your own web store to sell Amazon items or your own items Best of all Product Adv...

Страница 13: ...on uses the Product Advertising API to supply item descriptions and images and customer and seller reviews which you present to your customers 1 Customers shop on your web site 2 When the customer is...

Страница 14: ...ite Visual Introduction to Product Advertising API p 28 Describes how items are organized in Amazon databases Organization of Items for Sale on Amazon Introduces you to making Product Advertising API...

Страница 15: ...njunction with the Amazon Associates program you need to register to become a Product Advertising API developer and join the Amazon Associates Program Note For instructions on how to register to becom...

Страница 16: ...ment Becoming an Associate To become an Associate go to the Amazon Associates main page for your locale URL Locale https associates amazon ca Canada https associates amazon cn gp advertising api detai...

Страница 17: ...ng api sign in html United States 2 Click Sign Up and then sign in with the credentials for your Product Advertising API account These credentials are the same as those for your Amazon Associates acco...

Страница 18: ...ls on usage guidelines policies and requirements E Commerce and Web Services Topics What is E Commerce p 11 What is a Web Service p 12 What is XML p 12 What is a WSDL p 14 What is a Schema p 21 This c...

Страница 19: ...m or programming language A simple example of a Product Advertising API request is one that uses the ItemSearch operation This request asks Amazon s web servers to find descriptions of items in its da...

Страница 20: ...ument is said to be valid Product Advertising API responses always contain valid XML XML Structures Some data in XML documents are one dimensional for example para Sentence para Some data however is s...

Страница 21: ...st identify the WSDL they use so the web servers know how to interpret the requests In practice Product Advertising API developers use the same version of the Product Advertising API WSDL in every req...

Страница 22: ...w3 org 2001 XMLSchema Product Advertising API WSDL namespace is http webservices amazon com AWSECommerceService 2011 08 01 The date at the end is the version number It is the date the WSDL became publ...

Страница 23: ...f the WSDL you want to use The default version is 2005 10 05 If you want to use a different WSDL version including the latest you must specify it in each request for example in REST http webservices a...

Страница 24: ...d in an element declaration minOccurs is 1 maxOccurs defines the maximum number of times the parameter can appear in a request The default is 1 that is if maxOccurs is not included in an element decla...

Страница 25: ...n will have a name the name of the element and type which specifies the element s type The type will be a base type such as string which is defined in the schema xs as shown xs element name RequestId...

Страница 26: ...n In this example the operation ItemSearch is associated with its request and response definitions ItemSearchRequestMsg and ItemSearchResponseMsg The keywords input and output identify the operation s...

Страница 27: ...have seen that Product Advertising API responses are XML documents Service The Service segment of the WSDL specifies the web service used which in this case is Product Advertising API as shown in the...

Страница 28: ...simple types cannot In the WSDL section of this chapter you saw that complex types are declared as complexType In the following example the element SearchBinSet is defined as having two child elements...

Страница 29: ...piled books and set up three Sun Microsystems computers to take book orders online In 1995 Jeff opened his online bookstore to the public At that time there was only one kind of seller in fact there w...

Страница 30: ...cart Amazon takes care of the shipping payment and order fulfillment or notifies you to take care of the same Find items on a friend s wishlist wedding registry or baby registry and purchase those it...

Страница 31: ...Item Identifiers All items for sale on www amazon com have identifiers There are two major kinds The first identifies items regardless of whether or not they can be purchased ASIN Amazon Standard Item...

Страница 32: ...N Electronic International Standard Book Number A token that uniquely identifies a digital book All items in the Amazon marketplace have an ASIN even if they also have one of the preceding identifiers...

Страница 33: ...EISBN DE ASIN SKU UPC EISBN EAN ES ASIN SKU UPC EISBN EAN FR ASIN SKU UPC EISBN EAN IT ASIN EAN JAN SKU EISBN JP ASIN SKU UPC EISBN UK ASIN ISBN SKU UPC EISBN US The default value of IdType is ASIN Fo...

Страница 34: ...similar to ones you ve already found SimilarityLookup Find Out More About Specific Items Once you use the Product Advertising API operations in the previous section to get a list of items that match...

Страница 35: ...roduction to Product Advertising API Topics Tools to Find Items p 28 Tools to Find Out More About an Item p 29 Tools to Implement a Shopping Cart p 30 The previous chapter gave an overview of all Prod...

Страница 36: ...indices and a text entry box for a keyword Both of these parameter values are required for an ItemSearch request The result shown in this page displays many of the elements returned by the ItemAttribu...

Страница 37: ...rice element SimilarityLookup CartAdd operation The following figure shows the functionality not supported by Product Advertising API Tools to Implement a Shopping Cart If the customer clicked the Add...

Страница 38: ...nding what you want presents its own challenge In such a store a good store owner would arrange items in a way that would help customers quickly find the items they want to buy Such is the case with A...

Страница 39: ...that interests them For example the customer might be interested in the browse nodes Literature Fiction Medicine Mystery Thrillers Nonfiction or Outdoors Nature Browse nodes are related in a hierarchi...

Страница 40: ...xed Sets Name BrowseNode BrowseNode BrowseNodeId 538712 BrowseNodeId Name African American Comedy Name BrowseNode Children Item Ancestors BrowseNode BrowseNodeId 549726 BrowseNodeId Name Performing Ar...

Страница 41: ...owse node In this way you can see that the association between items and browse nodes is dynamic Browse nodes are created and deleted as items demand When for example a new toy or group of books start...

Страница 42: ...ber assignments You cannot assume for example that all IDs in the 2000s are related in any way If you have a browse node ID you can find the name of the browse node by putting the ID into one of the f...

Страница 43: ...turns the browse node that an item belongs to as well as the ancestry of that browse node The following response shows the ancestral browse nodes of High School As you read down the response the brows...

Страница 44: ...Studies Name BrowseNode Children This response shows that the Social Sciences browse node has three child browse nodes Anthropology Archaeology and Children s Studies and an ancestry that starts with...

Страница 45: ...oo many items in a response is almost as bad as returning no items at all Amazon addresses this difficulty by placing every item it sells into a product category called a search index You can think of...

Страница 46: ...ta that Amazon does or does not have For example the search index Grocery is currently supported in the US locale only because grocers in other countries have not yet teamed up with Amazon to provide...

Страница 47: ...equest The only parameter that you can use in the request is Keywords You cannot for example sort results Results are restricted to the first five pages of results Each page can have up to five result...

Страница 48: ...s are returned Item ASIN B00006XYAB ASIN ItemAttributes Binding Apparel Binding Brand Eddie Bauer Brand Department mens Department FabricType leather FabricType Feature Cotton Feature Feature Single c...

Страница 49: ...from the same response shows how each variation is differentiated by size Item ItemAttributes Brand Eddie Bauer Brand ItemAttributes VariationAttributes VariationAttribute Name ClothingSize Name Value...

Страница 50: ...Value 29W x 30L Value VariationAttribute VariationAttributes Item This response snippet shows that the VariationMatrix response group returns the names of the dimensions along with their values for e...

Страница 51: ...ments in the parent variation response specify the variation dimensions for the child variations for example VariationDimensions VariationDimension ClothingSize VariationDimension VariationDimension C...

Страница 52: ...all of the accessories associated with a main item by using the Accessories response group in an ItemLookup or ItemSearch request As you can see in the previous response snippet each accessory listed...

Страница 53: ...nses p 81 The Product Advertising API web service supports REST requests for remotely calling Product Advertising API operations hosted by Amazon servers REST requests are simple HTTP requests using e...

Страница 54: ...ice name in the request specifies that the request should be sent by the web servers to Product Advertising API This line is always the same in every Product Advertising API request regardless of loca...

Страница 55: ...rms that Change The remaining terms in the request vary significantly according to the operation chosen The terms however follow a pattern as shown in the next figure The Operation parameter is requir...

Страница 56: ...meters associated with the specified Product Advertising API operation Request Limitations Some Product Advertising API operations have many parameters and as you will learn in a future section you ca...

Страница 57: ...value pair Operation ItemSearch Parameter values must be URL encoded There are some characters such as an asterisk or space that cannot go into a URL There are equivalents of these characters that yo...

Страница 58: ...89123 Item 1 Quantity 2 Item 2 ASIN 123456 Item 2 Quantity 1 The sequence numbers associate the ASIN and quantity values This means that the compound parameters can be written in a different order wit...

Страница 59: ...he XML request generated by your toolkit SOAP Endpoints SOAP requests use endpoints in their requests The endpoint value varies by locale but there are only two endpoints per locale One endpoint in a...

Страница 60: ...zon com AWSECSCom merce onca soap AWSAccessKeyId 0PAP1H1P8JJVZEXAMPLE AWSAccessKeyId Request SearchIndex Books SearchIndex Keywords Harry 20Potter Keywords Request ItemSearch soapenv Body soapenv Enve...

Страница 61: ...se an existing Amazon com account login and password when creating the AWS account Alternately you could create a new AWS enabled Amazon com account by using a new Amazon com login and password The e...

Страница 62: ...Requests p 55 Authenticating REST Requests p 57 Viewing Your AWS Identifiers Your Access Key ID and Secret Access Key are displayed to you when you create your AWS account They are not e mailed to yo...

Страница 63: ...efined by ISO 8601 represented in Universal Time GMT YYYY MM DDThh mm ssZ where T and Z are literals Important If you are using NET you must not send overly specific time stamps due to different inter...

Страница 64: ...S matches the one you sent in the request the request is considered authentic If the comparison fails the request is discarded and AWS returns an error response Authenticating REST Requests This secti...

Страница 65: ...Note Use uppercase hex characters Tip Currently all Product Advertising API service parameter names use unreserved characters so you don t need to encode them However you might want to include code t...

Страница 66: ...it manually during signature formation and then again when the toolkit URL encodes the entire request Java Sample Code for Calculating Signature Version 2 Signatures The following Java code sample sh...

Страница 67: ...wsAccessKeyId params put Timestamp timestamp SortedMap String String sortedParamMap new TreeMap String String params String canonicalQS canonicalize sortedParamMap String toSign REQUEST_METHOD n endpo...

Страница 68: ...cannoical buffer toString return cannoical private String percentEncodeRfc3986 String s String out try out URLEncoder encode s UTF8_CHARSET replace 20 replace 2A replace 7E catch UnsupportedEncodingE...

Страница 69: ...ervices amazon com onca xml Service AWSECommerceServic e AWSAccessKeyId 00000000000000000000 Operation ItemLookup ItemId 0679722769 ResponseGroup ItemAttributes 2COffers 2CImages 2CRevi ews Version 20...

Страница 70: ...de samples for your programming language Nace U3Az4OhN7tISqgs1vdLBHBEijWcBeCqL5xN9xg 9 URL encode the plus and equal characters in the signature Nace 2BU3Az4OhN7tISqgs1vdLBHBEijWcBeCqL5xN9xg 3D 10 Add...

Страница 71: ...ateTag mytag 20 Operation ItemSe arch ResponseGroup ItemAttributes 2COffers 2CImages 2CReviews 2CV ariations SearchIndex DVD Service AWSECommerceService Signature T uM6E5L9u 2FuNqOX09ET03BXVmHLVFfJIna...

Страница 72: ...465600 AssociateTag mytag 20 ResponseG roup BrowseNodeInfo TopSellers NewReleases MostWishedFor MostGift ed String to Sign GET webservices amazon com onca xml AWSAccessKeyId 00000000000000000000 Asso...

Страница 73: ...larityType Inter section Timestamp 2009 01 01T12 3A00 3A00Z Version 2009 01 01 Authenticating SOAP Requests Topics Using SOAP with WS Security p 66 Using SOAP without WS Security p 71 The Product Adve...

Страница 74: ...cate generated by an external certificate authority follow the instructions provided by that CA Using Your Own Certificate If you have an X 509 certificate you want to use you can upload the certifica...

Страница 75: ...se When Troubleshooting The following example shows the initial portion of a SOAP request that uses WS Security with an X 509 certificate If you re using a SOAP toolkit that supports WS Security and X...

Страница 76: ...ithm http www w3 org 2000 09 xmld sig sha1 ds DigestMethod ds DigestValue HhRbxBBmc2OO348f8nLNZyo4AOM ds DigestValue ds Reference ds SignedInfo ds SignatureValue bmVx24Qom4kd9QQtclxWIlgLk4QsQBPaKESi79...

Страница 77: ...e base64 encoding of the full X 509 certificate chain if the ValueType is X509PKIPathv1 The Algorithm attribute of the CanonicalizationMethod element must be http www w3 org 2001 10 xml exc c14n The A...

Страница 78: ...Parameter Your AWS Access Key ID For more information see Your AWS Identifiers p 54 AWSAccessKeyId This is a required parameter if you include the Signature parameter Otherwise it is optional There i...

Страница 79: ...RAYCP1VJS767E02EXAMPLE aws AWSAccessKeyId aws Timestamp 2008 02 10T23 59 59Z aws Timestamp aws Signature SZf1CHmQnrZbsrC13hCZS061ywsEXAMPLE aws Signature soap Header soap Envelope Batch Requests Topic...

Страница 80: ...ce number The following parameter declaration syntax shows where the reference number goes OperationName ReferenceNumber Parameter Value The following request snippet shows an example of a reference n...

Страница 81: ...rally you only use the Shared value with required parameters Optional parameters do not need to be included in the request and their default values if any are assumed and thus shared across the simple...

Страница 82: ...ntain either an Access Key ID or a Subscription ID but not both Your Amazon assigned Access Key ID AWSAccessKeyId Every Product Advertising API 4 0 request must contain either an Access Key ID or a Su...

Страница 83: ...de some or all of the following optional parameters Description Value Parameter The Style parameter applies to REST requests only Use the Style parameter to control the format of the data returned by...

Страница 84: ...present Validate must equal True If the request is valid the response will contain an element called IsValid with a value of True If the request is invalid the response will contain 1 an element call...

Страница 85: ...es vary according to the operations and parameters submitted in the request There are however segments of the response that are common across all responses as shown in the following figure The followi...

Страница 86: ...s in the Operation Request segment is Product Advertising API processing information including the Request ID and the time it took to process the request This is interesting information for troublesho...

Страница 87: ...t says that the value is not a valid value for ItemId Please change this value and retry your request Invalid values The request is valid but there is no data that matches the search criteria In this...

Страница 88: ...tributes returned in a response vary according to the response group used and the items found Merchants do not always provide Amazon with a single set of item attributes For example one merchant might...

Страница 89: ...criteria Also it shows that those results are on 973 9729 10 pages You might try putting in an ItemPage value over 10 If you do Product Advertising API returns the following error Error Code AWS Param...

Страница 90: ...uras de Harry Potter Las Title Title Beacham s Sourcebook For Teaching Young Adult Fiction Exploring Harry Potter Title Title Beatrix Potter to Harry Potter Portraits of Children s Writers Title Produ...

Страница 91: ...with items BrowseNodeLookup If you do not know whether an item is for sale by a merchant or seller search first using ItemSearch for two reasons Most of the items sold on Amazon are sold by merchants...

Страница 92: ...ailable for purchase Its message concerns how quickly an item can ship when it is in stock A value returned for Availability does not guarantee that the item is in stock Tip The next chapter talks abo...

Страница 93: ...parameter is used and MerchantId is set to Amazon the availability results for Amazon Toys R Us and Target are merged MerchantId The following search indices do not work with the Availability paramet...

Страница 94: ...rowseNode A cursory look at the list of parameters shows you that most are very specific which makes it easy to determine whether or not they should be used in a request The Publisher parameter for ex...

Страница 95: ...an be used with the most search indices including Availability Specifies that the item must be available for purchase The only valid value for the parameter is Available BrowseNode Enables you to sear...

Страница 96: ...vailability parameter with the return element Availability The latter is an element in a response that describes how soon an item can be shipped such as Ships in 48 hours While this is a helpful value...

Страница 97: ...lude in an ItemSearch request Availability Available 1 Include in the request ResponseGroup Offers 2 Test to see that the value in the response for TotalOffers is greater than zero 3 Even though the A...

Страница 98: ...tchen Music PCHardware PetSupplies Software SoftwareVideoGames Apparel Automotive Books DVD Electronics GourmetFood Power Searches Topics Power Search Syntax p 91 ItemSearch s Power parameter which ca...

Страница 99: ...20military 20and 20language spanish Timestamp YYYY MM DDThh mm ssZ Signature Request Signature Note that spaces must be URL encoded 20 as shown Power Search Keywords Power search queries are created u...

Страница 100: ...ueries operators that you use to build queries Header 2 Header 1 Excludes the following parameter from the results for example subject history and not military excludes military history in the results...

Страница 101: ...keywords high tech and not fiction and pubdate during 1999 isbn 0446394319 or 0306806819 or 1567993850 Power Search Tips Topics Exact Matches p 94 Discarded Search Words p 94 The following tips help y...

Страница 102: ...nges for an item In the case of women s shoes for example SearchBins might return a bin that contains ASINs for shoes that cost between 0 and 50 a second bin for shoes that cost 50 to 100 and a third...

Страница 103: ...esponse group is included in a request ItemSearch automatically divides the ItemSearch results into bins Search Bin Example The following request uses the SearchBins response group to return search bi...

Страница 104: ...the values used to create the bins In this example the parameters are the minimum and maximum prices of the items in that bin For example in the last bin the minimum price of an item in that bin is 5...

Страница 105: ...rowBy Search Index Subject BrandName PriceRange SpecialSize Apparel Subject BrandName PriceRange SpecialSize Baby Subject BrandName PriceRange SpecialSize Beauty Not supported Blended Subject Books Su...

Страница 106: ...n price SearchBinSetNarrowBy PriceRange Bin BinName 0 24 BinName BinItemCount 1645 BinItemCount BinParameter Name MinimumPrice Name Value 9 Value BinParameter BinParameter Name MaximumPrice Name Value...

Страница 107: ...is PriceRange the related ItemSearch parameters are MinimumPrice and MaximumPrice 3 If you want to refine the results further use the SearchBins response group in a second request and repeat the proce...

Страница 108: ...items for sale are associated with each browse node Each browse node has an ID which is a positive integer and a name All items associated with a node have something to do with the name of the node F...

Страница 109: ...product For example if you have an item such as a carving knife you might find the node it is associated with and go up the hierarchy to find the root product category of knives and then in another r...

Страница 110: ...raverse up the browse node hierarchy one level at a time Related Topics BrowseNodes Response Group p 219 Finding a Node to Start Your Search Traversing up or down the browse node hierarchy is easy eno...

Страница 111: ...ode B might be Women Node C a child of BrowseNodes A and B might be Women s Shoes The number inside each node represents the number of items in the BrowseNode when ItemSearch is called on Node A Brows...

Страница 112: ...ItemSearch returns only the top ten BrowseNodes that contain the most items the identity of the top ten BrowseNodes can change with each ItemSearch Motivating Customers to Buy Topics Images p 105 Pro...

Страница 113: ...as shown in the following figure Promotions are only available with items that have offers Items that do not have offers are for example Collection and Variation parent ASINs For that reason when you...

Страница 114: ...case free promotion the camera is the eligible item Both It is possible for an item to be both the benefit and eligible item For example in a buy two shirts get the third shirt half off promotion the...

Страница 115: ...ER at checkout BenefitDescription TermsAndConditions STRONG To receive the Best Value discount STRONG OL LI Add 125 of qualifying Kitchen Housewares or Bed Bath products to your Shopping Cart via the...

Страница 116: ...lowing example shows a snipped from an RSS feed rss version 2 0 channel title Dollar Off Promotion title link http www amazon com link description Dollar Off Promotion description pubDate Thu 11 Mar 2...

Страница 117: ...yed individually as part of an ItemLookup ItemSearch or SimilarityLookup request For books Editorial Reviews is a separate listing on the DetailPageURL web page For example The following XML snippet s...

Страница 118: ...eturned by an ItemLookup or ItemSearch request ItemLookupResponse Items Item ASIN 0316067938 ASIN CustomerReviews IFrameURL http www amazon com reviews iframe akid AWS Access Key ID as in 0316067938 e...

Страница 119: ...sing the algorithm on purchases rather than viewing assures you that the similar items are more likely to be of interest to the customer Product Advertising API provides the following means of returni...

Страница 120: ...ned based on Similarity Items are similar to the one purchased Items viewed Customers who viewed the item in the cart also viewed the items returned by this response group Similar items Similar items...

Страница 121: ...kup operation requires the response includes similar items In previous sections you saw that you can use the Similarities response group to return similar items So why use SimilarityLookup This operat...

Страница 122: ...SimilarityLookup request The possible parameter values are Intersection which means that the items returned are similar to all of the items specified in the SimilarityLookup request This value is the...

Страница 123: ...d ItemLookup the search index must be Books or in non US locales ForeignBooks and for ItemLookup the specified item must be a book or foreign book http webservices amazon com onca xml Service AWSEComm...

Страница 124: ...AuthorityTitle parent as its physical CD counterpart AuthorityTitle Non buyable child of both MP3 albums and tracks DigitalMusicArranger Non buyable child of both MP3 albums and tracks DigitalMusicCom...

Страница 125: ...items In these images the circles represent relationship types and the bell shaped figure represent items The following illustration shows the MP3Downloads hierarchy The following illustration shows t...

Страница 126: ...Top Sellers From the Shopping Cart p 121 Top selling items by definition are enjoyed by many people Items labeled top sellers often spark a customer s interest You can use the BrowseNodeLookup operati...

Страница 127: ...se node ID and name with which the ASIN B000002ADT is associated Alternately you can look in the Product Advertising API Developer Guide for a list of the top level browse node IDs Generalizing the To...

Страница 128: ...BrowseNodeLookup only returns one ancestor of a browse node even if a node has multiple ancestors Which ancestor is returned is not predictable This limitation of the operation typically is of little...

Страница 129: ...customers Product Advertising API enables you to take advantage of that motivator with two response groups NewReleases and CartNewReleases The NewReleases response group returns the ASIN and title of...

Страница 130: ...IN Title Brokeback Mountain Widescreen Edition Title NewRelease NewReleases Sorting by Popularity Price or Condition The order in which you present the items returned is important to your customers Of...

Страница 131: ...d from the cheapest to the most expensive http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID Operation ItemSearch Keywords Rocket SearchIndex Toys Sort p...

Страница 132: ...ot set this value you can only use the value Returning Price and Availability Information Topics Returning Prices p 125 Determining Availability p 131 Previous chapters have shown how to find items an...

Страница 133: ...r ItemLookup operation in these cases the string Too Low to Display is returned instead of the actual price The only way to see the actual price is to add the item to a remote shopping cart and follow...

Страница 134: ...2Fy3ZNjJ 2Brxg GUqPn 2FNy 2BqBcVFoVLQWAugwljO5Zt9zqm865o 2BTk3zGIGDF5oWog FW7frgBq77QgTs 2Baxm 2B2gLQ 3D 3D OfferListingId Price Amount 21995 Amount CurrencyCode USD CurrencyCode FormattedPrice 219 9...

Страница 135: ...ms That Do Not Have Offers There are two kinds of items returned by Product Advertising API Regular items Parent items A parent item is an abstraction of a collection of items For example shirt is a p...

Страница 136: ...amazon com onca xml Service AWSECommerceService AWSAccessKeyId 1MEXAMPLEZBG2 Operation ItemSearch Keywords Ralph 20Lauren SearchIndex Apparel Sort pricerank ResponseGroup Offers Variations Availabilit...

Страница 137: ...arent ASINs cannot be sold A child ASIN of it would be a blue shirt size 16 sold by MyApparelStore This child ASIN is one of potentially many variations The ways in which variations differ are called...

Страница 138: ...er in an ItemSearch request Items might be available for example in one condition but not another 3 With Merchants you use one of the Offer response groups to determining item availability Availabilit...

Страница 139: ...if a copy becomes available Out of Print Limited Availability Titles occasionally go out of print or publishers run out of stock The buyer is notified if the item becomes unavailable Special Order Th...

Страница 140: ...talNew 1 TotalNew TotalUsed 0 TotalUsed TotalCollectible 0 TotalCol lectible TotalRefurbished 0 TotalRefurbished OfferSummary This response shows that only one of the specified items B000BWFJQ2 is ava...

Страница 141: ...ing cart is called remote because the cart is hosted by Amazon servers In that sense the shopping cart is remote to the seller s or Associate s servers where the customer is shopping The opposite of a...

Страница 142: ...ready to be purchased SavedForLaterItem Contains items that a customer has chosen to buy but are currently unavailable or items that a customer has designated they want to save and buy later Available...

Страница 143: ...f a kind jewelry items Sometimes it is a limit set by the vendor for example they might set a limit for big ticket items of one per customer If you add an item to the cart with a quantity that exceeds...

Страница 144: ...d availability of items change often and Amazon automatically updates items in shopping carts Also Amazon automatically updates the status of lists such as Wishlists when a customer buys an item on a...

Страница 145: ...cart or if the cart is empty after seven days of disuse Carts are emptied either by the CartClear or CartModify operations or automatically when the customer purchases the items in their cart The exp...

Страница 146: ...ECommerceService AWSAccessKeyId AWS Access Key ID AssociateTag ID Operation CartCreate Item 1 OfferListingId B000062TU1 Item 1 Quantity 2 Timestamp YYYY MM DDThh mm ssZ Signature Request Signature In...

Страница 147: ...o the cart ASIN An alphanumeric token that uniquely identifies an item sold by a seller or merchant Amazon assigns OfferListingIds to items You can find an OfferListingId using the ItemLookup and Item...

Страница 148: ...antity 2 Quantity Title Harry Potter and the Sorcerer s Stone Full Screen Edition Harry Potter 1 Title ProductGroup DVD ProductGroup Price Amount 1499 Amount CurrencyCode USD CurrencyCode FormattedPri...

Страница 149: ...ed by an ASIN or OfferListingId those items lose those associations Instead to refer to an item in a cart in future cart operation requests you must use the item s CartItemId value CartItemId Modifyin...

Страница 150: ...ity 2 Timestamp YYYY MM DDThh mm ssZ Signature Request Signature This request adds to the cart two Quantity 2 of the same items which are identified by the OfferListingId 1400042127 As you can see the...

Страница 151: ...lowing XML snippet from a response SavedForLaterItem CartItemId ULI7S9IYFJHX0 CartItemId ASIN B0009GZV4A ASIN Quantity 2 Quantity Title Mark VII Men s Short Sleeve Golf Shirts with Tri Colored Stripe...

Страница 152: ...tems in a cart Use the cart s HMAC and CartId values in a CartGet request http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID AssociateTag ws Operation Ca...

Страница 153: ...mer to get back to your site after getting sent to the Amazon site To improve a customer s experience on your site you may want to note this on your site or provide a way to get back to your site usin...

Страница 154: ...input type submit name add value add form Purchasing the Items in a Remote Shopping Cart Topics Order Pipeline p 147 Implementing the Proceed to Checkout Button p 148 When a customer has finished shop...

Страница 155: ...18938 1696046 26associate id Your ID 26hmac b0ogzvivVYLXjSZ9WwoBRFesFYU 26AWSAc cessKeyId Access Key ID PurchaseURL This value is a URL that should be submitted like a request to purchase the items in...

Страница 156: ...50 Results and Errors p 151 All responses contain an IsValid element for example IsValid False IsValid The IsValid element tells you whether or not there is an error in the syntax of any elements of t...

Страница 157: ...you were to submit a request and no items in Amazon satisfied the request you would receive an error The following request is an example of this problem http webservices amazon com onca xml Service A...

Страница 158: ...as much information as possible even when an error prevents the successful completion of a portion of a request Retrieving Errors Typically you want your application to check whether or not a request...

Страница 159: ...Each account will receive an additional 500 requests per hour up to a maximum of 25 000 requests per hour for every 1 of shipped item revenue driven per hour in a trailing 30 day period You could ver...

Страница 160: ...o many values for ParameterName This parameter can have a maximum of MaximumNumber values AWS ExceededMaximumParameterValues You will receive this error message when you specify too many values for on...

Страница 161: ...fy the Operation parameter and retry Valid values for the Operation parameter include ListOfOperationValues AWS InvalidOperationParameter You will receive this error message when the operation name yo...

Страница 162: ...he AWS XSLT service is unable to access the XSLT file you used as the value for the Style parameter in your request All Your request should have at most Maximum Number of the following parameters Para...

Страница 163: ...his error message when the your request does not contain the required Service parameter ItemSearch ItemLookup The value you specified for ParameterName is invalid Valid values must be between LowerBou...

Страница 164: ...Remember that the HMAC must be URL encoded if you are using REST AWS ECommerceService InvalidHMAC You will receive this error message when the shopping cart HMAC value you use in your request is not r...

Страница 165: ...nce per second per IP address RequestThrottled You will receive this error if your application is submitting requests faster than once per second per IP address Best Programming Practices Topics Read...

Страница 166: ...Product Advertising API operations Some enable you to Operations Task ItemSearch ItemLookup and BrowseNodeLookup Find products and categories SimilarityLookup Find similar items CartCreate CartAdd Ca...

Страница 167: ...uct Advertising API is restricting the number of requests it is processing from your application The Product Advertising API Terms and Conditions outline the number of allowed requests permitted per s...

Страница 168: ...look at the DE homepage for Amazon you see the listings in German If you purchased an item you would find the price in Euros and if you were to purchase a movie you would find that the movie rating w...

Страница 169: ...erent items in different locales Item identifiers The availability of some response groups sort parameters and search indices varies by locale Availability of some response groups Associate IDs To be...

Страница 170: ...tomer in the US could purchase a copy of a Harry Potter book from the UK locale The shipping charges however would be significantly higher than if the same item were purchased through the US locale Fo...

Страница 171: ...The following sections of the guide provide reference material for the Product Advertising API For more information about any concepts or programming tasks associated with the reference material refe...

Страница 172: ...p in an ItemSearch p 196 request You can use BrowseNodeLookup iteratively to navigate through the browse node hierarchy to reach the node that most appropriately suits your search Then you can use the...

Страница 173: ...r example DVD Actors Actresses Steve Martin DVD Used DVDs Kids Family The first hierarchy narrows the search down to DVDs in which Steve Martin plays a part The second hierarchy narrows the list of DV...

Страница 174: ...Black Comedy Name BrowseNode BrowseNode BrowseNodeId 291102 BrowseNodeId Name British Name BrowseNode Children Item Ancestors BrowseNode BrowseNodeId 549726 BrowseNodeId Name Performing Arts Name Ance...

Страница 175: ...are returned by the CartCreate operation If the associated CartCreate p 175 request specified an AssociateTag all CartAdd requests must also include a value for Associate Tag otherwise the request wi...

Страница 176: ...Type String Default None Valid Values Value returned by CartCreate CartId Yes The Hash Message Authentication Code is an encrypted alphanumeric token that is used to authenticate requests Type String...

Страница 177: ...by separating them with commas Type String Default Cart p 221 Valid Values CartSimilarities p 226 CartTopSellers p 225 NewReleases p 251 ResponseGroup CartAdd also accepts the parameters that all oper...

Страница 178: ...rtAdd Item 1 OfferListingId Offer Listing ID Item 1 Quantity 1 Timestamp YYYY MM DDThh mm ssZ Signature Request Signature The response to this request is shown in Response to Sample Request p 167 Add...

Страница 179: ...VbEg HMAC Items Item ASIN 1400042127 ASIN Quantity 1 Quantity Item Items CartAddRequest Request CartId 102 6666665 5792105 CartId HMAC oRqNBTpiRBugxEKEJ FyUZkVbEg HMAC URLEncodedHMAC oRqNBTpiRBugxEKEJ...

Страница 180: ...t even though they have been emptied The lifespan of a cart is 7 days since the last time it was acted upon For example if a cart created 6 days ago is modified the cart lifespan is reset to 7 days Av...

Страница 181: ...use For more information see Common Request Parameters p 210 Response Description Name Container for remote shopping cart related response elements Cart Container for CartClear and HMAC CartClearReque...

Страница 182: ...CartCreate p 175 CartGet p 181 CartModify p 185 CartCreate Description The CartCreate operation enables you to create a remote shopping cart A shopping cart is the metaphor used by most e commerce so...

Страница 183: ...ter being unused for 7 days The lifespan of a cart restarts however every time a cart is modified In this way a cart can last for more than 7 days If for example on day 6 the customer modifies a cart...

Страница 184: ...id Values Does not take a value Type String Default None Item No Container for one or more Item objects This parameter is for SOAP only Items Deprecated This parameter is deprecated When a customer pu...

Страница 185: ...he cart CartItems Locale of the sale that specifies the formatting of the price CurrencyCode The price of the item as it should appear to the customer FormattedPrice An encoded value used to authentic...

Страница 186: ...vices amazon com onca xml Service AWSECommerceService AWSAccessKeyId Access Key ID AssociateTag Associate Tag Operation CartCreate Item 1 OfferListingId Offer Listing ID Item 1 Quantity 2 Item 2 Offer...

Страница 187: ...erNickname Quantity 2 Quantity Title Harry Potter and the Sorcerer s Stone Full Screen Edition Harry Potter 1 Title ProductGroup DVD ProductGroup Price Amount 997 Amount CurrencyCode USD CurrencyCode...

Страница 188: ...s availability you should not keep a copy of a cart locally Instead use CartGet to retrieve the items in a remote shopping cart To retrieve the items in a cart you must specify the cart using the Cart...

Страница 189: ...ult None Valid Values Value returned by CartCreate CartId Yes Alphanumeric token that uniquely identifies an item in a cart Once an item specified by an ASIN or OfferListingId has been added to a cart...

Страница 190: ...Code returned by CartCreate that identifies a cart This is an encrypted alphanumeric token that is used to authenticate cart operations HMAC Container for Amount CurrencyCode FormattedPrice Cost of t...

Страница 191: ...YLXjSZ9WwoBRFesFYU HMAC URLEncodedHMAC b0ogzvivVYLXjSZ9WwoBRFesFYU URLEncodedHMAC PurchaseURL https www amazon com gp cart aws merge html cart id 002 9918938 1696046 26associate id ws 26hmac b0ogzvivV...

Страница 192: ...his value is the URL encoded version of the HMAC This encoding is necessary because some characters such as and cannot be included in a URL Rather than encoding the HMAC yourself use the URLEncodedHMA...

Страница 193: ...lso be used on all other operations associated with the same cart Type String Default None Valid Value The same Associate tag that was used in the related CartCreate request Constraint AssociateTag Ye...

Страница 194: ...t MergeCart Conditional Specifies the revised number of items that the customer would like in the cart where N is a positive integer This parameter is used in conjunction with Item N CartItemId to mod...

Страница 195: ...ese tags see the appropriate response group in Response Groups p 213 Examples Increase the quantity of an item Item 1 already in the cart and remove an item Item 2 http webservices amazon com onca xml...

Страница 196: ...changed to 10 from 5 The rest of the CartModify request is identical to the CartCreate p 175 response Related Operations CartAdd p 168 CartClear p 173 CartCreate p 175 CartGet p 181 ItemLookup Descri...

Страница 197: ...an item All IdTypes except ASINx require a SearchIndex to be specified Type String Default ASIN Valid Values SKU UPC EAN ISBN US only when search index is Books UPC is not valid in the CA locale IdTy...

Страница 198: ...include Episode Season and Tracks For a complete list of types go to Relationship Types p 117 Required when RelatedItems response group is used RelationshipType No Page of reviews returned by ItemLook...

Страница 199: ...d Sort by the date the item was first used FirstUsed LastUsed Sort by the date the item was last used LastUsed Name Alphabetical A Z Name Usages Items least used to most used To sort items in descendi...

Страница 200: ...nly VariationSummary p 293 ResponseGroup ItemLookup also accepts the parameters that all operations can use For more information see Common Request Parameters p 210 Response Description Name Amazon St...

Страница 201: ...DDThh mm ssZ Signature Request Signature In the following request the ItemId is an SKU which requires that you also specify the IdType http webservices amazon com onca xml Service AWSECommerceService...

Страница 202: ...each of the offer listing condition classes including New Used Collectible and Refurbished Use the Accessories p 213 response group to find the a list of accessory product ASINs and Titles for each pr...

Страница 203: ...ee refurbished and three collectible items Or for example if there are no collectible or refurbished offers ItemSearch returns three new and three used offers Because there are thousands of items in e...

Страница 204: ...earch Parameter Combinations p 398 The parameters that apply to the largest number of search indices are shown in the following table Valid Search Indices Parameter All but All Blended BrowseNode All...

Страница 205: ...ciated with the item You can enter all or part of the name Type String Default None Author Yes Enables ItemSearch to return only those items that are available This parameter must be used in combinati...

Страница 206: ...eter is set to Available the Condition parameter cannot be set to New ItemSearch returns up to ten search results at a time When condition equals All ItemSearch returns up to three offers per conditio...

Страница 207: ...ages response tag Valid Values 1 to 10 1 to 5 when the search index All Type String Default None ItemPage No A word or phrase associated with an item The word or phrase can be in various product field...

Страница 208: ...d Values Positive integer MinPercentageOff No Name of an orchestra associated with the item You can enter all or part of the name Type String Default None Orchestra No Performs a book search using a c...

Страница 209: ...specific values of SearchIndex Type String Default None Valid Values A search index for example Apparel Beauty Blended Books and so forth For Blended searches go to Blended Searches p 91 For a comple...

Страница 210: ...ype String Default None Title No By default reviews are truncated to 1000 characters within the Reviews iframe To specify a different length enter the value To return complete reviews specify 0 Type I...

Страница 211: ...ceRating AudienceRating Values Locale G PG PG 13 R NC 17 NR Unrated Family Viewing CA 6 12 16 DE PG 12 16 18 FR G PG PG 13 R NC 17 NR Unrated US Response Description Name Amazon Standard Identificatio...

Страница 212: ...ough multiple search indices for items that have Mustang in their name or description A blended search looks through multiple search indices at the same time For more information see Blended Searches...

Страница 213: ...p 189 SimilarityLookup Description The SimilarityLookup operation returns up to ten products per page that are similar to one or more items specified in the request This operation is typically used to...

Страница 214: ...items http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID Operation SimilarityLookup ItemId ASIN1 ASIN2 ASIN3 Timestamp YYYY MM DDThh mm ssZ Signature Re...

Страница 215: ...only include items sold by Amazon By default Product Advertising API returns items sold by various merchants including Amazon Enter Amazon to return only items sold by Amazon Type String Valid Values...

Страница 216: ...is a snippet of the full response to the first sample request Item ASIN B0009VX8XQ ASIN ItemAttributes ProductGroup Apparel ProductGroup Title Mark VII Men s Short Sleeve Herringbone Knit Golf Shirt T...

Страница 217: ...y CartCreate To obtain an Associate Tag go to https affiliate program amazon com For more information see Associate Tag p 212 Valid Values An alphanumeric token distributed by Amazon that uniquely ide...

Страница 218: ...roduct Advertising API responses Style only pertains to REST requests Set this parameter to XML the default to generate a pure XML response Set this parameter to the URL of an XSLT stylesheet to have...

Страница 219: ...Valid Values Single Double XMLEscaping AssociateTag The AssociateTag parameter is a required parameter in Product Advertising API requests When you register as an Amazon Associate an Associate tag is...

Страница 220: ...m p 244 MostGifted p 248 MostWishedFor p 249 NewReleases p 251 OfferFull p 252 OfferListings p 254 Offers p 256 OfferSummary p 260 PromotionSummary p 262 RelatedItems p 265 Request p 267 Reviews p 268...

Страница 221: ...http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID AssociateTag Associate ID Operation ItemLookup IdType ASIN ItemId B00008OE6I ResponseGroup Accessories...

Страница 222: ...Rag Book Ring bound Roughcut School Library Binding Sheet music Slide Software Spiral bound Stationery Textbook Binding Turtleback Unbound Unknown Binding Wall Chart Workbook Foam Book Game Gift Hardc...

Страница 223: ...ng request illustrates the XML response elements returned by AlternateVersions http webservices amazon com onca xml Service AWSECommerceService Operation ItemSearch AWSAccessKeyId AWS Access Key ID As...

Страница 224: ...ou to return more highly targeted results Generalizing a response enables you to find what product category a browse node belongs to This response group is similar to the BrowseNodes p 219 response gr...

Страница 225: ...amp YYYY MM DDThh mm ssZ Signature Request Signature Sample Response Snippet The following response snippet shows the elements returned by BrowseNodeInfo Item ASIN 0131856340 ASIN BrowseNodes BrowseNo...

Страница 226: ...nse group also returns the names and IDs of the child and parent browse nodes of the items returned in the response It is possible for one item to belong to multiple browse nodes So it is common to se...

Страница 227: ...Potter ResponseGroup BrowseNodes Version 2011 08 01 Timestamp YYYY MM DDThh mm ssZ Signature Request Signature Sample Response Snippet The following response snippet shows the elements returned by Bro...

Страница 228: ...s Cart Response Group The Cart response group provides information about a specified remote shopping cart and the items in it The cart information includes CartId HMAC PurchaseURL For each item in the...

Страница 229: ...p 313 Parent Response Group The following response groups are parent response groups of Cart None Child Response Group The following response groups are child response groups of Cart None Sample REST...

Страница 230: ...Amount 1994 Amount CurrencyCode USD CurrencyCode FormattedPrice 19 94 FormattedPrice SubTotal CartItems SubTotal Amount 1994 Amount CurrencyCode USD CurrencyCode FormattedPrice 19 94 FormattedPrice Su...

Страница 231: ...response group include CartAdd p 168 CartCreate p 175 CartModify p 185 CartGet p 181 Response Elements The following table describes the elements returned by CartNewReleases ASIN p 297 Title p 311 Par...

Страница 232: ...cart operation For example when adding a television to a cart the five top sellers in the root category electronics are returned for example the top selling computers MP3 players or digital cameras Us...

Страница 233: ...esponse snippet shows the elements returned by CartTopSellers TopSellers TopSeller ASIN B00005JOFQ ASIN Title Brokeback Mountain Widescreen Edition Title TopSeller TopSeller ASIN B000E6EK3S ASIN Title...

Страница 234: ...pping cart The response group is used typically to spur the customer s interest in purchasing additional items Relevant Operations Operations that can use this response group include CartAdd p 168 Car...

Страница 235: ...herCategoriesSimilarProducts OtherCategoriesSimilarProduct ASIN 0590353403 ASIN Title Harry Potter and the Sorcerer s Stone Book 1 Title OtherCategoriesSimilarProduct OtherCategoriesSimilarProducts Co...

Страница 236: ...lustrates the XML response elements returned by Collections http webservices amazon com onca xml Service AWSECommerceService AWSAccessKey Access Key ID Operation ItemLookup ItemId B000ALMQ9C ResponseG...

Страница 237: ...reviews returned may be different than those returned by www amazon com Relevant Operations Operations that can use this response group include ItemLookup p 189 ItemSearch p 196 SimilarityLookup p 206...

Страница 238: ...sponse Group The Images response group returns the URLs to all available images of an item in three sizes small medium and large For example if a blender is for sale and there are four images of it th...

Страница 239: ...ponse group None Sample REST Use Case All locales http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID Operation ItemSearch ItemId B000Q678OO ResponseGroup...

Страница 240: ...g URL Height Units pixels 110 Height Width Units pixels 86 Width TinyImage MediumImage URL http ecx images amazon com images I 51YL4rlI 2B9L _SL160_ jpg URL Height Units pixels 160 Height Width Units...

Страница 241: ...But all items within a single search index do not necessarily return the same attributes For that reason it is impossible to predict exactly which item attributes will be returned in a response Releva...

Страница 242: ...ge p 305 Name p 306 Type p 313 AudioFormat p 297 LegalDisclaimer p 305 ListPrice p 305 MagazineType Manufacturer p 305 ManufacturerMaximumAge p 305 ManufacturerMinimumAge p 305 ManufacturerPartsWarran...

Страница 243: ...ment p 313 Warranty p 314 WEEETaxValue p 314 ItemAttributes also returns the elements that all response groups return as described in Elements Common to All Response Groups p 295 Parent Response Group...

Страница 244: ...ge Name English Name Type Original Language Type Language Languages ListPrice Amount 1999 Amount CurrencyCode USD CurrencyCode FormattedPrice 19 99 FormattedPrice ListPrice NumberOfItems 1 NumberOfIte...

Страница 245: ...ds None Child Response Group The following response groups are child response groups of ItemIds None Sample REST Use Case All locales http webservices amazon com onca xml Service AWSECommerceService A...

Страница 246: ...onse group is ideally suited for building product detail pages similar to those found on Amazon s retail web site Relevant Operations Operations that can use this response group include ItemLookup p 1...

Страница 247: ...304 Label p 305 LegalDisclaimer p 305 Length p 305 Manufacturer p 305 ManufacturerMaximumAge p 305 ManufacturerMinimumAge p 305 ManufacturerPartsWarrantyDescription p 305 MaterialType p 306 Message p...

Страница 248: ...Warranty p 314 Weight p 314 Width p 314 Large also returns the elements that all response groups return as described in Elements Common to All Response Groups p 295 Parent Response Group The following...

Страница 249: ...Width SmallImage MediumImage URL http ec1 images amazon com images P B000A3UB2O 01 A3QXF272WQ86AH _SCMZZZZZZZ_ jpg URL Height Units pixels 160 Height Width Units pixels 160 Width MediumImage LargeIma...

Страница 250: ...ite inlay and butterfly closure Content EditorialReview EditorialReviews BrowseNodes BrowseNode BrowseNodeId 1045534 BrowseNodeId Name Jewelry Name Ancestors BrowseNode BrowseNodeId 1044486 BrowseNode...

Страница 251: ...urned by each of these response groups refer to their sections Relevant Operations Operations that can use this response group include ItemLookup p 189 ItemSearch p 196 SimilarityLookup p 206 Response...

Страница 252: ...cturerMaximumAge p 305 ManufacturerMinimumAge p 305 ManufacturerPartsWarrantyDescription p 305 MaterialType p 306 Message p 306 MetalStamp MetalType p 306 Model p 306 MPN p 306 NumberOfDiscs p 307 Num...

Страница 253: ...ups return as described in Elements Common to All Response Groups p 295 Parent Response Group The following response groups are parent response groups of Medium None Child Response Group The following...

Страница 254: ...mImage ItemAttributes Author Wayne G Pardy Author Binding Paperback Binding EAN 9781890966539 EAN Edition Reprint Edition ISBN 1890966533 ISBN ListPrice Amount 5995 Amount CurrencyCode USD CurrencyCod...

Страница 255: ...ilable in all locales Relevant Operations Operations that can use this response group include BrowseNodeLookup p 165 Response Elements The following table describes the elements returned by MostGifted...

Страница 256: ...esponse snippet shows the elements returned by MostGifted TopItemSet Type MostGifted Type TopItem ASIN 0553576399 ASIN Title Distraction Title ProductGroup Book ProductGroup Author Bruce Sterling Auth...

Страница 257: ...Sample REST Use Case The following request illustrates the XML response elements returned by MostWishedFor http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access K...

Страница 258: ...or the Music search index ASIN p 297 Authors p 297 for the Books search index ProductGroup p 308 Title p 311 TopItemSet p 311 NewReleases also returns the elements that all response groups return whic...

Страница 259: ...se Group The OfferFull response group returns comprehensive information about an offer OfferFull is a parent response group that returns the results of the Offers p 256 response group Note Not all mer...

Страница 260: ...ll None Child Response Group The following response groups are child response groups of OfferFull Offers p 256 Sample REST Use Case The following request illustrates the XML response elements returned...

Страница 261: ...OfferAttributes Condition New Condition OfferAttributes OfferListing OfferListingId cMVuIFx8kiYSgRIJXiCzKZZyyl wztVSAYV8vCo2OxHS8L9SB7lwho8fK6CxYkmdDPy8thFzm30Y 3D OfferListingId Price Amount 2580 Amo...

Страница 262: ...he elements on the right side of the slash mark Amount p 297 Availability p 297 Code p 299 Condition p 299 CurrencyCode p 300 FormattedPrice p 302 IsEligibleForSuperSaverShipping p 303 MoreOffersURL N...

Страница 263: ...qIMjOLpQI5pkO774zf 2BsvrzbG4JR92xLmC OfferListingId Price Amount 24700 Amount CurrencyCode USD CurrencyCode FormattedPrice 247 00 FormattedPrice Price Availability Usually ships in 1 2 business days A...

Страница 264: ...sed New Refurbished or Collectible Amazon offer Amazon Used New Refurbished or Collectible Error invalid value Any other value Used New Refurbished or Collectible Lowest priced offer for each conditio...

Страница 265: ...rent response groups of Offers None Child Response Group The following response groups are child response groups of Offers OfferSummary p 260 Sample REST Use Case The following request illustrates the...

Страница 266: ...ttributes OfferListing OfferListingId 6vZH 2FR4dOoabV7sTSv3vC0Np5xK1c8MKOhAl5HYbCIJhx OLlJw1O2AM6mLYyVhjnI8s2gMkx7yq 2F 2BEC7yKPWkQTqhVhFBeUDm71EdpaYwrXpppfc AL1yPzyQFkOuK6MsK8aLPSNSWVs 3D OfferListin...

Страница 267: ...ipping OfferListing Offer Offers Item The Request that Generated the Response REST http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId replaceable replaceable AWS Access Ke...

Страница 268: ...he following table describes the elements returned by OfferSummary Amount p 297 CurrencyCode p 300 FormattedPrice p 302 TotalCollectible p 311 TotalNew p 311 TotalRefurbished p 312 TotalUsed p 312 Off...

Страница 269: ...ding the type of promotion beginning and ending dates of the promotion the promotion ID eligibility requirements and text that describes the specifics of the promotion PromotionSummary must be used al...

Страница 270: ...mmary p 311 TermsAndConditions p 311 PromotionSummary also returns the elements that all response groups return which described in Elements Common to All Response Groups p 295 Parent Response Group Th...

Страница 271: ...subtracted from the return credit LI OL BR STRONG Terms and Conditions STRONG UL LI Promotional offer valid for a limited time only Items placed in Shopping Cart overnight may not be eligible for prom...

Страница 272: ...e the RelatedItems response group Some values include Episode Season Tracks and Variation For a list of all relationship types go to the ItemLookup p 189 page The relationship type is usually named af...

Страница 273: ...013D8EQK ASIN ItemAttributes Creator Role Primary Contributor Johnny Cash Creator Manufacturer Columbia Legacy Manufacturer ProductGroup Digital Music Album ProductGroup Title At San Quentin Title Ite...

Страница 274: ...elevant Operations Operations that can use this response group include All Product Advertising API operations use the Request response group by default Response Elements The following table describes...

Страница 275: ...ument Name SearchIndex Value Books Argument Name Service Value AWSECommerceService Argument Name Title Value Harry Potter Argument Name Operation Value ItemSearch Argument Name AWSAccessKeyId Value VA...

Страница 276: ...FrameURL p 303 Reviews also returns the elements that all response groups return as described in Elements Common to All Response Groups p 295 Parent Response Group The following response groups are pa...

Страница 277: ...Arguments RequestProcessingTime 0 0416880000000000 RequestProcessingTime OperationRequest Items Item ASIN 0316067938 ASIN CustomerReviews IFrameURL http www amazon com reviews iframe akid AWS Access...

Страница 278: ...elements returned by SalesRank http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID Operation ItemLookup ItemId 0976925524 ResponseGroup SalesRank Version...

Страница 279: ...quest ItemSearch automatically divides the ItemSearch results into bins NarrowBy Values NarrowBy values include Subject BrowseNode IDs of all topics related to items returned by ItemSearch For example...

Страница 280: ...ject OfficeProducts Subject BrandName PriceRange PercentageOff OutdoorLiving Subject BrandName PriceRange PercentageOff PCHardware Subject BrandName PriceRange PetSupplies Subject BrandName PriceRange...

Страница 281: ...example you would add the following Name and its corresponding value as additional parameters in the original ItemSearch request MinimumPrice 0 MaximumPrice 2499 You could narrow the search results ev...

Страница 282: ...s the XML response elements returned by SearchBins http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID Operation ItemSearch Condition All SearchIndex Spor...

Страница 283: ...Value 2499 Value BinParameter Bin SearchBinSet SearchBinSet NarrowBy BrandName Bin BinName Rawlings BinName BinItemCount 71 BinItemCount BinParameter Name Brand Name Value Rawlings Value BinParameter...

Страница 284: ...Operations Operations that can use this response group include ItemLookup p 189 ItemSearch p 196 SimilarityLookup p 206 Response Elements The following table describes the elements returned by Simila...

Страница 285: ...larProduct Small Response Group The Small response group returns basic information about items in a response The information includes the item s ASIN title product group and author This response group...

Страница 286: ...ollowing request illustrates the XML response elements returned by Small http webservices amazon com onca xml Service AWSECommerceService AWSAccessKey AWS Access Key ID Operation ItemSearch Condition...

Страница 287: ...lable in all locales Relevant Operations Operations that can use this response group include BrowseNodeLookup p 165 Response Elements The following table describes the elements returned by TopSellers...

Страница 288: ...following response snippet shows the elements returned by TopSellers TopItemSet Type TopSellers Type TopItem ASIN 0553576399 ASIN Title Distraction Title ProductGroup Book ProductGroup Author Bruce S...

Страница 289: ...following request illustrates the XML response elements returned by Tracks http webservices amazon com onca xml Service AWSECommerceService AWSAccessKeyId AWS Access Key ID Operation ItemSearch Condit...

Страница 290: ...old A child ASIN of it would be a blue shirt size 16 sold by MyApparelStore This child ASIN is one of potentially many variations The ways in which variations differ are called dimensions In the prece...

Страница 291: ...talGemWeight DecimalWithUnits Relevant Operations Operations that can use this response group include ItemLookup p 189 ItemSearch p 196 SimilarityLookup p 206 Response Elements The following table des...

Страница 292: ...mp YYYY MM DDThh mm ssZ Signature Request Signature Sample Response Snippet The following response snippet shows the elements returned by Variations ItemSearchRequest Keywords Hooded Short Down Jacket...

Страница 293: ...always have images associated with them their children however should Relevant Operations Operations that can use this response group include ItemLookup p 189 Response Elements The following table des...

Страница 294: ...snippet shows the elements returned by VariationImages ImageSets ImageSet Category primary SmallImage URL http images amazon com images P B99999999A 01 _SCTHUMBZZZ_ jpg URL Height Units pixels 60 Heig...

Страница 295: ...If a returned item does not have variations the VariationMatrix response group will not return any data For example rings vary by ring size RingSize therefore is the dimension related to this item Th...

Страница 296: ...oup The following response groups are child response groups of VariationMatrix None Sample REST Use Case The following request illustrates the XML response elements returned by VariationMatrix http we...

Страница 297: ...not returned for the individual variations Variations is the parent response group of VariationOffers The only valid values for MerchantId are Amazon and All which is the default value For reasons of...

Страница 298: ...07 TotalCollectible p 311 TotalNew p 311 TotalOfferPages p 312 TotalOffers p 312 VariationOffers also returns the elements that all response groups return as described in Elements Common to All Respon...

Страница 299: ...nPages 1 TotalVariationPages Item ASIN B000N637Y2 ASIN Offers Offer Merchant Name Amazon com Name Merchant OfferAttributes Condition New Condition OfferAttributes OfferListing OfferListingId ct 2FbvUK...

Страница 300: ...ation is a child ASIN The parent ASIN is an abstraction of the children items For example Shirt is a parent ASIN Parent ASINs cannot be sold A child ASIN of it would be a blue shirt size 16 sold by My...

Страница 301: ...response groups are parent response groups of VariationSummary None Child Response Group The following response groups are child response groups of VariationSummary None Sample REST Use Case The follo...

Страница 302: ...turned by all response groups Definition Response Element An token distributed by Amazon that uniquely identifies an item Type String Ancestry Item ASIN ASIN Error code if there is an error Type Integ...

Страница 303: ...provides a description of all response elements In the Ancestry paragraphs the elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark Definition...

Страница 304: ...release item or similar item Ancestry Item ASIN CartItem SavedForLaterItem Cart NewReleases NewRelease NewReleases NewRelease ASIN OtherCategoriesSimilarProduct ASIN SimilarProduct SimilarViewedProdu...

Страница 305: ...ibutes Large Medium Brand A positive integer that uniquely identifies a parent product category Ancestry BrowseNode Ancestors BrowseNode BrowseNode Children BrowseNode BrowseNodeId A positive integer...

Страница 306: ...of a collection For more information see Collections Ancestry None Collection An item that is part of a collection of items For more information see Collections Ancestry None CollectionItem The parent...

Страница 307: ...rements EligibilityRequirement CurrencyAmount Benefits Benefit FixedAmount OfferSummary LowestCollectiblePrice CurrencyCode OfferSummary LowestNewPrice CurrencyCode OfferSummary LowestRefurbishedPrice...

Страница 308: ...r one or more EligibilityRequirement elements Ancestry None EligibilityRequirements Specifies the eligibility requirements to qualify for the promotion for example MinPurchase MinQuantity or ForEachQu...

Страница 309: ...tes Format The price formatted as it should be displayed to the user The formatting is specified by CurrencyCode and varies by country Or the discounted price formatted for display Ancestry Eligibilit...

Страница 310: ...the iframe on a web page add the following to your HTML iframe src reviews_iframe_url Note The URL expires in 24 hours Ancestry CustomerReviews IFrameURL An image associated with a seller s item Ance...

Страница 311: ...icle parts to return with higher ASIN values than those already returned IsNext Indicates that there are more vehicle parts to return with lower ASIN values than those already returned IsPrevious Cont...

Страница 312: ...tPrice In the JP locale only loyalty points are returned Loyalty points are used to generate sales Ancestry Offers Offer LoyaltyPoints The number of points awarded as part of a purchase Points transla...

Страница 313: ...butes MetalType The minimum number of hours for which the item is available Ancestry Offers Offer OfferListing AvailabilityAttributes MinimumHours Model Ancestry ItemAttributes Model The URL where all...

Страница 314: ...A number that uniquely identifies an offer listing This number represents a sales offer from a specific merchant Ancestry Offers Offer OfferListing OfferListingId Specifies the name of the operating s...

Страница 315: ...n An alphanumeric token that uniquely identifies a promotion Ancestry Offers Offer Promotions Promotion Summary PromotionId A container for one or more Promotion elements Ancestry Offers Offer Promoti...

Страница 316: ...r parent Relationships are uni directional either parent to child or child to parent Ancestry RelatedItems Relationship Specifies how the related item relates to the specified item in the ItemLookup r...

Страница 317: ...er that uniquely identifies an item Ancestry ItemAttributes SellerListing SKU Container for a small image Thumbnail and Small images are the same size Ancestry ImageSets ImageSet SmallImage Where the...

Страница 318: ...ts in other product groups similar products in the same product group similar products in the same product group that have been viewed Ancestry ItemAttributes Accessories Accessory SavedForLaterItem C...

Страница 319: ...stomerReviews TotalReviewPages Total number of reviews of an item Ancestry CustomerReviews TotalReviews Container object for all other Total elements including Total SubTotal Tax ShippingCharges Promo...

Страница 320: ...into a bar code that is printed on an item or its packaging Ancestry ItemAttributes SellerListing UPC The container for one or more UPCListElement p 313 attributes Ancestry ItemAttributes UPCList A po...

Страница 321: ...ItemSearch Sort parameter enables you to choose the order of the items in a response Available sort values vary by locale and search index There are many sort values The majority are not applied unle...

Страница 322: ...Index VideoGames p 318 SearchIndex All You cannot use any sort parameters with the All search index SearchIndex Books Description Value Bestselling salesrank Price low to high pricerank Price high to...

Страница 323: ...lerank SearchIndex ForeignBooks Description Value Bestselling salesrank Price low to high pricerank Price high to low inverse pricerank Publication date newer to older daterank Alphabetical A to Z tit...

Страница 324: ...gh pricerank Price high to low inverse pricerank Alphabetical A to Z titlerank Rel Date Old to New daterank SearchIndex SoftwareVideoGames Description Value Bestselling salesrank Price low to high pri...

Страница 325: ...19 SearchIndex Automotive p 320 SearchIndex Baby p 320 SearchIndex Beauty p 320 SearchIndex Books p 321 SearchIndex Electronics p 321 SearchIndex Grocery p 321 SearchIndex HealthPersonalCare p 322 Sea...

Страница 326: ...Price Low to high price Price High to low price Average customer review High to low reviewrank Latest arrivals launchdate SearchIndex Appliances Description Value Items ranked according to the followi...

Страница 327: ...r example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found using...

Страница 328: ...lerank Alphabetical Z to A titlerank Release date Older to newer release date Release date Newer to older release date SearchIndex Grocery Description Value Items ranked according to the following cri...

Страница 329: ...criptions if there are multiple keywords and how often customers purchased the products they found using the keyword relevancerank Best to worse selling salesrank Price Low to high price Price High to...

Страница 330: ...o high price Price High to low price Average customer review High to low reviewrank SearchIndex Misc Description Value Items ranked according to the following criteria how often the keyword appears in...

Страница 331: ...ria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are m...

Страница 332: ...hased the products they found using the keyword relevancerank Best to worse selling salesrank Price Low to high price Price High to low price Average customer review High to low reviewrank Launch date...

Страница 333: ...abetical Z to A titlerank Release date Oldest to newest releasedate Release date Newest to oldest releasedate SearchIndex Video Description Value Best to worse selling salesrank Price Low to high pric...

Страница 334: ...arel p 328 SearchIndex Automotive p 328 SearchIndex Baby p 329 SearchIndex Beauty p 329 SearchIndex Books p 329 SearchIndex Classical p 330 SearchIndex DVD p 330 SearchIndex Electronics p 330 SearchIn...

Страница 335: ...th the All search index SearchIndex Apparel Description Value Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the desc...

Страница 336: ...high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the description where the keyword appears for example the ranking is higher when k...

Страница 337: ...to Z titlerank Alphabetical Z to A titlerank SearchIndex DVD Description Value Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabetical Z to A t...

Страница 338: ...ptions if there are multiple keywords and how often customers purchased the products they found using the keyword relevancerank Bestselling salesrank Price low to high price Price high to low price Av...

Страница 339: ...ustomers purchased the products they found using the keyword relevancerank Highest to lowest ratings in customer reviews reviewrank SearchIndex KindleStore Description Value Items ranked according to...

Страница 340: ...chIndex Magazines Description Value Bestselling salesrank Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex Jewelry Description Value Bestselling salesrank Items ranked according...

Страница 341: ...here are multiple keywords how closely they occur in descriptions and finally how often customers purchased the products they found using the keyword relevancerank Highest to lowest ratings in custome...

Страница 342: ...iewrank Bestselling salesrank Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the description where the keyword appear...

Страница 343: ...dex OutdoorLiving Description Value Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex Outlet You cannot use...

Страница 344: ...closely they occur in descriptions and finally how often customers purchased the products they found using the keyword relevancerank Bestselling first salesrank Average customer review high to low re...

Страница 345: ...newer to older date Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex Tools Description Value Bestselling salesrank Price low to high price Price high to low pricerank Alphabeti...

Страница 346: ...l A to Z titlerank Alphabetical Z to A titlerank SearchIndex VideoGames Description Value Bestselling salesrank Price low to high price Price high to low price Publication date newer to older date Alp...

Страница 347: ...cording to the following criteria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur...

Страница 348: ...tion where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchas...

Страница 349: ...erank Bestselling salesrank Price low to high price Price high to low price Average customer review high to low reviewrank Review rank high to low reviewrank_authority SearchIndex Music Description Va...

Страница 350: ...tion where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchas...

Страница 351: ...found using the keyword relevancerank Bestselling salesrank Price low to high price Price high to low price Average customer review high to low reviewrank Review rank high to low reviewrank_authority...

Страница 352: ...d appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles and if there are multiple keywords how closely they occur in descriptions and...

Страница 353: ...evancerank Highest to lowest ratings in customer reviews reviewrank Bestselling salesrank SearchIndex Books Description Value Bestselling to worse selling salesrank Price low to high pricerank Price h...

Страница 354: ...o low price Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex ForeignBooks Description Value Bestselling salesrank Price low to high pricerank Price high to low inverse pricerank...

Страница 355: ...king is higher when keywords are found in titles and if there are multiple keywords how closely they occur in descriptions and finally how often customers purchased the products they found using the k...

Страница 356: ...talbumrank Price low to high price Price high to low price Time Short to Long runtime Time Long to Short runtime Release date newer to older releasedate Items ranked according to the following criteri...

Страница 357: ...ranked according to the following criteria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles and if there...

Страница 358: ...dex Shoes Description Value Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the description where the keyword appears...

Страница 359: ...scription Value Items ranked according to the following criteria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in...

Страница 360: ...o low price Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex VideoGames Description Value Bestselling salesrank Price low to high price Price high to low price Rel Date new to o...

Страница 361: ...x Music p 356 SearchIndex Shoes p 357 SearchIndex Software p 357 SearchIndex Toys p 358 SearchIndex VideoGames p 358 SearchIndex Watches p 358 SearchIndex All You cannot use any sort parameters with t...

Страница 362: ...rs for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found u...

Страница 363: ...ia how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are mu...

Страница 364: ...word relevancerank Best to worse selling salesrank Price Low to high price Price High to low price Average customer review high to low reviewrank Newest arrivals releasedate SearchIndex Software Descr...

Страница 365: ...her when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found using the keyword relevancerank Be...

Страница 366: ...SearchIndex HomeImprovement p 363 SearchIndex Jewelry p 364 SearchIndex Kitchen p 364 SearchIndex Marketplace p 365 SearchIndex MP3Downloads p 365 SearchIndex Music p 366 SearchIndex MusicalInstrument...

Страница 367: ...ria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles and if there are multiple keywords how closely they o...

Страница 368: ...ank SearchIndex Books Description Value Bestselling salesrank Price low to high pricerank Price high to low inverse pricerank Publication date newer to older daterank Alphabetical A to Z titlerank Alp...

Страница 369: ...asedate SearchIndex Electronics Description Value Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabetical Z to A titlerank Release date newer t...

Страница 370: ...x Hobbies Description Value Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabetical Z to A titlerank Release date older to newer release date R...

Страница 371: ...n where the keyword appears for example the ranking is higher when keywords are found in titles and if there are multiple keywords how closely they occur in descriptions and finally how often customer...

Страница 372: ...d finally how often customers purchased the products they found using the keyword relevancerank Bestselling salesrank Alphabetical A to Z titlerank Alphabetical Z to A titlerank Artist album rank high...

Страница 373: ...ngs in customer reviews reviewrank Bestselling salesrank Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the descripti...

Страница 374: ...low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the description where the keyword appears for example the ranking is higher...

Страница 375: ...e Release date newer to older releasedate SearchIndex Toys Description Value Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabetical Z to A tit...

Страница 376: ...ue Bestselling salesrank Price low to high price Price high to low price Price low to high pricerank Price high to low pricerank Alphabetical A to Z titlerank Alphabetical Z to A titlerank Release dat...

Страница 377: ...tical Z to A titlerank Sort Values for UK Topics SearchIndex All p 371 SearchIndex Apparel p 371 SearchIndex Automotive p 371 SearchIndex Baby p 372 SearchIndex Beauty p 372 SearchIndex Books p 372 Se...

Страница 378: ...introduced from the most recent to the least recent launch date Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the d...

Страница 379: ...ywords are found in titles and if there are multiple keywords how closely they occur in descriptions and finally how often customers purchased the products they found using the keyword relevancerank B...

Страница 380: ...viewrank Price low to high price Price high to low price Price high to low inverse pricerank Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex DVD Description Value Bestselling s...

Страница 381: ...r when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found using the keyword relevancerank Best...

Страница 382: ...ank SearchIndex Jewelry Description Value Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the description where the ke...

Страница 383: ...Average customer review high to low reviewrank Price low to high price Price high to low price Publication date older to newer daterank Alphabetical A to Z titlerank Alphabetical Z to A titlerank Sea...

Страница 384: ...hen keywords are found in titles and if there are multiple keywords how closely they occur in descriptions and finally how often customers purchased the products they found using the keyword relevance...

Страница 385: ...etical A to Z titlerank Alphabetical Z to A titlerank SearchIndex OfficeProducts Description Value Price low to high price Price high to low price Items ranked according to the following criteria how...

Страница 386: ...l was introduced from the most recent to the least recent launch date Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in...

Страница 387: ...ling salesrank Average customer review high to low reviewrank Price low to high price Price high to low inverse pricerank Publication date older to newer daterank Alphabetical A to Z titlerank Alphabe...

Страница 388: ...ewrank Price low to high price Price high to low price Price high to low inverse pricerank Publication date older to newer daterank Publication date older to newer releasedate Alphabetical A to Z titl...

Страница 389: ...to A titlerank Sort Values for US Topics SearchIndex All p 383 SearchIndex Apparel p 383 SearchIndex Appliances p 384 SearchIndex ArtsAndCrafts p 384 SearchIndex Automotive p 384 SearchIndex Baby p 3...

Страница 390: ...ndex Wireless p 397 SearchIndex WirelessAccessories p 398 SearchIndex All You cannot use any sort parameters with the All search index SearchIndex Apparel Description Value Items ranked according to t...

Страница 391: ...s Description Value Featured items pmrank Price low to high price Price high to low price Items ranked according to the following criteria how often the keyword appears in the description where the ke...

Страница 392: ...nked according to the following criteria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles how closely they...

Страница 393: ...songtitlerank Date added uploaddaterank SearchIndex DVD Description Value Items ranked according to the following criteria how often the keyword appears in the description where the keyword appears fo...

Страница 394: ...en keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found using the keyword relevancerank Bestsell...

Страница 395: ...e Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex Jewelry Description Value Featured items pmrank Bestselling salesrank Price low to high pricerank Price high to low inversepri...

Страница 396: ...alue Featured items pmrank Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabetical Z to A titlerank SearchIndex Magazines Description Value Bes...

Страница 397: ...customers purchased the products they found using the keyword relevancerank Bestselling salesrank Price low to high pricerank Price high to low inverseprice Newest arrivals launch date On sale sale f...

Страница 398: ...ds are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found using the keyword relevancerank Bestselling sales...

Страница 399: ...ex MusicalInstruments Description Value Featured items pmrank Bestselling salesrank Price low to high price Price high to low price Newest arrivals launch date On sale sale flag SearchIndex MusicTrack...

Страница 400: ...habetical A to Z titlerank SearchIndex PetSupplies Description Value Featured items pmrank Bestselling salesrank Price low to high price Price high to low price Alphabetical A to Z titlerank Alphabeti...

Страница 401: ...keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are multiple keywords...

Страница 402: ...cerank Bestselling salesrank Price low to high pricerank Price high to low inverseprice Newest arrivals launch date On sale sale flag SearchIndex Tools Description Value Featured items pmrank Bestsell...

Страница 403: ...ample the ranking is higher when keywords are found in titles how closely they occur in descriptions if there are multiple keywords and how often customers purchased the products they found using the...

Страница 404: ...riteria how often the keyword appears in the description where the keyword appears for example the ranking is higher when keywords are found in titles how closely they occur in descriptions if there a...

Страница 405: ...can be used in a request For example in the US locale when SearchIndex is Blended the only parameter that can be used in an ItemSearch request is Keywords Amazon ca CA Combinations p 398 Amazon cn CN...

Страница 406: ...ndex Blended Keywords SearchIndex Books In an ItemSearch request when the SearchIndex parameter equals VALUE only the following parameters can be used in the request Power Publisher Sort Title ItemPag...

Страница 407: ...cturer MaximumPrice BrowseNode Condition Count ItemPage SearchIndex ForeignBooks In an ItemSearch request when the SearchIndex parameter equals ForeignBooks only the following parameters can be used i...

Страница 408: ...BrowseNode Condition Count SearchIndex SoftwareVideoGames In an ItemSearch request when the SearchIndex parameter equals SoftwareVideoGames only the following parameters can be used in the request Mi...

Страница 409: ...Condition Count SearchIndex ItemSearch Parameter Combinations for CN This Search Index Matrix shows you which ItemSearch parameters may be used with each of the available SearchIndex values for the CN...

Страница 410: ...parel only the following parameters can be used in the request MinimumPrice Sort Title Keywords Manufacturer MaximumPrice Availability Author Brand BrowseNode SearchIndex Appliances In an ItemSearch r...

Страница 411: ...eters can be used in the request MinimumPrice Sort Title Keywords Manufacturer MaximumPrice Availability Author Brand BrowseNode SearchIndex Books In an ItemSearch request when the SearchIndex paramet...

Страница 412: ...g parameters can be used in the request MinimumPrice Sort Title Keywords Manufacturer MaximumPrice Availability Author Brand BrowseNode SearchIndex Home In an ItemSearch request when the SearchIndex p...

Страница 413: ...facturer MaximumPrice Availability Author Brand BrowseNode SearchIndex Music In an ItemSearch request when the SearchIndex parameter equals Music only the following parameters can be used in the reque...

Страница 414: ...e Availability Brand BrowseNode SearchIndex Software In an ItemSearch request when the SearchIndex parameter equals Software only the following parameters can be used in the request MinimumPrice Sort...

Страница 415: ...Actor Availability BrowseNode Director SearchIndex VideoGames In an ItemSearch request when the SearchIndex parameter equals VideoGames only the following parameters can be used in the request Minimum...

Страница 416: ...ex Jewelry p 413 SearchIndex KindleStore p 413 SearchIndex Kitchen p 413 SearchIndex Lighting p 414 SearchIndex Magazines p 414 SearchIndex Marketplace p 414 SearchIndex MP3Downloads p 415 SearchIndex...

Страница 417: ...otive In an ItemSearch request when the SearchIndex parameter equals Automotive only the following parameters can be used in the request MinimumPrice Sort Title ItemPage Keywords Manufacturer MaximumP...

Страница 418: ...le Keywords MaximumPrice MerchantId MinimumPrice Author BrowseNode Condition ItemPage SearchIndex Classical In an ItemSearch request when the SearchIndex parameter equals Music only the following para...

Страница 419: ...s only the following parameters can be used in the request Publisher Sort Title Keywords MaximumPrice MerchantId MinimumPrice Author BrowseNode Condition ItemPage SearchIndex Grocery In an ItemSearch...

Страница 420: ...welry only the following parameters can be used in the request Sort Title Keywords MerchantId Availability BrowseNode SearchIndex KindleStore In an ItemSearch request when the SearchIndex parameter eq...

Страница 421: ...ItemSearch request when the SearchIndex parameter equals Magazines only the following parameters can be used in the request Publisher Sort Title MaximumPrice MerchantId MinimumPrice BrowseNode Conditi...

Страница 422: ...tist Availability BrowseNode Count Format SearchIndex MusicalInstruments In an ItemSearch request when the SearchIndex parameter equals MusicalInstruments only the following parameters can be used in...

Страница 423: ...Condition ItemPage Keywords SearchIndex Outlet In ItemSearch request when SearchIndex equals Outlet only the following parameters can be used in a request Keywords SearchIndex PCHardware In an ItemSea...

Страница 424: ...following parameters can be used in the request MinimumPrice Sort Title Manufacturer MaximumPrice MerchantId BrowseNode Condition ItemPage Keywords SearchIndex SportingGoods In an ItemSearch request...

Страница 425: ...ly the following parameters can be used in the request Publisher Sort Title Format ItemPage Keywords Magazines Performer Actor AudienceRating Availability BrowseNode Count Director SearchIndex Video I...

Страница 426: ...h Parameter Combinations for ES This Search Index Matrix shows you which ItemSearch parameters may be used with each of the available SearchIndex values for the ES locale Topics SearchIndex All p 419...

Страница 427: ...Sort Title DeliveryMethod Director Keywords MaximumPrice Actor AudienceRating Availability BrowseNode SearchIndex Electronics In an ItemSearch request when the SearchIndex parameter equals Electronic...

Страница 428: ...arch request when the SearchIndex parameter equals Music only the following parameters can be used in the request MusicLabel Sort Title Keywords MaximumPrice MerchantId MinimumPrice Artist Availabilit...

Страница 429: ...d BrowseNode DeliveryMethod SearchIndex Watches In an ItemSearch request when the SearchIndex parameter equals Watches only the following parameters can be used in the request MerchantId Sort Title Av...

Страница 430: ...428 SearchIndex VHS p 428 SearchIndex Video p 429 SearchIndex VideoGames p 429 SearchIndex Watches p 429 SearchIndex All In ItemSearch request when SearchIndex equals All only the following parameter...

Страница 431: ...SearchIndex parameter equals Books only the following parameters can be used in the request Power Publisher Sort Title ItemPage Keywords MaximumPrice MinimumPrice Author BrowseNode Condition Count Sea...

Страница 432: ...rice BrowseNode Condition ItemPage SearchIndex ForeignBooks In an ItemSearch request when the SearchIndex parameter equals ForeignBooks only the following parameters can be used in the request Power P...

Страница 433: ...ailability Brand BrowseNode Condition Count SearchIndex Lighting In an ItemSearch request when the SearchIndex parameter equals Lighting only the following parameters can be used in the request Sort T...

Страница 434: ...mPrice MinimumPrice Keywords Availability Brand BrowseNode SearchIndex MusicTracks In an ItemSearch request when the SearchIndex parameter equals MusicTracks only the following parameters can be used...

Страница 435: ...llowing parameters can be used in the request MinimumPrice Sort Title Keywords Manufacturer MaximumPrice BrowseNode Condition Count ItemPage SearchIndex SoftwareVideoGames In an ItemSearch request whe...

Страница 436: ...deoGames In an ItemSearch request when the SearchIndex parameter equals VideoGames only the following parameters can be used in the request MinimumPrice Sort Title ItemPage Keywords Manufacturer Maxim...

Страница 437: ...archIndex VideoGames p 433 SearchIndex Watches p 433 SearchIndex All In ItemSearch request when SearchIndex equals All only the following parameters can be used in a request Keywords SearchIndex Books...

Страница 438: ...the following parameters can be used in the request Power Publisher Sort Title Keywords MaximumPrice MinimumPrice Author Availability BrowseNode SearchIndex Garden In an ItemSearch request when the S...

Страница 439: ...parameters can be used in the request MinimumPrice Sort Title Keywords Manufacturer MaximumPrice Availability Brand BrowseNode SearchIndex Software In an ItemSearch request when the SearchIndex parame...

Страница 440: ...in the request Keywords Sort Availability BrowseNode SearchIndex ItemSearch Parameter Combinations for JP This Search Index Matrix shows you which ItemSearch parameters may be used with each of the a...

Страница 441: ...o p 441 SearchIndex VideoGames p 441 SearchIndex Watches p 441 SearchIndex All In ItemSearch request when SearchIndex equals All only the following parameters can be used in a request Keywords SearchI...

Страница 442: ...s can be used in the request MinimumPrice Sort Title ItemPage Keywords Manufacturer MaximumPrice Brand BrowseNode Condition SearchIndex Blended In an ItemSearch request when the SearchIndex parameter...

Страница 443: ...azines Performer Actor AudienceRating Availability BrowseNode Count Director SearchIndex Electronics In an ItemSearch request when the SearchIndex parameter equals VALUE only the following parameters...

Страница 444: ...imumPrice BrowseNode Condition ItemPage Keywords SearchIndex Hobbies In an ItemSearch request when the SearchIndex parameter equals Hobbies only the following parameters can be used in the request Min...

Страница 445: ...ex parameter equals Marketplace the MarketplaceDomain parameter must be supplied Only the following parameters can be used in the request Title MaximumPrice MinimumPrice Sort Availability BrowseNode K...

Страница 446: ...s can be used in the request MinimumPrice Sort Keywords MaximumPrice Condition ItemPage SearchIndex OfficeProducts In an ItemSearch request when the SearchIndex parameter equals OfficeProducts only th...

Страница 447: ...e BrowseNode Condition ItemPage SearchIndex Toys In an ItemSearch request when the SearchIndex parameter equals Toys only the following parameters can be used in the request MinimumPrice Sort Title Ke...

Страница 448: ...mumPrice Brand BrowseNode Condition ItemPage SearchIndex Watches In an ItemSearch request when the SearchIndex parameter equals Watches only the following parameters can be used in the request Title K...

Страница 449: ...Index Outlet p 448 SearchIndex Shoes p 448 SearchIndex Software p 448 SearchIndex SoftwareVideoGames p 448 SearchIndex Toys p 449 SearchIndex VHS p 449 SearchIndex Video p 449 SearchIndex VideoGames p...

Страница 450: ...eywords Magazines Manufacturer Author Availability Brand BrowseNode Condition Count SearchIndex Beauty In an ItemSearch request when the SearchIndex parameter equals Beauty only the following paramete...

Страница 451: ...Search request when the SearchIndex parameter equals DVD only the following parameters can be used in the request Publisher Sort Title Format ItemPage Keywords Magazines Performer Actor AudienceRating...

Страница 452: ...on ItemPage Keywords Manufacturer Brand BrowseNode Condition ItemPage Brand SearchIndex HomeGarden In an ItemSearch request when the SearchIndex parameter equals HomeGarden only the following paramete...

Страница 453: ...ce In an ItemSearch request when the SearchIndex parameter equals Marketplace the MarketplaceDomain parameter must be supplied Only the following parameters can be used in the request Title MaximumPri...

Страница 454: ...acks In an ItemSearch request when the SearchIndex parameter equals MusicTracks only the following parameters can be used in the request MinimumPrice Sort Keywords MaximumPrice Condition ItemPage Sear...

Страница 455: ...e Condition Count ItemPage SearchIndex Software In an ItemSearch request when the SearchIndex parameter equals Software only the following parameters can be used in the request MinimumPrice Sort Title...

Страница 456: ...rowseNode Count Director SearchIndex Video In an ItemSearch request when the SearchIndex parameter equals VALUE only the following parameters can be used in the request Publisher Sort Title Format Ite...

Страница 457: ...rchIndex Beauty p 452 SearchIndex Blended p 453 SearchIndex Books p 453 SearchIndex Classical p 453 SearchIndex DigitalMusic p 453 SearchIndex Grocery p 454 SearchIndex MP3Downloads p 454 SearchIndex...

Страница 458: ...ndex equals All only the following parameters can be used in a request Keywords SearchIndex Apparel In an ItemSearch request when the SearchIndex parameter equals apparel only the following parameters...

Страница 459: ...e MinPercentageOff Sort Title ItemPage Keywords Manufacturer MaximumPrice MerchantId Brand BrowseNode Condition SearchIndex Baby In an ItemSearch request when the SearchIndex parameter equals Baby onl...

Страница 460: ...owseNode Condition SearchIndex Classical In an ItemSearch request when the SearchIndex parameter equals Classical only the following parameters can be used in the request Orchestra Performer Sort Titl...

Страница 461: ...wnloads only the following parameters can be used in the request Browsenode Keyword Title SearchIndex DVD In an ItemSearch request when the SearchIndex parameter equals DVD only the following paramete...

Страница 462: ...ywords SearchIndex HomeGarden MinimumPrice MinPercentageOff Sort Title Keywords Manufacturer MaximumPrice MerchantId Brand BrowseNode Condition ItemPage SearchIndex Industrial BrowseNode Keywords Manu...

Страница 463: ...es In an ItemSearch request when the SearchIndex parameter equals Magazines only the following parameters can be used in the request MinimumPrice Publisher Sort Title ItemPage Keywords MaximumPrice Me...

Страница 464: ...request MerchantId MinimumPrice MinPercentageOff Sort Title ItemPage Keywords MaximumPrice Brand BrowseNode Condition SearchIndex MobileApps In an ItemSearch request when the SearchIndex parameter equ...

Страница 465: ...x MusicTracks In an ItemSearch request when the SearchIndex parameter equals MusicTracks only the following parameters can be used in the request MinimumPrice Sort Keywords MaximumPrice MerchantId Con...

Страница 466: ...Brand BrowseNode Condition Manufacturer SearchIndex PetSupplies In an ItemSearch request when the SearchIndex parameter equals PetSupplies only the following parameters can be used in the request Mer...

Страница 467: ...BrowseNode Condition Manufacturer SearchIndex SportingGoods In an ItemSearch request when the SearchIndex parameter equals SportingGoods only the following parameters can be used in the request Minim...

Страница 468: ...Title ItemPage Keywords MaximumPrice MerchantId MinimumPrice Actor BrowseNode Condition Director SearchIndex VHS In an ItemSearch request when the SearchIndex parameter equals VHS only the following p...

Страница 469: ...atches In an ItemSearch request when the SearchIndex parameter equals Watches only the following parameters can be used in the request Title MerchantId MinimumPrice MinPercentageOff Sort BrowseNode Co...

Страница 470: ...t by Locale The following table provides a list of the search indices available by locale A check mark in the following table indicates that a search index is available in a particular locale Note All...

Страница 471: ...re Hobbies Home HomeGarden HomeImprovement Industrial Jewelry KindleStore Kitchen Lighting Magazines Marketplace Miscellaneous MobileApps MP3Downloads Music MusicalInstruments MusicTracks OfficeProduc...

Страница 472: ...eless WirelessAccessories Browse Node IDs The following table presents browse node IDs by search index and locale These IDs represent the top level browse nodes only You can use these IDs in a BrowseN...

Страница 473: ...4031 57239051 340846031 2 1 2 7 2 1 5 0 5 1 Grocery 3760931 66280031 161669011 197861031 64257031 852803051 H e a l t h P e r s o n a l C a r e 13331821 Hobbies 2 0 1 6 1 2 6 0 5 1 Home 285080 1105259...

Страница 474: ...541708 897415051 110218011 V i d e o G a m e s 1079730 595312 14315361 524009031 60937031 599388031 193708031 1 9 5 3 1 6 4 0 5 1 Watches 508494 Wireless 13900851 W i r e l e s s A c c e s s o r i e s...

Страница 475: ...ID buyer A person s agreeing to exchange money for an item delivered by a seller collection An ensemble of related items such as a coordinated set of sheets pillow cases and curtains EISBN Electronic...

Страница 476: ...0 or In stock Offerings will have transactional rules max quantity purchasable condition types new used and tax codes associated with them An offering is not a buyable entity on its own An offering wi...

Страница 477: ...barcodes variant A single version of a given product that has variations A variant is an item defined by its product and the unique set of property values from each property in the full set of requir...

Страница 478: ...in text Blocks of sample code are set apart from the body and marked accordingly ls l var www html index html rw rw r 1 root root 1872 Jun 21 09 33 var www html index html date Wed Jun 21 09 33 42 EDT...

Страница 479: ...ce is hyperlinked it is also underscored For detailed conceptual information see the Amazon Mechanical Turk Developer Guide Technical publication references A special font marks text that the user typ...

Страница 480: ...hin a code description square brackets denote completely optional commands or parameters sed n quiet Use square brackets in XML examples to differentiate them from tags Date date Date square brackets...

Страница 481: ...BuyAmountXGetAmountOffX 106 262 BuyAmountXGetSimpleShippingFreeX 106 262 C caching 160 cart 135 137 Active 135 Active area 135 Add to Cart form 146 adding items to 142 create 139 expiration 138 ident...

Страница 482: ...ributes 81 available 88 available for in store pickup 86 benefit 107 eligible 107 find using browse nodes 101 finding 28 86 finding out more about one item 29 for sale 24 for sale by third parties 86...

Страница 483: ...s 92 operators 93 syntax 91 tips 94 pre orders 85 pre release order 131 Preferential 108 price 123 123 ranges 127 pricerank 123 Proceed to Checkout 148 Product Advertising API 23 28 promotion 106 cate...

Страница 484: ...ptionId 75 T TermsAndConditions 108 Title 88 92 title begins 92 title words begin 92 top seller 119 from shopping cart 121 generalizing 120 TopSellers response group 280 Tracks response group 281 trav...

Результаты поиска

Содержание Product Advertising API

Отзывы:

Похожие инструкции для Product Advertising API

Бренды по названию

Популярные бренды

Amazon Product Advertising API, Руководство разработчика

Результаты поиска

Содержание Product Advertising API

Отзывы:

Похожие инструкции для Product Advertising API

Бренды по названию

Популярные бренды