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

GetReportRequestList

返回可用于获取报告的 ReportRequestId 的报告请求列表。

描述

GetReportRequestList 操作返回与查询参数相匹配的报告请求列表。您可为报告状态、日期范围和报告类型指定查询参数。列表中包含每个报告请求的 ReportRequestId。您可以通过在 GetReportList 操作中指定 ReportRequestId 值,来获取 ReportId 值。

对于首次请求,最多可返回 100 个报告请求。如果要返回更多报告请求,则将响应中所返回的 HasNext 值设置为 true。要检索所有结果,您可以将 NextToken 参数的值重复传递给 GetReportRequestListByNextToken 操作,直至 HasNext 的返回值为 false

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

请求参数

名称 描述 必填项 有效值
ReportRequestIdList ReportRequestId 值的结构化列表。如果您传入 ReportRequestId 的值,则会忽略其他查询条件。

类型:xs:string

默认值:全部
ReportTypeList ReportType 枚举值的结构化列表。

类型:xs:string

默认值:全部
ReportProcessingStatusList 报告处理状态的结构化列表,依照其来过滤报告请求。

类型:xs:string

  • _SUBMITTED_
  • _IN_PROGRESS_
  • _CANCELLED_
  • _DONE_
  • _DONE_NO_DATA_

默认值:全部

MaxCount 非负整数,表明待返回报告请求的最大数量。如果指定一个大于 100 的数字,请求将被拒绝。

类型:xs:nonNegativeInteger

1-100

默认值:10

RequestedFromDate 用于选择待报告数据日期范围的起始日期,数据格式为 ISO8601。

类型:xs:dateTime

默认值:90 天前
RequestedToDate 用于选择待报告数据日期范围的结束日期,数据格式为 ISO8601。

类型:xs:dateTime

默认值:现在

响应元素

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

类型:xs:string

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

类型:xs:boolean

ReportRequestId 报告请求的唯一编码。

类型:xs:string

ReportType 所请求的 ReportType 值。
StartDate 用于选择待报告数据日期范围的起始日期。

类型:xs:dateTime

EndDate 用于选择待报告数据日期范围的结束日期。

类型:xs:dateTime

Scheduled 布尔值,用来指明是否已计划报告。如果已计划报告,则值为 true;否则值为 false

类型:xs:boolean

SubmittedDate 提交报告的日期。

类型:xs:dateTime

ReportProcessingStatus 报告的处理状态。
GeneratedReportId 用于检索报告的报告标识符。
StartedProcessingDate 开始处理报告的日期。
CompletedDate 完成处理报告的日期。

示例

查询请求示例

https://mws.amazonservices.com/
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=GetReportRequestList
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &ReportRequestIdList.Id.1=2291326454
  &ReportTypeList.Type.1=_GET_ORDERS_DATA_
  &ReportTypeList.Type.2=_GET_MERCHANT_LISTINGS_DATA_
  &ReportProcessingStatusList.Status.1=_DONE_
  &Marketplace=ATVPDKIKX0DER
  &SellerId=A1XEXAMPLE5E6
  &Signature=pBixmXKBaS%2Bq3EbPzgFhv%2BDf6do%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2009-02-04T18%3A12%3A21.921Z
  &Version=2009-01-01

响应示例

<?xml version="1.0"?>
<GetReportRequestListResponse xmlns="http://mws.amazonservices.com/
doc/2009-01-01/">
  <GetReportRequestListResult>
  <NextToken>2YgYW55IPQhcm5hbCBwbGVhc3VyZS4=</NextToken>
    <HasNext>true</HasNext>
    <ReportRequestInfo>
      <ReportRequestId>2291326454</ReportRequestId>
      <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
      <StartDate>2011-01-21T02:10:39+00:00</StartDate>
      <EndDate>2011-02-13T02:10:39+00:00</EndDate>
      <Scheduled>false</Scheduled>
      <SubmittedDate>2011-02-17T23:44:09+00:00</SubmittedDate>
      <ReportProcessingStatus>_DONE_</ReportProcessingStatus>
      <GeneratedReportId>3538561173</GeneratedReportId>
      <StartedProcessingDate>2011-02-17T23:44:43+00:00
      </StartedProcessingDate>
      <CompletedDate>2011-02-17T23:44:48+00:00</CompletedDate>
    </ReportRequestInfo>
  </GetReportRequestListResult>
  <ResponseMetadata>
    <RequestId>732480cb-84a8-4c15-9084-a46bd9a0889b</RequestId>
  </ResponseMetadata>
</GetReportRequestListResponse>