ItemSearchのまとめ

Amazon

Product Advertising API (Version 2009-03-31)のまとめ - SELECT * FROM life;

SearchIndexに指定できるもの一覧

OperationにItemSearchを指定した場合、SearchIndexが必須パラメータとなる。
SearchIndexで指定できるものを下に示す。それぞれ、表にあるパラメータが追加で指定でき、それ以外のものを指定するとエラーとなる。また、イタリックになっているパラメータの中から少なくとも一つ選ぶ必要がある。

  • Apparel
Author Availability Brand BrowseNode Condition Count DeliveryMethod
Format ISPUPostalCode ItemPage Keywords Magazines Manufacturer MerchantId
Performer PostalCode Sort State Title
  • Baby
Brand BrowseNode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort State Title
  • Beauty
Brand BrowseNode Condition ItemPage Keywords Manufaturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • Blended
Keywords
  • Books
Author BrowseNode Condition ItemPage Keywords MaximumPrice
MerchantId MinimumPrice Poewr Publisher Sort Title
  • Classical
Actor Availability BrowseNode Composer Conductor Count
Format ItemPage Keywords Magazines MusicLabel Orchesta
Performer PostalCode Sort State Title
  • DVD
Actor AudienceRating Availability BrowseNode Count Director
Format ItemPage Keywords Magezines Performer
PostalCode Publisher Sort State Title
  • Electronics
BrowseNode Condition ItemPage Keywords MaximumPrice
MerchantId MinimumPrice Sort Title
  • ForeignBooks
Author BrowseNode Condition ItemPage Keywords MaximumPrice
MerchantId MinimumPrice Publicher Sort Title
  • Grocery
Brand BrowseNode Condition Count ItemPage Keywords
MaximumPrice MinimumPrice Manufacturer MerchantId Sort Title
  • HealthPersonalCare
BrowseNode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • Hobbies
BrowseNode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • Jewelry
Availability BrowseNode DeliveryMethod Keywords MerchantId Sort Title
  • Kitchen
Brand BrowseNode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • Music
Artist Availability BrowseNode Count Format ItemPage Keywords
Magazines MusicLabel Performer PostalCode Sort State Title
  • MusicTracks
Condition ItemPage Keywords MaximumPrice MerchantId MinimumPrice Sort
  • Software
Brand BrowseNode Condition ItemPage Keywords
MaximumPrice MerchantId MinimumPrice Sort Title
  • SPoftingGoods
Browsenode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • Toys
Browsenode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • VHS
Actor AudienceRating Availability BrowseNode Count Director
Format ItemPage Keywords Magazines Performer PostalCode
Publisher Sort State Title
  • Video
Actor AudienceRating Availability BrowseNode Count Director
Format ItemPage Keywords Magazines Performer PostalCode
Publisher Sort State Title
  • VideoGames
Brand BrowseNode Condition ItemPage Keywords Manufacturer
MaximumPrice MerchantId MinimumPrice Sort Title
  • Watches
BrowseNode Condition ItemPage Keywords MerchantId
MinimumPrice Sort State TextStream Title

ResponseGroupsに指定できるもの一覧

ResponseGroupsの種類 - SELECT * FROM life;
下記の中から必要なものを選択。複数ある場合は','(カンマ)で区切る。その際、空白はいれない。

Small(デフォルト) Accessories AltenateVersions BrowseNodes Collections EditorialReview Images
ItemAttributes ItemIds Large ListmaniaLists Medium MerChantItemAttributes OfferFull
OfferListings Offers OfferSummary PromotionalTag PromotionDetails PromotionSummary RelatedItems
Reviews SalesRank SearchBins SearchInside Similarities Subjects Tags
TagsSummary Tracks VariationMatrix VariationMinimum VariationOffers Variations VariationSummary

ResponseGroupsの種類

Amazon

ResponseGroupに指定できるのは下記。それぞれOperationの種類によって指定できるものとできないものが存在するので注意が必要。

  • Accessories
  • AlternateVersions
  • BrowseNodeInfo
  • BrowseNodes
  • Cart
  • CartNewReleases
  • CartTopSellers
  • CartSimilarities
  • Collections
  • CustomerFull
  • CustomerInfo
  • CustomerLists
  • CustomerReviews
  • EditorialReview
  • HasPartCompatibility
  • Help
  • Images
  • ItemAttributes
  • ItemIds
  • Large
  • ListFull
  • ListInfo
  • ListItems
  • ListmaniaLists
  • ListMinimum
  • Medium
  • MerchantItemAttributes
  • Mostgifted
  • MostWishedFor
  • NewReleases
  • OfferFull
  • OfferListings
  • Offers
  • OfferSummary
  • PartBrandBinsSummary
  • PartBrowseNodeBinsSummary
  • PromotionDetails
  • PromotionSummary
  • RelatedItems
  • Request
  • Reviews
  • SalesRank
  • SearchBins
  • Seller
  • SellerListing
  • Similarities
  • Small
  • Subjects
  • TaggedGuides
  • TaggedItems
  • TaggedListmaniaLists
  • Tags
  • TagsSummary
  • TopSellers
  • Tracks
  • TransactionDetails
  • VariationMinimum
  • Variations
  • VariationImages
  • VariationMatrix
  • Variationoffers
  • VariationSummary
  • VehicleMakes
  • VehicleModels
  • VehicleOptions
  • VehiclePartFit
  • VehicleParts
  • VehicleTrims
  • VehicleYears

ItemLookupのまとめ

Amazon

必須パラメータ

ItemId
１〜１０個以下の値をカンマ区切りで指定する（単数形だが複数指定できる）。値の種類はIdTypeによって変化する。例えばIdTypeがASINならItemIdもASINを指定する。
RelationshipType
ResponseGroupにRelatedItemsを指定した場合必須となる。
SearchIndex
IdTypeがASIN以外だった場合必須。逆にASINの時は指定しない

オプションパラメータ

Condition
商品の状態を指定する。デフォルトはAllではなくNew。指定できるのは、New,AllUsed,Collectible,Refurbished
IdType
商品を指定するコードの種類。デフォルトでASIN。ASIN以外のものを指定した場合はSearchIndexが必須となる。指定できるのは、ASIN,SKU,UPC,EAN,ISBN,JAN
MerchantId
売り手を指定する。デフォルトでAmazon。
OfferPage
ItemLookupで返ってくるページ。１ページ当たり10個含まれるので、11〜20の商品を見るには2を指定する。指定できるのは1〜100の整数
RelatedItemsPage
ResponseGroupにRelatedItemsを指定した時だけ有効。１ページ当たり10個含まれる。
ReviewPage
レビューのページ。1ページ当たり5個のレビューが含まれるので、6〜10個目を見るには2を指定する。デフォルトは1
ReviewSort
レビューをソートする方法。デフォルトでは-SubmissionDateで投稿が新しいものが優先される。その他に指定できるのは-HelpfulVotes(最も参考になっているレビューが最初),HelpfulVotes(最も参考になっているレビューが最後),-OverallRating(評価が高いものが最初),OverallRating(評価が高いものが最後),SubmissionDate(古いものが最初)
TagPage
タグのページ。デフォルトはなし。最大で400
TagPerPage
返す商品に関連したタグの数
TagSort
ソートの種類。指定できるのはFirstUsed(先に使われた物順),LastUsed(後に使われた順),Name(アルファベット順),Usages(使われる順)。それぞれ先頭に-をつけることで降順になる
VariationPage
subsectionを返すのに使う（らしい）。デフォルトではAll。指定できるのは1〜150の整数
ResponseGroup
返すデータに含める項目を指定する。デフォルトはSmall。カンマ区切りで複数指定できる。下記参照
ResponseGroup

ResponseGroupsの種類 - SELECT * FROM life;

Small(D) Accessories AlternateVersions BrowseNodes Collections
EditorialReview Images ItemAttributes ItemIds Large
ListmaniaLists Medium MerchantItemAttributes OfferFull OfferListings
Offers OfferSummary PromotionalTag PromotionDetails PromotionSummary
RelatedItems Reviews SalesRank SearchInside Similarities
Subjects Tags TagsSummary Tracks VariationImages
VariationMatrix VariationMinimum VariationOffers Variations VariationSummary

Challengeの用法について

English

先日、Lang-8に

I want to challenge a full marathon this year, so I have to start training.

って書いたら

Japanese speakers often use challenge where a native speaker would use a different verb- enter a marathon, take a test, try TOEIC etc. When native speakers use challenge as a verb (not very often!) it is used to describe a contest between 2 people or teams- I challenged him to a game of darts etc. Generally speaking it isn't so widely used so it's probably best to avoid using it at all.
In English a marathon is a race that is over 26 miles. Usually when talking about that race a native speaker would say simply "marathon".

と添削されたよ。
ふむふむ。超約すると...

日本人ってネイティブが使わないようなとこでchallengeって動詞を使うことが多いよね。challenge a marathon, challenge a test, challenge TOEICみたいにさ。でも、俺らネイティブならenter a marathon, take a test, try TOEICみたいに表現するんだ。じゃあchallengeを動詞としてどういう時に使うかというと（そもそもほとんど使わないけど）、「人とか、チームとかの間が競争する時」とかに使うね。例えば"I challenged him to a game of darts"みたいな感じさ。でも、はっきり言ってこれは一般的には使われないから、使わないようにするのが望ましいね。
あと、英語ではマラソンって26km以上のレースのことを指すんだ。"full marathon"じゃなくてネイティブは"marathon"って言うんだぜ。

って感じ？勉強になりましたm(_ _)m

【追記】
26 miles≠26 kmですね。1 mile ≒1.6 kmなので