Feed API(Buy)

Feed API 概要 (Feed API Overview)

バージョン：1.2.1

注: Feed API beta（ベータ版）のドキュメントをお探しですか？それらは こちら で入手可能です。

Feed API を使用すると、選択したカテゴリや特定のマーケットプレイスの商品フィードファイルをダウンロードして、eBayのカテゴリをミラーリング（複製）することができます。

注: これは限定リリース (Limited Release) APIであり、ビジネスユニットによって承認された一部の開発者のみが利用可能です。本番環境（Production）でのアクセス権取得方法については、Buy API Requirements を参照してください。

技術概要 (Technical overview)

Feed APIを使用することで、バイヤー向けに商品や製品の豊富な選択情報をダウンロードできます。商品フィードにより、さまざまなトップレベル（L1）カテゴリにわたるeBayマーケットプレイス商品の詳細を取得できます。利用可能なL1カテゴリのリストは、Taxonomy API を通じて取得可能です。

注: Taxonomy APIレスポンス内のL1カテゴリは、categoryTreeNodeLevel の値が 1 になっています。

メソッド

Feed APIでは以下のメソッドを使用します：

  • getAccess – アプリケーションのフィードファイルアクセス構成の詳細を返します。アプリケーションがフィードをダウンロードできるマーケットプレイスとカテゴリをリストします。
  • getFeedTypes – ダウンロード可能なすべてのフィードのリストをフィードタイプ別に返します。レスポンスには、フィードのスコープ（日次、時間次、または週次）、サポートされているフィード、マーケットプレイス、およびステータス（アクティブ、一時停止中、または廃止予定）に関する情報が含まれます。
  • getFeedType – ダウンロード可能な特定のフィードタイプのフィードリストを返します。レスポンスには、フィードのスコープ、サポートされているフィード、マーケットプレイス、およびステータスに関する情報が含まれます。
  • getFile – 指定されたダウンロードファイルに関する選択されたメタデータを返します。フィードの日付、ファイルタイプ、スコープ、形式、および対象となるマーケットプレイスの詳細が含まれます。
  • getFiles – ダウンロード可能なフィードファイルのリストを返します。ファイルの検索は、フィードタイプ、フィードスコープ、カテゴリID、および提供開始時期などの条件でフィルタリングできます。
  • downloadFile – 選択したフィードファイルをダウンロードします。

サポートされているフィードタイプ

以下の表は、現在 Feed API でサポートされているフィードタイプをリストしています：

フィードタイプ ID フィードタイプの説明 サポートされる
マーケットプレイス
CURATED_ITEM_FEED カテゴリと日付に基づいた、厳選された（キュレーションされた）商品のコレクションを提供し、それらの商品を説明するフィールドセットを返します。 AU, DE, FR, GB, IT, US
PRODUCT_FEED 一意のeBayプロダクト識別子（ePID）と商品の状態ごとに単一のオファー（出品）のみを含む商品のコレクションを提供し、それらの商品を説明するフィールドセットを返します。 AU, DE, FR, GB, IT, US
PROMOTION 実行中の割引（Discounts）と現在それらに関連付けられている商品の時間単位のスナップショットを提供し、割引を説明するフィールドセットを返します。
注: 2024年7月8日以降、これらは「割引（Discounts）」と呼ばれます。 		AU, DE, GB, US
CBT_ITEM_ALL_ACTIVE 仕向け地市場向けに設計されており、国際的な可視性のための商品のコレクションを提供します。これらは特定の市場から調達され、他の市場（ドイツからオーストリアなど）へ発送可能な在庫で構成されます。注: この出力形式は AVRO です。 AT, IE
注: 各タイプで返されるフィードフィールドの例を表示するには、表内のフィードタイプリンクをクリックしてください。

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

Feed APIが対応する主なユースケースは以下の通りです：

  • 関連性の高いオファーのみを含む日次スナップショットの Curated Item フィードファイルをダウンロードする。
  • 一意のeBay製品識別子（ePID）と商品の状態ごとに単一のオファーのみを含む Product Feed ファイルをダウンロードする。
  • 実行中の割引と、現在関連付けられているすべての商品の1時間ごとのスナップショットを含む Promotion フィードファイルをダウンロードする。
  • 商品アスペクト、価格、製品情報、配送先などの条件により、オフラインで商品をキュレーション（精査）する。
  • ライブサイトの詳細と同期することで、商品情報を最新の状態に保つ。

Feed APIの使用に関する詳細は、Buying Integration Guideの Feed API v1 セクションを参照してください。

API制限 (API restrictions)

Feed APIに関する以下の制約事項に注意してください。また、Buy API全般の要件についても Buy APIs Requirements で確認してください。

地域/サイトの制約

特定のフィードタイプでサポートされているマーケットプレイスのリストを確認するには、getFeedTypes メソッドを使用してください。利用可能なフィードファイルの詳細にアクセスするには、対象のeBayマーケットプレイスの X-EBAY-C-MARKETPLACE-ID リクエストヘッダーを渡します（例：X-EBAY-C-MARKETPLACE-ID : EBAY_AU）。

サンドボックスの制限とサポート

Feed APIは、現在eBayのサンドボックス環境では利用できません。

本番環境（Production）での使用は制限されています。ユーザーは標準の適格性要件を満たし、eBayサポート組織からの承認を得て、eBayと契約を締結する必要があります。詳細はBuying Integration Guideの Production eligibility requirements を参照してください。

eBay Partner Network (ePN) 追跡リンク

ePNパブリッシャーは、適切な追跡リンクを使用してeBay商品を宣伝する必要があります。Feed APIは追跡リンクを直接提供しません。リンクを取得するには Browse API の getItem メソッドを使用するか、自身で作成する必要があります。作成方法は Create EPN Tracking Link を参照してください。

レート制限

Feed APIは、アプリケーションに代わって1日に行える呼び出し回数を制限しています。現在のアプリケーションレート制限については、API call limits ページを参照してください。

トップに戻る