出品管理

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 にホストされている画像の保存期間を延長します。通常、未使用の画像は一定期間後に削除されますが、このコールで延長可能。

原文リファレンスを読む →

トップに戻る