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

Deprecation Notice:

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 文档

UpdateReportAcknowledgements

更新一个或多个报告的确认状态。

描述

UpdateReportAcknowledgements 操作是可选请求,用于更新一个或多个报告的已确认状态。如果您希望亚马逊MWS 记住您报告的已确认状态,请使用该操作。为随时了解您已收到哪些报告,在您收到并成功存储报告后确认报告是个不错的做法。这样,当提交 GetReportList 请求时,您就可以指定只接收您尚未确认的报告。

要找回已丢失的报告,请将 Acknowledged 设置为 false,然后提交 GetReportList 请求。该操作可返回过去 90 天内、与查询参数相匹配的所有报告列表。

注: 当提交 GetReportListGetReportListByNextToken 操作时,请确保 HasNext 返回 false 之后,再提交 UpdateReportAcknowledgements 操作。这样可确保返回与您的查询参数匹配的所有报告。

UpdateReportAcknowledgements 操作的最大请求限额为 10 个,恢复速率为每 45 秒 1 个请求。有关限制术语的定义,请参阅限制

请求参数

名称 描述 必填项 有效值
ReportIdList 报告编号的结构化列表。可以指定的最大报告数量为 100。

类型:xs:string

默认值:无
Acknowledged 布尔值,用来指明您是否已收到并保存了报告。指定为 true,可将报告的确认状态设置为 true。指定为 false,可将报告的确认状态设置为 false

类型:xs:boolean

默认值:全部

响应元素

名称 描述
Count 非负整数,指明报告请求总数。

类型:tns: nonNegativeInteger

ReportId 报告的唯一编码。

类型:xs:string

ReportType 所请求的 ReportType 值。
ReportRequestId 报告请求的唯一编码。

类型:xs:string

AvailableDate 报告可供使用的日期。

类型:xs:dateTime

Acknowledged 布尔值,用来指明在之前调用 UpdateReportAcknowledgements 之时是否已确认报告。如果报告已确认,则该值为 true;否则为 false

类型:xs:boolean

AcknowledgedDate 确认报告的日期。

类型:xs:dateTime

示例

查询请求示例

https://mws.amazonservices.com/
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=UpdateReportAcknowledgements
  &ReportIdList.Id.1=841997483
  &ReportIdList.id.2=843337483
  &Acknowledged=true
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &Marketplace=ATVPDKIKX0DER
  &SellerId=A1XEXAMPLE5E6
  &ReportIdList=624169093
  &Signature=cE8%2FUgE8BspmM%2B26UTy7oVEdBk4%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2009-02-04T18%3A12%3A20.718Z
  &Version=2009-01-01            
           

响应示例

<?xml version="1.0"?>
<UpdateReportAcknowledgementsResponse
  xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
  <UpdateReportAcknowledgementsResult>
    <Count>1</Count>
    <ReportInfo>
      <ReportId>841997483</ReportId>
      <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
      <ReportRequestId>2234038326</ReportRequestId>
      <AvailableDate>2009-01-06T03:48:36+00:00</AvailableDate>
      <Acknowledged>true</Acknowledged>
      <AcknowledgedDate>2009-02-20T02:10:41+00:00</AcknowledgedDate>
    </ReportInfo>
  </UpdateReportAcknowledgementsResult>
  <ResponseMetadata>
    <RequestId>42a578a7-ed92-486b-ac67-5de7464fcdfa</RequestId>
  </ResponseMetadata>
</UpdateReportAcknowledgementsResponse>