【 ECS4.0 】
2005年12月20日

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