出品する商品

www.amazon.co.jp や、www.amazon.com などには、数百万点もの商品が出品されています。これらの商品のほとんどは、Amazon や、マルイなどの大規模マーチャントによって倉庫に保管および販売されます。これらの商品は、すべて Amazon マーケットプレイスの一部です。

商品を販売している大規模なマーチャントに加え、個人や企業も www.amazon.co.jp や、www.amazon.comにある商品を出品できます。これらの出品者の一部は、Amazon.co.jp や Amazon.com に独自のストアフロントを持っており、それぞれのストアにのみ出品しています。しかし、ほとんどの出品者は、自身のストアに加えてAmazon マーケットプレイスに商品を掲載しています。

Product Advertising API のオペレーションは、Amazon に掲載されている商品だけを取得できます。Product Advertising API を利用して、出品したい商品を Amazon に追加することはできません。Amazon のカタログに商品を追加するには、Amazon e託販売登録者などとして、別個の登録または契約が必要です。

商品 ID

www.amazon.co.jp や www.amazon.com に出品されているすべての商品にはIDがあります。IDは大きく4種類に分けられます。次の2種類のIDは、購入できるかどうかにかかわらず商品の識別に使われます。

  • ASIN—Amazon Standard Item Number

    Amazon マーケットプレイス内の商品を一意に識別する英数字の文字列です。

    ASIN は、マーケットプレイスのすべての商品に付与されていいます。ASIN は、現時点で最もよく使われている ID です。ASIN は、Product Advertising API のほとんどのオペレーションで使われます。

  • ListingId—zShop と 呼ばれるプロマーチャントのストアや、マーチャント@のストアの商品を一意に識別する英数字の文字列です。

    ListingId は、ASIN に比べるとあまり使われません。ListingId は、自身のストアで商品を販売しているプロマーチャントが出品している商品に割り当てられます。

残りの2つのIDは、実際に購入可能な商品を識別します。

  • OfferListingId—Amazon マーケットプレイス内の購入可能な商品を一意に識別する英数字の文字列です。

    マーケットプレイス内の購入可能な全ての商品には OfferListingId があります。これは、購入可能な商品に対して現時点で最もよく使われるIDです。

  • ExchangeId—zShop と呼ばれるプロマーチャントのストアや、マーチャント@のストアで出品されている、購入可能な商品を一意に識別する英数字の文字列です。

    ExchangeIds は、OfferListingId ほど頻繁には使われません。これは、 www.amazon.com の商品のほとんどが、出品者のストア以外でも入手できるためです。

その他の商品 ID

Amazon には、上記以外の商品IDがありますが、これらはごく一部の Product Advertising API でしか使われていません。

  • UPC—Universal Product Code

    US および CA サイトで使われる、12桁の商品 ID です。UPC は、バーコードで使われる ID です。

  • EAN—European Article Number

    UPCと同等の13桁のIDです。ヨーロッパで製品やバーコードに使われます。

  • JAN—Japanese Article Number

    日本で製品のバーコードに使われる、EAN に相当するIDです。

  • ISBN—International Standardized Book Number

    書籍を一意に識別する英数字の文字列です。通常、書籍のEANは、その書籍のISBNと同じになるように設定されます。

  • SKU—Stock Keeping Unit

    シャツや椅子など、購入可能な商品に対するマーチャント固有の ID です。SKUの Amazon 版がASINです。

    Amazon は、商品に ASIN という SKU を割り当てます。SKU だけを使用して検索する必要がある場合は、各マーチャントの商品をそれぞれ検索する必要があります。これは、SKU がすべてのマーチャントで一意でないためです。いくつかの Product Advertising API のオペレーションでは SKU で検索できますが、同じリクエストの中でマーチャントも指定する必要があります。

Amazon マーケットプレイスにあるすべての商品には、上記の ID のいずれかが設定されている場合であっても、ASIN が割り当てられています。これらの ID は、ごく一部の Product Advertising API のオペレーションでのみ使用できます。この機能は、利便性を目的として提供されています。通常、当該商品の ASIN がわからない場合は、わかっているIDを1つだけ使用します。

これらのIDが使用できるかどうかは、サーチインデックスによって異なります(次表を参照)。

サーチインデックス (SearchIndex)UPCEANSKU
Apparel YYY
Automotive YYY
Automotive YYY
Baby YYY
BeautyYYY
BooksYYY
Classical YYY
DigitalMusic YNN
DVD YYY
Electronics YYY
HealthPersonalCare YYY
HomeGarden YYY
Industrial YYY
Jewelry YYY
Kitchen YYY
Magazines NYY
Merchants NNY
Miscellaneous YYY
Music YYY
MusicalInstruments YYY
MusicTracks NNN
OfficeProducts YYY
OutdoorLiving YYY
PCHardware YYY
PetSupplies YYY
Photo YYY
Software YYY
Tools YYY
Toys YYY
VHS YYY
Video YYY
WatchesYYY

次の表は、各国サイトごとに有効な商品 ID をまとめたものです。

サイト有効な商品 ID
CA ASIN, EAN, SKU
DE ASIN, EAN, SKU
FR ASIN, SKU, UPC
JP ASIN, EAN, JAN, SKU
UK ASIN, SKU, UPC
US ASIN, ISBN, SKU, UPC

デフォルトの IdType 値は、ASIN です。ISBN、JAN、SKU、UPC、EAN による検索など、ASIN 以外を使用した検索では、IdType などの追加パラメータと組み合わせて使用することが必要となります。