タクソノミー API（Taxonomy API）

Taxonomy API は、販売者が在庫品を販売できる最も適切な eBay カテゴリと、購入者が購入する品物を閲覧または検索できる最も適切なカテゴリを見つけることができます。さらに、リストに含める必要のあるカテゴリの側面（アスペクト）と推奨されるカテゴリの側面に関するメタデータを提供し、部品の互換性情報を取得するための操作も備えています。

バージョン: v1.1.1

ベースURL: https://api.ebay.com/commerce/taxonomy/v1

認証（OAuth スコープ）

この API は クライアント資格情報（Client Credentials） フローを使用します。ユーザー認証は不要で、アプリケーショントークンのみで呼び出し可能です。

リソース一覧

Taxonomy API は以下の 2 リソースカテゴリ、合計 9 エンドポイント（すべて GET）で構成されています。

category_tree — カテゴリツリー管理（8 エンドポイント）

category_tree リソースは、eBay カテゴリツリーの取得、サブツリーの取得、推奨カテゴリの検索、アスペクト情報の取得、および部品互換性情報の取得を提供します。

GET /category_tree/{category_tree_id}

getCategoryTree — category_tree_id で識別される完全なカテゴリツリーを取得します。応答には、指定された eBay カテゴリツリーのすべてのノードの詳細と、このカテゴリツリーを使用する eBay マーケットプレイスが含まれます。

注: このメソッドは非常に大きなペイロードを返す可能性があるため、gzip 圧縮がサポートされています。Accept-Encoding: gzip ヘッダーを含めてください。

レスポンス: 200 → CategoryTree / 400 / 404 / 500

GET /category_tree/{category_tree_id}/fetch_item_aspects

fetchItemAspects — eBay マーケットプレイスに属するすべてのリーフカテゴリのアスペクトの完全なリストを返します。

注: 応答は content-type: application/octet-stream で gzip 圧縮された JSON ファイルとして返されます。ファイルは 100 MB を超える場合があります。.gz を処理するユーティリティで解凍してください。オープンソースの Taxonomy SDK を使用すると、バージョン間の変更を比較できます。

レスポンス: 200 → GetCategoriesAspectResponse（gzip 圧縮バイナリ）/ 400 / 404 / 500

GET /category_tree/{category_tree_id}/get_category_subtree

getCategorySubtree — カテゴリツリーの指定されたカテゴリの下にあるサブツリーのすべてのノードの詳細を取得します。

注: gzip 圧縮がサポートされています。Accept-Encoding: gzip ヘッダーを含めてください。

レスポンス: 200 → CategorySubtree / 400 / 404 / 500

GET /category_tree/{category_tree_id}/get_category_suggestions

getCategorySuggestions — クエリ文字列に最も近いと判断されるカテゴリツリーのリーフノードの配列を返します。各推奨ノードのローカライズされた名前と、カテゴリの各祖先ノードの詳細が返されます。

重要: この呼び出しはサンドボックス環境ではサポートされていません。サンドボックスでは categoryName にランダムテキストが返されます。

レスポンス: 200 → CategorySuggestionResponse / 204 / 400 / 404 / 500

GET /category_tree/{category_tree_id}/get_compatibility_properties

getCompatibilityProperties — 自動車部品またはアクセサリと互換性のある自動車を定義するために使用される互換性プロパティ（メーカー、モデル、年式、エンジン、トリムなど）を取得します。

対応マーケットプレイス: eBay US (0)、eBay Motors US (100)、eBay Canada (2)、eBay UK (3)、eBay Germany (77)、eBay Australia (15)、eBay France (71)、eBay Italy (101)、eBay Spain (186)

レスポンス: 200 → GetCompatibilityMetadataResponse / 204 / 400 / 404 / 500

GET /category_tree/{category_tree_id}/get_compatibility_property_values

getCompatibilityPropertyValues — 指定された eBay マーケットプレイス、カテゴリ、およびフィルターに基づいて、適用可能な互換性プロパティ値を取得します。compatibility_property で取得するプロパティを指定し、filter で結果を絞り込みます。

使用例: 2018 年型トヨタ カムリのトリムを取得する場合: compatibility_property=Trim&filter=Year:2018,Make:Toyota,Model:Camry

レスポンス: 200 → GetCompatibilityPropertyValuesResponse / 204 / 400 / 404 / 500

GET /category_tree/{category_tree_id}/get_expired_categories

getExpiredCategories — 指定されたカテゴリツリー内の期限切れのリーフカテゴリと、対応するアクティブなリーフカテゴリとのマッピングを取得します。複数の期限切れカテゴリが 1 つのアクティブカテゴリにマッピングされる場合があります。

注: このメソッドはマッピングされたカテゴリ（結合/分割カテゴリ）に関する情報のみ返します。対応するアクティブカテゴリがない期限切れカテゴリの情報は返しません。

レスポンス: 200 → ExpiredCategories / 204 / 400 / 404 / 500

GET /category_tree/{category_tree_id}/get_item_aspects_for_category

getItemAspectsForCategory — 指定されたリーフカテゴリ内のアイテムを正確に記述するのに適切または必要なアスペクトのリストを返します。各アスペクトのメタデータには以下が含まれます:

• データ型、形式、入力モード
• リストへの必須/推奨の区別
• バリエーションでの使用可否
• 複数値の受け入れ可否
• 許可される値のリスト

レスポンス: 200 → AspectMetadata / 204 / 400 / 404 / 500

get_default_category_tree_id — デフォルトカテゴリツリー ID（1 エンドポイント）

GET /get_default_category_tree_id

getDefaultCategoryTreeId — 指定された eBay マーケットプレイスに関連付けられたデフォルトのカテゴリツリーへの参照を取得します。応答にはツリーの一意の識別子とバージョンのみが含まれます。

レスポンス: 200 → BaseCategoryTree / 204 / 400 / 500

スキーマ定義（全 24 スキーマ）

カテゴリツリー

CategoryTree

CategoryTreeNode

Category

BaseCategoryTree

CategorySubtree

カテゴリ候補

CategorySuggestionResponse

CategorySuggestion

AncestorReference

アスペクト

AspectMetadata

Aspect

AspectConstraint

AspectValue

ValueConstraint

RelevanceIndicator

GetCategoriesAspectResponse

CategoryAspect

互換性

GetCompatibilityMetadataResponse

CompatibilityProperty

GetCompatibilityPropertyValuesResponse

CompatibilityPropertyValue

期限切れカテゴリ

ExpiredCategories

ExpiredCategory

共通スキーマ

Error

ErrorParameter

エンドポイント一覧（全 9 エンドポイント）