商品APIでのデジタルコンテンツのASINの識別方法について書籍や音楽CD等の商品登録において、同タイトルのデジタルコンテンツ商品のASINを誤って指定してしまうことで、実際にはその商品を販売できていないという状況が発生することがあります。商品APIを正しく使うことで、これらの問題を防ぐことができます。
具体的には、以下のように商品APIを使って正しいASINを取得してください。
- ListMatchingProducts ではなくGetMatchingProductForId を使う
- ListMatchingProducts や GetMatchingProductForId のレスポンスから正しい商品を特定する
以下に、それぞれのケースをご紹介します。
1. ListMatchingProducts ではなくGetMatchingProductForId を使う
ListMatchingProducts で書籍のISBNをQueryパラメータに指定して検索した際、紙書籍と電子書籍の両方が販売されているにも関わらず電子書籍の情報だけが返却され、紙書籍のASINを取得できない場合があります。
この現象を避けるために、ISBNやJANなどの商品コードがわかっている場合は ListMatchingProducts オペレーションの代わりにGetMatchingProductForId オペレーションを使います。
（例：ISBNでの検索の場合）
リクエストパラメータのIdType に“ISBN”を、IdList に検索するISBNの値を指定して検索します。
&Action=GetMatchingProductForId
:
&IdType=ISBN
&IdList.Id.1=1234****7890
これにより、商品コードに一致している紙書籍と電子書籍の両方の情報を取得できます。
続いて、次にご紹介する方法で出品したい商品の識別を行います。
2. ListMatchingProducts や GetMatchingProductForId のレスポンスから正しい商品を特定する
ListMatchingProducts を利用し商品タイトル等で検索すると、紙書籍と電子書籍、CDとMP3などの異なる媒体の商品が同時に返される場合があります。
その場合、レスポンスには複数の Product 要素が存在します。たとえば書籍の場合、「文庫」「ハードカバー」「コミック」などの紙書籍のProduct要素に加えて「Kindle版」のProduct要素が出現します。
この時、レスポンスの最初にあるProduct要素を紙書籍やCDと仮定して無条件に取り込んでしまうと、誤ってデジタルコンテンツのASINに対して出品してしまうことがあります。
複数の Product 要素が返却された場合、子要素のProductGroup によって商品カテゴリーを識別し、正しい商品へ出品する必要があります。紙書籍の場合は Book 、電子書籍の場合はeBooks がProductGroupの値となりますので、紙書籍に出品する場合は、ProdcutGroupがBookのProduct要素を使用します。
〔GetMatchingProductForId のレスポンス例〕
<?xml version="1.0"?> <GetMatchingProductForIdResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetMatchingProductForIdResult Id="9780751565355" IdType="ISBN" status="Success"> <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Product> <Identifiers> <MarketplaceASIN> <MarketplaceId>A1VC38T7YXB528</MarketplaceId> <ASIN>B01BMK1NBQ</ASIN> <-------- 電子書籍のASIN </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="ja-JP"> <ns2:Binding>Kindle版</ns2:Binding> <ns2:Creator Role="著">Rowling, J.K.</ns2:Creator> <ns2:Creator Role="著">Tiffany, John</ns2:Creator> <ns2:Creator Role="著">Thorne, Jack</ns2:Creator> <ns2:Format>Kindle本</ns2:Format> ： <ns2:Manufacturer>Pottermore from J.K. Rowling</ns2:Manufacturer> <ns2:NumberOfPages>320</ns2:NumberOfPages> <ns2:ProductGroup>eBooks</ns2:ProductGroup> <-------- 電子書籍のProductGroup <ns2:ProductTypeName>ABIS_EBOOKS</ns2:ProductTypeName> <ns2:PublicationDate>2016-07-31</ns2:PublicationDate> <ns2:Publisher>Pottermore from J.K. Rowling</ns2:Publisher> <ns2:ReleaseDate>2016-07-31</ns2:ReleaseDate> ： <Product> <Identifiers> <MarketplaceASIN> <MarketplaceId>A1VC38T7YXB528</MarketplaceId> <ASIN>0751565350</ASIN> <-------- 紙書籍のASIN </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="ja-JP"> <ns2:Binding>ハードカバー</ns2:Binding> <ns2:Creator Role="著">Rowling, J. K.</ns2:Creator> <ns2:Creator Role="著">Thorne, Jack</ns2:Creator> <ns2:Creator Role="著">Tiffany, John</ns2:Creator> ： <ns2:PackageQuantity>1</ns2:PackageQuantity> <ns2:PartNumber>9780751565355</ns2:PartNumber> <ns2:ProductGroup>Book</ns2:ProductGroup> <-------- 紙書籍のProductGroup <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName> <ns2:PublicationDate>2016-07-31</ns2:PublicationDate> ：
以上を参考に、既にカタログが存在する商品の出品時には、デジタルコンテンツではなく紙書籍やCD等のASINを指定するようお願いいたします。
なお、デジタルコンテンツのASINを指定して出品した場合、処理レポートにはエラーが表示されます。
フィードをアップロードした場合は、処理レポートのエラーを必ずご確認頂くようお願いします。
以上、皆様の開発時の参考となれば幸いです。
まずはスクラッチパッドで商品APIの動作をお試しください。
