商品移動API

複数の商品データを一括で別のカテゴリに移動します。
または、商品データを現在のカテゴリから別のカテゴリにリンクし、複数のカテゴリに同じ商品を掲載することも可能です。
※ フロント反映はしません。別途反映処理が必要です。

変更履歴

リクエストURL

テスト用APIを利用したい場合は、こちらから利用申請をお願いします。

リクエストパラメータ

「Web APIの使い方#POSTとは」をご参照ください。

パラメータ	値	説明
seller_id （必須）	string	ストアアカウントを指定します。
item_code （必須）	string	商品コードを指定します。「,」区切りで複数指定可能。（最大100個）
from_stcat_key （必須）	string	移動元のストアカテゴリのページIDを指定します。
to_stcat_key （必須）	string	移動先、またはリンク先とするストアカテゴリのページIDを指定します。
mode	string （デフォルト : move）	商品の移動を行うのか、リンクを作成するのかを指定します。 move : 商品の移動を行います。 link : 商品のリンクを作成します。

サンプルリクエストURL

https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/moveItems

サンプルリクエスト

POST /ShoppingWebService/V1/moveItems HTTP/1.1
     Host: circus.shopping.yahooapis.jp
     Authorization: Bearer <アクセストークン>

     seller_id=teststore&item_code=item1%2Citem2&from_stcat_key=b7ac32ba5a&to_stcat_key=a5aba5c6a53

レスポンスフィールド

フィールド	説明
/ResultSet	クエリーレスポンスのすべてを含みます。
/ResultSet/Result	各個別レスポンスを含みます。
/ResultSet/Result/Status	更新結果（このフォーマットではOKのみです。）

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
    <Result>
        <Status>OK</Status>
    </Result>
</ResultSet>

エラー

Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。

• Yahoo! ショッピングAPI共通エラーコード一覧

商品系API、および商品移動APIで固有に返すエラーコードは以下をご覧ください。

商品系API共通エラーコード

コード	HTTPステータスコード	説明
ed-00000	404	ページが見つかりません。
ed-00001	500	システムエラーが発生しました。
ed-00002	503	サーバがメンテナンス中です。
ed-00003	400	ストアアカウントが指定されていません。
ed-00004	400	ストアアカウントが存在しません。
ed-00005	400	ストアアカウントの指定が不正です。
ed-00006	400	反映またはアップロード中のため更新ができません。

エラーコード

コード	HTTPステータスコード	説明
it-03001	400	item_codeが指定されていません。
it-03002	400	to_stcat_keyが指定されていません。
it-03003	400	item_codeが指定できる上限を超えています。
it-03004	400	指定されたストアカテゴリは存在しません。
it-03006	400	すでに移動先またはリンク先に商品が設定されています。
it-03007	400	from_stcat_keyが指定されていません。
it-03008	400	指定された商品は移動元またはリンク元のストアカテゴリに存在しません。
it-03011	400	modeの値が不正です。
it-03012	400	item_codeの値が不正です。
it-03013	400	セール期間中の商品が含まれているため、すべて編集できません。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）

利用約款

このAPIに関する利用約款はこちら。