 | ドキュメントのフィードバック |  |
SellerListingSearch オペレーションでは、特定の出品者が出品している商品を検索できます。マーチャントが出品している商品を SellerListingSearch で検索することはできません。マーチャントが出品している商品を検索するには、
ItemLookup
または
ItemSearch
を MerchantId パラメータとともに使用します。
SellerListingSearch は、商品の出品IDまたはExchange IDを返します。通常これらの値は、商品の詳細を検索する際に
SellerListingLookup
で使用します。
各 SellerListingSearch リクエストは、最大で10個の商品を返します。デフォルトでは、最初の10件の商品が返されます。商品の残りのページ (最大10ページまで) を表示するには ListingPage パラメータを使用します。
Product Advertising API を使用するには、出品している商品が10万個未満の出品者でなければなりません。10万個以上の商品を出品している出品者に関しては、Product Advertising API の代わりに、Amazon在庫管理システムやマーチャント@ APIなどのほかの出品者APIを使用する必要があります。
![[注]](images/note.png) | 注意 |
|---|---|
|
タイトルまたは商品の説明に "Newton" という単語が含まれる、マーケットプレイス内の商品を検索し、価格の高い順に商品を並べ替えます。
http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=SellerListingSearch&
SellerId=[A Seller ID]&
Keywords=Newton&
Sort=+price&
OfferStatus=Open このリクエストに対するレスポンスをレスポンス例に示します。
| 名前 | 説明 | 必須 |
|---|---|---|
ListingPage
|
返されるレスポンスのページ。ページあたり最大10件のリストが返されます。10件を超えるリストがあるカスタマーの場合、複数の結果ページが返されます。デフォルトでは最初のページが返されます。別のページを返すには、ページ番号を指定します。 タイプ: 正の整数 タイプ: 文字列 デフォルト: 1 制約: 最大値は500です。 | いいえ |
OfferStatus
|
商品が入手できる (Open) か入手できない (Closed) かを指定します。クローズ状態 (Closed) の商品は、製造中止または在庫切れになっている製品です。 タイプ: 文字列 デフォルト: Open 有効な値:Closed | いいえ |
SellerId
|
出品者を一意に識別する半角英数字の文字列。これらの文字列は、Amazon によって作成され、出品者に割り当てられます。 有効な値: 有効なSeller ID | はい |
Sort
|
Sortパラメータにより、出品者の出品情報の検索結果の並べ替え方法が指定できます。-bfp (Featuredリスト、デフォルト) は、US、UK、DEサイトにのみ適用されます。 タイプ: 文字列 デフォルト: なし 有効な値: -startdate | startdate | +startdate | -enddate | enddate | -sku | sku | -quantity | quantity | -price | price | +price | -title | title | いいえ |
Title
|
商品名に基づいて商品を検索します。KeywordsとTitleは相互に排他的であり、各リクエストではどちらか一方しか指定できません。 タイプ: 文字列。値に複数の単語を指定する場合は、スペースを%20としてURLエンコードします。単語の順序は識別されず、大文字と小文字も区別されません。 タイプ: 文字列 デフォルト: なし | いいえ |
ResponseGroup
|
返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。 タイプ: 文字列 デフォルト: SellerListing | いいえ |
SellerListingSearch には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。
次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。
<SellerListing>
<ExchangeId>Y02Y3120110Y3481102</ExchangeId>
<ListingId>0411W027887</ListingId>
<Title>Spartas, Dale C. (photographs by) and Steve Smith (text by): Just Labs</Title>
<Price>
<Amount>2200</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$22.00</FormattedPrice>
</Price>
<StartDate>2001-04-11</StartDate>
<EndDate>2004-03-26</EndDate>
<Status>Open</Status>
<Quantity>1</Quantity>
<Availability>Usually ships within 1-2 business days</Availability>
<Seller>
<SellerId>A3U5ACHDJ10963</SellerId>
<Nickname>alphabooks</Nickname>
</Seller>
</SellerListing>
<SellerListing>
<ExchangeId>Y01Y1679802Y5496404</ExchangeId>
<ListingId>0829W011414</ListingId>
<Title>Incredible Journey,Quad Movie Poster, 40" x 30",1963</Title>
<Price>
<Amount>1975</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$19.75</FormattedPrice>
</Price>
<StartDate>2004-08-29</StartDate>
<EndDate>2007-08-14</EndDate>
<Status>Open</Status>
<Quantity>1</Quantity>
<Availability>Usually ships within 1-2 business days</Availability>
<Seller>
<SellerId>A1ZKKOH0E9LH0B</SellerId>
<Nickname>nostalgia_dot_com</Nickname>
</Seller>
</SellerListing>| 名前 | 説明 |
|---|---|
Amount
| 最低通貨単位（ペニーなど）を基準とした価格。 |
Availability
| 商品の発送可能時期。 |
CurrencyCode
| 金額の表示形式。 |
EndDate
| 商品の出品期限。 |
ExchangeId
| マーケットプレイス内の出品情報を一意に識別する文字列。Exchange IDは、第三者によって出品された全ての商品で使用できます。ExchangeId を使用する際には、該当する出品者 ID と ASIN も指定する必要があります。 |
FormattedPrice
| Web サイトでの表示金額。 |
ListingId
| 商品を一意に識別する文字列。 |
NickName
| 出品者を識別する文字列。 |
Price
| Amount、CurrencyCode、FormattedPrice を含む、価格情報のコンテナ。 |
Quantity
| 商品の在庫数。 |
Seller
| SellerId および Nickname を含む、出品者情報のコンテナ。 |
SellerId
| 出品者を識別するトークン。 |
StartDate
| 商品の出品開始日。 |
Status
| 商品がまだ入手できる (Open) かもう入手できない (Closed) かを指定します。クローズ状態 (Closed) の商品は、製造中止または在庫切れになっている製品です。 |
Title
| 商品のタイトル。 |
これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。
