商品の状態(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エンコードして下さい。

商品の状態(Condition)

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

( Written by Tatsuo Ikura )

関連記事 (一部広告含む)