ECS4.0

2005年12月20日 はてなブックマーク livedoorクリップ

OperationとResponseGroupの一覧

ECS4.0はAWS3.0に比べかなり柔軟ですが、なにぶん数が多いのでここにメモを残しておきます。

"Version:2005-10-05"のマニュアルを参考にしています。
また、(私が)よく使うものには色をつけています。

まずは、"Operations"(オペレーション)の一覧。
とはいえ、"ItemSearch"・"ItemLookup"があれば基本的に事足りますが・・・
意外に"Help"オペレーションは「ツールを作れば」役に立ったりします。


[Operations一覧]

[商品情報]

ItemLookup ASINコード等から特定の商品の情報を検索。
ItemSearch 指定した条件(キーワード等)に合わせて商品を検索。
SimilarityLookup 関連商品の検索。


[リスト情報]

ListLookup リスト(リストマニア、ウィッシュリスト等)から特定の商品情報を検索。
ListSearch リストから商品を検索。


[ショッピングカート]

CartAdd ショッピングカートに商品を追加。
CartClear ショッピングカートの中身をクリア。
CartCreate 新しくショッピングカートを作成。
CartGet ショッピングカートの中身を検索。
CartModify カート内の商品の数量変更や削除。


[出品者情報]

SellerLookup 出品者に対する情報を検索。
SellerListingLookup マーケットプレイス(またはzShop)の商品を検索。
SellerListingSearch 指定した条件に合わせてマーケットプレイスの商品を検索。


[顧客情報]

CustomerContentLookup 日本未実装?
CustomerContentSearch 日本未実装?
TransactionLookup 日本未実装?


[その他]

Help ヘルプ機能。操作と応答グループに関する情報を検索。
BrowseNodeLookup ブラウズノードに関する情報を検索。



次にResponseGroupsの一覧。度忘れした時に役立つと思います(ノ∀`)。


[ResponseGroups一覧]

Accessories アクセサリー(デジカメならバッテリーやメモリカード等)の情報
BrowseNodeInfo ブラウズノードの情報(Operation=BrowseNodeLookup用)
BrowseNodes ブラウズノードの情報(Operation=ItemLookup等用)
Cart CartId、HMAC識別子、PurchaseURL等リモートショッピングカートの為の情報
CartNewReleases ※日本未実装
CartTopSellers ※日本未実装
CartSimilarities カート内の商品と関連のある商品情報
CustomerFull ResponseGroupのセット。
CustomerInfo、CustomerLists、CustomerReviewsを指定した場合と同じ
CustomerInfo 顧客情報。CustomerId、Name、Nickname、およびLocation(公開されている情報のみ)
CustomerLists 顧客情報。WishListId
CustomerReviews 顧客によるレビューの情報
EditorialReview Amazon.co.jpからの商品紹介情報
Help リクエストしたOperationとResponseGroupsの情報
Images 商品画像の情報。一つの画像につきSmall,Medium,Largeの3つを返します。つまり一つの商品に対して2種類の画像があれば、3×2=6個の画像を返します。
ItemAttributes 各商品に付随する情報(タイトルや商品のサイズ、フォーマット、発売日等。商品カテゴリ毎によっても異なる)
ItemIds ASINコードの情報。ItemSearchの場合は検索結果の総数とページ数も提供する。
Large ResponseGroupのセット。
Medium、Tracks、BrowseNodes、Reviews、 ListmaniaLists、Similarities、Offers、Accessoriesの全てを指定した場合と同じ
ListFull ResponseGroupのセット。
ListInfo、ListItemsを指定した場合と同じ
ListInfo リスト(ウィッシュリスト等)の情報。ListMinimumの情報+リスト作成者+リスト作成日
ListItems リストの入っている商品の情報
ListmaniaLists リストマニアのリスト情報
ListMinimum ListIdのみ
Medium ResponseGroupのセット。
Small, Request, ItemAttributes, OfferSummary, SalesRank, EditorialReviewの全てを指定した場合と同じ
NewReleases ※日本未実装
OfferFull Offers+出品者のニックネーム+Location等
Offers OfferSummary+各々の出品商品の情報
OfferSummary 出品者リストの数とその最低価格の情報(新品、中古品を含む)
Request リクエストした内容の情報
Reviews 顧客レビューのリスト、平均したランク(1~5)、およびレビューの総数
SalesRank SalesRankの情報。
※Sortでのsalesrankの順位とは一致していないようです。
SearchBins ※日本未実装
Seller 出品者の情報
SellerListing マーケットプレイスのリスト情報
Similarities 関連商品情報
Small ASINコード、商品URL、ItemAttributesの一部の情報等、最小限のデータ情報を包括
Subjects 書籍のサブ名称の情報
TopSellers ※日本未実装
Tracks CDの各トラックナンバーとタイトル情報
TransactionDetails アマゾンの取引に関する情報
VariationMinimum 子ASINコードの情報(同じ商品の色違い等があった場合等)
Variations ResponseGroupのセット。
VariationMinimum、VariationSummary
VariationImages 子ASINコードの画像情報
VariationSummary 子ASINコードの価格情報

※自分なりに英語のマニュアルを辞書を引き引き調べたデータなので、内容間違ってたらすいません。
※実装・未実装についても全てチェックした訳ではないので、使えないかもしれません。


投稿者 shiz : 2005年12月20日 20:03

トラックバック

このエントリーのトラックバックURL:
http://mt.amonya.com/mt-tb.cgi/5

※トラックバックのリンク確認後に掲載させて頂きます。
(当エントリー又は当サイトへのリンクがない場合は掲載しません)

コメント

はじめまして。
このブログのとても有用な記事の数々を拝見させていただきまして、とても感謝しております。

ところで質問なのですが、
ある商品のマーケットプレイス出品リスト一覧(価格含む)を得たいと思って以下のリクエストを実行したところ、最低価格が付いている出品物の情報(LowestUsedPrice)しか得られませんでした。最低価格以外の物も含めた情報を取得するには、リクエストのどこを直せば良いのか、教えていただけませんでしょうか。

http://webservices.amazon.co.jp/onca/xml
?Service=AWSECommerceService
&AWSAccessKeyId=******
&Operation=ItemLookup
&ItemId=******
&MerchantId=All
&ResponseGroup=OfferFull

投稿者 DHA : 2006年05月03日 05:05

DHAさん、はじめまして。

MerchantId指定までは、非常にいい線いってました。おしかったです。
実際にはMerchantId、Condition、OfferPageの組み合わせでおそらくご希望のデータが取得できます。
[例]MerchantId=All&Condition=All(OfferPageでページ選択)

Condition(新品、中古)がデフォルト値でNew(新品のみ表示)なのが原因ですね。

投稿者 シズマル(管理人) : 2006年05月03日 10:06

シズマルさん、ご返答いただきましてありがとうございます。

教えていただいた通りに試してみたところ、目的の結果が得られました!
どうもありがとうございます!!

正直言ってAWSの公式の開発情報サイトは情報を発見しづらい構成で、しかも英語なので余計に分かりづらくて苦労するので、僕の中ではシズマルさんのブログを「公式」リファレンスとして活用させていただいてます(笑)。

これだけ分かりやすくまとめられるのは、相当な技術力とご経験、そして高い文章力があるからだと思います。
これからもぜひシズマルさんならではの有用で価値のある記事を期待しております。
どうもありがとうございました。

投稿者 DHA : 2006年05月04日 08:20

>DHAさん

ほ、ほめ殺しですか!?(笑

私もまだまだビギナーですよ。
WEB系の勉強を始めたのは昨年からですし。それまではCGIもJavascriptも、もちろんECS(AWS)も全然知りませんでした(英語の技術文献は多少読みなれていましたが)。まだまだブログ内の情報も少ないですしね。

とはいえ、DHAさんの言葉を励みにブログを充実させていきたいと思います。お互いがんばっていきましょう。

投稿者 投稿者 シズマル(管理人) : 2006年05月04日 09:05

コメントしてください




保存しますか?