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.
上传上传数据以供亚马逊MWS处理。
该 SubmitFeed 操作可上传文件及所有待处理的必要元数据。请注意:您必须计算所提交文件的 Content-MD5 标头。有关创建 Content-MD5 标头的更多信息,请参阅 您应了解的亚马逊 MWS 上传数据 API 部分的相关内容。
该 SubmitFeed 操作的最大请求限额为 15 个,恢复速率为每 2 分钟 1 个请求。有关限制术语的定义以及限制的完整解释,请参阅亚马逊MWS开发者指南中的限制:针对提交请求频率的限制。
上传数据大小限制在每个上传数据 2,147,483,647 字节 (2^31 -1)。如果您有大量数据需要提交,则应通过将数据拆分来提交小于上传数据大小限制的上传数据,或者在一段时间内分别提交这些上传数据。例如,提交最大为 30,000 个记录/项目的上传数据,或在一段时间内(如每隔几小时)提交上传数据。
通常,按照以下指南操作,您就可以最快速度处理上传数据文件:
必须根据您的商城和文件类型,对您的上传数据进行有效编码,同时,必须将编码指定为 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>