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.
レポートリクエストを作成し、リクエストをAmazon MWSに送信します。
RequestReportオペレーションは、レポートリクエストを作成します。 Amazon MWS はレポートリクエストを処理し、レポートが完了すると、レポートリクエストのステータスを_DONE_に設定します。レポートは90日間保存されます。
RequestReportオペレーションを呼び出すときは、MarketplaceIdListリクエストパラメーターにマーケットプレイスIDのリストを提供し、レポートが必要なマーケットプレイスを指定します。マーケットプレイスIDを指定しない場合、最初に出品用アカウントを登録したサイトのマーケットプレイスIDが使用されます。MarketplaceIdListリクエストパラメーターは日本と中国では使用できませんのでご注意ください。
RequestReportオペレーションの最大リクエストクォータは15回で、回復レートは毎分1リクエストです。 スロットリング用語の定義およびスロットルの詳しい説明については、Amazon MWS開発者ガイドのスロットリング: リクエストを送信できる頻度を制限するを参照してください。
このオペレーションはすべてのマーケットプレイスで利用できます。
MarketplaceIdListパラメーターは日本と中国では使用できません。
| 最大リクエストクォータ | 回復レート | 時間あたりのリクエストクォータ |
|---|---|---|
| 15リクエスト | 毎分1リクエスト | 1時間あたり60リクエスト |
すべてのAmazon MWSオペレーションで必須のリクエストパラメーターについては、Amazon MWS開発者ガイドの必須リクエストパラメータを参照してください。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| ReportType | ReportType列挙子の値。リクエストするレポートタイプを示します。 | はい | ReporrType値 タイプ：xs:string |
| StartDate | レポートするデータの選択に使用する日付範囲の開始日。 | いいえ | 現在の日付以前にする必要があります。 デフォルト：現在 値の形式： ISO 8601日時フォーマット タイプ：xs:dateTime |
| EndDate | レポートするデータの選択に使用する日付範囲の終了日。 | いいえ | 現在の日付以前にする必要があります。 デフォルト：現在 値の形式： ISO 8601日時フォーマット タイプ：xs:dateTime |
| ReportOptions | レポートに渡す追加情報。 | いいえ | レポートがReportOptionsを受け入れた場合は、ReportType列挙子セクションにあるレポートの説明に情報が表示されます。 タイプ：xs:string |
| MarketplaceIdList (NA、EUのみ) |
出品用アカウントを登録したマーケットプレイスの1つ以上のマーケットプレイスID。レポートには、指定したすべてのマーケットプレイスの情報が含まれます。複数のMarketplaceId値を送信した場合のレポートの動作については、複数のマーケットプレイスへの出品を参照してください。 例： &MarketplaceIdList.Id.1=A13V1IB3VIYZZH &MarketplaceIdList.Id.2=A1PA6795UKMFR9 |
いいえ | 出品用アカウントが登録されているマーケットプレイスのマーケットプレイスID。 デフォルト：出品用アカウントを最初に登録したマーケットプレイス タイプ：リスト - タイプ：xs:string |
| 名前 | 説明 |
|---|---|
| ReportRequestInfo | レポートリクエストに関する詳細な情報。 タイプ： ReportRequestInfo |
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
POST / HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2 &Action=RequestReport &EndDate=2008-06-26T18%3A12%3A21 &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &Marketplace=ATVPDKIKX0DER &ReportType=_GET_MERCHANT_LISTINGS_DATA_ &SellerId=A1XEXAMPLE5E6 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &StartDate=2009-01-03T18%3A12%3A21 &Timestamp=2009-02-04T18%3A12%3A21.687Z &Version=2009-01-01 &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?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>