Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント
Amazon MWS ドキュメント

RequestReport

レポートリクエストを作成し、リクエストを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オペレーションで必須のリクエストパラメーターについては、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>

↑ トップへ戻る