在庫のある商品だけを返す

ItemSearch は在庫がある商品と在庫がない商品を返します。在庫がない商品とは、例えば、一時的に在庫切れになっている商品です。Availability パラメータに "Available” を設定することで、 ItemSearch で在庫がない商品のほとんどを除外することができます。次の ItemSearch リクエストは在庫があるシャツを返します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemSearch&
MerchantId=All&
Condition=All&
Availability=Available&
SearchIndex=Apparel&
Keywords=Shirt

このパラメータで指定できる値は “Available” だけです。他の値を設定するとエラーメッセージが返されます。デフォルトでは、値は設定されていません。

在庫がある商品は、Amazon リテール Web サイトで次のように分類されています。

商品の在庫状況は随時変化します。通常、 ItemSearch によって返される在庫状況の情報と、Amazon の Web サイトで表示されるリアルタイムの在庫情報の間にはタイムラグがあります。このため、 ItemSearch で返される在庫状況と、Amazon の Web サイトにおける在庫状況には若干の差異が生じることになります。これらの違いは、ソフトウェアのように在庫状況が頻繁に変化する商品において最も顕著です。

[注]注意

Availability パラメータを、返される要素の Availability と混同しないでください。後者は、 "48時間以内に発送" のように、商品をどれだけ迅速に発送できるかを示す、レスポンス内の要素です。これは表示に便利な値ですが、本当に商品の在庫があり購入できることを保証するものではありません。在庫の判断には、Offers、OfferFull、Largeの各レスポンスグループで返されるOfferListingIdを確認します。