Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
ASIN、GCID、SellerSKU、UPC、EAN、ISBN、およびJANのリストに応じた、商品およびその属性のリストを返します。
GetMatchingProductForIdオペレーションは、指定した商品IDのリストに応じた商品およびその属性のリストを返します。商品IDには、ASIN、GCID、SellerSKU、UPC、EAN、ISBN、JANがあります。
このオペレーションはすべてのマーケットプレイスで利用できます。
| 最大リクエストクォータ | 回復レート | 時間あたりのリクエストクォータ |
|---|---|---|
| 20リクエスト | 1秒ごとに5商品 | 1時間あたり18000リクエスト |
すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイドの必須のリクエストパラメーターを参照してください。
| 名前 | 説明 | 必須 | 推奨値 |
|---|---|---|---|
| MarketplaceId | 暗号化された、Amazonが定義したマーケットプレイスID | はい | タイプ： MarketplaceType |
| IdType | Idの値が示す商品IDのタイプ。 | はい | IdType値：ASIN、GCID、SellerSKU、UPC、EAN、ISBN、JAN タイプ：xs:string |
| IdList | Id値の構造化リスト。指定したマーケットプレイスにある商品を識別するために使用。 | はい | 最大：5つのId値。 タイプ：xs:stringのリスト |
GetMatchingProductForIdオペレーションが返すレスポンス要素は、一般に公開されている次のXSDで内容を確認できます。
以下の表は、GetMatchingProductForIdオペレーションで返される主要な要素に関する追加情報です。
| 名前 | 説明 |
|---|---|
| Product | ProductsAPI_Response.xsdのProduct要素の4つのサブ要素を含む。サブ要素：Identifiers、AttributeSets、Relationships、SalesRankings。 |
| Identifiers | 商品を一意に識別するMarketplaceASINの組み合わせを含む。 |
| AttributeSets | 返された商品に該当する場合は、default.xsdのItemAttributes要素の商品の属性を含む。属性の言語が複数ある場合、Productレスポンス要素には複数の属性セットが含まれます。翻訳されていない属性も含め、すべての属性がそれぞれの属性セットで繰り返されます。それぞれの属性セットで使用される言語は、lang属性で示されます。 |
| Relationships | 商品のバリエーション情報がある場合は、これに含まれます。バリエーションの親ASINで識別される商品が検索条件に一致する場合、関連するVariationChild要素がRelationships要素に含まれます。バリエーションの子ASINが検索条件に一致する場合、関連するVariationParent要素がRelationships要素に含まれます。 注: このオペレーションが返すのは商品の属性の一部でしかないため、VariationChild要素にはバリエーション要素の値が同じ、別のASIN値が含まれている場合があります。それぞれを区別する商品属性が返されない場合でも、バリエーションの子ASINは区別されます。
バリエーション属性は、default.xsdのVariationChild要素に含まれます。 注: 入力されたASIN値に2,000以上のVariationChild要素の組み合わせがある場合、バリエーション属性はVariationChild要素には含まれません。
|
| SalesRankings | 商品カテゴリー別の商品売上ランキング情報。 サブ要素：
|
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
POST /Products/2011-10-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetMatchingProductForId &IdList.Id.1=9781933988665 &IdList.Id.2=0439708184 &IdType=ISBN &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T21%3A09%3A02Z &Version=2011-10-01 &Signature=ZhhdEXAMPLEiTy6k5etzw%2BIOCvbDrGop5u9EXAMPLE8%3D
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?>
<GetMatchingProductForIdResponse
xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetMatchingProductForIdResult Id="9781933988665"
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>ATVPDKIKX0DER</MarketplaceId>
<ASIN>1933988665</ASIN>
</MarketplaceASIN>
</Identifiers>
<AttributeSets>
<ns2:ItemAttributes xml:lang="en-US">
<ns2:Author>Marmanis, Haralambos</ns2:Author>
<ns2:Author>Babenko, Dmitry</ns2:Author>
<ns2:Binding>Paperback</ns2:Binding>
<ns2:Edition>1</ns2:Edition>
<ns2:ItemDimensions>
<ns2:Height Units="inches">9.17</ns2:Height>
<ns2:Length Units="inches">7.36</ns2:Length>
<ns2:Width Units="inches">0.75</ns2:Width>
<ns2:Weight Units="pounds">1.40</ns2:Weight>
</ns2:ItemDimensions>
<ns2:IsEligibleForTradeIn>true</ns2:IsEligibleForTradeIn>
<ns2:Label>Manning Publications</ns2:Label>
<ns2:Languages>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Unknown</ns2:Type>
</ns2:Language>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Original Language</ns2:Type>
</ns2:Language>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Published</ns2:Type>
</ns2:Language>
</ns2:Languages>
<ns2:ListPrice>
<ns2:Amount>44.99</ns2:Amount>
<ns2:CurrencyCode>USD</ns2:CurrencyCode>
</ns2:ListPrice>
<ns2:Manufacturer>Manning Publications</ns2:Manufacturer>
<ns2:NumberOfItems>1</ns2:NumberOfItems>
<ns2:NumberOfPages>368</ns2:NumberOfPages>
<ns2:PackageDimensions>
<ns2:Height Units="inches">0.80</ns2:Height>
<ns2:Length Units="inches">9.10</ns2:Length>
<ns2:Width Units="inches">7.30</ns2:Width>
<ns2:Weight Units="pounds">1.35</ns2:Weight>
</ns2:PackageDimensions>
<ns2:ProductGroup>Book</ns2:ProductGroup>
<ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName>
<ns2:PublicationDate>2009-07-05</ns2:PublicationDate>
<ns2:Publisher>Manning Publications</ns2:Publisher>
<ns2:SmallImage>
<ns2:URL>
http://ecx.images-amazon.com/images/I/51EEz05N2HL._SL75_.jpg
</ns2:URL>
<ns2:Height Units="pixels">75</ns2:Height>
<ns2:Width Units="pixels">60</ns2:Width>
</ns2:SmallImage>
<ns2:Studio>Manning Publications</ns2:Studio>
<ns2:Title>Algorithms of the Intelligent Web</ns2:Title>
</ns2:ItemAttributes>
</AttributeSets>
<Relationships/>
<SalesRankings>
<SalesRank>
<ProductCategoryId>book_display_on_website</ProductCategoryId>
<Rank>59485</Rank>
</SalesRank>
<SalesRank>
<ProductCategoryId>377886011</ProductCategoryId>
<Rank>32</Rank>
</SalesRank>
<SalesRank>
<ProductCategoryId>3887</ProductCategoryId>
<Rank>66</Rank>
</SalesRank>
<SalesRank>
<ProductCategoryId>3870</ProductCategoryId>
<Rank>82</Rank>
</SalesRank>
</SalesRankings>
</Product>
</Products>
</GetMatchingProductForIdResult>
<GetMatchingProductForIdResult Id="0439708184" 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>ATVPDKIKX0DER</MarketplaceId>
<ASIN>059035342X</ASIN>
</MarketplaceASIN>
</Identifiers>
<AttributeSets>
<ns2:ItemAttributes xml:lang="en-US">
<ns2:Author>Rowling, J.K.</ns2:Author>
<ns2:Binding>Paperback</ns2:Binding>
<ns2:Brand>Scholastic Press</ns2:Brand>
<ns2:Creator Role="Illustrator">GrandPré, Mary</ns2:Creator>
<ns2:Edition>1st</ns2:Edition>
<ns2:Feature>Recommended Age: 9 years and up</ns2:Feature>
<ns2:ItemDimensions>
<ns2:Height Units="inches">0.80</ns2:Height>
<ns2:Length Units="inches">7.50</ns2:Length>
<ns2:Width Units="inches">5.20</ns2:Width>
<ns2:Weight Units="pounds">0.50</ns2:Weight>
</ns2:ItemDimensions>
<ns2:IsAutographed>false</ns2:IsAutographed>
<ns2:IsMemorabilia>false</ns2:IsMemorabilia>
<ns2:Label>Scholastic Paperbacks</ns2:Label>
<ns2:Languages>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Unknown</ns2:Type>
</ns2:Language>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Original Language</ns2:Type>
</ns2:Language>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Published</ns2:Type>
</ns2:Language>
</ns2:Languages>
<ns2:ListPrice>
<ns2:Amount>10.99</ns2:Amount>
<ns2:CurrencyCode>USD</ns2:CurrencyCode>
</ns2:ListPrice>
<ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer>
<ns2:NumberOfItems>1</ns2:NumberOfItems>
<ns2:NumberOfPages>320</ns2:NumberOfPages>
<ns2:PackageDimensions>
<ns2:Height Units="inches">1.00</ns2:Height>
<ns2:Length Units="inches">7.50</ns2:Length>
<ns2:Width Units="inches">5.20</ns2:Width>
<ns2:Weight Units="pounds">0.50</ns2:Weight>
</ns2:PackageDimensions>
<ns2:PackageQuantity>1</ns2:PackageQuantity>
<ns2:PartNumber>9780590353427</ns2:PartNumber>
<ns2:ProductGroup>Book</ns2:ProductGroup>
<ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName>
<ns2:PublicationDate>1999-10-01</ns2:PublicationDate>
<ns2:Publisher>Scholastic Paperbacks</ns2:Publisher>
<ns2:ReleaseDate>1999-09-08</ns2:ReleaseDate>
<ns2:SmallImage>
<ns2:URL>
http://ecx.images-amazon.com/images/I/51MU5VilKpL._SL75_.jpg
</ns2:URL>
<ns2:Height Units="pixels">75</ns2:Height>
<ns2:Width Units="pixels">51</ns2:Width>
</ns2:SmallImage>
<ns2:Studio>Scholastic Paperbacks</ns2:Studio>
<ns2:Title>Harry Potter and the Sorcerer's Stone (Book 1)</ns2:Title>
</ns2:ItemAttributes>
</AttributeSets>
<Relationships/>
<SalesRankings>
<SalesRank>
<ProductCategoryId>book_display_on_website</ProductCategoryId>
<Rank>362</Rank>
</SalesRank>
<SalesRank>
<ProductCategoryId>15356791</ProductCategoryId>
<Rank>6</Rank>
</SalesRank>
<SalesRank>
<ProductCategoryId>3153</ProductCategoryId>
<Rank>9</Rank>
</SalesRank>
<SalesRank>
<ProductCategoryId>3045</ProductCategoryId>
<Rank>14</Rank>
</SalesRank>
</SalesRankings>
</Product>
<Product>
<Identifiers>
<MarketplaceASIN>
<MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
<ASIN>0439708184</ASIN>
</MarketplaceASIN>
</Identifiers>
<AttributeSets>
<ns2:ItemAttributes xml:lang="en-US">
<ns2:Author>J.K. Rowling, Mary GrandPré</ns2:Author>
<ns2:Binding>Paperback</ns2:Binding>
<ns2:Label>Scholastic Paperbacks</ns2:Label>
<ns2:Languages>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Unknown</ns2:Type>
</ns2:Language>
<ns2:Language>
<ns2:Name>english</ns2:Name>
<ns2:Type>Published</ns2:Type>
</ns2:Language>
</ns2:Languages>
<ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer>
<ns2:NumberOfItems>1</ns2:NumberOfItems>
<ns2:NumberOfPages>784</ns2:NumberOfPages>
<ns2:PackageDimensions>
<ns2:Height Units="inches">0.73</ns2:Height>
<ns2:Length Units="inches">8.43</ns2:Length>
<ns2:Width Units="inches">5.85</ns2:Width>
<ns2:Weight Units="pounds">0.79</ns2:Weight>
</ns2:PackageDimensions>
<ns2:ProductGroup>Book</ns2:ProductGroup>
<ns2:ProductTypeName>BOOKS_1973_AND_LATER</ns2:ProductTypeName>
<ns2:PublicationDate>1999-09-08</ns2:PublicationDate>
<ns2:Publisher>Scholastic Paperbacks</ns2:Publisher>
<ns2:SmallImage>
<ns2:URL>
http://ecx.images-amazon.com/images/I/51STfI7UiCL._SL75_.jpg
</ns2:URL>
<ns2:Height Units="pixels">75</ns2:Height>
<ns2:Width Units="pixels">52</ns2:Width>
</ns2:SmallImage>
<ns2:Studio>Scholastic Paperbacks</ns2:Studio>
<ns2:Title>Harry Potter and the Sorcerer's Stone</ns2:Title>
</ns2:ItemAttributes>
</AttributeSets>
<Relationships/>
<SalesRankings>
<SalesRank>
<ProductCategoryId>book_display_on_website</ProductCategoryId>
<Rank>2091024</Rank>
</SalesRank>
</SalesRankings>
</Product>
</Products>
</GetMatchingProductForIdResult>
<ResponseMetadata>
<RequestId>7ba3245e-a213-430a-bea9-EXAMPLE38d76</RequestId>
</ResponseMetadata>
</GetMatchingProductForIdResponse>