OfferSummaryについて
OfferSummary レスポンスグループは、レスポンスの各商品に対し、出品情報の数とコンディションタイプごとの最低価格を返します。
コンディションタイプには、New、Used、Collectible、Refurbished があります。
そのため、例えばこのレスポンスグループは、コンディションごとに最低価格を返します。・新品 (New)
・中古商品 (Used)
・コレクター商品 (Collectible)
・再生商品 (Refurbished)個別の出品情報は返されません。
OfferSummary は ASIN パラメータのみに基づいて返され、MerchantId や Condition パラメータによる影響は受けません(すなわちOfferSummary は、他のパラメータとの関連を持たず、指定した ASIN に対してのみ返されます)。[Amazon Product Advertising API 開発者ガイドより引用]
レスポンス要素
グループに含まれるレスポンス要素は以下の7つです。
■Amount
最低通貨単位(ペニーなど)を基準とした、カート内の商品価格。
■CurrencyCode
指定された国の価格の通貨表示の略語。
■FormattedPrice
ユーザーへの表示用に書式設定された価格。形式は CurrencyCode で指定され、国によって異なります。または、表示用に書式設定された割引後の価格。
■TotalCollectible
出品されているコレクター商品の合計数。
■TotalNew
出品されている新品の合計数。
■TotalRefurbished
出品されている新品同様の商品の合計数。
■TotalUsed
出品されている中古商品の合計数。
レスポンスXMLのサンプル
今回対象にした商品は以下のもの。
Nintendo Switch Joy-Con (L) ネオンブルー/ (R) ネオンレッド
<Item> <ASIN>B01NCXFWIZ</ASIN> <ParentASIN>B01NBWQWTF</ParentASIN> <OfferSummary> <LowestNewPrice> <Amount>39800</Amount> <CurrencyCode>JPY</CurrencyCode> <FormattedPrice>¥ 39,800</FormattedPrice> </LowestNewPrice> <LowestUsedPrice> <Amount>39500</Amount> <CurrencyCode>JPY</CurrencyCode> <FormattedPrice>¥ 39,500</FormattedPrice> </LowestUsedPrice> <LowestCollectiblePrice> <Amount>43500</Amount> <CurrencyCode>JPY</CurrencyCode> <FormattedPrice>¥ 43,500</FormattedPrice> </LowestCollectiblePrice> <TotalNew>179</TotalNew> <TotalUsed>24</TotalUsed> <TotalCollectible>1</TotalCollectible> <TotalRefurbished>0</TotalRefurbished> </OfferSummary> </Item>
データ取得時の状態別価格表示は以下の通り。