SellerListingLookup

説明

SellerListingLookup オペレーションを使用すると、商品の説明、在庫状況、コンディション、在庫数などの、出品者による出品情報を返すことができます。レスポンスには、出品者のニックネームも含まれます。各リクエストではSeller IDが必要です。

出品者による出品商品を検索するには、 ItemLookupを使用することもできます。ただし、次の理由から SellerListingLookupを使用することをお勧めします。

  • SellerListingLookup では、Seller IDで検索できます。

  • SellerListingLookup は、 ItemLookup よりもずっと多くの情報を返します。

このオペレーションは、出品している商品数が10万個未満の出品者のみ使用できます。10万個以上の商品を出品している出品者に関しては、Product Advertising API の代わりに、Amazon在庫管理システムやマーチャント@ APIなどの他の出品者APIを使用する必要があります。

利用可能なサイト

全ての国のサイト

次のリクエストは、出品IDで指定した商品に関する情報を返します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=SellerListingLookup&
SellerId=[Seller ID]&
IdType=Listing&
Id=[Offer Listing ID]   

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

リクエストパラメータ

名前説明必須
ID

商品を一意に識別する番号。有効な値はIdTypeの値によって異なります。

タイプ: 文字列

デフォルト: なし

有効な値:Exchange ID | Listing ID | ASIN | SKU

はい
IdType

商品リストで返される出品情報をコンディションタイプでフィルタリングするには、IdTypeパラメータは、ID パラメータの種類の指定に使用します。Amazon マーケットプレイスの商品を検索する場合は、IdTypeの値に Exchange、ASIN、SKU のいずれかを使用します。もし IdType がListing、SKU、ASINのいずれかの場合、製造中止または在庫切れの商品は返されません。ただし、IdType がExchangeの場合は、これらの商品が返されます。

タイプ: 文字列

デフォルト: なし

有効な値: Exchange | Listing | ASIN | SKU

はい
SellerId

出品者を一意に識別する半角英数字の文字列。このパラメータは、結果を1つのSellerIDに限定します。

タイプ: 文字列

デフォルト: なし

有効な値: 有効なSeller ID

SellerId (IdType = Exchange である場合を除き必須.

条件付き
ResponseGroup

返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。

タイプ: 文字列

デフォルト: SellerListing (デフォルト)

いいえ

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

レスポンス例

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

<?xml version="1.0" encoding="UTF-8"?>
<SellerListing>
  <ExchangeId>Y11M6070795M8983336</ExchangeId>
  <ListingId>1108L899040</ListingId>
  <ASIN>8478888640</ASIN>
  <SKU>Y EL CALIZ DE FUEGO</SKU>
  <WillShipExpedited>0</WillShipExpedited>
  <WillShipInternational>0</WillShipInternational> &#8722; <Title> Harry
    Potter y El Caliz de Fuego (Spanish Edition) [Paperback] by Rowling, J. K.
  </Title> &#8722; <Price>
    <Amount>1390</Amount>
    <CurrencyCode>USD</CurrencyCode>
    <FormattedPrice>$13.90</FormattedPrice>
  </Price>
  <StartDate>2009-03-30</StartDate>
  <Status>Open</Status>
  <Quantity>3</Quantity>
  <Condition>new</Condition>
  <SubCondition>new</SubCondition> &#8722; <Seller>
    <SellerId>A3TWXQJ2WJKWBJ</SellerId>
    <Nickname>READERS</Nickname>
  </Seller>
</SellerListing>

レスポンス

名前説明
Amount 最低通貨単位(ペニーなど)を基準とした商品価格。
Availability 商品の発送可能時期。
CurrencyCode 金額の表示形式。
EndDate 商品の出品期限。
ExchangeId マーケットプレイス内の出品情報を一意に識別する文字列。Exchange IDは、第三者によって出品された全ての商品で使用できます。ExchangeId を使用する際には、該当する出品者 ID と ASIN も指定する必要があります。
FeaturedCategory FeaturedカテゴリーのブラウズノードID。Amazon と出品者の間の取り決めによって決まります。この値は、JP、FR、CAサイトでは返されません。
FormattedPrice Web サイトでの表示金額。
ListingId 商品を一意に識別する文字列。
NickName 出品者を識別する文字列。
Price Amount、CurrencyCode、FormattedPriceを含む、価格情報のコンテナ。
Quantity 商品の在庫数。
Seller SellerId および Nickname を含む、出品者情報のコンテナ。
SellerId 出品者を識別するトークン。
StartDate 商品の出品開始日。
Status 商品がまだ入手できる (オープン) かもう入手できない (クローズ) かを指定します。クローズ状態の商品は、製造中止または在庫切れになっている製品です。
Title 商品のタイトル。

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

関連オペレーション