カスタマーのほしい物リストにある商品を勧める

カスタマーが友人のためにリスト商品のいずれかを購入する場合、友人が登録している他のリスト商品にも興味を持つ可能性があります。Product Advertising API では、ほしい物リスト、リストマニア、ウェディングレジストリ、ベビーレジストリの4種類のリストにアクセスできるようにします。カスタマーがあるリストから商品を購入する場合、友人の複数のリストにある全ての商品を表示することができます。

カスタマーのリストを検索するには

  1. リストIDを検索します。

    カスタマーの名前またはEメールアドレスを ListSearch リクエストに指定すると、カスタマーのリストIDが返されます。

  2. いずれかのリストIDを ListLookup リクエストで指定します。

    このオペレーションは、指定されたリスト上の商品を返します。

例えば、John Smith という人物によって作成されたリストを検索するには、次のリクエストを使用します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[アクセスキー ID]&
Operation=ListSearch&
ListType=WishList&
Name=John%20Smith

姓と名の間のスペースが%20にURLエンコードされていることに注意してください。

次のレスポンス例は、John Smith が作成したリストの1つを示しています。

<List>
  <ListId>ZZ6666662H77</ListId>
  <ListURL>http://www.amazon.com/gp/registry/ZZ6666662H77
  </ListURL>
  <ListType>WishList</ListType>
  <TotalItems>51</TotalItems>
  <TotalPages>6</TotalPages>
  <DateCreated>2002-10-02</DateCreated>
  <CustomerName>

このレスポンスは、John Smith のほしい物リストに51個の商品があることを示しています。1ページあたり20個の商品が表示されるので、全ての商品を返すと6ページになります。<TotalPages> の値を使用し、異なる ListPage 値を指定して、6ページ全てが返されるまでリクエストを繰り返すことができます。

また、ListURL に指定された URL を使用して、レスポンスにほしい物リストを表示することもできます。

John のほしい物リストのIDがわかっているので、次のリクエストを使用してほしい物リストにある商品を返すことができます。

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

次のレスポンス例には、John のほしい物リストにある商品から2つがリストアップされています。

<ListItem>
  <ListItemId>IOWNUUPH86VRC</ListItemId> 
  <DateAdded>2002-01-27</DateAdded> 
  <QuantityDesired>1</QuantityDesired> 
  <QuantityReceived>0</QuantityReceived> 
  <Item>
    <ASIN>1890966533</ASIN> 
    <ItemAttributes>
      <Title>Safety Incentives: The Pros and Cons of Award and Recognition Programs (Osha Compliance)</Title> 
    </ItemAttributes>
  </Item>
</ListItem>
<ListItem>
  <ListItemId>I1JY2MH4BGECYR</ListItemId> 
  <DateAdded>2002-01-27</DateAdded> 
  <QuantityDesired>1</QuantityDesired> 
  <QuantityReceived>0</QuantityReceived> 
  <Item>
    <ASIN>0963229613</ASIN> 
    <ItemAttributes>
      <Title>Confined Space Program: A Complete Compliance Program (Osha Compliance)
      </Title> 
    </ItemAttributes>
  </Item>
</ListItem>

ListFull レスポンスグループで返される情報で、ほしい物リストにある商品の追加購入をカスタマーに勧めることができます。画像など、ほしい物リストの商品に関する詳細な情報を追加したい場合は、ほしい物リストにある商品のASINを使用して ItemLookup リクエストを送信します。

ほしい物リストに商品を追加する方法については、 リストに商品を追加するをご参照ください。