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.
ASINList、SellerSKUList、IdListの各リクエストパラメーターを使用して一括でオペレーションを実行する方法を説明しています。
ASINList、SellerSKUList、またはIdListを入力パラメーターとするAmazon MWS商品APIセクションの各種オペレーションでは、これらの入力パラメーター(ASINまたはSellerSKU)に対する結果は、その他の入力に対する結果とは別に返されます。したがって、たとえばGetCompetitivePricingForASINオペレーションにおいて、ASINList入力パラメーターに20のASINを指定し、このうち18のASINに対してのみ情報が取得できた場合、リクエスト全体をエラーとする代わりに18のASINに対する結果が返されます。また残りの2つのASINはエラーになったことも示されます。ASINList、SellerSKUList、またはIdListを入力パラメーターとする一括オペレーションは、GetMatchingProduct、GetMatchingProductForId、GetCompetitivePricingForSKU、GetCompetitivePricingForASIN、GetLowestOfferListingsForSKU、GetLowestOfferListingsForASIN、GetMyFeesEstimateの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 (ASIN、SellerSKU、またはId)に対し、OperationNameResultレスポンス要素を返します。各OperationNameResultレスポンス要素には、指定した商品IDに一致する商品が返されたかどうかを示すStatus属性、およびリクエストでASIN、SellerSKU、Idのどれが指定されたかを示すASIN、SellerSKU、またはIdの各属性が含まれます。
以下の表に、Amazon MWS商品APIセクションの一括オペレーションで返されるレスポンス要素を示します。本書では、これら各レスポンス要素の例を各レスポンス例のセクションで確認することができます。
名前 | 説明 |
---|---|
OperationNameResult | リクエストで指定した商品ID (ASIN、SellerSKU、またはId)に対して返される要素。たとえば、GetLowestOfferListingsForSKUオペレーションを送信した場合、この要素はGetLowestOfferListingsForSKUResult.と呼ばれる。 |
Status | OperationNameResult要素の属性。指定した商品ID (ASIN、SellerSKU、またはId)に対し一致する商品が返されたかどうかを示す。 有効値:
|
ASIN |
OperationNameResult要素の属性。リクエストで指定したASINを示す。 ASINを入力する場合、必須。 |
SellerSKU |
OperationNameResult要素の属性。リクエストで指定したSellerSKUを示す。 SellerSKUを入力する場合、必須。 |
IdType |
OperationNameResult要素の属性。リクエストで指定したIdTypeを示す。 IdTypeを入力する場合、必須。 |
Id |
OperationNameResult要素の属性。リクエストで指定したIdを示す。 Idを入力する場合、必須。 |
Error |
次の子要素に対する親要素:Type、Code、Message。 status=ClientErrorまたはstatus=ServerErrorの場合のみ返される。 任意。 |
Code |
レスポンスが失敗したときのエラーのタイプ。 例: InternalError 任意。 |
Type |
リクエスト関連のエラーか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>