商品の状態(Condition)

商品の状態を設定します。状態とは新品や中古などについてです。書式は次の通りです。

Condition=<状態>

パラメータ名として「Condition」を使います。デフォルトでは「New」となっており指定しない場合には新品の商品のみが対象となります。設定可能な値は次の通りです。

指定する値	状態
New	新品
All	全ての商品
Used	中古
Collectible	収集品
Refurbished	修理品

状態を使って条件を設定するのは、商品に対して出品されている実際の出品商品の状態です。例えばある商品があり、Amazon自体は新品を出品していますがAmazon以外の出品者がマーケットプレイスに出品している場合があります。出品されたものは新品であったり中古品であったりしますが「Condition」パラメータで「All」や「Used」を指定した時には中古の出品商品情報を取得することができます。

「Condition」パラメータで「All」や「Used」を指定した場合でも、出品者IDである「MerchantId」パラメータはデフォルトで「Amazon」となっています。Amazonは新品しか出品しませんので中古品に関する情報を取得する場合には合わせて「MerchantId」パラメータに「All」などの設定を行う必要があります。(「MerchantId」パラメータについて詳しくは「出品者ID(MerchantId)」を参照して下さい)。

「Condition」パラメータはこのように出品商品に関する条件設定ですので、取得する結果に「Offer」要素が含まれている場合に意味を持ちます。

「Condition」パラメータが利用できる商品カテゴリーは次の通りです。

指定する値	利用可能かどうか
All	--
Apparel	○
Baby	○
Beauty	○
Blended	--
Books	○
Classical	--
DVD	--
Electronics	○
ForeignBooks	○
Grocery	○
HealthPersonalCare	○
Hobbies	○
Jewelry	--
Kitchen	○
Music	--
MusicTracks	○
Software	○
SportingGoods	○
Toys	○
VHS	--
Video	--
VideoGames	○
Watches	○

多くのカテゴリで利用可能です。

記述例としては次のようになります。下記の場合は新品だけではなく中古品も含む全ての商品が対象となります。

Condition=All

実際に使用する場合は次のようになります。

http://ecs.amazonaws.jp/onca/xml?
Service=AWSECommerceService
&AWSAccessKeyId=[AccessKey]
&Version=2009-07-01
&Operation=ItemSearch
&SearchIndex=Books
&Keywords=Java
&Condition=All
&MerchantId=All

サンプル

では簡単なサンプルで試しておきます。SearchIndexプロパティは「Books」、Keywordsプロパティは「村上春樹」です。そしてConditionプロパティを「Used」に設定しMerchantIdプロパティを「All」にしています。

http://ecs.amazonaws.jp/onca/xml?
Service=AWSECommerceService
&AWSAccessKeyId=[AccessKey]
&Version=2009-07-01
&ResponseGroup=Medium
&Operation=ItemSearch
&SearchIndex=Books
&Keywords=村上春樹
&Condition=Used
&MerchantId=All

※必要に応じてURLエンコードして下さい。

中古商品だけを検索し、各商品毎に中古商品の最低価格を表示しています。

AjaxTower