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

GetMyPriceForASIN

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

説明

GetMyPriceForASINオペレーションは、商品を一意に識別するためにMarketplaceIdASINを指定する点と、SKUIdentifier要素を返さない点を除き、GetMyPriceForSKUオペレーションと同様です。

利用可否

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

スロットリング

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

リクエストパラメーター

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

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

タイプ:xs:string

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

タイプ:xsのリスト:string

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

タイプ:xs:string

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

デフォルト:All

レスポンス要素

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

名前 説明
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>

ASINList.ASIN.1=1933890517
&AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetMyPriceForASIN
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T22%3A40%3A47Z
&Version=2011-10-01
&Signature=x%2FEXAMPLEFSPqX7tAN83%2FROsuHWc04SEaepLkEXAMPLEo%3D

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<GetMyPriceForASINResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetMyPriceForASINResult ASIN="1933890517" 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>
            </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>
    </GetMyPriceForASINResult>
    <ResponseMetadata>
        <RequestId>a3381684-87bd-416e-9b95-EXAMPLE9c236</RequestId>
    </ResponseMetadata>
</GetMyPriceForASINResponse>

↑ トップへ戻る