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

SubmitFeed

上传上传数据以供亚马逊 MWS处理。

描述

SubmitFeed 操作可上传文件及所有待处理的必要元数据。请注意:您必须计算所提交文件的 Content-MD5 标头。有关创建 Content-MD5 标头的更多信息,请参阅 您应了解的亚马逊 MWS 上传数据 API 部分的相关内容

SubmitFeed 操作的最大请求限额为 15 个,恢复速率为每 2 分钟 1 个请求。有关限制术语的定义以及限制的完整解释,请参阅亚马逊 MWS 开发者指南中的限制:针对提交请求频率的限制

上传数据大小限制在每个上传数据 2,147,483,647 字节 (2^31 -1)。如果您有大量数据需要提交,则应通过将数据拆分来提交小于上传数据大小限制的上传数据,或者在一段时间内分别提交这些上传数据。例如,提交最大为 30,000 个记录/项目的上传数据,或在一段时间内(如每隔几小时)提交上传数据。

最快处理上传数据

通常,按照以下指南操作,您就可以最快速度处理上传数据文件:

  • 避免提交大量只包含几条记录的上传数据文件。尽可能将这些数据整合为少量较大的上传数据文件。
  • 仅包含要更新的商品,不要包含所有库存商品。
  • 上传同一类型的上传数据文件的时间间隔要超过 20 分钟。以便有足够的时间来处理较大的上传数据文件。
  • 将文件大小控制在 10 MB 以内

设置上传数据的 Content-Type

必须根据您的商城和文件类型,对您的上传数据进行有效编码,同时,必须将编码指定为 HTTP Content-Type 标头。以下表格向您显示了可用于每个商城库存模板文件及 XML 文件的 HTTP Content-Type 标头:

商城 库存模板文件 Content-Type XML 文件 Content-Type
北美和欧洲 text/tab-separated-values; charset=iso-8859-1 text/xml
日本 text/tab-separated-values; charset=Shift_JIS text/xml
中国 text/tab-separated-values;charset=UTF-8

text/tab-separated-values;charset=UTF-16

text/xml

使用多个商城编号提交上传数据

如果某一亚马逊卖家注册了多个商城,则该卖家的卖家编号将会对应多个商城编号。有关使用多个商城编号提交上传数据的更多信息,请参阅使用多个商城

请求参数

有关所有亚马逊 MWS 操作的必需请求参数的更多信息,请参阅亚马逊 MWS 开发者指南中的必需的请求参数

名称 描述 必填项 有效值
FeedContent 上传数据自身的实际内容,可以是 XML 文件或库存模板文件格式。您必须 在 HTTP 请求的正文中包含 FeedContent

类型:HTTP-BODY

默认值:无
FeedType FeedType 值,指明了数据处理方式。

类型:xs:string

默认值:无
MarketplaceIdList 您已注册的要应用上传数据的一个或多个 商城 ID。上传数据将应用于您指定的所有商城。

例如: &MarketplaceIdList.Id.1=A13V1IB3VIYZZH &MarketplaceIdList.Id.2=A1PA6795UKMFR9

请注意: MarketplaceIdList 请求参数不在日本 (JP) 和中国 (CN) 使用。

您所注册的商城 ID。

默认值:您所注册的第一个商城。

PurgeAndReplace 可启用清除并替换功能的布尔值。要清除并替换现有数据,设置为 true,否则设置为 false。该值仅适用于商品相关库存模板文件上传数据类型,不可在上传数据正文中指定清除并替换。只能在特殊情况下使用该参数。其使用受到限制,在 24 小时的时段内,只允许进行一次清除和替换。

类型:xs:boolean

默认值:false

响应元素

名称 描述
FeedSubmissionId 上传数据提交的唯一编码。

类型:xs:string

FeedType 已提交的上传数据类型。这是提供给 SubmitFeed 操作的 FeedType 值。
SubmittedDate 提交上传数据的日期和时间。

类型:xs:dateTime

FeedProcessingStatus 所提交的上传数据的处理状态。有关更多信息,请参阅 FeedProcessingStatus 枚举

示例

查询请求示例

POST /?AWSAccessKeyId=0PB842ExampleN4ZTR2
&Action=SubmitFeed
&FeedType=_POST_PRODUCT_DATA_
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceIdList.Id.1=ATVExampleDER
&SellerId=A1XExample5E6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-01-26T23%3A51%3A31.315Z
&Version=2009-01-01
&Signature=SvSExamplefZpSignaturex2cs%3D HTTP/1.1
Content-MD5: ExampleMd5HashOfHttpBodyAsPerRfc2616Example
Content-Type: text/xml; charset=iso-8859-1
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

以下是针对健康相关商品 SubmitFeed 请求的 HTTP 正文示例。请参阅以上有关 FeedContent 的说明。未加密形式的 HTTP 正文如下:

<?xml version="1.0" encoding="utf-8"?>
<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>M_EXAMPLE_123456</MerchantIdentifier>
  </Header>
  <MessageType>Product</MessageType>
  <PurgeAndReplace>false</PurgeAndReplace>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Product>
      <SKU>56789</SKU>
      <StandardProductID>
        <Type>ASIN</Type>
        <Value>B0EXAMPLEG</Value>
      </StandardProductID>
      <ProductTaxCode>A_GEN_NOTAX</ProductTaxCode>
      <DescriptionData>
        <Title>Example Product Title</Title>
        <Brand>Example Product Brand</Brand>
        <Description>This is an example product description.</Description>
        <BulletPoint>Example Bullet Point 1</BulletPoint>
        <BulletPoint>Example Bullet Point 2</BulletPoint>
        <MSRP currency="USD">25.19</MSRP>
        <Manufacturer>Example Product Manufacturer</Manufacturer>
        <ItemType>example-item-type</ItemType>
      </DescriptionData>
      <ProductData>
        <Health>
          <ProductType>
            <HealthMisc>
              <Ingredients>Example Ingredients</Ingredients>
              <Directions>Example Directions</Directions>
            </HealthMisc>
          </ProductType>
        </Health>
      </ProductData>
    </Product>
  </Message>
</AmazonEnvelope>

示例响应

亚马逊 MWS 对以下标头进行响应:

HTTP/1.1 200 OK
Content-Type: text/xml

亚马逊 MWS 对以下 HTTP 正文进行响应:

<?xml version="1.0" encoding="utf-8"?>
<SubmitFeedResponse xmlns="http://mws.amazonaws.com/doc/2009-01-01/">
  <SubmitFeedResult>
    <FeedSubmissionInfo>
      <FeedSubmissionId>2291326430</FeedSubmissionId>
      <FeedType>_POST_PRODUCT_DATA_</FeedType>
      <SubmittedDate>2009-02-20T02:10:35+00:00</SubmittedDate>
      <FeedProcessingStatus>_SUBMITTED_</FeedProcessingStatus>
    </FeedSubmissionInfo>
  </SubmitFeedResult>
  <ResponseMetadata>
    <RequestId>75424a38-f333-4105-98f0-2aa9592d665c</RequestId>
  </ResponseMetadata>
</SubmitFeedResponse>