AWS(Amazon Web Service) - OperationとResponseGroupの一覧
リクエスト作成にあたり、調べてみました。なお最新の情報ではないですが、これをもとに試してみて今のところ不自由はありません。以下羅列。
Operations一覧
[商品情報]
- ItemLookup ASINコード等から特定の商品の情報を検索。
- ItemSearch 指定した条件(キーワード等)に合わせて商品を検索。
- SimilarityLookup 関連商品の検索。
[リスト情報]
- ListLookup リスト(リストマニア、ウィッシュリスト等)から特定の商品情報を検索。
- ListSearch リストから商品を検索。
[ショッピングカート]
- CartAdd ショッピングカートに商品を追加。
- CartClear ショッピングカートの中身をクリア。
- CartCreate 新しくショッピングカートを作成。
- CartGet ショッピングカートの中身を検索。
- CartModify カート内の商品の数量変更や削除。
[出品者情報]
- SellerLookup 出品者に対する情報を検索。
- SellerListingLookup マーケットプレイス(またはzShop)の商品を検索。
- SellerListingSearch 指定した条件に合わせてマーケットプレイスの商品を検索。
[顧客情報]
- CustomerContentLookup 日本未実装?
- CustomerContentSearch 日本未実装?
- TransactionLookup 日本未実装?
[その他]
- Help ヘルプ機能。操作と応答グループに関する情報を検索。
- BrowseNodeLookup ブラウズノードに関する情報を検索。
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コードの価格情報
-– 注意点 —
*Versionを指定しないと、その時点での最新Versionでレスポンスになる
*ResponseGroupパラメータは組み合わせ可能。最低限の情報と関連商品の情報を取得したい場合は「ResponseGroup=Small,Similarities」という風にカンマ区切りで複数パラメータを指定する。
*最新のSearchIndexを取得するには、でたらめなSearchIndexを指定してリクエストすると、エラーが発生するが、その中に有効なSearchIndexのリストが書いてある
*Keywordsに日本語を使用する場合は、UTF-8でURLエンコードする
*2005年12月20日情報
フォーマット・その他
[フォーマット] ContentType :フォーマット
&ContentType
= text/xml (結果をXMLで取得したい場合)
= text/html (結果をHTMLで取得したい場合)
※PerlやPHPなどスクリプトで処理⇒XMLデータ、ブラウザでそのまま表示など⇒HTML
[取得するページの指定] Page : 取得する検索結果のページ指定
&Page= 1 ( 1~検索結果の数に応じて任意の数字)
※通常は、1ページにつき10個の商品が検索結果として返ってきます
※リクエスト・パラメータを組み合わせることで、10個以上の商品を取得することもできるのですが、それはまたの機会に
※例えば「インターネット」という単語で検索した場合、4871件の商品がマッチするので、480ページあることになります
このページ指定は、主にナビゲーションなどで利用するのですが、特定のページを指定する必要が無い場合でも、Page=1と指定しておく必要があります。
[Version] Version : ECSのバージョン情報
&Version= 2004-10-04 (任意のバージョンを指定)
※特に、トラブルになりやすいのは、XSLT機能を利用している時です。変換ルールとして自作するXSLT内ではXMLのnamespaceとしてVersionを指定するのですが、RESTリクエスト内のVersionと、XSLT内のnamespaceで指定するバージョンが異なっていると、XSLT変換が行われず、期待するレスポンスを受け取れません
※RESTリクエストでVersionを指定しないと、デフォルトとして最新のVersionとみなされるので、スクリプトを開発したときは、問題なく動いていても、アマゾンが新しいVersionにアップデートした段階で、動作しなくなります
ここはECS4.0のハマリどころなので(僕もはまりました)、しっかりVersionを指定しましょう
[商品の種類] &SearchIndex : 商品の種類
&SearchIndex= Blended (すべての商品)
Books (和書)
Music (音楽)
MusicTracks (曲名から調べる)
Classical (クラシック音楽)
Video (DVD&VHS)
DVD (DVD)
VHS (VHS)
VideoGames (ゲーム)
Electronics (家電 エレクトロニクス)
Kitchen (ホーム&キッチン)
Toys (おもちゃ&ホビー)
Software (PC ソフトウェア)
※Blendedを指定すると、すべての商品から検索されますが、1種類あたりの商品数が少なくなってしまうので、詳細検索の際には各商品種別を指定する必要があります
[XSLTファイルのURLを指定] &Style : XSLTファイルのURL
&Style= http://www.my-web.com/xsl/my.xsl (自分で作成したXSLTファイルのURL)
[Operation=ItemSearchの場合の検索キー] &Keywords= 検索したいキーワード
&BrowseNode= BrowseNode番号 (Amazonのカテゴリごとのベストセラーを取得)
※Operation=ItemLookupを選択した場合は、ASINなどのID番号の種類と、番号の2種類を指定して検索します。
[Operation=ItemLookupの場合の検索キー] &IdType=ASIN&ItemId= 検索したいASIN番号
BrowseNode ID 一覧
- &SearchIndex=Books&BrowseNode=
466300 新刊
466284 文学 小説
571582 哲学 地域
571584 社会 政治
492152 ノンフィクション
466286 旅行 地理
466282 ビジネス キャリア
492054 投資
466298 コンピューター ネット
466294 アート 写真集
466296 エンターテイメント
466292 スポーツ ホビー
466304 ホーム ファミリー
466302 外国語
466306 子供向け
466280 マンガ アニメ
746102 楽譜
13384021 雑誌
- &SearchIndex=DVD&BrowseNode=
562014 邦画
562016 洋画
562018 音楽
562020 アニメ
562022 ホビー フィットネス
562024 スポーツ
562026 ファミリー
562028 ドキュメンタリー
564522 DVDボックス
896246 アダルト
- &SearchIndex=Electronics&BrowseNode=
3371371 デジタル カメラ
3371441 DVDプレーヤー
3371411 ポータブル音楽機器
3371341 コンピューター
3371351 PC周辺機器
3371361 プリンタ スキャナ
3371381 ネットワーク機器
3371401 PDA
3371421 アクセサリ
3371391 メモリーカード HDD
3371431 オーディオ ビジュアル
- &SearchIndex=Music&BrowseNode=
569170 J-POP
569290 ポップ
569292 ロック
569298 ハードロック
562050 ブルース カントリー
569318 ソウル R&B
569320 ヒップホップ
569322 ダンス
562052 ジャズ フュージョン
562056 ワールド
562064 ニューエイジ
562058 サウンドトラック
562060 アニメ
562062 子供 ファミリー
569174 バラード
569186 伝統音楽
899296 スポーツ
- &SearchIndex=VideoGames&BrowseNode=
637874 プレイステーション2
637876 プレイステーション
637878 Nintendo Gamecube
637880 ゲームボーイ アドバンス
637882 ゲームボーイ
639096 Xbox
637886 その他
-– 注意点 —
*2004年10月26日時点
▼参考
http://www.goodpic.com/mt/archives2/2004/10/amazon_ecs_401.html
http://ecs.amonya.com/ecs40/operations.html