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 ドキュメント

UpdateReportAcknowledgements

1件以上のレポートの確認ステータスを更新します。

説明

UpdateReportAcknowledgementsオペレーションは1件以上のレポートの確認済みステータスを更新するオプション機能です。Amazon MWSにレポートの確認ステータスを記憶させておく際に、このオペレーションを使用します。受信したレポートの記録を保持するには、それらを受領して無事に保存してからレポートを確認済みにすることを推奨します。その後、GetReportListを送信するときに、まだ確認していないレポートのみを受け取るよう指定できます。

この機能は、Acknowledgedfalseを設定してGetReportListを呼び出して、ハードディスク障害などによって失われたレポートを取得する際にも使用できます。この呼び出しは、問い合わせパラメーターに一致する過去90日以内のレポートのリストを返します。

注: GetReportListまたはGetReportListByNextTokenオペレーションを送信する際には、UpdateReportAcknowledgementsオペレーションを送信する前に、HasNextがfalseを返していることを確認します。これは、クエリパラメーターと一致するレポートがすべて返されていることを確認する際に役立ちます。

利用可否

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

スロットリング

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

リクエストパラメーター

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

名前 説明 必須
ReportIdList レポートIDの構造化リスト。指定可能なレポートの最大数は100です。 はい デフォルト:なし

タイプ:xs:string

Acknowledged レポートを受領し、保存したことを示すBoolean値。レポートの確認済みステータスをtrueに設定するには、trueを指定します。レポートの確認済みステータスをfalseに設定するには、falseを指定します。 いいえ デフォルト:すべて

タイプ:xs:boolean

レスポンス要素

名前 説明
Count レポートリクエストの合計数を表す負でない整数。

タイプ:xs:nonNegativeInteger

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=true
&Action=UpdateReportAcknowledgements
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&ReportIdList.Id.1=841997483
&ReportIdList.id.2=843337483
&SellerId=A1XEXAMPLE5E6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-02-04T18%3A12%3A20.718Z
&Version=2009-01-01
&Signature=cE8%2FUgE8BspmM%2B26UTy7oVEdBk4%3D

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<UpdateReportAcknowledgementsResponse
    xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
    <UpdateReportAcknowledgementsResult>
        <Count>1</Count>
        <ReportInfo>
            <ReportId>841997483</ReportId>
            <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
            <ReportRequestId>2234038326</ReportRequestId>
            <AvailableDate>2009-01-06T03:48:36+00:00</AvailableDate>
            <Acknowledged>true</Acknowledged>
            <AcknowledgedDate>2009-02-20T02:10:41+00:00</AcknowledgedDate>
        </ReportInfo>
    </UpdateReportAcknowledgementsResult>
    <ResponseMetadata>
        <RequestId>42a578a7-ed92-486b-ac67-5de7464fcdfa</RequestId>
    </ResponseMetadata>
</UpdateReportAcknowledgementsResponse>

↑ トップへ戻る