カテゴリのインポート
インポート
カテゴリのインポート
Product Recommendation API を使用して商品をインポートする前に、商品カテゴリ階層全体を Kameleoon にインポートします。
POST
カテゴリのインポート
このエンドポイントは、すべての商品カテゴリを Kameleoon アカウントにインポートします。
商品をアップロードする前に、最新のカテゴリリストを当社のデータベースにアップロードする必要があります。
データは、リクエスト本文を含む JSON 文字列として送信されます。すべてのカテゴリを 1 つのリクエストで送信する必要があります。
失敗したリクエストの例:
HTTP リクエスト
クエリパラメーターのリスト
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
shop_id | String | Yes | ストアキー。Kameleoon アプリの Recommendations > Settings > Store settings で確認できます。キーについては、カスタマーサクセスマネージャーにもお問い合わせいただけます。 |
shop_secret | String | Yes | シークレットキー。Kameleoon アプリの Recommendations > Settings > Store settings で確認できます。キーについては、カスタマーサクセスマネージャーにもお問い合わせいただけます。 |
categories | List | Yes | カテゴリオブジェクトのリスト。categories に必要なパラメーターはこの表を参照してください。 |
webhook | String | No | Webhook URL。インポート完了時に POST リクエストが送信されます。 |
webhook は、リクエストが完了したことを開発者に通知するために使用されます。API 呼び出しで指定されたすべてのカテゴリがインポートされ完全に利用可能になると、指定された Webhook に POST リクエストが送信されます。カテゴリを Kameleoon で処理するのに数分かかることがあるため、多数のカテゴリをインポートする場合は webhook の使用を強く推奨します。商品インポートエンドポイントを使用して商品をインポートしている場合、Webhook を使用することで、商品インポートを開始する前にすべてのカテゴリが完全に処理されたことを保証できます。カテゴリは最初に Kameleoon で処理する必要があるため、既知のカテゴリがない商品はインポート中に無視されます。成功したリクエストの例:categories オブジェクトのパラメーターリスト
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
id | String | Yes | カテゴリに割り当てられた一意の ID |
name | String | Yes | カテゴリの名前 |
parent | String/NULL | Optional | カテゴリが階層構造の場合、このフィールドにはこのカテゴリの親を定義します |
url | String | Optional | カテゴリに関連付ける URL |
alias | String | Optional | カテゴリのエイリアス |