Feed API

Feed API 概要 (Feed API Overview)

Sell Feed API を使用すると、セラーはフィードファイルやレポートのアップロードとダウンロード、およびスケジュールの作成を行うことができます。アップロードおよびダウンロードされるフィードファイルは、eBayによって非同期で処理されます。すべてのアップロードおよびダウンロードタスクのステータスは、一意の「タスクID」で追跡されます。各レポートは、日付範囲やその他のフィルタ条件を使用してカスタマイズできます。

技術概要 (Technical overview)

このAPIには以下のリソースが含まれています：

  • order_task - 注文に関連するフィルタ条件を使用して注文ダウンロードタスクを作成し、特定の注文タスクまたは注文タスクグループのステータスと詳細を取得します。
  • inventory_task - 在庫に関連するフィルタ条件を使用して在庫アップロードまたはダウンロードタスクを作成し、特定の在庫タスクまたは在庫タスクグループのステータスと詳細を取得します。
  • schedule - フィードAPIリソースのスケジュールを作成します。スケジュールは、指定された feedType のレポートを定期的に生成します。スケジュールは、フィードタイプなどの使用されるパラメータを定義するテンプレートに基づいています。
  • task - フィルタ条件なしでアップロードまたはダウンロードタスクを作成し、特定のタスクまたはタスクグループのステータスと詳細を取得します。ダウンロードタスクかアップロードタスクかは、指定された feed_type によって決まります。
  • customer_service_metric_task - フィルタ条件を使用してカスタマーサービス指標ダウンロードタスクを作成します。このタスクは、特定のカスタマーサービス指標タスクまたはタスクグループのステータスと詳細も取得できます。

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

Sell Feed API は以下のユースケースをサポートしています。詳細については、LMS Feed API Guide を参照してください。

出品の一括作成と管理

さまざまなeBayフィードタイプを使用して、セラーはファイルをアップロードし、出品を一括で作成および管理できます。これは、一度に多数の出品を作成または更新する必要がある大規模なセラーにとって特に便利です。Trading API関連のXMLデータファイル（出品の追加、修正、再出品、検証、または終了を一括で行う）をアップロードするには、Upload flow（LMS Feed API Guide内）を参照してください。Seller Hubワークフローについては、Seller Hub feed flow（Seller Hub Feed API Guide内）を参照してください。

注文レポートのダウンロード

order_task メソッドを使用することで、すべての未確認注文に関する詳細情報を示す注文レポートを生成できます。詳細については、Overview of order report flow を参照してください。

Order Ackアップロードファイルによる履行済み注文の確認

注文確認ファイル（order acknowledgment file）をアップロードすることで、受信し処理または履行中の注文を確認（Acknowledge）できます。このファイルが処理された後、次の注文レポートには未確認の注文のみが返されます。詳細については、Submitting an order acknowledgment file を参照してください。

アクティブ在庫レポートのダウンロード

inventory_task メソッドを通じて、すべてのアクティブな出品の価格と数量情報を示すアクティブ在庫レポートを作成できます。詳細については、Overview of active inventory report flow を参照してください。

カスタマーサービス指標レポートのダウンロード

customer_service_metric_task メソッドを通じて、レポートダウンロードタスクを作成し、特定の評価タイプ、サービス指標タイプについてパフォーマンスに影響を与える取引のリストを取得できます。その他のフィルタも指定可能です。リクエスト作成日のデータ範囲フィルタを適用して、返される取引リストを検索できます。詳細については、Customer Service Metrics Report を参照してください。

スケジュールの作成

schedule メソッドを通じて、スケジュール（指定されたスケジュールテンプレートへのサブスクリプション）を作成できます。スケジュールは、テンプレートで指定された feed_type のレポートを返します。スケジュールを作成する際には、フィードタイプおよびスケジュールに必要なその他のパラメータを含むテンプレートを指定します。また、希望するトリガー時間（時）、曜日、または日付を指定することもできます。詳細については、Creating Schedules を参照してください。

要件と制限 (Requirements and restrictions)

以下は、Sell Feed APIの要件と制限です。

ファイル保持期間

ファイルが保持され（利用可能で）ある日数は、フィードタイプによって異なります。詳細については以下の表を参照してください。

LMS feedType * タスクリクエストの保持期間（日） タスクレスポンス ** の保持期間（日）
LMS_ORDER_REPORT 適用なし 30
LMS_ACTIVE_INVENTORY_REPORT 適用なし 90
その他のすべての LMS feedTypes 3 90

* アップロードおよびダウンロードフィードタイプの完全なリストについては、Available feed types を参照してください。
** ダウンロードタスクの場合はレポートまたはエラーレスポンス、アップロードタスクの場合はレスポンスペイロードが含まれます。

注: タスクリクエストとレスポンスについて：

スコープ制限

以下の表は、Sell Feed APIのスコープとそれらがサポートするユースケースをリストしています。

スコープ (Scope) ユースケース (Use Case)
https://api.ebay.com/oauth/api_scope/sell.inventory Active Inventory Report
https://api.ebay.com/oauth/api_scope/sell.fulfillment LMS Order Ack および Order Report
https://api.ebay.com/oauth/api_scope/sell.marketing 将来の使用のため
https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly 将来の使用のため
https://api.ebay.com/oauth/api_scope/sell.analytics.readonly Customer Service Metrics Report

ご不明な点がございましたら、以下のメールアドレスまでいつでもお気軽にお問い合わせください：
ebayjapan-techsupport@ebay.com

トップに戻る