Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon 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.

Amazon MWS ドキュメント

GetReportList

過去90日間に作成されたレポートのリストを返します。

説明

GetReportListのオペレーションは、クエリパラメーターと一致する、過去90日間に作成されたレポートのリストを返します。1つのリクエストで最大100件の結果を返すことができます。それ以上の結果がある場合は、レスポンスのHasNextがtrueに設定されて返されます。すべての結果を取得するには、GetReportListByNextTokenオペレーションにNextTokenパラメーターの値を指定し、HasNextがfalseに設定されて返されるまでこれを繰り返します。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。

スロットリング

最大リクエストクォータ 回復レート 時間あたりのリクエストクォータ
10リクエスト 毎分1リクエスト 1時間あたり60リクエスト
スロットリング用語の定義およびスロットルの詳しい説明については、Amazon MWS開発者ガイドのスロットリング: リクエストを送信できる頻度を制限するを参照してください。

リクエストパラメーター

すべてのAmazon MWSオペレーションで必須のリクエストパラメーターについては、Amazon MWS開発者ガイドの必須リクエストパラメータを参照してください。

名前 説明 必須 値
MaxCount 返されるレポートリクエストの最大数を表す負でない整数。100を超える数を指定すると、リクエストは拒否されます。 いいえ 1～100

デフォルト：10

タイプ：xs:nonNegativeInteger
ReportTypeList ReportType列挙子値の構造化リスト。 いいえ デフォルト：すべて

タイプ：xs:string
Acknowledged 注文レポートがUpdateReportAcknowledgementsの前回の呼び出しで確認されているかどうかを示すboolean値。確認されている注文レポートのリストを取得するにはtrueと設定します。確認されていない注文レポートを表示するにはfalseと設定します。本フィルタは、注文レポートでのみ有効で、出品レポートでは動作しません。 いいえ デフォルト：すべて

タイプ：xs:boolean
ReportRequestIdList ReportRequestId値の構造化リスト。ReportRequestId値が指定された場合は、他のクエリ条件は無視されます。 いいえ デフォルト：すべて

タイプ：xs:string
AvailableFromDate 検索開始日付(ISO 8601日時フォーマット形式)。 いいえ デフォルト：90日前

タイプ：xs:dateTime
AvailableToDate 検索終了日付(ISO 8601日時フォーマット形式)。 いいえ デフォルト：現在

タイプ：xs:dateTime

レスポンス要素

名前 説明
NextToken 別の呼び出しに情報を渡すために使用される文字列トークン。HasNextの値がtrueの場合は、NextTokenを使用して再度オペレーションを呼び出します。

タイプ：xs:string
HasNext さらに取得できる項目があるかどうかを示すboolean値。これらの項目を取得するには、このオペレーションへの追加の呼び出しが必要です。さらに取得できる項目がある場合は、値がtrueになり、そうでない場合はfalseになります。

タイプ：xs:boolean
ReportInfo レポートに関する詳細な情報。

タイプ： ReportInfo

例

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

POST / HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
&Acknowledged=false
&Action=GetReportList
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&ReportRequestIdList.Id.1=2291326454
&ReportRequestIdList.Id.2=2294446454
&ReportTypeList.Type.1=_GET_ORDERS_DATA_
&SellerId=A1XEXAMPLE5E6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-02-04T18%3A12%3A19.796Z
&Version=2009-01-01
&Signature=3yvUqWWBpLDld9CCx0ANjVU95ks%3D

↑ トップへ戻る

レスポンス例

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<GetReportListResponse
    xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
    <GetReportListResult>
        <NextToken>2YgYW55IPQhvu5hbCBwbGVhc3VyZS4=</NextToken>
        <HasNext>true</HasNext>
        <ReportInfo>
            <ReportId>898899473</ReportId>
            <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
            <ReportRequestId>2278662938</ReportRequestId>
            <AvailableDate>2009-02-10T09:22:33+00:00</AvailableDate>
            <Acknowledged>false</Acknowledged>
        </ReportInfo>
    </GetReportListResult>
    <ResponseMetadata>
        <RequestId>fbf677c1-dcee-4110-bc88-2ba3702e331b</RequestId>
    </ResponseMetadata>
</GetReportListResponse>

↑ トップへ戻る