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

RequestReport

创建报告请求,并将请求提交至亚马逊MWS

描述

RequestReport 操作用于创建报告请求。亚马逊MWS 处理报告请求,并在报告完成时,将报告请求的状态设置为 _DONE_。报告保留 90 天。

当调用 RequestReport 操作时,如果向可选请求参数 MarketplaceIdList 提供商城编号列表,则可以指定报告要涵盖的商城。如果不指定商城编号,将使用本地商城编号。请注意,MarketplaceIdList 请求参数不在日本和中国使用。

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

请求参数

名称 描述 必填项 有效值
ReportType ReportType的值,指明待请求报告的类型。

类型:xs:string

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

类型:xs:dateTime

默认值:现在
EndDate 用于选择待报告数据日期范围的结束日期。

类型:xs:dateTime

默认值:现在
ReportOptions 传递给报告的其他信息。

类型:xs:string

如果报告接受 ReportOptionsReportType 枚举 章节的报告描述中会介绍这些参数值。
MarketplaceIdList 一个包含您所注册的一个或多个商城编号的列表。生成的报告将包含您指定的所有商城的信息。

示例: &MarketplaceIdList.Id.1=A13V1IB3VIYZZH &MarketplaceIdList.Id.2=A1PA6795UKMFR9

请注意,MarketplaceIdList 请求参数不在日本和中国使用。

您注册的商城编号。

默认值:您注册的第一个商城。

响应元素

名称 描述
ReportRequestId 报告请求的唯一编码。

类型:xs:string

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

类型:xs:dateTime

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

类型:xs:dateTime

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

类型:xs:boolean

SubmittedDate 提交报告的日期。

类型:xs:dateTime

ReportProcessingStatus 报告的处理状态。

示例

查询请求示例

https://mws.amazonservices.com/
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=RequestReport
  &EndDate=2008-06-26T18%3A12%3A21
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &Marketplace=ATVPDKIKX0DER
  &SellerId=A1XEXAMPLE5E6
  &ReportType=_GET_MERCHANT_LISTINGS_DATA_
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &StartDate=2009-01-03T18%3A12%3A21
  &Timestamp=2009-02-04T18%3A12%3A21.687Z
  &Version=2009-01-01

响应示例

<?xml version="1.0"?>
<RequestReportResponse xmlns="http://mws.amazonaws.com/doc/2009-01-01/">
  <RequestReportResult>
    <ReportRequestInfo>
      <ReportRequestId>2291326454</ReportRequestId>
      <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
      <StartDate>2009-01-21T02:10:39+00:00</StartDate>
      <EndDate>2009-02-13T02:10:39+00:00</EndDate>
      <Scheduled>false</Scheduled>
      <SubmittedDate>2009-02-20T02:10:39+00:00</SubmittedDate>
      <ReportProcessingStatus>_SUBMITTED_</ReportProcessingStatus>
    </ReportRequestInfo>
  </RequestReportResult>
  <ResponseMetadata>
    <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
  </ResponseMetadata>
</RequestReportResponse>