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

GetReportList

返回在过去 90 天内所创建的报告列表。

描述

GetReportList 操作可返回与查询参数相匹配的、过去 90 天内所创建的报告列表。每个请求最多可返回 100 个结果。如果还可以返回其他结果,则响应中所返回的 HasNext 值为 true。要检索所有结果,您可以将 NextToken 参数的值反复传递给 GetReportListByNextToken 操作,直至 HasNext 的返回值为 false

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

请求参数

名称 描述 必填项 有效值
MaxCount 非负整数,表明待返回报告请求的最大数量。如果指定一个大于 100 的数字,请求将被拒绝。

类型:xs:nonNegativeInteger

1-100

默认值:10

ReportTypeList ReportType 枚举值的结构化列表。

类型:xs:string

默认值:全部
Acknowledged 布尔值,用来指明在之前调用 UpdateReportAcknowledgements 时是否已确认订单报告。所发布订单报告如已经确认,则设置为 true;所发布订单报告如未经确认,则设置为 false。此过滤器仅对订单报告有效;不支持商品报告。

类型:xs:boolean

默认值:全部
AvailableFromDate 您可进行查找的最早日期,格式为 ISO8601。

类型:xs:dateTime

默认值:90 天前
AvailableToDate 您可进行查找的最近日期,格式为 ISO8601。

类型:xs:dateTime

默认值:现在
ReportRequestIdList ReportRequestId 值的结构化列表。如果您传入 ReportRequestId 的值,则会忽略其他查询条件。

类型:xs:string

默认值:全部

响应元素

名称 描述
NextToken 字符串标记,用于向另一调用传递信息。如果 HasNext 的值为 true,则使用 NextToken 再次调用操作。

类型:xs:string

HasNext 布尔值,用来指明是否可返回多个对象,要求其他调用执行此操作,以对其进行检索。如果还有其他待检索对象,则值为 true;否则值为 false

类型:xs:boolean

ReportId 报告的唯一编码。

类型:xs:string

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

类型:xs:string

AvailableDate 报告可供使用的日期。

类型:xs:dateTime

Acknowledged 如果报告已确认,则值为 true;否则值为 false

类型:xs:boolean

AcknowledgedDate 确认报告的日期。

类型:xs:dateTime

示例

查询请求示例

https://mws.amazonservices.com/
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Acknowledged=false
  &Action=GetReportList
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &ReportRequestIdList.Id.1=2291326454
  &ReportRequestIdList.Id.2=2294446454
  &ReportTypeList.Type.1=_GET_ORDERS_DATA_
  &Marketplace=ATVPDKIKX0DER
  &SellerId=A1XEXAMPLE5E6
  &Signature=3yvUqWWBpLDld9CCx0ANjVU95ks%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2009-02-04T18%3A12%3A19.796Z
&Version=2009-01-01            
           

响应示例

<?xml version="1.0"?>
<GetReportListResponse xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
  <GetReportListResult>
  <NextToken>2YgYW55IPQhvu5hbCBwbGVhc3VyZS4=</NextToken>
    <HasNext>true</HasNext>
    <ReportInfo>
      <ReportId>898899473</ReportId>
      <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
      <ReportRequestId>2278662938</ReportRequestId>
      <AvailableDate>2009-02-10T09:22:33+00:00</AvailableDate>
      <Acknowledged>false</Acknowledged>
    </ReportInfo>
  </GetReportListResult>
  <ResponseMetadata>
    <RequestId>fbf677c1-dcee-4110-bc88-2ba3702e331b</RequestId>
  </ResponseMetadata>
</GetReportListResponse