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.
返回可用于获取报告的 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 |
否 |
默认值:全部 |
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>