Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档
亚马逊 MWS 文档

处理批量操作请求

介绍如何使用 ASINListSellerSKUListIdList 请求参数处理批量操作。

在亚马逊 MWS 商品 API 部分中,以 ASINListSellerSKUListIdList 作为输入参数的操作可以为所有输入值中的每个输入值单独返回结果。举例来说,如果您为 GetCompetitivePricingForASIN 操作的 ASINList 输入参数指定了 20 个 ASIN,而此操作只能获得其中 18 个 ASIN 的数据,则此操作会返回这 18 个 ASIN 的结果,而不会导致整个请求失败。此操作还会显示失败的其余两个 ASIN。以 ASINListSellerSKUListIdList 作为输入参数的六个批量操作为:GetMatchingProductGetMatchingProductForIdGetCompetitivePricingForSKUGetCompetitivePricingForASINGetLowestOfferListingsForSKUGetLowestOfferListingsForASIN

以下示例显示了如何使用 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 值。

亚马逊 MWS 商品 API 部分中的批量操作会对请求中指定的各个商品编码(ASINSellerSKUId)返回一个 OperationNameResult 响应元素。每个 OperationNameResult 响应元素都包含一个 Status 属性,用于表明是否能为指定的商品编码返回数据;还包含一个 ASINSellerSKUId 属性,用于表明请求中指定的 ASINSellerSKUId 值。

下表显示了在亚马逊 MWS 商品 API 部分中执行批量操作所返回的响应元素。请注意,您可以从本文档中相应的“响应示例”部分找到这些响应元素的示例。

批量操作中的响应元素

名称 描述
OperationNameResult 为请求中指定的各个商品编码(ASINSellerSKUId)返回的元素。例如,如果您提交了 GetLowestOfferListingsForSKU 操作,则此元素会被命名为 GetLowestOfferListingsForSKUResult
Status OperationNameResult 元素的一个属性。表明是否能为指定的商品编码(ASINSellerSKUId)返回数据。

有效值:

  • Success - 请求成功。
  • ClientError - 请求失败。请求出现问题。
  • ServerError - 请求失败。网络服务出现问题。
ASIN

OperationNameResult 元素的一个属性。表明请求中指定的 ASIN

ASIN 为输入值的操作需要有此属性。

SellerSKU

OperationNameResult 元素的一个属性。表明请求中指定的 SellerSKU

SellerSKU 为输入值的操作需要有此属性。

IdType

OperationNameResult 元素的一个属性。表明请求中指定的 IdType

IdType 为输入值的操作需要有此属性。

Id

OperationNameResult 元素的一个属性。表明请求中指定的 Id

Id 为输入值的操作需要有此属性。

Error

以下子元素的父元素:TypeCodeMessage

只在 status=ClientErrorstatus=ServerError 时返回此元素。

可选项。

Code

导致响应失败的错误类型。

示例:InternalError

可选项。

Type

表明是请求还是网络服务中的问题引发错误。

有效值:
  • Sender - 请求出现问题。
  • Receiver - 网络服务出现问题。

可选项。

Message

包含提供更多错误信息的消息。

示例:SellerSKU1 对于商城 ATVPDKIKX0DER 是一个无效 SellerSKU

可选项。

Detail

如果适用,包含其他任何详情。

可选项。

响应示例

<?xml version="1.0"?>
<OperationNameResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<OperationNameResult ASIN=”B002KT3XQM” status=”Success”>
  <!—Successful response goes here-->
</OperationNameResult>
<OperationNameResult ASIN=”B000O15GSG” status=”ClientError”>
  <Error>
    <Code>InvalidParameterValue</Code>
    <Type>Sender</Type>
    <Message>B000O15GSG is an invalid ASIN for marketplace ATVPDKIKX0DER</Message>
    <Detail/>
  </Error>
</OperationNameResult>
<ResponseMetadata>
  <RequestId>454d8b3c-5514-4919-b5ca-6a08fb974272</RequestId>
</ResponseMetadata>
</OperationNameResponse>