Taxonomy API

Taxonomy API 概要 (Taxonomy API Overview)

Taxonomy APIを使用すると、セラーとバイヤーの両方を支援できます：

  • セラーが、選択したeBayマーケットプレイスで販売する各在庫アイテムを提供するのに最適なeBayカテゴリを決定するのを支援します。セラーがキャンペーンやプロモーションに含めるアイテムのカテゴリを選択するのに役立ちます。また、特定のカテゴリで在庫アイテムを定義する際に含めるべきアスペクト（属性）に関する情報も提供します。詳細については、Selling Integration Guide を参照してください。
  • バイヤーが、特定のeBayマーケットプレイスで購入しようとしているアイテムを閲覧または検索するための適切なカテゴリを決定するのを支援します。詳細については、Buying Integration Guide を参照してください。

RESTful APIの使用方法の詳細については、Using eBay Restful APIs を参照してください。

技術概要 (Technical overview)

特定のeBayマーケットプレイスで商品を販売したり、購入する商品を見つけたりするプロセスにおいて、Taxonomy APIを使用して、そのマーケットプレイスで利用可能なカテゴリを見つけ、セラーやバイヤーがそれらのカテゴリのサブセットを反復処理したり、eBayからのカテゴリ提案を得るためにキーワードやフレーズを入力したりできるようにします。このプロセスの目的は、セラーやバイヤーが、それぞれ商品を販売したり購入したりするために最も適切なカテゴリを選択できるように支援することです。

主要なTaxonomy APIオブジェクト

オブジェクトは以下の通りです：

  • Category（カテゴリ）：Category オブジェクトは、カテゴリIDと名前でeBay製品カタログ内のカテゴリを定義します。eBayカテゴリは、以下を識別するために機能します：
    • eBayマーケットプレイス内の類似した出品のセット、または
    • より具体的なeBayカテゴリのセット

    すべてのeBay製品カテゴリは、eBayカテゴリツリー内のカテゴリツリーノードに配置されています。

    出品を適切なカテゴリに割り当てることで、潜在的なバイヤーがそのカテゴリ内を閲覧または検索してその出品を見つけられるようになります。出品を間違ったカテゴリに割り当てると、その出品を販売するセラーの能力に深刻な損害を与える可能性があります。

  • Category Tree Node（カテゴリツリーノード）：CategoryTreeNode オブジェクトは、eBayカテゴリツリー内の場所を識別します。これには関連付けられた Category オブジェクトが含まれ、以下のいずれかとして指定されます：
    • リーフ（leaf）ノード（その関連カテゴリは類似した出品のセットを識別します）、または
    • 親（parent）ノード（その関連カテゴリはより具体的なカテゴリのセットを識別します）

    親 CategoryTreeNode オブジェクトには、1つ以上のネストされたカテゴリツリーノードが含まれます。

  • Category Tree（カテゴリツリー）：カテゴリツリーは、カテゴリツリーノードで構成される完全な階層フレームワークを構成し、各ノードには関連付けられたeBayカテゴリがあります。CategoryTree オブジェクトはカテゴリツリーを表し、1つのルートレベルの親カテゴリツリーノードを含み、そのノードにはさらに1つ以上のネストされたカテゴリツリーノードが含まれます。

    特定のカテゴリツリーは、1つ以上のeBayマーケットプレイスで使用されるデフォルトのツリーになることができます。

  • Category Subtree（カテゴリサブツリー）：カテゴリサブツリーは、指定されたカテゴリツリーの完全なブランチ（枝）を構成します。これは、1つ以上のカテゴリツリーノードで構成され、各ノードには関連付けられたeBayカテゴリがあります。CategorySubtree オブジェクトには、1つの非ルートカテゴリツリーノードが含まれ、これはリーフノード（つまりサブツリー全体）または親ノード（さらに1つ以上のネストされたカテゴリツリーノードを含む）のいずれかになります。
  • Aspect（アスペクト）：アスペクトは、色やサイズなど、リーフカテゴリに関連付けられた定義済みの属性です。各リーフカテゴリには、独自のアスペクトセットがあります。Aspect オブジェクトには、アスペクト名、有効な値、およびそれらの値の使用に関する制約が含まれます。セラーは、Inventory APIの createOrReplaceInventoryItem 呼び出しを使用してそのカテゴリで在庫アイテムを定義する際に、特定のカテゴリの一部の必須アスペクトに値を提供または選択する必要があります。カテゴリの他のアスペクトは利用可能ですが、必須ではない場合があります。

以下の図は、eBayカテゴリツリー内のオブジェクト間の関係を示しています：

Taxonomy Overview Diagram

このカテゴリツリーには10個のカテゴリツリーノードが含まれています。5個はリーフノードで、すべてにカテゴリが含まれています。各リーフノードカテゴリは、そのカテゴリに属する出品を識別し、各非リーフカテゴリはより具体的なカテゴリを識別します。

注: ルートノードのカテゴリはツリー内のすべてのカテゴリを識別しますが、そのカテゴリ名が予測可能であることや、意味のある情報を提供することに依存しないでください。

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

このセクションでは、Taxonomy APIが対応する高レベルのユースケースについて概説します。

出品またはプロモーションに使用するカテゴリを発見する

商品のeBay出品を作成する前に、Taxonomy APIを使用して、セラーが最も適切なカテゴリを発見するのを支援できます。出品を間違ったカテゴリに割り当てると、セラーがその商品を販売する能力が大幅に制限される可能性があるため、商品に最適なカテゴリを見つけることは不可欠です。また、セラーがプロモーションに含めるカテゴリを選択できるようにすることもできます。オファーを公開するときは、必須のカテゴリアスペクトをItem Specifics（商品詳細）として含めてください。

バイヤーが商品を閲覧または検索するためのカテゴリを発見する

バイヤーが購入アプリケーションでeBayの商品を検索する前に、Taxonomy APIを使用してeBayマーケットプレイスの完全なカテゴリツリーを提示し、ツリー階層を閲覧して、興味のある分野のカテゴリに検索の焦点を絞り込めるようにすることができます。このようにして、バイヤーが購入したい商品をカバーするカテゴリを特定しつつ、検索結果を乱雑にする可能性のある不要な商品の数を最小限に抑えることができます。

期限切れカテゴリのカテゴリマッピングを取得する

eBayは、購入および販売体験を向上させるために、定期的にカテゴリ構造を更新します。これは、既存のカテゴリが時折期限切れになり、新しいカテゴリに置き換えられるか、既存のカテゴリに統合されることを意味します。セラーとして、潜在的なバイヤーへの可視性を確保するために、出品のカテゴリを最新の状態に保つことが重要です。期限切れのリーフカテゴリ（指定されたカテゴリツリー内）を置き換えたアクティブなリーフカテゴリを特定するために、セラーは getExpiredCategories メソッドを使用できます。レスポンスは、期限切れのリーフカテゴリと対応するアクティブなリーフカテゴリ間のマッピングを提供します。

API制限 (API restrictions)

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

現在、Taxonomy APIは少なくとも20のマーケットプレイスでサポートされています。リストについては、Marketplaces with Default Category Trees を参照してください。

レート制限

Taxonomy APIを使用して1日に行うことができる呼び出し数は、アプリケーションのeBay互換性レベルによって異なります。Tier 1アプリケーションは、1日あたり 5,000 回の呼び出しに制限されています。

トップに戻る