ListSearch

	重要
	利用率低下により、このオペレーションおよび関連レスポンスグループは2010年07月25日をもってサポート終了となっておりますので、ご利用にならないようご注意ください。

説明

カスタマー名またはEメールアドレスを ListSearch オペレーションで指定すると、関連付けられているリストIDが返されます (リスト商品は返されません) 。リスト商品を検索するには、 ListSearch で返されたリストIDを ListLookup で使用します。

リクエストで、フルネーム、名前だけまたは姓だけを指定すると、さまざまな人が所有する複数のリストが返されます。ID情報としてEメールを使用すると、さらに結果を絞り込めます。

	注意
	Eメールアドレスの@記号は、必ず %40 にURLエンコードしてください。これをしないと、リクエストは失敗します。

全ての国のサイト

Wishlists と WeddingRegistry のリストタイプの場合、次のパラメータを1つまたは複数指定する必要があります。

BabyRegistry リストタイプの場合、次のパラメータを1つまたは複数指定する必要があります。

例えば、e-mail address または Name を指定してベビーレジストリを取得することはできません。

ListSearch には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループをご参照ください。

次のリクエストは、John Smith のほしい物リストIDを返しています。

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

このリクエストに対するレスポンスをレスポンス例に示します。

次のリクエストは、JohnSmith@ISP.com のほしい物リストIDを返しています。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[アクセスキー ID]&
Operation=ListSearch&
ListType=WishList&
e-mail=JohnSmith40ISP.com

次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。

<TotalResults>2</TotalResults> 
<TotalPages>1</TotalPages>
<List>
  <List>
    <ListId>BR4444442H77</ListId> 
    <ListURL>http://www.amazon.com/gp/registry/BR4444442H77</ListURL> 
    <ListType>WishList</ListType> 
    <TotalItems>70</TotalItems> 
    <TotalPages>7</TotalPages> 
    <DateCreated>1999-10-06</DateCreated> 
    <CustomerName>John Smith</CustomerName> 
  </List>
  <List>
    <ListId>BR6666662H77</ListId> 
    <ListURL>http://www.amazon.com/gp/registry/BR6666662H77</ListURL> 
    <ListType>WishList</ListType> 
    <TotalItems>51</TotalItems> 
    <TotalPages>6</TotalPages> 
    <DateCreated>2002-10-02</DateCreated> 
    <CustomerName>John Smith</CustomerName> 
  </List>
</Lists>  

デフォルトのレスポンスは、見つかったリストに関する要約情報を返します。この例は、John Smith が2つのほしい物リストをもっていることを示しています。最初のListIdが BR4444442H77 のリストには、70個の商品が含まれています。2番目のListIdが BR6666662H77 のリストには、51個の商品が含まれています。ほしい物リストの商品を返すには、これらのリストIDを使用して ListLookup オペレーションを実行します。

レスポンスから、ListIdがわかっていれば、URL: http://www.amazon.com/gp/registry/ListId を使用して直接リストを参照することもできます。上の例で、最初のListId は BR4444442H77 です。

	注意
	ListLookup では、BabyRegistry 内の商品にアクセスできません。現時点では、BabyRegistry 内の商品を表示する方法はありません。