Marketing Beta API(Buy)

Marketing Beta API 概要 (Marketing Beta API Overview)

バージョン：v1_beta.2.0

注: これは Marketing API のベータ版です。v1 バージョンについては、Marketing API v1 を参照してください。

Marketing Beta API は eBay Buy API の一部です。この API は、「ベストセラー（Best Selling）」などの指標に基づいて eBay 製品を取得します。これにより、買い物客が製品を比較し、購入意欲を高めるのに役立ちます。他の Buy API 群と組み合わせることで、eBay サイトにアクセスすることなく、ユーザー（eBay 会員またはゲスト）が eBay セラーから購入できるアプリケーションを作成できます。Buy API は、アプリやウェブサイト内で eBay 商品を購入する機会を提供します。

技術概要 (Technical overview)

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

  • merchandised_product - 「ベストセラー」などの特定の指標に基づいて eBay 製品を取得し、「この商品を見た人はこんな商品も見ています（also viewed）」や「この商品を買った人はこんな商品も買っています（also bought）」といった製品を返します。

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

他の Buy API と併用することで、Marketing Beta API は買い物客が製品単位で閲覧することを可能にし、以下のような機能を提供できます：

  • ベストセラー製品を表示することで、顧客の購入意欲を促進する。
  • 「also viewed」や「also bought」製品を表示することで、さまざまな製品/アイテムへの認識を高め、バイヤーが製品を比較・調査し、自信を持って製品を選択できるように支援する。
  • 製品の需要要因、レビュー、コンテキスト、またはバイヤーの購入プロセスの段階に基づいた製品/アイテムのコレクションを表示する。
  • これらのコレクションを使用してランディングページのモジュールを構築する。

API制限 (API restrictions)

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

地域/サイトの制約

すべての Buy API がサポートされている eBay サイトのリストについては、Buy API Support by Marketplace を参照してください。

サイトを指定するには、X-EBAY-C-MARKETPLACE-ID リクエストヘッダーにサイト（マーケットプレイスID）を設定します。例：
X-EBAY-C-MARKETPLACE-ID = EBAY_GB

eBay のポリシーとルール

eBay Buy API は、eBay のサンドボックス環境では誰でも使用できますが、本番環境（Production）での使用は制限されています。本番環境で Buy API にアクセスするには、標準の適格性要件を満たし、eBay サポート組織からの承認を得て、eBay と契約を締結する必要があります。

サンドボックスでのテスト

サンドボックス環境で getMerchandisedProducts メソッドをテストするには、カテゴリ ID 9355 を使用する必要があります。なお、レスポンスは模擬データ（mock data）となります。

レート制限

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

トップに戻る