Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

Deprecation Notice:

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.

Amazon MWS ドキュメント

GetMatchingProduct

ASINのリストに応じた、商品およびその属性のリストを返します。

説明

GetMatchingProductオペレーションは、指定したASINのリストに応じた、商品およびその属性のリストを返します。このオペレーションは最大10商品を返します。

重要:GetMatchingProductオペレーションのすべての機能は、新しいGetMatchingProductForIdオペレーションにあります。GetMatchingProductオペレーションは、互換性のために商品APIセクションに含まれていますが、可能な限りGetMatchingProductの代わりにGetMatchingProductForIdオペレーションを使用してください。詳しくは、GetMatchingProductForIdを参照してください。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。

スロットル

最大リクエストクォータ 回復レート 時間あたりのリクエストクォータ
20リクエスト 1秒ごとに2商品 1時間あたり7200リクエスト
スロットリング用語の定義およびスロットリングの詳しい説明については、Amazon MWS開発者ガイドスロットリング:リクエストの送信頻度を制限するを参照してください。商品ごとのスロットリングの詳細については、商品APIのスロットリングを参照してください。

リクエストパラメーター

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイド必須のリクエストパラメーターを参照してください。

名前 説明 必須 推奨値
MarketplaceId マーケットプレイスID。商品情報を取得したいマーケットプレイスを指定する。

タイプ:xs:string

はい MarketplaceId値の一覧については、Amazon MWS開発者ガイドAmazon MWSエンドポイントとMarketplaceId値を参照してください。
ASINList ASIN値の構造化リスト。指定したマーケットプレイスにある商品を識別するために使用。

タイプ:xsのリスト:string

はい 最大:10個のASIN

レスポンス要素

GetMatchingProductオペレーションが返すレスポンス要素は、一般に公開されている次のXSDで内容を確認できます。

以下の表は、GetMatchingProductオペレーションで返される主要な要素に関する追加情報です。

注: Amazon MWS商品APIセクションは、新しいレスポンス要素を追加して更新しているため、ProductsAPI_Response.xsdスキーマとdefault.xsdスキーマも更新する場合があります。これらのスキーマを検証に使用する場合は、ご注意ください。
名前 説明
Product ProductsAPI_Response.xsdのProduct要素の4つのサブ要素を含む。サブ要素:IdentifiersAttributeSetsRelationshipsSalesRankings
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 商品カテゴリー別の商品売上ランキング情報。

サブ要素:

  • ProductCategoryId。売上ランキングの対象の商品カテゴリーを指定する。
  • Rank。商品カテゴリー内の商品の売上ランク。

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

POST /Products/2011-10-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

ASINList.ASIN.1=B002KT3XRQ
&AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetMatchingProduct
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A01%3A53Z
&Version=2011-10-01
&Signature=5O%2EXAMPLEtpSD0NbC%2FltDxXuLe2TXAd%2B48AEXAMPLE0%3D

↑ トップへ戻る

レスポンス例

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<GetMatchingProductResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetMatchingProductResult ASIN="B002KT3XRQ" status="Success">
        <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"
            xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
            <Identifiers>
                <MarketplaceASIN>
                    <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                    <ASIN>B002KT3XRQ</ASIN>
                </MarketplaceASIN>
            </Identifiers>
            <AttributeSets>
                <ns2:ItemAttributes xml:lang="en-US">
                    <ns2:Binding>Apparel</ns2:Binding>
                    <ns2:Brand>Pearl iZUMi</ns2:Brand>
                    <ns2:Department>mens</ns2:Department>
                    <ns2:Feature>
                        Select transfer fabric sets the benchmark for moisture transfer and
                        four-way performance stretch
                    </ns2:Feature>
                    <ns2:Feature>
                        6-Panel anatomic design for superior, chafe-free comfort, UPF 50+ sun
                        protection
                    </ns2:Feature>
                    <ns2:Feature>
                        Comfortable silicone leg grippers keep shorts in place,
                        moisture-wicking, antimicrobial properties
                    </ns2:Feature>
                    <ns2:Feature>
                        Tour 3D Chamois is male-specific and non-chafing with padding in
                        key areas
                    </ns2:Feature>
                    <ns2:Feature>86 percent nylon, 14% spandex, 9-Inch inseam</ns2:Feature>
                    <ns2:ItemDimensions>
                        <ns2:Height Units="inches">2.00</ns2:Height>
                        <ns2:Length Units="inches">9.00</ns2:Length>
                        <ns2:Width Units="inches">9.00</ns2:Width>
                    </ns2:ItemDimensions>
                    <ns2:Label>Pearl iZUMi</ns2:Label>
                    <ns2:ListPrice>
                        <ns2:Amount>50.00</ns2:Amount>
                        <ns2:CurrencyCode>USD</ns2:CurrencyCode>
                    </ns2:ListPrice>
                    <ns2:Manufacturer>Pearl iZUMi</ns2:Manufacturer>
                    <ns2:Model>0275</ns2:Model>
                    <ns2:PackageDimensions>
                        <ns2:Height Units="inches">2.80</ns2:Height>
                        <ns2:Length Units="inches">9.75</ns2:Length>
                        <ns2:Width Units="inches">8.40</ns2:Width>
                        <ns2:Weight Units="pounds">0.40</ns2:Weight>
                    </ns2:PackageDimensions>
                    <ns2:PackageQuantity>1</ns2:PackageQuantity>
                    <ns2:PartNumber>0275</ns2:PartNumber>
                    <ns2:ProductGroup>Apparel</ns2:ProductGroup>
                    <ns2:ProductTypeName>SHORTS</ns2:ProductTypeName>
                    <ns2:Publisher>Pearl iZUMi</ns2:Publisher>
                    <ns2:SmallImage>
                        <ns2:URL>
                            http://ecx.images-amazon.com/images/I/41ty3Sn%2BU8L._SL75_.jpg
                        </ns2:URL>
                        <ns2:Height Units="pixels">75</ns2:Height>
                        <ns2:Width Units="pixels">58</ns2:Width>
                    </ns2:SmallImage>
                    <ns2:Studio>Pearl iZUMi</ns2:Studio>
                    <ns2:Title>Pearl iZUMi Men's Quest Cycling Short</ns2:Title>
                </ns2:ItemAttributes>
            </AttributeSets>
            <Relationships>
                <ns2:VariationChild>
                    <Identifiers>
                        <MarketplaceASIN>
                            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                            <ASIN>B002KT3XQC</ASIN>
                        </MarketplaceASIN>
                    </Identifiers>
                    <ns2:Color>Black</ns2:Color>
                    <ns2:Size>Small</ns2:Size>
                </ns2:VariationChild>
                <ns2:VariationChild>
                    <Identifiers>
                        <MarketplaceASIN>
                            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                            <ASIN>B002KT3XQW</ASIN>
                        </MarketplaceASIN>
                    </Identifiers>
                    <ns2:Color>Black</ns2:Color>
                    <ns2:Size>Medium</ns2:Size>
                </ns2:VariationChild>
                <ns2:VariationChild>
                    <Identifiers>
                        <MarketplaceASIN>
                            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                            <ASIN>B002KT3XQM</ASIN>
                        </MarketplaceASIN>
                    </Identifiers>
                    <ns2:Color>Black</ns2:Color>
                    <ns2:Size>Large</ns2:Size>
                </ns2:VariationChild>
                <ns2:VariationChild>
                    <Identifiers>
                        <MarketplaceASIN>
                            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                            <ASIN>B002KT3XR6</ASIN>
                        </MarketplaceASIN>
                    </Identifiers>
                    <ns2:Color>Black</ns2:Color>
                    <ns2:Size>X-Large</ns2:Size>
                </ns2:VariationChild>
                <ns2:VariationChild>
                    <Identifiers>
                        <MarketplaceASIN>
                            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                            <ASIN>B002KT3XRG</ASIN>
                        </MarketplaceASIN>
                    </Identifiers>
                    <ns2:Color>Black</ns2:Color>
                    <ns2:Size>XX-Large</ns2:Size>
                </ns2:VariationChild>
            </Relationships>
            <SalesRankings>
                <SalesRank>
                    <ProductCategoryId>apparel_display_on_website</ProductCategoryId>
                    <Rank>159</Rank>
                </SalesRank>
                <SalesRank>
                    <ProductCategoryId>2420095011</ProductCategoryId>
                    <Rank>1</Rank>
                </SalesRank>
                <SalesRank>
                    <ProductCategoryId>2611189011</ProductCategoryId>
                    <Rank>4</Rank>
                </SalesRank>
            </SalesRankings>
        </Product>
    </GetMatchingProductResult>
    <ResponseMetadata>
        <RequestId>b12caada-d330-4d87-a789-EXAMPLE35872</RequestId>
    </ResponseMetadata>
</GetMatchingProductResponse>

↑ トップへ戻る