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 ドキュメント

GetMyPriceForSKU

SellerSKUに応じた、出品者自身の出品の価格情報を返します。

説明

GetMyPriceForSKUオペレーションは、指定したSellerSKUMarketplaceIdにマッピングされているASINに基づき、出品者自身の出品の価格設定情報を返します。出品していない商品のSellerSKUを送信した場合は、Offers要素が空の状態で返されます。このオペレーションは、商品の価格情報を最大20件返します。

利用可否

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

スロットル

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

リクエストパラメーター

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

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

タイプ:xs:string

はい MarketplaceId値の一覧については、Amazon MWS開発者ガイドAmazon MWSエンドポイントとMarketplaceId値を参照してください。
SellerSKUList SellerSKU値の構造化リスト。指定したマーケットプレイスにある商品を識別するために使用。SellerSKUは出品者のSellerIdにより限定されます。SellerIdは、送信する各AmazonマーケットプレイスWebサービス(Amazon MWS)オペレーションに含まれます。

タイプ:xsのリスト:string

はい 最大:20個のSellerSKU
ItemCondition 商品コンディションにより出品をフィルターする。

タイプ:xs:string

いいえ ItemCondition値:
  • New
  • Used
  • Collectible
  • Refurbished
  • Club

デフォルト:All

レスポンス要素

GetMyPriceForSKUオペレーションが返すレスポンス要素は、一般に公開されているXSD: ProductsAPI_Response.xsdで内容を確認できます。以下の表は、GetMyPriceForSKUオペレーションで返される主要な要素に関する追加情報です。

名前 説明
Identifiers 商品を一意に識別する以下のIDを含む。
  • MarketplaceASIN: MarketplaceIdASINの組み合わせ。
  • SKUIdentifier: MarketplaceIdSellerSKUSellerIdの組み合わせ。リクエストにSellerSKUが指定されている場合のみ返されます。
BuyingPrice プロモーションおよび配送料などを含む、価格情報を含む。

以下の要素を含む:

  • LandedPrice: ListingPrice + Shipping - Points。LandedPriceが返されない場合、ListingPriceがその商品の最低のLandedPriceを表します。
  • ListingPrice: 商品に適用されるプロモーションなどを含む現在の価格。
  • Shipping: 商品の配送料。
  • Points: 商品の購入で獲得するAmazonポイント数と相当金額。Points要素が返されるのは日本(JP)の場合のみです。
RegularPrice 商品に適用されるプロモーションを除く現在の価格。配送料を除きます。
FulfillmentChannel 出品のフルフィルメントチャネル

有効値:

  • Amazon: Amazonから出荷。
  • Merchant: 出品者から出荷。
ItemCondition その出品の商品コンディション。有効値:NewUsedCollectibleRefurbishedClub
ItemSubCondition その出品の商品サブコンディション。有効値:NewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen Box、 またはOther
SellerId オペレーションで送信されたSellerId
SellerSKU その出品のSellerSKU

クエリリクエスト例

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

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

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=GetMyPriceForSKU
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SellerSKUList.SellerSKU.1=SKU2468
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T22%3A08%3A04Z
&Version=2011-10-01
&Signature=%2B0EXAMPLEuiHJv7xLyYVBgLQa17eJtmP4MIEXAMPLE0%3D

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<GetMyPriceForSKUResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetMyPriceForSKUResult SellerSKU="SKU2468" 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>1933890517</ASIN>
                </MarketplaceASIN>
                <SKUIdentifier>
                    <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                    <SellerId>A1IMEXAMPLEWRC</SellerId>
                    <SellerSKU>SKU2468</SellerSKU>
                </SKUIdentifier>
            </Identifiers>
            <Offers>
                <Offer>
                    <BuyingPrice>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>303.99</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>300.00</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>3.99</Amount>
                        </Shipping>
                    </BuyingPrice>
                    <RegularPrice>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>300.00</Amount>
                    </RegularPrice>
                    <FulfillmentChannel>MERCHANT</FulfillmentChannel>
                    <ItemCondition>Used</ItemCondition>
                    <ItemSubCondition>Acceptable</ItemSubCondition>
                    <SellerId>A1IMEXAMPLEWRC</SellerId>
                    <SellerSKU>SKU2468</SellerSKU>
                </Offer>
            </Offers>
        </Product>
    </GetMyPriceForSKUResult>
    <ResponseMetadata>
        <RequestId>bc6e4601-3d74-4612-adcf-EXAMPLEf1796</RequestId>
    </ResponseMetadata>
</GetMyPriceForSKUResponse>

↑ トップへ戻る