VariationImages レスポンスグループ

VariationImages レスポンスグループは、同じ商品のさまざまな画像のバリエーションを4サイズ（スウォッチ、小、中、大）表示します。スウォッチ画像は小サイズの画像よりも小さな画像です。 VariationImages は、出品商品のバリエーションがある場合に使われます。例えば、シャツの色が4色あるとします。VariationImages をレスポンスグループとして使用すると、シャツの画像は16種類（4色4サイズ）表示されます。

返される画像は、商品を出品しているマーチャントに関連付けられています。そのため、VariationImages レスポンスグループを使用する際には、リクエストでマーチャントIDを指定する必要があります。MerchantId のデフォルトは "Amazon" です。ただし、商品が Amazon によって出品されている場合、MerchantId は指定しなくてもかまいません。Amazon 以外のマーチャントが商品を出品しているのに MerchantId を指定していない場合、Product Advertising API は画像を返しません。

親 ASIN には画像が関連付けられていないこともありますが、その子には画像が関連付けられています。

レスポンス要素

次の表では、VariationImages によって返される要素について説明しています。「親」列で、スラッシュ記号の左側の要素は親、右側の要素はその子です。

VariationImages は、全てのレスポンスグループに共通のレスポンス要素に示されている、全てのレスポンスグループが返す要素も返します。

親レスポンスグループ

次のレスポンスグループは、VariationImages の親レスポンスグループです。

なし

子レスポンスグループ

次のレスポンスグループは、VariationImages の子レスポンスグループです。

なし

REST 利用例

次のリクエストを使用して、VariationImages によって返されるXMLレスポンス要素を説明しています。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=
        [AWS アクセスキー ID]
      &
Operation=ItemLookup&
ItemId=0239409223&
ResponseGroup=VariationImages

レスポンス例

次のレスポンスの例は、VariationImages で返される要素をまとめたものです。

<ImageSets>
  <ImageSet Category="primary">

  <SmallImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01._SCTHUMBZZZ_.jpg
    </URL>
    <Height Units="pixels">60</Height>
    <Width Units="pixels">60</Width>
  </SmallImage>

  <MediumImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01._SCMZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">140</Height>
    <Width Units="pixels">140</Width>
  </MediumImage>

  <LargeImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01._SCLZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">500</Height>
    <Width Units="pixels">500</Width>
    </LargeImage>
    </ImageSet>
  <ImageSet Category="variant">

  <SmallImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01.PT01._SCTHUMBZZZ_.jpg
    </URL>
    <Height Units="pixels">48</Height>
    <Width Units="pixels">60</Width>
  </SmallImage>

  <MediumImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01.PT01._SCMZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">120</Height>
    <Width Units="pixels">150</Width>
  </MediumImage>

  <LargeImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01.PT01._SCLZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">400</Height>
    <Width Units="pixels">500</Width>
  </LargeImage>

</ImageSet>