出品管理
Trading API — 出品管理(Listing Management)
出品管理カテゴリには、eBay 上でのリスティング(商品出品)のライフサイクル全体を管理する 19 のコールが含まれます。リスティングの作成、修正、終了、再出品、および出品前のデータ検証や画像管理が可能です。
RESTful 代替: 新規開発では Inventory API(Sell)の使用も検討してください。ただし、バリエーション出品や一部の高度な出品オプションは Trading API でのみ対応しています。
よくある利用シナリオ
- 大量出品ツール:
AddItemsで一括出品 →ReviseInventoryStatusで在庫・価格を即時更新 →EndItemsで一括終了 - 出品検証フロー:
VerifyAddItemで手数料計算とエラーチェック → 問題なければAddItemで本出品 - 再出品自動化: 売れ残りリスティングを
GetMyeBaySellingで検出 →RelistItem/RelistFixedPriceItemで自動再出品 - 画像管理:
UploadSiteHostedPicturesで事前に画像をアップロード → 返却された URL を出品データに使用 - セカンドチャンス: オークション終了後、
GetAllBiddersで落札できなかった入札者を確認 →AddSecondChanceItemでオファーを送信
出品の作成(5 コール)
AddItem
最も汎用的な出品コール。オークション形式・固定価格形式の両方に対応します。商品タイトル、カテゴリ、価格、配送オプション、商品状態、支払い方法などを指定して新規リスティングを作成します。バリエーション(マルチ SKU)出品にも対応。
AddFixedPriceItem
固定価格リスティング専用の出品コール。AddItem と同等の機能ですが、固定価格に特化しているため、一部のフィールドが簡略化されています。GTC(Good 'Til Cancelled)リスティングの作成に最適。
AddItems
複数のリスティングを 1 回のコールで一括作成します。最大 5 件のアイテムを同時に出品可能。大量出品時の API コール数削減に有効です。
AddSecondChanceItem
オークション終了後、落札できなかった入札者にセカンドチャンスオファーを送信します。同一商品の在庫が複数ある場合に有効。オファー期間(1〜7 日)を指定可能。
AddToItemDescription
既存のアクティブなリスティングの説明文に追記します。元の説明文は保持され、新しいテキストが末尾に追加されます。説明文の修正ではなく追記のみ。
出品の修正(3 コール)
ReviseItem
アクティブなリスティングの各種属性(タイトル、価格、説明文、画像、配送オプション等)を修正します。入札がある場合、修正可能なフィールドが制限されます。
ReviseFixedPriceItem
固定価格リスティング専用の修正コール。ReviseItem と類似ですが、固定価格特有の機能(バリエーション修正等)に最適化されています。
ReviseInventoryStatus
在庫数量と価格のみを迅速に更新する軽量コール。1 回のコールで最大 4 つの SKU を同時に更新可能。完全な ReviseItem よりもはるかに高速で、在庫同期に最適。
出品の終了(3 コール)
EndItem
アクティブなリスティングを早期終了します。終了理由(売り切れ、誤出品など)を指定する必要があります。
EndFixedPriceItem
固定価格リスティング専用の終了コール。特定の SKU のみを終了することも可能(マルチバリエーション出品の場合)。
EndItems
複数のリスティングを 1 回のコールで一括終了。最大 10 件のアイテムを同時に終了可能。
再出品(2 コール)
RelistItem
終了したリスティングを再出品します。元のリスティングのデータが引き継がれ、必要に応じて一部フィールドを変更可能。
RelistFixedPriceItem
終了した固定価格リスティング専用の再出品コール。GTC リスティングの更新にも使用されます。
出品検証(4 コール)
Verify 系コールは、実際に出品せずにデータの妥当性チェックと手数料の事前計算を行います。本番出品前のドライランとして活用してください。
VerifyAddItem / VerifyAddFixedPriceItem
それぞれ AddItem / AddFixedPriceItem と同じリクエストフォーマットで、出品データを検証します。エラーがあれば事前に検出でき、推定手数料も返されます。
VerifyAddItem → | VerifyAddFixedPriceItem →
VerifyAddSecondChanceItem / VerifyRelistItem
セカンドチャンスオファーおよび再出品の事前検証。
VerifyAddSecondChanceItem → | VerifyRelistItem →
画像管理(2 コール)
UploadSiteHostedPictures
eBay のピクチャーサーバーに画像をアップロードし、返却された URL を出品データの PictureURL フィールドに使用します。Base64 エンコードまたは外部 URL からのアップロードに対応。
ExtendSiteHostedPictures
eBay にホストされている画像の保存期間を延長します。通常、未使用の画像は一定期間後に削除されますが、このコールで延長可能。