AmazonAPI レスポンスグループ補足説明（OfferSummary）

- 目次 -

1 OfferSummaryについて
- - 1.0.1 レスポンス要素
  - 1.0.2 レスポンスXMLのサンプル

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>

データ取得時の状態別価格表示は以下の通り。