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サブスクリプションAPIセクションを利用すると、Amazonとのビジネスに関する通知の受信をサブスクライブ(購読)できます。サブスクリプションAPIセクションのオペレーションを実行して登録すると、Amazon MWSサービスをポーリングすることなくAmazonから重要な情報を受信できます。サブスクライブしている情報が更新された時点で、その情報が出品者に直接送信されます。
通知を受信するには、まずAmazonシンプルキューサービス(Amazon SQS)キューなどのDestinationを作成して登録する必要があります。次に、受信するNotificationType(通知のタイプ)のSubscription (サブスクリプション)を作成します。(例:自社と同じ商品を出品している他の出品者が出品情報を変更した場合の通知 等)最後に、SendTestNotificationToDestinationオペレーションを呼び出して、Amazonからの通知がDestination(配信先)に配信されることを確認します。
以下の表には、このAPIセクションの用語が定義されています。
用語 | 説明 |
---|---|
通知 | 出品者に影響のある特定の状態の変化やイベントを含む通知。通知はメッセージとも呼ばれます。 |
通知タイプ | 通知する種類を特定します。例:AnyOfferChanged通知 |
配信チャネル | 通知の受信に使用するテクノロジー。例:Amazon SQS |
配信先 | 通知を受信するために作成する配信チャネル。例:Amazon SQSキューのURL「http://sqs.us-east-1.amazonaws.com/12345/queue1」 |
サブスクリプション | 受信する通知タイプおよび通知の受信場所を表すオブジェクト。(例:出品者A1234のAnyOfferChanged通知を「http://sqs.us-east-1.amazonaws.com/12345/queue1」のAmazon SQSキューに送信) |
サブスクリプションAPIセクションには、以下のオペレーションが含まれています。
オペレーション | 説明 | 利用可否 |
---|---|---|
RegisterDestination | 通知を受信する新しい配信先を指定します。 | 中国とメキシコを除くすべてのマーケットプレイス |
DeregisterDestination | 登録済みの配信先リストから既存の配信先を削除します。 | 中国とメキシコを除くすべてのマーケットプレイス |
ListRegisteredDestinations | 登録したすべての配信先を一覧表示します。 | 中国とメキシコを除くすべてのマーケットプレイス |
SendTestNotificationToDestination | 既存の配信先にテスト通知を送信します。 | 中国とメキシコを除くすべてのマーケットプレイス |
オペレーション | 説明 | 利用可否 |
---|---|---|
CreateSubscription | 指定した通知タイプおよび配信先で新しいサブスクリプションを作成します。 | 中国とメキシコを除くすべてのマーケットプレイス |
GetSubscription | 指定した通知タイプおよび配信先のサブスクリプションを取得します。 | 中国とメキシコを除くすべてのマーケットプレイス |
DeleteSubscription | 指定した通知タイプおよび配信先のサブスクリプションを削除します。 | 中国とメキシコを除くすべてのマーケットプレイス |
ListSubscriptions | 現在のすべてのサブスクリプションのリストを返します。 | 中国とメキシコを除くすべてのマーケットプレイス |
UpdateSubscription | 指定した通知タイプおよび配信先のサブスクリプションを更新します。 | 中国とメキシコを除くすべてのマーケットプレイス |