Feed Beta API(Buy)

Feed Beta API 概要 (Feed Beta API Overview)

バージョン：v1_beta.35.3

Feed Beta APIを使用すると、以下のことが可能になります：

  • 特定のeBayマーケットプレイスから、あるカテゴリのすべての商品をダウンロードする。
  • 特定の日に特定のカテゴリ、特定のマーケットプレイスに出品されたすべての商品をダウンロードする。
  • 商品のアイテムグループ（バリエーション）情報をダウンロードする。
  • 商品アスペクト、価格、製品情報、支払い方法、配送先などの条件により、オフラインで商品をキュレーション（精査）する。
  • 1時間ごとのフィードファイルを使用して、商品情報を最新の状態に保つ。
  • 日次プライオリティ商品フィードファイルを使用して、特定のキャンペーン内の優先商品のステータス変更を追跡する。
注: これは限定リリース (Limited Release) APIであり、ビジネスユニットによって承認された一部の開発者のみが利用可能です。本番環境（Production）でのアクセス権取得方法については、Buy API Requirements を参照してください。

技術概要 (Technical overview)

Feed APIを使用することで、バイヤー向けに豊富な商品や製品のセレクションを作成できます。商品フィードにより、さまざまなカテゴリのeBayマーケットプレイス商品の詳細を取得できます。利用可能なカテゴリのリストは、Taxonomy API を通じて取得可能です。

注: サンドボックス環境では、限られた数のカテゴリのみがサポートされています。詳細は「サンドボックスの制限とサポート」セクションを参照してください。

このAPIは以下のリソースを使用します：

  • item - 特定のカテゴリ、日付、マーケットプレイスにおいて新しく出品された商品の「日次商品フィードファイル」（feed_scope = NEWLY_LISTED）、または特定のカテゴリとマーケットプレイス内のすべての商品を含む「週間商品ブートストラップ（Bootstrap）フィードファイル」（feed_scope = ALL_ACTIVE）を返します。詳細は getItemFeed を参照してください。
  • item_group - 「日次商品フィードファイル」に含まれる商品のバリエーション情報を含む「日次アイテムグループファイル」（feed_scope = NEWLY_LISTED）、または「商品ブートストラップフィードファイル」に含まれる商品のバリエーション情報を含む「週間アイテムグループブートストラップフィードファイル」（feed_scope = ALL_ACTIVE）を返します。詳細は getItemGroupFeed を参照してください。
  • item_snapshot - 特定の日時にカテゴリとマーケットプレイスで変更があった商品を含む、1時間ごとのGZIPファイルを返します。詳細は getItemSnapshotFeed を参照してください。スナップショットフィードには新規出品も含まれるようになりました。itemCreationDate を確認することで、指定された時間内に新しく作成された出品を特定できます。
  • item_priority - 追跡ペイロードが更新されたキャンペーンに対して、追加または削除された、指定カテゴリ内のすべての商品の日次GZIPファイルを返します。詳細は getItemPriorityFeed を参照してください。
注: itemEndDate および estimatedAvailabilityStatus フィールドを確認し、その出品が購入可能かどうかをチェックしてください。終了日（EndDate）が過去である場合、または estimatedAvailabilityStatus が OUT_OF_STOCK（在庫切れ）の場合は、その出品情報を取り込むべきではありません。

APIに加えて、Javaで書かれたオープンソースの Feed SDK が用意されており、フィードファイルのダウンロードと解凍、およびファイル内の商品をキュレートするためのフィールドフィルタの指定が可能です。

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

他のBuy API群と併用することで、Feed APIは事実上あらゆる場所でショッピングや購入の機会を創出できます。例えば、SNSアプリケーションの中にシームレスな購買体験を組み込むことが可能です。

新規出品商品の「日次フィードファイル」の取得

特定の日付とカテゴリにおける、新規出品商品の情報またはアイテムグループ（バリエーション）情報を含む、日次の Item、Item Group、または Item Priority フィードファイルをダウンロードできます。

カテゴリ内の全商品の「週間フィードファイル」の取得

カテゴリ内のすべての商品の情報またはアイテムグループ情報を含む、週間の Item Bootstrap または Item Group Bootstrap フィードファイルをダウンロードできます。

商品のキュレーション

フィードファイルで返される各フィールドを使用して商品をキュレーションし、特定のユーザー層に合わせたショッピング体験を作成できます。返されるフィールドのリストについては、getItemFeed を参照してください。

商品詳細の更新

eBayでは数量や価格などの商品詳細が頻繁に変更されるため、保存している情報の変更をチェックする必要があります。以下の方法が利用可能です：

  • getItemSnapshotFeed メソッドを使用して、1時間以内に変更があった商品のカテゴリ別TSV_GZIPフィードファイルを1時間ごとに取得する。
  • Browse API の getItem メソッドを使用して、特定の商品の最新詳細を取得する。これは、変化の激しい価格や数量を確認するためによく使用されます。

API制限 (API restrictions)

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

地域/サイトの制約

すべてのBuy APIがサポートされているeBayサイトのリストについては、Buy API Support by Marketplace を参照してください。フィードファイルのサイトを指定するには、X-EBAY-C-MARKETPLACE-ID リクエストヘッダーを設定します（例：X-EBAY-C-MARKETPLACE-ID = EBAY_GB）。

カテゴリの制約

不動産 (Real Estate) のL1カテゴリに分類される商品は、すべてのマーケットプレイスのすべてのフィードから除外されます。

フィードファイルフィルタ

良好なユーザーエクスペリエンスを確保するため、各フィードファイル内の商品はフィルタリングされています。詳細は Feed File Filters を参照してください。

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

サンドボックス環境では誰でも使用可能ですが、以下の制限があります：

  • 日次フィード：カテゴリ 1 および 220 のみサポート。
  • アイテムスナップショット：カテゴリ 220 および 625 のみサポート。
  • ブートストラップ（Bootstrap）フィードはサンドボックス環境では利用できません。

eBay Partner Network (ePN) 追跡リンク

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

レート制限

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

トップに戻る