ItemSearchクラス

ItemSearch

プロパティ説明
AWSAccessKeyIdAmazonのAccess Key IDを指定する。もしもっていなければ、こちらのページで取得できる。AWSAccessKeyIdかSubscriptionIdのどちらかを必ず指定する必要がある。
SubscriptionIdAccess Key IDではなくSubscription Idを持っている場合は、それを指定する。AWSAccessKeyIdかSubscriptionIdのどちらかを必ず指定する必要がある。
AssociateTagAmazonアソシエイト・プログラムに参加しているならば、Associate IDを指定できる。指定しなくても良いが、アフィリエイトで儲けたいのであれば、指定する。
XMLEscapingXMLエンコードを一回だけ行うか、2回行うかを、"Single"または"Double"で指定する。例えば"&"という文字がレスポンスに含まれているならば、"Single"では"&"を返すが、"Double"では"&"を返す。デフォルトで"Single"。
Validate実際には実行せずに、テストだけするかどうか。Validateを指定する時は、必ず"True"とする。正常であれば、レスポンスのIsValidがTrueとなる。失敗すると、IsValidがFalseとなり、Errorsが返される。ただし、実際に実行されるわけでは無いので、実際に実行された時に返されるエラーが返されない時もある。
RequestItemSearchRequestオブジェクトの配列を指定する。必ず指定する。
SharedRequestに複数のリクエストを指定してバッチリクエストを行う時、それらのリクエストに共通のプロパティを指定する。例えば、検索キーワードは同じで複数の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オーケストラ名で検索したい時にクエリーを指定する。
PowerPower 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を。
AudienceRatingAmazon.co.jpでは無効。
TextStreamUSのみ。
CityUSのみ。
State
CuisineUSのみ。
NeighborhoodUSのみ。
DeliveryMethodUSのみ。DeliveryMethodを指定した時は、DeliveryMethodSpecifiedをTrueにする必要がある。
PostalCode
ISPUPostalCodeUSのみ。
FutureLaunchDate
参考
ItemSearch Operation

SearchIndex

Amazon.co.jpにおいて、SearchIndexに指定できる文字列とその意味は次の通りです。

Search Index Name説明
Blendedすべての商品
Books
Classicalクラシック音楽
DVDDVD
Electronicsエレクトロニクス
ForeignBooks洋書
Hobbiesホビー
Kitchenホーム&キッチン
Music音楽
MusicTracks曲名
Softwareソフトウェア
SportingGoodsスポーツ
Toysおもちゃ
VHSVHSビデオ
VideoDVD&ビデオ
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*1562028
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
ForeignBooksArts & Photography1
Audiobooks44
MusicJ-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
SoftwarePCゲーム (Games)689132
Children's*21040140
Hobby*3637656
Foreign Language Training*4637658
ホームページ作成 (Internet)637648
ビジネス・オフィス (General Business)637644
会計・企業業務 (Industry-Specific Business)1040106
デザイン・グラフィック (Graphics)637652
Music*5637654
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)*61332181
トレーディングカード (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)*7637886


*1 日本のTVドラマでの検索結果ともちょっと違う。少なくともドキュメンタリーではない。
*2 はじめての学習での検索結果ともちょっと異なる。
*3 アニメ・キャラクター・サウンドトラックにいろいろ足した感じ。
*4 英語学習・その他の語学とも違う。
*5 アニメ・キャラクター・サウンドトラックとも違う。
*6 結果なしになってしまう...。
*7 ニンテンドー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

プロパティ説明
OperationRequestOperationRequestオブジェクトを返す。すべてのオペレーションで返される。
ItemsItemsの配列。

OperationRequest

プロパティ説明
HTTPHeadersHTTPHeadersHeaderの配列。HTTPヘッダの名前と値を返す。
RequestIdこのオペレーションリクエストのID。
RequestProcessingTimeリクエストを処理するためにWebサービスがかかった時間(秒)。RequestProcessingTimeが設定されている時は、RequestProcessingTimeSpecifiedがTrueとなる。
ArgumentsArgumentsArgumentの配列。HTTPコマンドライン引数の名前と値を返す。
ErrorsErrorsErrorの配列。

Items

プロパティ説明
Request使用されたリクエストの情報。Request型。
TotalResults検索でヒットした商品の総数。
TotalPages10個の商品を1ページに表示するとき、検索でヒットした商品を表示するのに必要なページ数。
ItemItemの配列。商品に関する様々な情報が含まれている。
CorrectedQuery検索した語句が間違えていると判断し、自動的に修正して検索した時に、修正した語句とメッセージを返す。
SearchBinSetsUSのみ。詳しくは、SearchBins Response Groupを。
SearchResultsMapSearchIndexが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が必要。
DetailPageURLAmazon.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

プロパティ説明
IsValidリクエストが正しいかどうか。
Errorsリクエストに関するエラーがあるときに返される。ErrorsErrorの配列。
ItemSearchRequest使用されたリクエスト。ItemSearchRequest型。
ItemLookupRequest使用されたリクエスト。ItemLookupRequest型。
SimilarityLookupRequest使用されたリクエスト。SimilarityLookupRequest型。
ListSearchRequest使用されたリクエスト。ListSearchRequest型。
ListLookupRequest使用されたリクエスト。ListLookupRequest型。
SellerListingSearchRequest使用されたリクエスト。SellerListingSearchRequest型。
SellerListingLookupRequest使用されたリクエスト。SellerListingLookupRequest型。
SellerLookupRequest使用されたリクエスト。SellerLookupRequest型。
CartGetRequest使用されたリクエスト。CartGetRequest型。
CartAddRequest使用されたリクエスト。CartAddRequest型。
CartCreateRequest使用されたリクエスト。CartCreateRequest型。
CartModifyRequest使用されたリクエスト。CartModifyRequest型。
CartClearRequest使用されたリクエスト。CartClearRequest型。
HelpRequest使用されたリクエスト。HelpRequest型。
BrowseNodeLookupRequest使用されたリクエスト。USのみ。
CustomerContentSearchRequest使用されたリクエスト。USのみ。
CustomerContentLookupRequest使用されたリクエスト。USのみ。
TransactionLookupRequest使用されたリクエスト。USのみ。

ErrorsError

プロパティ説明
Codeエラーコード。
Messageエラーメッセージ。エラーの説明と、対処法など。

DecimalWithUnits

プロパティ説明
Value値。
UnitsValueの単位。長さならば"hundredths-inches"や"cm"、重さならば"hundredths-pounds"など。

Image

プロパティ説明
URL画像のURL。
Width画像の幅。ピクセル単位。DecimalWithUnits型。
Height画像の高さ。ピクセル単位。DecimalWithUnits型。
IsVerified

Creator

プロパティ説明
Role役割。本ならば"編集"や"著"、音楽ならば"演奏"や"アーティスト"、"Adapter"、DVDならば"監督"や"出演・声の出演"や"俳優"など。
ValueRoleに対応する名前。

Price

プロパティ説明
Amount価格の数字。Amazon.co.jpでは、日本円での価格。
CurrencyCodeAmountの単位。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トラックの値。曲名。

ページ情報
[ トップ ]   [ 編集 | 凍結 | 差分 | バックアップ | 添付 | 複製 | 名前変更 | リロード ]   [ 新規 | 子ページ作成 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]