ItemSearchクラス †
ItemSearch †
| プロパティ | 説明 | | AWSAccessKeyId | AmazonのAccess Key IDを指定する。もしもっていなければ、こちらのページで取得できる。AWSAccessKeyIdかSubscriptionIdのどちらかを必ず指定する必要がある。 | | SubscriptionId | Access Key IDではなくSubscription Idを持っている場合は、それを指定する。AWSAccessKeyIdかSubscriptionIdのどちらかを必ず指定する必要がある。 | | AssociateTag | Amazonアソシエイト・プログラムに参加しているならば、Associate IDを指定できる。指定しなくても良いが、アフィリエイトで儲けたいのであれば、指定する。 | | XMLEscaping | XMLエンコードを一回だけ行うか、2回行うかを、"Single"または"Double"で指定する。例えば"&"という文字がレスポンスに含まれているならば、"Single"では"&"を返すが、"Double"では"&"を返す。デフォルトで"Single"。 | | Validate | 実際には実行せずに、テストだけするかどうか。Validateを指定する時は、必ず"True"とする。正常であれば、レスポンスのIsValidがTrueとなる。失敗すると、IsValidがFalseとなり、Errorsが返される。ただし、実際に実行されるわけでは無いので、実際に実行された時に返されるエラーが返されない時もある。 | | Request | ItemSearchRequestオブジェクトの配列を指定する。必ず指定する。 | | Shared | Requestに複数のリクエストを指定してバッチリクエストを行う時、それらのリクエストに共通のプロパティを指定する。例えば、検索キーワードは同じで複数のSearchIndexから検索したいのであれば、Shared.Keywordsを指定する。バッチリクエストについて詳しくは、Combining Operations into a Single Request。 | | MarketplaceDomain | |
- 参考
- Common Parameters to all Operation Requests
ItemSearchRequest †
| プロパティ | 説明 | | SearchIndex | 検索するストアのインデックスを指定する。必ず指定する。詳しくは下のSearchIndexを。 | | Keywords | 検索するキーワードを指定する。 | | Title | 商品のタイトルで検索したい時にクエリーを指定する。 | | Artist | アーティスト名で検索したい時にクエリーを指定する。 | | Author | 作者名で検索したい時にクエリーを指定する。 | | Actor | 俳優名で検索したい時にクエリーを指定する。 | | Director | ディレクター名で検索したい時にクエリーを指定する。 | | Manufacturer | メーカー名で検索したい時にクエリーを指定する。 | | MusicLabel | レコードレーベル名で検索したい時にクエリーを指定する。 | | Composer | 作曲家名で検索したい時にクエリーを指定する。 | | Publisher | 出版社名で検索したい時にクエリーを指定する。 | | Brand | 商標名で検索したい時にクエリーを指定する。 | | Conductor | 指揮者名で検索したい時にクエリーを指定する。 | | Orchestra | オーケストラ名で検索したい時にクエリーを指定する。 | | Power | Power Searchを行う。Power Searchについて詳しくはこちら。 | | BrowseNode | より狭いカテゴリを指定して検索する。詳しくは下のBrowseNodeを。 | | ItemPage | ページを指定する。1〜400までの数字を指定できる。デフォルトは1。なお1ページにつき10の結果まで（Blendedではそれ以上）取得できる。 | | Sort | 並び方を指定する。詳しくは下のSortを。 | | MinimumPrice | 検索する商品の最低価格を指定する。 | | MaximumPrice | 検索する商品の最高価格を指定する。 | | MerchantId | 販売業者を指定する。"All"、"Amazon"、または販売業者名（アルファベット）を指定する。デフォルトは"Amazon"。Availabilityが指定されてなく、MerchantIdに"Amazon"が指定されている時は、すべての売り手から検索される。SearchIndexがBlendedやMusicTracksの時は使用できない。 | | Condition | 商品の状態を指定する。"All", "New"（新品）, "Used"（ユーズド商品）, "Refurbished"（再生品）, "Collectible"（コレクター商品）の何れかを指定できる。デフォルトは"New"。Conditionを指定した時は、ConditionSpecifiedをTrueにする必要がある。 | | Availability | 利用可能なアイテムだけを検索する。Availabilityを"Available"とし、Conditionを"All"とし、MerchantIdを指定する必要がある。SearchIndexがBlendedやMusicTracksの時は使用できない。Availabilityを指定した時は、AvailabilitySpecifiedをTrueにする必要がある。（Availabilityを指定して排除される商品は「在庫切れ」の商品のようだが、在庫切れの商品がすべて排除されるわけではない。違いは不明。） | | ResponseGroup | 返されるデータの種類を指定する。デフォルトは"Request"と"Small"。詳しくは下のResponseGroupを。 | | AudienceRating | Amazon.co.jpでは無効。 | | TextStream | USのみ。 | | City | USのみ。 | | State | | | Cuisine | USのみ。 | | Neighborhood | USのみ。 | | DeliveryMethod | USのみ。DeliveryMethodを指定した時は、DeliveryMethodSpecifiedをTrueにする必要がある。 | | PostalCode | | | ISPUPostalCode | USのみ。 | | FutureLaunchDate | |
- 参考
- ItemSearch Operation
SearchIndex †
Amazon.co.jpにおいて、SearchIndexに指定できる文字列とその意味は次の通りです。
| Search Index Name | 説明 | | Blended | すべての商品 | | Books | 本 | | Classical | クラシック音楽 | | DVD | DVD | | Electronics | エレクトロニクス | | ForeignBooks | 洋書 | | Hobbies | ホビー | | Kitchen | ホーム＆キッチン | | Music | 音楽 | | MusicTracks | 曲名 | | Software | ソフトウェア | | SportingGoods | スポーツ | | Toys | おもちゃ | | VHS | VHSビデオ | | Video | DVD＆ビデオ | | VideoGames | ゲーム | | HealthPersonalCare | ヘルス＆ビューティー |
- 参考
- Search Index Values
BrowseNode †
Amazon.co.jpのBrowse Nodesは次の通りです。
| SearchIndex | ジャンル | 値 | | Books | 文学・評論 (Literature & Fiction) | 466284 | | 人文・思想 (Philosophy & Religion) | 571582 | | 社会・政治 (Society & Politics) | 571584 | | ノンフィクション (Nonfiction) | 492152 | | 歴史・地理 (Travel & Geography) | 466286 | | ビジネス・経済・キャリア (Business & Career) | 466282 | | 投資・金融・会社経営 (Investment & Financial Management) | 492054 | | コンピュータ・インターネット (Computer & Internet) | 466298 | | アート・建築・デザイン (Art & Photography) | 466294 | | エンターテイメント (Entertainment) | 466296 | | 実用・スポーツ・ホビー (Sports & Hobby) | 466292 | | 暮らし・健康・子育て (Home & Family) | 466304 | | 語学・辞事典・年鑑 (Foreign Language Reference) | 466302 | | こども (Children's Books) | 466306 | | コミック・アニメ・BL (Cartoons & Anime) | 466280 | | 新書・文庫 (New Releases) | 466300 | | 楽譜・スコア・音楽書 (Sheet Music) | 746102 | | Classical | クラシック (Classical) | 701040 | | DVD | 日本映画 (Japanese) | 562014 | | 外国映画 (Foreign) | 562016 | | ミュージック (Music) | 562018 | | アニメ (Animation) | 562020 | | ホビー・実用 (Hobby & Fitness) | 562022 | | スポーツ・フィットネス (Sports) | 562024 | | キッズ・ファミリー (Family) | 562026 | | TV Documentary*1 | 562028 | | BOXセット (Box Sets) | 564522 | | アダルト (Adult) | 896246 | | Electronics | デジタルカメラ (Digital Cameras) | 3371371 | | DVDプレーヤー・レコーダー (DVD Players) | 3371441 | | ポータブルオーディオ (Portable Audio) | 3371411 | | コンピュータ (Computer) | 3371341 | | PC周辺機器・パーツ (PC Peripherals) | 3371351 | | プリンタ・スキャナ (Printer & Scanner) | 3371361 | | ネットワーク機器 (Network Equipment) | 3371381 | | PDA・電子辞書 (PDA) | 3371401 | | アクセサリ・サプライ (Accessories) | 3371421 | | 記録メディア・テープ (Storage & Memory) | 3371391 | | オーディオ・ビジュアル (Audio Visual) | 3371431 | | ForeignBooks | Arts & Photography | 1 | | Audiobooks | 44 | | Music | J-POP (J-Pop) | 569170 | | ポップス (Popular) | 569290 | | ロック (Rock) | 569292 | | ハードロック・ヘヴィーメタル (Hard Rock) | 569298 | | ブルース・カントリー (Blues & Country) | 562050 | | ソウル・R＆B (Soul & R&B) | 569318 | | ヒップホップ (Hip Hop) | 569320 | | ダンス・エレクトロニカ (Dance) | 569322 | | ジャズ・フュージョン (Jazz Fusion) | 562052 | | ワールド (World) | 562056 | | ヒーリング・ニューエイジ (New Age) | 562064 | | サウンドトラック (Soundtracks) | 562058 | | アニメ・ゲーム (Animation) | 562060 | | キッズ・ファミリー (Children & Family) | 562062 | | 歌謡曲・演歌 (Ballad) | 569174 | | 日本の伝統音楽・芸能 (Traditional) | 569186 | | スポーツ・その他 (Sports) | 899296 | | Software | PCゲーム (Games) | 689132 | | Children's*2 | 1040140 | | Hobby*3 | 637656 | | Foreign Language Training*4 | 637658 | | ホームページ作成 (Internet) | 637648 | | ビジネス・オフィス (General Business) | 637644 | | 会計・企業業務 (Industry-Specific Business) | 1040106 | | デザイン・グラフィック (Graphics) | 637652 | | Music*5 | 637654 | | PCユーティリティ (Utility) | 637662 | | プログラミング (Programming) | 637650 | | OS (Operating System) | 637666 | | Macintosh (Macintosh) | 3137861 | | Toys | ぬいぐるみ (Stuffed Animals) | 13321741 | | アクションフィギュア・ソフビ (Action Figures) | 13321821 | | カード・ボードゲーム (Cards and Board Games) | 13321791 | | スポーツ・プレイトイ (Sports & Outdoor Play)*6 | 1332181 | | トレーディングカード (Trading Cards) | 13321801 | | パズル・ジグソーパズル (Puzzles) | 13321721 | | パーティー・手品 (Party Goods) | 13321771 | | ファッション・アクセサリ (Fashion & Accessories) | 13321751 | | ブロック (Blocks) | 13321701 | | プラモデル (Plastic Models) | 13321841 | | ホビー (Hobbies & Collectibles) | 13321861 | | ミニカー・乗り物 (Vehicles) | 13321831 | | ラジコン (Radio & Remote Control) | 13321851 | | 人形・ミニドール (Dolls) | 13321731 | | 変身・なりきり (Pretend Play & Dress-Up) | 13321761 | | 学習・手芸・工作 (Science & Discovery) | 13321681 | | 楽器・音楽玩具 (Musical Instruments) | 13321691 | | 知育玩具 (Learning Toys) | 13321671 | | 積み木・木のおもちゃ (Wooden Building Blocks) | 13321711 | | 赤ちゃん (Baby Toys) | 13321461 | | 電子玩具 (Electronics) | 13321781 | | VHS | 日本映画 (Japanese) | 561984 | | 外国映画 (Foreign) | 561986 | | 音楽・ステージ (Music) | 561988 | | アニメ (Animation) | 561990 | | ホビー・実用 (Hobby & Fitness) | 561992 | | スポーツ・フィットネス (Sports) | 561994 | | キッズ・ファミリー (Family) | 561996 | | TV・ドキュメンタリー (TV Documentary) | 561998 | | Import (輸入版) (Imports) | 564546 | | VideoGames | プレイステーション2 (Play Station 2) | 637874 | | プレイステーション (Play Station) | 637876 | | ゲームキューブ (Nintendo Gamecube) | 637878 | | ゲームボーイアドバンス (Game Boy Advance) | 637880 | | ゲームボーイ (Game Boy) | 637882 | | Xbox (Xbox) | 639096 | | その他の機種 (Other)*7 | 637886 |
日本のTVドラマでの検索結果ともちょっと違う。少なくともドキュメンタリーではない。
はじめての学習での検索結果ともちょっと異なる。
アニメ・キャラクター・サウンドトラックにいろいろ足した感じ。
英語学習・その他の語学とも違う。
アニメ・キャラクター・サウンドトラックとも違う。
結果なしになってしまう...。
ニンテンドーDSやPSPなどは含まれない。
- 参考
- Browse Node Values
Sort †
並べ方を指定します。地域とSearchIndexにより、指定できる値が異なります。Amazon.co.jpでは以下のような値を指定できます。詳しくは、「Sort Values for JP」を。
| 値 | 説明 | SearchIndex | | salesrank | 売れている順番。 | MusicTracks以外 | | pricerank | 価格の安い順番。 | Books, Classical, DVD, Electronics, ForeignBooks, Music, VHS, Video | | price | 価格の安い順番。 | Kitchen, Software, SportingGoods, Toys, VideoGames | | inverse-pricerank | 価格の高い順番。 | Books, ForeignBooks | | -pricerank | 価格の高い順番。 | Classical, DVD, Electronics, Hobbies, Music, VHS, Video | | -price | 価格の高い順番。 | Kitchen, Software, SportingGoods, Toys, VideoGames | | daterank | 出版年月が新しい順番。 | Books, ForeignBooks | | titlerank | タイトル名の順番:昇順。 | すべて | | -titlerank | タイトル名の順番:降順。 | すべて | | -orig-rel-date | リリースの新しい順番。（発売日） | Classical, DVD, Music, VHS, Video | | orig-rel-date | リリースの古い順番。 | Classical, DVD, Music, VHS, Video | | -releasedate | リリースの新しい順番。（発売日） | Electronics, Hobbies, Kitchen, Software, SportingGoods, Toys, VideoGames | | releasedate | リリースの古い順番。 | Electronics, Hobbies, Kitchen, Software, SportingGoods, Toys, VideoGames | | mfg-age-min | 対象年齢が低い順番。 | Hobbies | | -mfg-age-min | 対象年齢が高い順番。 | Hobbies |
ResponseGroup †
取得するデータの種類（何についてのデータを取得するか、その範囲）を指定します。これを正しく指定しないと（範囲が狭いと）、取得したい値が取得できなくなります（NULLが返される）。範囲を広く指定すれば取得したいデータを取得できない可能性は減りますが、帰ってくるデータ量が多くなります。
指定できる文字列とその意味に関しては、「Response Groups」で説明されています。
ItemSearchResponse †
OperationRequest †
| プロパティ | 説明 | | HTTPHeaders | HTTPHeadersHeaderの配列。HTTPヘッダの名前と値を返す。 | | RequestId | このオペレーションリクエストのID。 | | RequestProcessingTime | リクエストを処理するためにWebサービスがかかった時間（秒）。RequestProcessingTimeが設定されている時は、RequestProcessingTimeSpecifiedがTrueとなる。 | | Arguments | ArgumentsArgumentの配列。HTTPコマンドライン引数の名前と値を返す。 | | Errors | ErrorsErrorの配列。 |
Items †
| プロパティ | 説明 | | Request | 使用されたリクエストの情報。Request型。 | | TotalResults | 検索でヒットした商品の総数。 | | TotalPages | 10個の商品を1ページに表示するとき、検索でヒットした商品を表示するのに必要なページ数。 | | Item | Itemの配列。商品に関する様々な情報が含まれている。 | | CorrectedQuery | 検索した語句が間違えていると判断し、自動的に修正して検索した時に、修正した語句とメッセージを返す。 | | SearchBinSets | USのみ。詳しくは、SearchBins Response Groupを。 | | SearchResultsMap | SearchIndexがBlendedの時に、どのIndex(IndexName)でどの様な商品(ASIN、最大3つ)がどれだけ見つかったか(Results)などを返す。 |
Item †
| プロパティ | 説明 | | Accessories | この商品にアクセサリーがあれば、そのリスト。ResponseGroupにAccessoriesが必要。 | | AlternateVersions | その本で利用できるメディアフォーマットのリストを返す。SearchIndexがBooksかForeignBooksである必要がある。ResponseGroupにAlternateVersionsが必要。詳細はAlternateVersions Response Group。 | | ASIN | 商品のASIN(Amazon Standard Identification Number)。 | | BrowseNodes | この商品が属しているBrowseNodeのリスト。ResponseGroupにBrowseNodesが必要。 | | CustomerReviews | この商品のお勧め度やカスタマーレビューに関する情報。CustomerReviews型。ResponseGroupにReviewsが必要。 | | DetailPageURL | Amazon.co.jpでのこの商品の説明ページのURL。 | | EditorialReviews | この商品のエディターレビューに関する情報。EditorialReview型。ResponseGroupにEditorialReviewが必要。 | | Errors | 商品に関連したエラーがあるときに返される。ErrorsErrorの配列。 | | LargeImage | この商品の大きい画像に関する情報。Image型。500x500に収まる程度の大きさのようだ。ResponseGroupにImagesが必要。 | | MediumImage | この商品の中ぐらいの画像関する情報。Image型。160x160に収まる程度の大きさのようだ。ResponseGroupにImagesが必要。 | | SmallImage | この商品の小さい（サムネイル）画像関する情報。Image型。75x75に収まる程度の大きさのようだ。ResponseGroupにImagesが必要。 | | ImageSets | | | ItemAttributes | この商品に関する様々な情報。TitleやCreator等以外の情報の取得には、ResponseGroupにItemAttributesが必要。詳しくは../ItemAttributesを。 | | ListmaniaLists | この商品のリストマニアに関する情報。ListmaniaListsListmaniaListの配列。ResponseGroupにListmaniaListsが必要。 | | MerchantItemAttributes | この商品を売っているマーチャントに関する情報。ResponseGroupにMerchantItemAttributesが必要。 | | Offers | この商品を売っているベンダー毎の商品に関する価格等の情報や、売り手の情報。Offers型。ResponseGroupにOffersが必要。 | | OfferSummary | この商品を売っているベンダーの数や最安値などの情報。OfferSummary型。ResponseGroupにOfferSummaryが必要。 | | SalesRank | この商品の売り上げのランク。ResponseGroupにSalesRankが必要。 | | SearchInside | | | SimilarProducts | この商品の「この商品を買った人はこんな商品も買っています」に表示される商品の情報。SimilarProductsSimilarProductの配列。ResponseGroupにSimilaritiesが必要。 | | Subjects | この商品の「同じキーワードの商品を探す」の文字列。ResponseGroupにSubjectsが必要。 | | Tracks | この商品の曲目リストを返す。TracksDiscの配列。ResponseGroupにTracksが必要。 | | Variations | 色、サイズ、スタイルの異なる子製品の情報を返す。USのみ。 | | VariationSummary | 色、サイズ、スタイルの異なる子製品の情報のサマリーを返す。USのみ。 | | Collections | テーマとして関連のある商品のリスト。ResponseGroupにCollectionsが必要。 |
- 参考
- Product Data Output
Request †
ErrorsError †
| プロパティ | 説明 | | Code | エラーコード。 | | Message | エラーメッセージ。エラーの説明と、対処法など。 |
DecimalWithUnits †
| プロパティ | 説明 | | Value | 値。 | | Units | Valueの単位。長さならば"hundredths-inches"や"cm"、重さならば"hundredths-pounds"など。 |
Image †
Creator †
| プロパティ | 説明 | | Role | 役割。本ならば"編集"や"著"、音楽ならば"演奏"や"アーティスト"、"Adapter"、DVDならば"監督"や"出演・声の出演"や"俳優"など。 | | Value | Roleに対応する名前。 |
Price †
| プロパティ | 説明 | | Amount | 価格の数字。Amazon.co.jpでは、日本円での価格。 | | CurrencyCode | Amountの単位。Amazon.co.jpでは、"JPY"。 | | FormattedPrice | フォーマットされた価格("￥ 1,000"など)。 |
ListmaniaListsListmaniaList †
| プロパティ | 説明 | | ListId | リストマニアのList ID。 | | ListName | リストマニアのリストの名前。 |
SimilarProductsSimilarProduct †
| プロパティ | 説明 | | ASIN | 商品のASIN。 | | Title | 商品のタイトル。 |
TracksDisc †
| プロパティ | 説明 | | Number | ディスクの番号。"1", "2", "3"...というようにディスクごとに連番がつけられるようだ。 | | Track | トラックの情報。TracksDiscTrackの配列。 |
TracksDiscTrack †
| プロパティ | 説明 | | Number | トラックの番号。"1", "2", "3"...というようにディスクごとに連番がつけられるようだ。 | | Value | トラックの値。曲名。 |
|
