Compliance API

Compliance API 概要 (Compliance API Overview)

注: Compliance API は非推奨 (deprecated) となり、2026年3月30日に廃止 (decommissioned) される予定です。

Compliance APIは、セラーが出品をeBayのポリシーに準拠させるのに役立ちます。このAPIを使用して、違反がある特定のセラーのすべての出品を特定します。出品違反は、バイヤーに悪い体験をもたらす可能性があり、違反が修正されるまでセラーが出品を更新できなくなる可能性もあります。Compliance APIは、さまざまなコンプライアンスタイプの出品違反を取得するために使用されます。セラーのアクティブな出品で出品違反が発見された場合、セラーはこれらの出品を修正して出品違反を訂正する必要があります。出品コンプライアンスタイプの概要は以下のとおりです：

  • Aspects Adoption（アスペクト採用）: このコンプライアンスタイプは、セラーの出品がアスペクト（Item Specifics: 商品詳細）に関するeBayのポリシーに違反していないかを確認するために使用されます。各カテゴリについて、eBayは必須および推奨アスペクトのリストを保持しています。ASPECTS_ADOPTIONを確認すると、必須または推奨アスペクトが欠落しているか、無効な値を持つ出品がレスポンスに含まれます。
  • HTTPS protocol（HTTPSプロトコル）: このコンプライアンスタイプは、商品説明でHTTPSリンクの代わりにHTTPリンクを使用するというeBayのポリシーに違反している出品があるかどうかを確認するために使用されます。この要件には、外部でホストされている出品画像へのリンクが含まれます。出品画像をホストしているサーバーがHTTPSプロトコルをサポートしていない場合、このサーバーは出品画像のホストには使用できません。APIインターフェースでは、このコンプライアンスタイプの列挙値は HTTPS です。
  • Non-eBay Links（非eBayリンク）: このコンプライアンスタイプは、商品説明にeBay以外のサイトへのリンクを許可しないというeBayのポリシーに違反している出品があるかどうかを確認するために使用されます。セラーが商品説明に個人のメールアドレスや電話番号を含めることも、このポリシーの違反となります。セラーとバイヤー間のすべての通信は、eBayの通信システムを通じて処理される必要があります。この外部リンクルールの唯一の例外は、製品ビデオ、貨物配送サービスに関する情報、または法的に必要な情報へのリンクです。APIインターフェースでは、このコンプライアンスタイプの列挙値は OUTSIDE_EBAY_BUYING_AND_SELLING です。
  • Product Adoption（製品採用）: Product Adoptionは現時点では強制されていません。
  • Product Adoption Conformance（製品採用適合性）: Product Adoptionは現時点では強制されていません。
  • Return Policy（返品ポリシー）: このコンプライアンスタイプは、サポートされなくなった返品期間を持つ出品があるかどうかを確認するために使用されます。最近、多くのeBayサイト（米国を含む）で14日間の返品期間が廃止されたため、多くのeBayサイトでの最短返品期間は30日となりました。APIインターフェースでは、このコンプライアンスタイプの列挙値は RETURNS_POLICY です。

Compliance APIには、以下の2つの呼び出しがあります：

  • getListingViolationsSummary : この呼び出しは、現在1つ以上のコンプライアンスタイプに違反しているアクティブな出品の数を返します。結果は、一意のeBayマーケットプレイスとコンプライアンスタイプの組み合わせごとにグループ化されます。
  • getListingViolations : この呼び出しは、セラーのアクティブな出品における各出品違反に関するデータを返します。結果は出品ごとにグループ化されるため、1つのeBay出品に特定のコンプライアンスタイプの複数の出品違反がある場合、これらの違反は一緒に表示されます。1回の呼び出しで使用できるコンプライアンスタイプは1つだけです。

技術概要 (Technical overview)

Compliance APIは、どのユーザーインターフェース、ツール、またはAPIを使用して作成されたかに関係なく、あらゆるeBay出品の出品違反を取得するRESTful APIです。eBay RESTful APIの使用が初めての方には、Using eBay RESTful APIs ドキュメントを読むことをお勧めします。このドキュメントには、eBay開発者アカウントの要件、OAuthアクセストークン、エラーメッセージの処理などがまとめられています。

getListingViolations 呼び出しでは、ページネーション制御が有効になっています。ページネーション制御を使用すると、ユーザーは1ページのデータで返される出品違反の数の制限を設定でき、offset クエリパラメータを使用して複数の結果ページをスクロールできます（該当する場合）。

ビジネスユースケース (Business use cases)

以下は、Compliance APIが対応する高レベルのユースケースです。

  • 1つ以上の出品違反があるアクティブな出品の数を取得する。
  • すべての出品違反に関するデータを取得する。取得されたデータには、eBay出品の一意の識別子（および該当する場合はバリエーションの一意の識別子）と出品違反の詳細が含まれます。セラーがこの出品違反に関する情報を持ったら、Inventory APIの createOrReplaceInventoryItem 呼び出し、またはTrading APIの ReviseItem/ReviseFixedPriceItem 呼び出しを使用して、これらの出品を修正できます。

Compliance APIの要件と制限 (Compliance API requirements and restrictions)

Compliance API（またはその他のeBayパブリックAPI）を使用するには、ユーザーはeBay Developers Programアカウントを持っている必要があります。すでにアカウントを持っているが、eBay RESTful APIを使用したことがない場合、追加の要件については Using eBay RESTful APIs ドキュメントで説明されています。

サポートされているマーケットプレイス

Compliance APIは、APIサポートがあるすべてのeBayマーケットプレイスでサポートされています。

注: Compliance APIの将来のリリースでは、listing_id クエリパラメータの有効化により、getListingViolations 呼び出しは指定されたeBay出品の出品違反データを取得する機能をサポートする予定です。
トップに戻る