Catalog API

Catalog API 概要 (Catalog API Overview)

Catalog APIを使用すると、ユーザーは販売したい商品と直接一致するeBayカタログ製品を検索して特定できます。eBayカタログ製品に対して出品（Listing）することは、すべての出品（そのカタログ製品に基づく）が完全かつ正確な情報を持つことを保証するのに役立ちます。これにより、バイヤーは「同じ条件」で比較できるようになり、価格、送料、商品プロモーションなどの出品間の実質的な違いに基づいて購入決定を行うことができます。

高品質な出品の作成を支援することに加えて、カタログ情報を使用して出品を作成するセラーにとってのもう1つのメリットは、出品タイトルの大部分が、出品タイトル、商品説明、Item Specifics（商品詳細）、および製品のストック画像（利用可能な場合）を含め、事前入力（プリフィル）されることです。セラーはItem Specificsを自分で入力する必要がなく、全体的な出品プロセスがはるかに迅速かつ簡単になります。

eBayカタログ製品の検索とこれらの製品を使用した出品の詳細については、Selling Integration Guideの Matching inventory to catalog products を参照してください。

技術概要 (Technical overview)

eBay製品カタログ内の各製品（または製品バリエーション）は、eBay製品ID（ePID）によって一意に識別され、各カタログ製品は通常、UPC、EAN、ISBNなどの1つ以上のGlobal Trade Item Numbers（GTIN）、または製品ブランドと常にペアになるメーカー部品番号（MPN）に関連付けられています。

Catalog APIを使用すると、カテゴリID、キーワード、製品属性、およびアスペクトの絞り込み（refinements）を使用して、一致するカタログ製品を検索できます。セラーがカタログ製品の一致を確認できたら、そのセラーは製品の epid 値を取得し、この値を使用してカタログ製品の詳細に基づいた出品を作成します。eBayは、カタログからのすべての製品情報をセラーの出品に含めます。

主要なCatalog APIオブジェクト

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

  • Product Summary（製品サマリー）

    ProductSummary オブジェクトには、製品のタイトル、アスペクトとその値、関連画像、および製品に適用される認識された識別子など、製品に関する基本的な情報が含まれています。また、そのeBay製品ページへのURLも含まれています。

  • Refinement（絞り込み）

    Refinement オブジェクトには、指定されたeBayカテゴリのアスペクト（プロパティ）と、各アスペクトに使用された値、および各値が過去のeBay出品で使用された回数のカウントが含まれています。この情報は、セラーが製品に最も適切な検索条件を選択するのに役立ちます。

  • Product（製品）

    Product オブジェクトには、製品のタイトルと説明、アスペクトとその値、関連画像、適用可能なカテゴリID、および製品に適用される認識された識別子など、製品に関する詳細情報が含まれています。

  • Product Aspect（製品アスペクト）

    ProductAspect オブジェクトには、製品のブランドとカテゴリに応じて変化する製品属性のタイプ（アスペクト）に関する情報が含まれています。たとえば、Sleeve Length（袖丈）というアスペクトはシャツには適用されるかもしれませんが、カメラには適用されません。製品ブランドとカテゴリのすべての組み合わせには、アスペクトの一意の組み合わせがあります。

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

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

eBay出品のベースとなる候補製品を発見する

商品のeBay出品を作成する前に、search 呼び出しを使用して、出品のベースとなる正しいカタログ製品を発見します。

eBayが推奨する、または指定したカテゴリのすべてのアスペクトに関するヒストグラム情報を含む絞り込みデータをリクエストできます。ヒストグラムデータをセラーに提示して、商品に一致するアスペクト値を選択させ、その値を使用して検索結果をフィルタリングします。

製品の1つ以上のカテゴリと、製品レコードで検索するキーワードを特定することで選択肢を絞り込むことができ、これにより確認のためにセラーに提示する候補製品のサマリーが返されます。

製品の詳細を取得する

セラーが製品サマリーに基づいて商品に一致する製品を確認できなかった場合は、getProduct 呼び出しを使用して個々の製品に関する利用可能なすべての詳細を取得し、それらの詳細をセラーに提示して一致する製品を選択させます。

API制限 (API restrictions)

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

Catalog APIは、AU、CA (en)、DE、ES、FR、GB、IT、およびUSマーケットプレイスでサポートされています。

SandboxとProductionデータ

eBay Sandbox環境のデータは静的です。範囲と数量が制限されている可能性があり、シミュレートされたデータや模擬データの場合があります。その結果、Production環境のデータにも同じ制限があると依存すべきではありません。アプリケーションが遭遇する可能性のあるデータのより広い範囲と変動性を予測するために、優れたコーディング手法を使用してください。

レート制限

Catalog APIは、アプリケーションに代わって1日に行うことができる呼び出しの数を制限しています。現在のアプリケーションレート制限については、API Call Limits ページを参照してください。

Catalog APIは、認証されたユーザーが行うことができる呼び出しの数も制限しています。特定のユーザーに代わって行われる呼び出しは、1日あたり 100,000 回に制限されています。

トップに戻る