 | ドキュメントのフィードバック |  |
商品IDを指定すると、 ItemLookup オペレーションは、リクエストで指定したレスポンスグループに従って、一部または全ての商品属性が返します。デフォルトでは、 ItemLookup は商品のASIN, DetailPageURL, Manufacturer, ProductGroup および Title を返します。
ItemLookup は、多数のレスポンスグループをサポートしています。このため、商品レビュー、バリエーション、類似品、価格、在庫状況、商品画像、アクセサリなど、商品属性と呼ばれるさまざまな情報を取得できます。
複数の商品を一度に検索するには、商品IDをカンマで区切ります。
全ての国のサイト。ただし、パラメータのサポートは各国のサイトごとに異なります。
| 名前 | 説明 | 必須 |
|---|---|---|
Condition
|
商品のコンディションを指定します。Condition が "All" に設定されている場合、Condition の有効な値に対して個々のレスポンスセットが返されます。デフォルト値は "New" です（ "All" ではありません）。リクエストで結果が何も返されない場合は、値を "All" に設定してみてください。値が "New" の場合、ItemSearch の Availability パラメータに "Available" を設定することはできません。Amazonでは、"New" の商品だけを販売しています。 タイプ: 文字列 デフォルト: New 有効な値: Used | Collectible | Refurbished | All | いいえ |
IdType
|
商品の検索に使う商品IDの種類。全ての タイプ: 文字列 デフォルト: ASIN 有効な値: SKU | UPC | EAN | ISBN (US のみで、サーチインデックスが Books の場合有効) | JAN. UPCはCAサイトでは無効です。 | いいえ |
ItemId
|
商品を一意に識別する1～10の整数。数値の意味は タイプ: 文字列 デフォルト: なし 有効な値: 有効な商品ID。カンマで区切ったリストを使用することで、最大10までIDを指定できます。 | はい |
MerchantId
|
商品を出品しているマーチャントを指定します。 出品者 ID ではなく必ずマーチャント ID を使用してください。出品者 ID はサポートされていません。 タイプ: 文字列 デフォルト: Amazon 有効な値: MerchantId--マーチャントのID | All--Amazonとその他全てのマーチャント | Featured-- "ショッピングカートに入れる" をクリックしたときに表示されるマーチャント | いいえ |
OfferPage
|
タイプ: 文字列 デフォルト: 1 有効な値: 1～ 100までの整数 | いいえ |
RelatedItemsPage
| このオプションパラメータは、RelatedItemsレスポンスグループを使用する場合にのみ有効です。各 ItemLookup
リクエストは、最大で10個の関連商品を返します。RelatedItemsPage の値には、受け取りたい関連商品の10のセットを指定します。例えば、値に 2を指定すると、10個ずつひとまとまりとした場合の2番目の関連商品を返します。 | いいえ |
RelationshipType
| このパラメータは、RelatedItemsレスポンスグループを使用する場合に必要です。受け取りたい関連商品の種類がRelationshipType パラメータで指定されます。値の例としては、Episode、Season、Tracks があります。 全てのタイプの一覧については、 関連商品のタイプ をご参照ください。制約: RelatedItems レスポンスグループを使用する場合は必須です。 | はい |
ReviewPage
|
タイプ: 文字列 デフォルト: 1 有効な値: 1～ 20までの整数 | いいえ |
ReviewSort
|
返されるレビューの並べ替え順序を指定します。詳細については、 レビューの並べ替え をご参照ください。 タイプ: 文字列 デフォルト: -SubmissionDate 有効な値: -HelpfulVotes | HelpfulVotes | -OverallRating | OverallRating | SubmissionDate | いいえ |
SearchIndex
|
検索対象の商品カテゴリ。 タイプ: 文字列 デフォルト: なし 有効な値: サーチインデックス名。例えば、Apparel, Beauty, Blended, Books などです。 サーチインデックスの一覧については、 国ごとに使用可能なサーチインデックス をご参照ください。 制約: | 条件付き |
TagPage
|
返される結果のページを指定します。各ページに10件の結果が表示されます。 タイプ: 整数 タイプ: 文字列 デフォルト: なし 制約: 最大ページ数は 400ページです。 | いいえ |
TagsPerPage
|
指定された商品に関連して返されるタグの数。 タイプ: 整数 タイプ: 文字列 デフォルト: なし | いいえ |
TagSort
|
結果の並べ替え順序を指定します。 タイプ: 文字列 デフォルト: - Usages 有効な値:
商品を降順に並べ替えるには、値の先頭にマイナス記号(-)を付けます。 | いいえ |
VariationPage
|
タイプ: 文字列 デフォルト: All 有効な値: 1～ 150までの整数 | いいえ |
ResponseGroup
|
返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。 有効な値: Accessories | BrowseNodes | EditorialReview | Images | ItemAttributes | ItemIds | Large | ListmaniaLists | Medium | MerchantItemAttributes | OfferFull | Offers | PromotionDetails | PromotionSummary | OfferSummary| RelatedItems | Reviews | SalesRank | Similarities | Subjects | Tags | TagsSummary | Tracks | VariationImages | VariationMinimum | Variations (US のみ) | VariationSummary | いいえ |
ItemLookup には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。
| 名前 | 説明 |
|---|---|
ASIN
| Amazon Standard Identification Number の略。Amazon によって割り当てられた、商品を一意に識別する半角英数字の文字列です。 |
Item
| DetailPageURL および ASIN, Title, ProductGroup, および、Manufacturer を含む、商品についての情報のコンテナ。
|
ItemAttributes
| 商品に関する情報のコンテナ。Title, ProductGroup. およびManufacturer を含む、商品についての情報のコンテナ。
|
Items
| 1つまたは複数の商品のコンテナ。 |
Manufacturer
| 商品を製造した会社の名前。 |
ProductGroup
| 商品のカテゴリー（例: "Book"、"DVD"）。完全な商品グループの一覧を参照するには、www.amazon.co.jp を開き、 "すべてのカテゴリーを見る" という文字をクリックしてください。 |
Title
| 商品のタイトル。 |
これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。
次のリクエストは、ItemId B00008OE6I に関する情報を返します。
http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=B00008OE6I このリクエストに対するレスポンスをレスポンス例に示します。
次のリクエストは、Amazon からは出品されていない新品同様の商品の出品情報を返します。
http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=B00008OE6I&
IdType=ASIN&
ResponseGroup=OfferFull&
Condition=All&
MerchantId=All この例では、商品が Amazon から出品されているわけではないため、値としてCondition=All および MerchantId=All または特定マーチャントのIDを指定する必要があります。
次のリクエストでは、ItemIdがSKUであるため、MerchantId と IdTypeも指定する必要があります。A MerchantIdの値が必要なのは、デフォルト値が "Amazon" であり、Amazon によって出品されている商品はSKU値では識別されないためです。
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS アクセスキー ID]& Operation=ItemLookup& ItemId=[SKU]& MerchantId=[MerchantID]& IdType=SKU
次のリクエストでは、ItemIdがUPCであるため、SearchIndexおよび、ItemTypeも指定する必要があります。
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS アクセスキー ID]& Operation=ItemLookup& ItemId=[UPC]& SearchIndex=Books& &IdType=UPC
次のリクエストでは、ItemIdがEANであるため、SearchIndex および ItemType.も指定する必要があります。
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS アクセスキー ID]& Operation=ItemLookup& ItemId=[EAN]& SearchIndex=Electronics& IdType=EAN
商品のブラウズノードを検索するには、BrowseNodes レスポンスグループを使用します。
レスポンスで各CDのトラック、タイトル、各トラック番号を検索するには、Tracks レスポンスグループを使用します。
レスポンスで返される類似品のASINとタイトルを検索するには、Similarities レスポンスグループを使用します。
レスポンスで、カスタマーによる商品のレビューと、各商品のレビューの総数を検索するには、Reviews レスポンスグループを使用します。
出品情報の数と、新品、中古商品、コレクター商品、新品同様の商品の各コンディションクラスの最低価格を検索するには、OfferSummary レスポンスグループを使用します。
レスポンスで、アクセサリがある商品ごとにアクセサリのASINとタイトルを検索するには、Accessories レスポンスグループを使用します。
次のコードは最初のリクエストに対するレスポンスの一部です。デフォルトで返される全ての商品属性が示されています。
<Items>
<Request>
<IsValid>True</IsValid>
<ItemLookupRequest>
<ItemId>B00008OE6I</ItemId>
</ItemLookupRequest>
</Request>
<Item>
<ASIN>B00008OE6I</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=B00008OE6I%2526tag=ws%2526lcode=xm2%2526cID=2025%2526ccmID=165953%2526location=/o/ASIN/B00008OE6I%25253FAWSAccessKeyId=[AWS アクセスキー ID]</DetailPageURL>
<ItemAttributes>
<Manufacturer>Canon</Manufacturer>
<ProductGroup>Photography</ProductGroup>
<Title>Canon PowerShot S400 4MP Digital Camera w/ 3x Optical Zoom</Title>
</ItemAttributes>
</Item>
</Items> 