SimilarityLookup

説明

SimilarityLookup オペレーションは、リクエストで指定した1つまたは複数の商品の類似品を1ページに最大10個ずつ表示します。このオペレーションは、すでに注文した商品の類似品についてもカスタマーの購買意欲をかきたてるために使用するものです。

複数の商品を指定した場合、SimilarityLookupは、各商品が個別に返す類似品のうち同一のものを返します。また、SimilarityType パラメータを使用すれば、指定した任意の商品の類似品も全て返すことができます。最大10個の類似品が返されます。このオペレーションでは1ページ分の類似品しか返されません。10個を超える類似商品がある場合、レスポンスに含まれる10個の商品はランダムに抽出されるため、同じリクエストでも結果は異なる場合があります。結果がランダムに抽出されるのは、複数の商品を指定し、結果に10個を超える類似品が含まれる場合だけです。

複数の商品を指定した場合、類似品の中に同一商品がない可能性もあります。この場合、次のエラーが返されます。

<Error>
  <Code>AWS.ECommerceService.NoSimilarities</Code> 
  <Message>There are no similar items for this ASIN: B00006WREH.</Message> 
</Error>

商品が異なるサーチインデックスに属していると、このようなエラーがよく発生します。ただし、複数の商品が同じサーチインデックスに属している場合でもエラーは発生します。

類似性とは、類似品が購入されたことを示すものです。つまり、Xを購入したカスタマーがY、Zも購入したということであり、Xを見たカスタマーがY、Zも見ているということではありません。

返される商品は次の項目でフィルタリングできます。

  • MerchantId—All, Featured, または特定のマーチャント ID。 MerchantId パラメータに "Featured" を設定すると、リテール Web サイトの商品の詳細ページで "ショッピングカートに入れる" ボタンをクリックしたときに表示されるマーチャントを返します。デフォルト値は "Amazon" です。

  • Condition—商品のステータスの説明です。有効な値は、All、New (デフォルト) 、Used、Refurbished、Collectibleです。Availability パラメータが "Available" に設定されている場合、Condition パラメータを "New" に設定することはできません。

リスト上にある商品の類似品を返す。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=SimilarityLookup&ItemId=ASIN1,ASIN2,ASIN3
    

このリクエストは、各ASINの類似品のうち同一のものを返します。このリクエストに対するレスポンスをレスポンス例に示します。

指定した任意のASINの類似品を最大10個まで返す。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=SimilarityLookup&ItemId=ASIN1,ASIN2,ASIN3&
SimilarityType=Random
    

このリクエストは、指定した全てのASINの類似品を全て返します。返すことができる商品は10個までで、全ての類似品の中からランダムに抽出されます。このオペレーションを繰り返し実行すると、それぞれ異なる結果が得られます。

リクエストパラメータ

名前説明必須
Condition

商品のコンディションを指定します。Conditionが "All" に設定されている場合、Conditionの有効な値に対して個々のレスポンスセットが返されます。

タイプ: 文字列

デフォルト: New

有効な値: All | Collectible | Refurbished | Used

いいえ
ItemId

検索する商品を指定します。ItemId は、商品に割り当てられた半角英数字の文字列です。ItemId はカンマで区切って10個まで指定できます。

タイプ: 文字列

デフォルト: なし

有効な値: ASIN

はい
MerchantId

商品を出品しているマーチャントを指定します。MerchantId は Amazon がマーチャントに割り当てた半角英数字の ID です。Seller IDではなく必ずMerchant IDを使用してください。Seller IDはサポートされていません。

タイプ: 文字列

デフォルト: Amazon

有効な値:

MerchantId--マーチャントのID

All-- Amazon とほかの全てのマーチャント

Featured-- "Add to Cart (ショッピングカートに入れる)" をクリックしたときに表示されるマーチャント

いいえ
SimilarityType

"Intersection" を指定すると、指定した全ての ASIN の類似品のうち同一のものを返します。"Random" を指定すると、指定した ASIN の類似品を全て返します。10個の商品だけが返されます。10個を超える類似品がある場合は、そのグループの中からランダムに選択された商品が返されます。このため、同じリクエストを複数回実行すると、異なる結果が得られることになります。

タイプ: 文字列

デフォルト: Intersection

有効な値:Random

いいえ
ResponseGroup

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

タイプ: 文字列

デフォルト: Request | Small

有効な値: Accessories | BrowseNodes | EditorialReview | Images | Large | ItemAttributes | ItemIds | ListmaniaLists | Medium | Offers | OfferSummary | PromotionDetails | PromotionSummary | Reviews | SalesRank | Similarities | Tracks | VariationMinimum | Variations | VariationSummary |

いいえ

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

レスポンス例

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

<Item>
  <ASIN>B0009VX8XQ</ASIN> 
  <DetailPageURL>http://www.amazon.com/exec/obidos/redirect?tag=ws%26link_code=xm2%26camp=2025%26creative=165953%26path=http://www.amazon.com/gp/redirect.html%253fASIN=B0009VX8XQ%2526tag=ws%2526lcode=xm2%2526cID=2025%2526ccmID=165953%2526location=/o/ASIN/B0009VX8XQ%25253FAWSAccessKeyId=[AWS アクセスキー ID]</DetailPageURL> 
  <ItemAttributes>
    <ProductGroup>Apparel</ProductGroup> 
    <Title>Mark VII Men's Short Sleeve Herringbone Knit Golf Shirt</Title> 
  </ItemAttributes>
</Item>
<Item>
  <ASIN>B0009VX8VI</ASIN> 
  <DetailPageURL>http://www.amazon.com/exec/obidos/redirect?tag=ws%26link_code=xm2%26camp=2025%26creative=165953%26path=http://www.amazon.com/gp/redirect.html%253fASIN=B0009VX8VI%2526tag=ws%2526lcode=xm2%2526cID=2025%2526ccmID=165953%2526location=/o/ASIN/B0009VX8VI%25253FAWSAccessKeyId=[AWS アクセスキー ID]</DetailPageURL> 
  <ItemAttributes>
    <ProductGroup>Apparel</ProductGroup> 
    <Title>Mark VII Men's Short Sleeve Knit Golf Shirt</Title> 
  </ItemAttributes>
</Item>
  

このレスポンスは、指定したASINに2つの類似品があることを示しています。各商品に含まれている情報によって、出品中の商品を表示できます。

レスポンス

名前説明
ASIN 商品を一意に識別する半角英数字の文字列。
DetailPageURL 出品中の商品に関する情報が表示される Web ページのURL。
Item DetailPageURL、ItemAttributes、ASIN を含む、商品情報のコンテナ。
ItemAttributes ProductGroup および Title を含む、商品についての情報のコンテナ。
ProductGroup 商品が属するカテゴリ。サーチインデックスに似ています。
Title 出品中の商品の名前。

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

関連オペレーション

Similarities レスポンスグループを使用した ItemSearch リクエスト