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

Amazon MWSサブスクリプションAPIセクションについて知っておくべきこと

概要

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セクションオペレーション

サブスクリプションAPIセクションには、以下のオペレーションが含まれています。

表 1. 配信先のオペレーション
オペレーション 説明 利用可否
RegisterDestination 通知を受信する新しい配信先を指定します。 中国とメキシコを除くすべてのマーケットプレイス
DeregisterDestination 登録済みの配信先リストから既存の配信先を削除します。 中国とメキシコを除くすべてのマーケットプレイス
ListRegisteredDestinations 登録したすべての配信先を一覧表示します。 中国とメキシコを除くすべてのマーケットプレイス
SendTestNotificationToDestination 既存の配信先にテスト通知を送信します。 中国とメキシコを除くすべてのマーケットプレイス
表 2. サブスクリプションのオペレーション
オペレーション 説明 利用可否
CreateSubscription 指定した通知タイプおよび配信先で新しいサブスクリプションを作成します。 中国とメキシコを除くすべてのマーケットプレイス
GetSubscription 指定した通知タイプおよび配信先のサブスクリプションを取得します。 中国とメキシコを除くすべてのマーケットプレイス
DeleteSubscription 指定した通知タイプおよび配信先のサブスクリプションを削除します。 中国とメキシコを除くすべてのマーケットプレイス
ListSubscriptions 現在のすべてのサブスクリプションのリストを返します。 中国とメキシコを除くすべてのマーケットプレイス
UpdateSubscription 指定した通知タイプおよび配信先のサブスクリプションを更新します。 中国とメキシコを除くすべてのマーケットプレイス