一部の商品は、さまざまなメディアフォーマットで販売されています。例えば、本には、ハードカバー、ペーパーバック、オーディオカセット、オーディオ CD、DVD などの形態があります。あるフォーマットの商品を購入するユーザは、異なるフォーマットの同じ商品に興味を持つ可能性があります。ある商品のすべてのメディアフォーマットを返すために、Product Advertising API には AlternateVersions レスポンスグループがあります。このレスポンスグループの難点は、Books または ForeignBooks の商品カテゴリでしか使用できないことです。つまり、 ItemSearch
および ItemLookup
で、サーチインデックスは Books か、ForeignBooks (US 以外のサイトの場合)にする必要があります。
ItemLookup
では、指定された商品は和書または洋書でなければなりません。
http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
Operation=ItemSearch&
AWSAccessKeyId=[AWS アクセスキー ID]
&
AssociateTag=ws&
SearchIndex=Books&
Keywords=potter&
MerchantId=All&
ResponseGroup=AlternateVersions&
Version=2006-06-28
このリクエストは、タイトルまたは商品の説明に "potter" を含む他のフォーマットの本およびメディアを返します。レスポンス例を次に示します。
<AlternateVersions> <AlternateVersion> <ASIN>030728364X</ASIN> <Title>Harry Potter and the Half-Blood Prince (Book 6) </Title> <Binding>Audio Cassette</Binding> </AlternateVersion> <AlternateVersion> <ASIN>0307283658</ASIN> <Title>Harry Potter and the Half-Blood Prince (Book 6) </Title> <Binding>Audio CD</Binding> </AlternateVersion> </AlternateVersions>
このレスポンスは、『Harry Potter and the Half-Blood Prince』という本が、オーディオカセットとCDで提供されていることを示します。