カスタマーIDを使用した商品の検索

リスト上の商品を表示するだけの場合は、返されたURLを使用します。ただし、単にリストを表示するのではなく、リストの商品をリモートショッピングカートに追加するために必要なASINとListItemIdsを返したい場合は、リストIDを ListLookup リクエストで使用する必要があります。ListSearch は、いくつかのレスポンスグループだけを使用します。つまり、リスト上の商品に関して返される情報は最小限になります。これに対し、ListLookup では多数のレスポンスグループを使用できるため、リスト上の商品に関する詳細な情報を返すことができます。

カスタマーIDを使用して商品を検索するには

以下のように、ListId を ListLookup リクエストで使用し、リストの商品のASINとListItemIds を返します。

次のURLは、 ListLookup リクエストの例です。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[アクセスキー ID]
Operation=ListLookup&
ListType=WishList&
ListId=BB4444444477

なお、 ListLookup リクエストでは、ListType に加えて ListIdも必要となるので注意してください。これは、ListId が全てのリストで一意でないためです。

次のXMLコードは、レスポンスの一部を示しています。

<ListItem>
  <ListItemId>98989898989898</ListItemId> 
  <DateAdded>2002-01-27</DateAdded> 
  <QuantityDesired>1</QuantityDesired> 
  <QuantityReceived>0</QuantityReceived> 
  <Item>
   <ASIN>0865874069</ASIN> 
   <ItemAttributes>
     <Title>Confined Space Entry : Complying with the Standard</Title> 
   </ItemAttributes>
  </Item>
</ListItem>

レスポンスにListItemId要素が含まれていることに注意してください。リストの商品をリモートショッピングカートに追加するには、<parameter>CartCreate</parameter> または <parameter>CartAdd</parameter> リクエストに商品のASINとListItemIdを含める必要があります。詳細については、リモートショッピングカートの商品の変更をご参照ください。

このレスポンスには、商品の属性として商品のタイトルだけが含まれています。リクエストでほかのレスポンスグループも指定すれば、リスト上の商品に関する詳細情報を返すことができます。