メッセージ・フィードバック・通知
Trading API — メッセージ・フィードバック・通知（Messaging, Feedback & Notification）
メッセージ・フィードバック・通知カテゴリには、eBay 上でのメンバー間メッセージング、フィードバック管理、プラットフォーム通知設定を行う 17 のコールが含まれます。バイヤーとセラー間のコミュニケーション全般をカバーします。
RESTful 代替: メッセージ機能には Commerce Message API、通知には Commerce Notification API も利用可能です。フィードバックには Commerce Feedback API が利用できます。
よくある利用シナリオ
- カスタマーサポート:
GetMemberMessagesで未回答の質問を一覧取得 →AddMemberMessageRTQで回答 - メッセージ管理:
GetMyMessagesで eBay からの通知やバイヤーメッセージを取得 →ReviseMyMessagesで既読マーク →ReviseMyMessagesFoldersでフォルダ整理 - フィードバック自動化:
GetItemsAwaitingFeedbackで未評価の取引を検出 →LeaveFeedbackでバイヤーに自動評価 - ネガティブフィードバック対応:
GetFeedbackで低評価を検出 →RespondToFeedbackでフォローアップコメント - リアルタイム通知:
SetNotificationPreferencesで注文完了やメッセージ受信のイベント通知を設定 → Webhook 受信で即時対応
メンバーメッセージ（4 コール）
AddMemberMessageAAQToPartner
取引相手（バイヤーまたはセラー）にメッセージを送信します。「Ask a Question（質問する）」機能に対応。アイテム ID を指定して、特定のリスティングに関する質問を送信できます。
AddMemberMessageRTQ
バイヤーからの質問（Ask a Question）に回答します。元のメッセージ ID を指定して、回答テキストを送信。セラーのカスタマーサポートワークフローの中核。
AddMemberMessagesAAQToBidder
オークションの入札者に一括でメッセージを送信します。商品に関する重要な更新情報（傷の発見、配送遅延など）を全入札者に通知する場合に使用。
GetMemberMessages
メンバー間メッセージ（質問、回答、連絡）を取得します。メッセージタイプ（質問、回答等）、ステータス（未回答、回答済み）、日時範囲でフィルタリング可能。
メッセージ設定（2 コール）
GetMessagePreferences / SetMessagePreferences
メッセージ受信の設定を取得・更新します。ASQ（Ask Seller a Question）サブジェクトの有効化/無効化など、セラーが受け付けるメッセージの種類を制御できます。
GetMessagePreferences → | SetMessagePreferences →
マイメッセージ（4 コール）
GetMyMessages
eBay の「マイメッセージ」ボックスのメッセージを取得します。eBay からのシステム通知、バイヤーからのメッセージ、プロモーション情報などが含まれます。メッセージの概要のみ取得するモードと、全文取得するモードがあります。
DeleteMyMessages
マイメッセージから指定したメッセージを削除します。メッセージ ID を指定して一括削除も可能。
ReviseMyMessages
マイメッセージのステータス（既読/未読、フラグ付き）を更新します。メッセージ管理の自動化に使用。
ReviseMyMessagesFolders
マイメッセージのカスタムフォルダを作成・削除・名前変更します。メッセージの整理に使用。
フィードバック（4 コール）
GetFeedback
ユーザーのフィードバック情報を取得します。フィードバックスコア、個別の評価（Positive/Neutral/Negative）、コメントテキスト、取引日時などが含まれます。特定ユーザーまたは特定アイテムのフィードバックを取得可能。
GetItemsAwaitingFeedback
フィードバック未評価の取引一覧を取得します。セラー/バイヤーどちらがまだ評価していないかも判別可能。フィードバック自動化ツールのデータソース。
LeaveFeedback
取引相手にフィードバック（Positive/Neutral/Negative）を残します。コメントテキスト（最大 80 文字）と、DSR（Detailed Seller Rating）の評価も可能。
RespondToFeedback
受け取ったフィードバックに対してフォローアップコメントを残します。ネガティブフィードバックへの説明や、追加のコメントに使用。元のフィードバックの評価は変更できません。
通知設定（3 コール）
GetNotificationPreferences / SetNotificationPreferences
eBay Platform Notifications（プラットフォーム通知）の購読設定を取得・更新します。注文完了、入札、メッセージ受信、リスティング終了など、数十種類のイベントタイプに対して通知を有効化/無効化できます。通知は指定した URL（Webhook）に HTTP POST で送信されます。
GetNotificationPreferences → | SetNotificationPreferences →
GetNotificationsUsage
プラットフォーム通知の使用状況統計を取得します。送信された通知の数、配信成功率、エラー率などが含まれます。通知システムの監視とデバッグに使用。