販売コミュニケーション

販売コミュニケーションガイド (Sell Communications Guide)

概要

eBay Sell Communication APIは、セラー（販売者）がeBayからビジネスに不可欠な通知を受け取る、商品をウォッチしている見込み客に割引オファーを送信する、バイヤー（購入者）や潜在顧客からの問い合わせに回答する、eBayの受信トレイ（Inbox）のメッセージやフォルダーをプログラムで管理する、といった機能を提供します。

APIのユースケース

eBay通知の購読と取得
関心のあるバイヤーへの割引オファーの送信
バイヤー・セラー間のコミュニケーション管理
フィードバックの処理

eBay通知の購読と取得

eBayには2つのAPI対応通知プラットフォームがあります。1つはRESTベースで、Notification APIとの統合が必要です。ユーザーはトピックリストの取得、通知受信エンドポイントの設定、トピックの購読が可能です。もう1つはXMLベースで、通知を購読し、通知受信エンドポイントを設定するために SetNotificationPreferences 呼び出しを使用する必要があります。

Notification APIを使用したトピックの購読

eBayのNotification APIと統合することで、サードパーティのプラットフォームは、eBayがユーザーの宛先エンドポイントに送信するさまざまな種類の通知を購読して受け取ることができます。一般的なトピックとセラー向けのトピックの概要を以下に示します。

Marketplace Account Deletion（マーケットプレイスアカウントの削除）：eBayユーザーが個人データの削除とアカウントの閉鎖をリクエストした際に、開発者に送信される通知です。詳細については、eBay Marketplace Account Deletion ページを参照してください。
Authorization Revocation（認可の取り消し）：ユーザーがeBay Developers Programアプリケーションへの権限を取り消した際に、開発者に送信される通知です。
Priority Campaign Strategy Budget Status（優先キャンペーン戦略の予算ステータス）：プロモーションリスティング（Promoted Listings）の優先戦略広告キャンペーンの1日の予算が完全に使い果たされた際に、セラーに送信される通知です。
Seller Standards Profile Metrics（セラー基準プロファイル指標）：セラーパフォーマンス指標のいずれかにおいて、セラー基準（Seller Standards）レベルの変更または変更の可能性があることをセラーに知らせるために送信される通知です。これらの指標としきい値の詳細については、eBayアカウントの eBay Seller Standards program ページを参照してください。
Seller Customer Service Metric Rating（セラーカスタマーサービス指標評価）：Item Not Received（未着商品）または Item Not as Described（説明と異なる商品）のカスタマーサービス指標パフォーマンスに重大な変更があったことをセラーに知らせるために送信される通知です（これには、サービス指標が「非常に高い（very high）」に向かっている場合の事前警告も含まれます）。

以下の手順を実行することで、設定したエンドポイントでこれらの通知の受信を開始できます。

createDestination を使用して、eBayからの通知を受け取るエンドポイントを設定します。このエンドポイントは、受信する通知データを安全に処理するために必要です。
getTopics を使用して、利用可能な通知トピックの完全なリストを取得します。authorizationScopes 配列内のOAuthスコープを確認してください。一部のトピックには特別なスコープが必要です。必要なスコープがない場合、そのトピックを購読することはできません。また、topicId の値も確認してください。これらの値はトピックを購読するために必要です。
createSubscription を使用して、トピックを購読します。トピックの topicId 値、通知を受け取るエンドポイントを指定し、status 値を ENABLED に設定します。
エンドポイントに送信されるすべての通知について、eBay通知に含まれるBase64エンコードされた X-EBAY-SIGNATURE ヘッダーを抽出します。この値をパスパラメータとして getPublicKey メソッドに渡します。レスポンスで返されたキー値を使用して、eBayプッシュ通知メッセージのペイロードを検証します。
通知に基づいて、必要なアクション（ある場合）を実行します。

以下は、Notification APIのその他のサポートメソッドの一部です。

destination（宛先）リソースには、以下の追加メソッドがあります。
- getDestination を使用して、特定の宛先エンドポイントの詳細を取得します。
- getDestinations を使用して、設定されているすべての宛先エンドポイントを取得します。
- updateDestination を使用して、宛先エンドポイントを更新します。
- deleteDestination を使用して、無効化された宛先エンドポイントを削除します。
subscription（購読）リソースには、以下の追加メソッドがあります。
- getSubscriptions を使用して、すべての通知トピックの購読詳細を取得します。updateSubscription を使用して、既存の購読を変更します。
- enableSubscription を使用して以前に無効化したトピックの購読を有効にし、disableSubscription を使用してアクティブなトピックの購読を無効にします。
- testSubscription を使用してテスト通知を送信し、購読の機能を確認します。
- deleteSubscription を使用して購読を削除し、そのトピックの通知配信を停止します。
- createSubscriptionFilter を利用してトピック購読のフィルターを設定し、特定の基準に一致する通知のみを受け取るようにします。
- getSubscriptionFilter を使用して、特定のフィルターの詳細情報（基準、ステータス、作成日など）にアクセスします。
- deleteSubscriptionFilter を使用してアクティブなフィルターを無効化して削除し、修正された基準で新しいフィルターを作成できるようにします。
getConfig メソッドはアプリケーションに関連付けられたメールアドレスを取得し、updateConfig メソッドはアプリケーションに関連付けられたメールアドレスを更新できます。

プラットフォーム通知イベントの購読

eBayの Trading API と統合することで、ユーザーは特定のeBayイベントによってトリガーされるさまざまなプラットフォーム通知を購読および管理できます。以下は、主要なセラー向けイベントタイプとその目的の一部です。

FixedPriceTransaction：数量が複数の固定価格リスティング（即決出品）で商品が販売されるたびに送信される通知です。
ItemSold：固定価格リスティングが購入されて終了するか、オークション形式のリスティングが落札されて終了した際に送信される通知です。
BestOffer：セラーがバイヤーからベストオファー（価格交渉）を受け取った際に送信される通知です。
BidReceived：オークション形式のリスティングに対して有効な入札が行われるたびに送信される通知です。
BuyerCancelRequested：バイヤーが注文のキャンセルをリクエストした際に送信される通知です。
ReturnCreated：バイヤーが商品の返品リクエストを作成した際に送信される通知です。
ItemOutOfStock：固定価格リスティングの数量が「0」になった際に送信される通知です。この通知は、セラーが在庫切れ管理（Out-of-Stock control）を有効にしている場合にのみ送信されます。
AskSellerQuestion：バイヤーがアクティブなリスティングについてセラーに質問をした場合に送信される通知です。

利用可能な通知イベントタイプの完全なリストについては、NotificationEventTypeCodeType を参照してください。これらのイベントタイプの詳細については、Platform Notifications ガイドをご覧ください。

Trading APIには、プラットフォーム通知を購読および管理するための以下の呼び出しがあります。

SetNotificationPreferences 呼び出しを利用して、特定の通知イベントタイプを購読します。通知の宛先（メールアドレスやURLエンドポイントなど）を定義します。
GetNotificationPreferences 呼び出しを使用して、現在の通知設定を取得します。これにより、購読しているイベントタイプを確認し、通知配信設定を見直すことができます。適切な通知を受け取るには、正しい構成が不可欠です。
GetNotificationsUsage 呼び出しを利用して、送信された通知の詳細にアクセスします。この情報を確認することで、通知設定が意図したとおりに機能しているかを評価し、調整が必要かどうかを判断できます。

関心のあるバイヤーへの割引オファーの送信

Negotiation API は、セラーが特別オファーの対象となる商品を特定し、それらの商品に関心を示している潜在的なバイヤーに割引オファーを送信してエンゲージメントを高めるために使用されます。特定のリスティングに関心を示したバイヤーをターゲットにすることで、セラーは成約の可能性を高めることができます。

findEligibleItems を利用して、セラー主導のオファーの対象となるリスティングを特定します。
sendOfferToInterestedBuyers を使用して、これらの対象リスティングに関心を示したバイヤーに割引オファーを提示します。

バイヤー・セラー間のコミュニケーション管理

Message APIを使用したコミュニケーション管理

Message API を使用すると、ユーザーはメッセージの送信、会話の取得、会話のステータスの変更を行うことができます。

メッセージの送信:

sendMessage メソッドを使用して、他のユーザーとの会話を開始したり、既存の会話でメッセージを送信したりできます。

sendMessage メソッドでメッセージを送信する場合、メッセージの内容を指定するために messageText フィールドが必要です。また、メッセージを既存の会話内で送信するか、新しい会話を開始するかを指定するために、以下のいずれかのフィールドも必要です。

conversationId: メッセージを送信する既存の会話の識別子。既存の会話でメッセージを送信する場合、このフィールドは必須です。このIDは、getConversations メソッドを使用して取得できます。
otherPartyUsername: メッセージの送信先となるeBayユーザー名。他のeBayユーザーと新しい会話を開始する場合、このフィールドは必須です。

さらに、以下のコンテナを通じて、メッセージにオプション情報を添付できます。

messageMedia: このコンテナを使用して、メッセージにメディアファイルを添付できます。1つのメッセージにつき最大5つのメディア形式を送信できます。以下の種類のメディアをメッセージに添付できます。
- IMAGE
  注: 画像の要件についての詳細は、Managing images を参照してください。
- PDF
- DOC
- TXT
reference: このコンテナを使用して、メッセージが特定のeBayリスティングを参照していることを指定できます。参照の種類は referenceType フィールドで指定し、参照の識別子は referenceID フィールドで指定できます。現在、リスティングのみがサポートされているため、referenceType は常に LISTING となり、referenceID はリスティングの商品ID（Item ID）値となります。

呼び出しが成功すると、提供された情報に基づいてメッセージが送信され、作成日やメッセージID値などのメッセージに関する詳細が返されます。

会話の更新:

updateConversation および bulkUpdateConversation メソッドを使用して、1つまたは複数の会話のステータスを更新できます。これには、会話のステータス（アクティブ、アーカイブ済み、削除済みなど）や、「既読」ステータス（既読または未読としてマークされているかなど）が含まれます。

これらのメソッドを使用して会話を更新する場合、更新対象の会話を指定するために、以下のフィールドがリクエストペイロードに必要です。

conversationId: 更新対象となる会話の一意の識別子。getConversations メソッドを使用してこの値を取得できます。
conversationType: 更新される会話の既存の会話タイプ。この値はこのメソッドでは更新できませんが、リクエストペイロードの一部として必要です。以下の文字列値がサポートされています。
- FROM_MEMBERS: この文字列値は、会話が他のeBayメンバー（バイヤーやセラーなど）とのものであることを示します。
- FROM_EBAY: この文字列値は、会話がeBay自体からのものであることを示します。

会話IDとタイプを指定したら、指定した会話のステータスを更新できます。これらのメソッドを使用すると、会話のステータスまたは既読ステータスのいずれかを変更できます。

重要: 1回の呼び出しで変更できるのは、会話のステータスまたは既読ステータスのいずれかのみです。

以下のフィールドを使用して、会話のステータスを更新できます。

conversationStatus: 指定した会話を更新するステータス。以下の文字列値がサポートされています。
- ACTIVE: この文字列値は、会話を ACTIVE（アクティブ）ステータスに更新します。これは、eBayメンバーまたはeBay自体との現在アクティブな会話であることを意味します。
- ARCHIVE: この文字列値は、会話を ARCHIVE（アーカイブ）ステータスに更新します。これは、会話がアーカイブされますが、削除はされないことを意味します。アーカイブされた会話は保存され、必要に応じてこのメソッドを使用して ACTIVE ステータスに戻すことができます。
- DELETE: この文字列値は、会話を DELETE（削除）ステータスに更新します。これは、会話が削除されることを意味します。削除された会話は復元できません。
- READ: この文字列値は、会話を READ（既読）ステータスに更新します。これは、受信者によって既読として表示されることを意味します。updateConversation メソッドには、この機能を処理する個別の read ブール値フィールドがあることに注意してください。
- UNREAD: この文字列値は、会話を UNREAD（未読）ステータスに更新します。これは、受信者によって未読として表示されることを意味します。updateConversation メソッドには、この機能を処理する個別の read ブール値フィールドがあることに注意してください。

呼び出しが成功すると、会話のステータスが指定されたステータスに更新されます。

会話の取得:

getConversation および getConversations メソッドを使用して、1つまたは複数の会話内のメッセージを取得できます。

getConversation メソッドは、指定された会話内のメッセージを取得するために使用できます。メッセージを取得する会話は、その conversation_id 値によって指定されます。会話のタイプも conversation_type クエリパラメータで指定する必要があります。呼び出しが成功すると、指定された会話内の（指定されたフィルター基準を満たす）各メッセージに関する詳細が返されます。これには、メッセージテキストとID、既読ステータス、送信者と受信者のユーザー名などの情報が含まれます。

あるいは、getConversations メソッドを使用して、最大10件の会話を取得できます。これらのメソッドで会話の検索を絞り込むために、以下のクエリパラメータを使用できます。

conversationStatus: 取得する会話のステータス。指定されたステータスの会話のみが取得されます。以下の値がサポートされています。
- ACTIVE: 会話は現在アクティブであり、アーカイブまたは削除されていません。
- ARCHIVE: 会話はアーカイブされており、必要に応じて参照したり、アクティブステータスに戻したりできます。
- DELETE: 会話は削除されており、アクセスできなくなっています。
- READ: 会話内の最新のメッセージは、受信者によって既読になっています。
- UNREAD: 会話内の最新のメッセージは、受信者によってまだ読まれていません。
conversation_type: 取得する会話のタイプ。指定されたタイプの会話のみが返されます。以下の値がサポートされています。
- FROM_EBAY: eBayからの会話です。
- FROM_MEMBERS: eBayメンバーとの会話です。
reference_id: 会話に関連付けられた参照の一意の識別子（商品ID値など）。指定された値を参照している会話のみが返されます。
reference_type: 会話に関連付けられた参照のタイプ（ある場合）。たとえば、LISTING の値は、会話が特定のリスティング（上記の対応する reference_id 値で指定）に関連付けられていることを指定します。現在、LISTING のみがサポートされています。
start_time および end_time: この期間内に送信された会話のみが返されます。
other_party_username: 会話を取得するeBayユーザーのユーザー名。この指定されたユーザーとの会話のみが返されます。

レスポンスペイロードで返されるデータ量を制御するために、以下のページネーションパラメータを使用できます。

limit: 単一ページで返される結果セットからのアイテム数を指定します。
offset: 結果セット内でスキップするアイテム数を指定します。

Trading APIを使用したコミュニケーション管理

バイヤーとセラー間の効果的なコミュニケーションを促進することは、eBayでの円滑な取引にとって極めて重要です。このユースケースでは、バイヤーとセラー間のメッセージ交換を可能にし、eBayのインボックスメッセージとフォルダーを取得および管理するために利用可能なメソッドの概要を説明します。

バイヤー・セラー間のコミュニケーションを管理するためのAPI呼び出しについては、以下で説明します。

AddMemberMessageAAQToPartner を使用すると、注文関係にあるバイヤーとセラーが互いのMy Messages受信トレイにメッセージを送信できるようになり、直接のコミュニケーションが促進されます。
AddMemberMessageRTQ を使用すると、セラーはアクティブな商品リスティングに関するバイヤーの質問に返信でき、問い合わせへの迅速な対応が保証されます。
AddMemberMessagesAAQToBidder を使用すると、セラーはアクティブな商品リスティングに関して、入札者またはベストオファー経由でオファーを行ったユーザーに最大10件のメッセージを送信でき、潜在的なバイヤーとのコミュニケーションが促進されます。
GetUserContactDetails を使用すると、呼び出し元とユーザーの間に入札関係（バイヤーまたはセラーとして）がある場合に限り、指定されたユーザーの連絡先情報を返し、必要に応じて直接の連絡を支援します。

eBayインボックスのメッセージとフォルダーを取得および管理するためのAPI呼び出しについては、以下で説明します。

GetMyMessages を使用すると、ユーザーに送信されたメッセージに関する情報を取得し、受信したすべての通信の概要を確認できます。この呼び出しには、日付範囲フィルター、メッセージフォルダーID、またはメッセージIDなど、返されるメッセージを制御するための複数のフィルターがあります。
GetMemberMessages を使用すると、バイヤーがあなたのアクティブな商品リスティングについて投稿したメッセージのリストを取得でき、セラーはバイヤーの質問や懸念に対処できます。
GetMessagePreferences を使用すると、セラーの「セラーへの質問（ASQ）」の件名をそれぞれの Subject フィールドで返し、セラーは現在のメッセージ設定を確認できます。
SetMessagePreferences を使用すると、セラーはカスタムの「セラーへの質問（ASQ）」件名を追加、削除、または変更したり、カスタム件名をデフォルト値にリセットしたりできます。
ReviseMyMessages を使用すると、メッセージを既読としてマークしたり、メッセージにフラグを付けたり外したり、指定したすべてのメッセージを別のインボックスフォルダーに移動したりできます。
ReviseMyMessagesFolders を使用すると、新しいフォルダーの作成、既存のフォルダーの名前変更、または空のフォルダーの削除ができます。
DeleteMyMessages を使用すると、特定のユーザーの選択したメッセージを削除できます。

フィードバックの処理

効果的なフィードバック管理は、eBay上でのバイヤーとセラー間の透明性と信頼を築きます。このユースケースでは、取引を円滑に進め、問題を解決し、肯定的な評判を維持するために、フィードバックを取得、送信、および返信する方法について説明します。フィードバックの処理には、Feedback API（REST）またはTrading API（レガシー）を使用できます。

Feedback APIの使用

Feedback API は、以下の表に含まれるメソッドを通じて取引フィードバックを管理します。

メソッド	説明
getItemsAwaitingFeedback	ユーザーの役割（ロール）に基づいて、ユーザーからのフィードバックが保留中となっている品目（ラインアイテム）のフィルタリングされたリストを取得します。
getFeedback	ユーザーの役割に基づいて、ユーザーからフィードバックが利用可能な品目のフィルタリングされたリストを取得します。このメソッドは、セラー向けの詳細な指標も取得します。
leaveFeedback	取引相手（オーダーパートナー）の品目に関連付けられたフィードバックを送信し、追跡および参照目的のための一意のIDを生成します。
respondToFeedback	注文内の特定の品目について取引相手から提供されたフィードバックに返信します。
getFeedbackRatingSummary	基準によってフィルタリングされた、eBayセラーのフィードバック指標の分類された要約を返します。

以下のシナリオは、主な用途を説明しています。

フィードバック待ちアイテムの取得
バイヤーまたはセラーとして、まだフィードバックが必要なアイテムのリストを取得するには、getItemsAwaitingFeedback メソッドを呼び出します。
フィードバックの取得
getFeedback メソッドを使用して、取引、アイテム、コメントタイプ、AIフィルターによるトピック、または写真を含むフィードバックに基づいてフィルタリングオプションを指定し、特定のユーザーのフィードバックを収集します。このメソッドは、セラー向けの詳細な指標も取得します。これを踏まえ、このメソッドはさまざまなフィードバック取得シナリオをサポートします。
- ユーザーに関するすべてのフィードバック
- ユーザーが受け取ったフィードバック
- ユーザーが残したフィードバック
- 特定のフィードバックエントリ
- 特定のリスティングまたは品目に関するフィードバック
- 特定のタイプのフィードバック
- セラーまたはバイヤーとしてのユーザーに対するフィードバック
AIでフィルタリングされたフィードバックの取得
getFeedback メソッドを通じてトピックを指定し、AIに関連する適用可能なフィードバック項目を生成させることができます。トピックを指定すると、それらのリスティングに関するフィードバックのみが返されます。たとえば、セラーとして配送に関連する過去30日間の肯定的なフィードバック項目をAIに生成させて返すには、次を使用します：filter=commentType:POSITIVE,topics:shipping,period:30,role:SELLER

利用可能な特定のトピックについては、フィルタークエリパラメータのtopics値を参照してください。
フィードバックを残す
バイヤーとセラーは、leaveFeedback メソッドを呼び出すことで、完了した品目に対するフィードバックを送信します。
フィードバック評価の要約を取得
集計されたフィードバック指標を確認用に返すには、getFeedbackRatingSummary メソッドを呼び出します。これらの評価はセラー専用であり、納期厳守、送料、コミュニケーションなどの指標を返すことができます。
受け取ったフィードバックへの返信
バイヤーとセラーは、respondToFeedback メソッドを呼び出すことで、取引相手が残したフィードバックに返信できます。

評価テンプレートの使用

評価テンプレートが使用される場合、それは取引で利用可能なフィードバック評価オプションを定義します。これには、納期厳守や全体的な体験（詳細なセラー評価の2つの例）、および自由記述コメントなどの主要な側面が含まれます。詳細なセラー評価（DSR）は、バイヤーがセラーにフィードバックを残す場合にのみ適用されます。各評価は、ユーザーに提示されるラベル、フィールドが必須かどうか、有効状態、および受け入れられる入力形式（事前定義された選択肢、範囲、または自由テキスト）を指定します。getItemsAwaitingFeedback メソッドを呼び出して、利用可能な評価テンプレートを返します。返される評価テンプレートの例については、以下を参照してください。

ON_TIME_DELIVERY（納期厳守）に対する事前定義された（PREDEFINED）はい/いいえの評価タイプ

{
  "ratingKey": "ON_TIME_DELIVERY",
  "ratingLabel": "Did this item arrive on time?",
  "required": false,
  "ratingValueType": "PREDEFINED",
  "enabled": true,
  "acceptableValues": [
    {
      "value": "2",
      "valueLabel": "Yes",
      "enabled": true
    },
    {
      "value": "3",
      "valueLabel": "No",
      "enabled": true
      }
  ]
}

OVERALL_EXPERIENCE（全体的な体験）に対する肯定的、中立的、否定的なフィードバックを含む事前定義された（PREDEFINED）タイプ

{
  "ratingKey": "OVERALL_EXPERIENCE",
  "ratingLabel": "How was your experience?",
  "required": true,
  "ratingValueType": "PREDEFINED",
  "enabled": true,
  "acceptableValues":
  [
    {
      "value": "POSITIVE",
      "valueLabel": "Positive",
      "enabled": true
    },
    {
      "value": "NEUTRAL",
      "valueLabel": "Neutral",
      "enabled": true
    },
    {
      "value": "NEGATIVE",
      "valueLabel": "Negative",
      "enabled": true
    }
  ]
}

OVERALL_EXPERIENCE_COMMENT（全体的な体験コメント）に対する自由テキスト（FREETEXT）評価タイプ

{
  "ratingKey": "OVERALL_EXPERIENCE_COMMENT",
  "ratingLabel": "What else would you add?",
  "maximumCharactersAllowed": 500,
  "required": true,
  "ratingValueType": "FREETEXT",
  "enabled": true
}

DSR_ITEM_AS_DESCRIBED（説明通りの商品）に対する1から5の値を取る範囲（RANGE）評価タイプ

{
  "ratingKey": "DSR_ITEM_AS_DESCRIBED",
  "ratingLabel": "Item description",
  "required": false,
  "ratingValueType": "RANGE",
  "enabled": true,
  "acceptableValues": [
    {
      "value": "1",
      "valueLabel": "Very inaccurate",
      "enabled": true
    },
    {
      "value": "2",
      "valueLabel": "Inaccurate",
      "enabled": true
    },
    {
      "value": "3",
      "valueLabel": "Neither inaccurate nor accurate",
      "enabled": true
    },
    {
      "value": "4",
      "valueLabel": "Accurate",
      "enabled": true
    },
    {
      "value": "5",
      "valueLabel": "Very accurate",
      "enabled": true
    }
  ]
}

Trading APIを使用したフィードバックの管理

以下のAPI呼び出しは、Trading API を通じて取引フィードバックを管理します。

セラーは GetFeedback を使用して、バイヤーから受け取ったフィードバックエントリ、またはバイヤーに残したフィードバックエントリを取得できます。この呼び出しは、セラーの詳細なフィードバック評価と指標も取得します。
GetItemsAwaitingFeedback 呼び出しは、セラーがまだバイヤーにフィードバックを残していないすべての販売取引を返します。
セラーは LeaveFeedback を使用して、特定の販売取引についてバイヤーにフィードバックを提供します。
RespondToFeedback を使用して、フィードバックに対処したり、フォローアップのコメントを含めたりします。これにより、セラーは問題を明確にしたり感謝の意を表したりすることができ、バイヤーとセラーの関係をさらに強化できます。

コードサンプル

eBay USマーケットプレイスでのセラー主導オファーの対象となるeBayリスティングの取得

curl -X GET "https://api.ebay.com/sell/negotiation/v1/find_eligible_items"
-H "Authorization: Bearer OAUTH_token"
-H "X-EBAY-C-MARKETPLACE-ID: EBAY_US"

すべての通知トピックの取得

curl -X GET "https://api.ebay.com/commerce/notification/v1/topic"
-H "Authorization: Bearer OAUTH_token"

エラー処理

createDestination または updateDestination が無効なエンドポイントエラーで失敗した場合は、エンドポイントがHTTPSプロトコルを使用しているか、パスに内部IPアドレスや localhost が含まれていないかを確認してください。
createDestination または updateDestination が無効な検証エラーで失敗した場合は、トークンの長さが32〜80文字であり、英数字、アンダースコア (_)、ハイフン (-) のみが含まれていることを確認してください。
無効な topicId が原因で createSubscription が失敗した場合は、getTopics を使用して正しいIDを取得し、宛先エンドポイントが正しく構成され、通知を受信できるように有効になっていることを確認してください。
公開鍵の取得時にエラーが発生した場合は、Base64エンコードされた X-EBAY-SIGNATURE ヘッダーが正しく抽出されてパラメータとして渡されていることを確認し、データの整合性を保証するためにペイロードに対して署名を検証してください。

ベストプラクティス

定期的に getSubscriptions を使用してアクティブな購読を監査および管理し、現在の通知ニーズと一致していることを確認してください。
createSubscriptionFilter を使用して特定の基準に基づいて通知を絞り込み、不要なデータ処理を削減してください。
getDestinations を使用して設定されているすべてのエンドポイントを定期的に確認し、最新かつ安全であることを確認してください。
testSubscription を使用してエンドポイントをテストし、通知を正しく受信していることを確認してください。
getPublicKey メソッドまたは以下のeBay Event Notification SDKのいずれかを使用して、受信した通知ペイロードが本物であり、改ざんされていないことを常に検証してください。
- Java SDK
- .NET SDK
- Node.js SDK
- PHP SDK
- Go SDK