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

一括オペレーションリクエストを実行する

ASINListSellerSKUListIdListの各リクエストパラメーターを使用して一括でオペレーションを実行する方法を説明しています。

ASINListSellerSKUList、またはIdListを入力パラメーターとするAmazon MWS商品APIセクションの各種オペレーションでは、これらの入力パラメーター(ASINまたはSellerSKU)に対する結果は、その他の入力に対する結果とは別に返されます。したがって、たとえばGetCompetitivePricingForASINオペレーションにおいて、ASINList入力パラメーターに20のASINを指定し、このうち18のASINに対してのみ情報が取得できた場合、リクエスト全体をエラーとする代わりに18のASINに対する結果が返されます。また残りの2つのASINはエラーになったことも示されます。ASINListSellerSKUList、またはIdListを入力パラメーターとする一括オペレーションは、GetMatchingProductGetMatchingProductForIdGetCompetitivePricingForSKUGetCompetitivePricingForASINGetLowestOfferListingsForSKUGetLowestOfferListingsForASINGetMyFeesEstimateの7つです。

次の例では、ASINList入力パラメーターを使って3つのASINをクエリ文字列に指定しています。

https://mws.amazonservices.com/Products/2011-10-01
?AWSAccessKeyId=AKIAJGUVGFGHNKE2NVUA
&Action=GetMatchingProduct
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&SellerId=A2NK2PX936TF53
&SignatureVersion=2
&Timestamp=2012-02-07T01%3A22%3A39Z
&Version=2011-10-01
&Signature=MhSREjubAxTGSldGGWROxk4qvi3sawX1inVGF%2FepJOI%3D
&SignatureMethod=HmacSHA256
&MarketplaceId=ATVPDKIKX0DER
&ASINList.ASIN.1=B002KT3XRQ
&ASINList.ASIN.2=B002KT3XQC
&ASINList.ASIN.3=B002KT3XQM

SellerSKUを入力パラメーターとするクエリリクエストは 同様に生成され、&ASINList.ASINの代わりに &SellerSKUList.SellerSKUを使用し、ASINの値の代わりに SellerSKUの値を指定します。同様に、 Idを入力パラメーターとするクエリリクエストは 同様に生成され、&ASINList.ASINの代わりに&IdList.Idを使用し、 ASINの値の代わりにIdの値を指定します。

Amazon MWS商品APIセクションの一括オペレーションは、リクエストで指定された各商品ID (ASINSellerSKU、またはId)に対し、OperationNameResultレスポンス要素を返します。各OperationNameResultレスポンス要素には、指定した商品IDに一致する商品が返されたかどうかを示すStatus属性、およびリクエストでASINSellerSKUIdのどれが指定されたかを示すASINSellerSKU、またはIdの各属性が含まれます。

以下の表に、Amazon MWS商品APIセクションの一括オペレーションで返されるレスポンス要素を示します。本書では、これら各レスポンス要素の例を各レスポンス例のセクションで確認することができます。

一括オペレーションのレスポンス要素

名前 説明
OperationNameResult リクエストで指定した商品ID (ASINSellerSKU、またはId)に対して返される要素。たとえば、GetLowestOfferListingsForSKUオペレーションを送信した場合、この要素はGetLowestOfferListingsForSKUResult.と呼ばれる。
Status OperationNameResult要素の属性。指定した商品ID (ASINSellerSKU、またはId)に対し一致する商品が返されたかどうかを示す。

有効値:

  • Success: リクエストは成功。
  • ClientError: リクエストは失敗。リクエストに関する問題。
  • ServerError: リクエストは失敗。Webサービスに関する問題。
ASIN

OperationNameResult要素の属性。リクエストで指定したASINを示す。

ASINを入力する場合、必須。

SellerSKU

OperationNameResult要素の属性。リクエストで指定したSellerSKUを示す。

SellerSKUを入力する場合、必須。

IdType

OperationNameResult要素の属性。リクエストで指定したIdTypeを示す。

IdTypeを入力する場合、必須。

Id

OperationNameResult要素の属性。リクエストで指定したIdを示す。

Idを入力する場合、必須。

Error

次の子要素に対する親要素:TypeCodeMessage

status=ClientErrorまたはstatus=ServerErrorの場合のみ返される。

任意。

Code

レスポンスが失敗したときのエラーのタイプ。

例: InternalError

任意。

Type

リクエスト関連のエラーかWebサービス関連のエラーかを示す。

有効値:
  • Sender: リクエストに関する問題。
  • Receiver: Webサービスに関する問題。

任意。

Message

エラーの詳細情報を含む。

例: SellerSKU1 is an invalid SellerSKU for marketplace ATVPDKIKX0DER.

任意。

Detail

さらに詳細な情報がある場合、ここに含まれる。

任意。

レスポンス例

<?xml version="1.0"?>
<OperationNameResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<OperationNameResult ASIN=”B002KT3XQM” status=”Success”>
  <!—成功レスポンスをここに記載-->
</OperationNameResult>
<OperationNameResult ASIN=”B000O15GSG” status=”ClientError”>
  <Error>
    <Code>InvalidParameterValue</Code>
    <Type>Sender</Type>
    <Message>B000O15GSGはATVPDKIKX0DERマーケットプレイスに対して無効なASINです</Message>
    <Detail/>
  </Error>
</OperationNameResult>
<ResponseMetadata>
  <RequestId>454d8b3c-5514-4919-b5ca-6a08fb974272</RequestId>
</ResponseMetadata>
</OperationNameResponse>