eBay Trading API 総合リファレンス
eBay Trading API は、eBay プラットフォーム上での出品、注文管理、ユーザー管理、メッセージングなどの主要機能を提供する XML ベースのレガシー API です。現在も多くのセラーツールで広く利用されています。
| プロトコル | XML(SOAP/REST ハイブリッド) |
| エンドポイント | https://api.ebay.com/ws/api.dll |
| 認証 | Auth'n'Auth トークンまたは OAuth トークン |
| コール数 | 82 コール(7 カテゴリ) |
注意: eBay は RESTful API への移行を推進しています。新規開発では可能な限り RESTful API の使用を推奨します。ただし、一部の機能は Trading API でのみ利用可能です。
機能カテゴリ別ガイド
出品管理(Listing Management)— 19 コール
| コール名 | 説明 | 原文 |
AddFixedPriceItem | 固定価格リスティングを作成 | 参照 |
AddItem | オークションまたは固定価格リスティングを作成 | 参照 |
AddItems | 複数リスティングを一括作成 | 参照 |
AddSecondChanceItem | 落札できなかった入札者にセカンドチャンスオファーを送信 | 参照 |
AddToItemDescription | 既存リスティングの説明文に追記 | 参照 |
EndFixedPriceItem | 固定価格リスティングを終了 | 参照 |
EndItem | リスティングを早期終了 | 参照 |
EndItems | 複数リスティングを一括終了 | 参照 |
ReviseFixedPriceItem | 固定価格リスティングを修正 | 参照 |
ReviseInventoryStatus | 在庫数量と価格を迅速に更新 | 参照 |
ReviseItem | リスティングを修正 | 参照 |
RelistFixedPriceItem | 終了した固定価格リスティングを再出品 | 参照 |
RelistItem | 終了したリスティングを再出品 | 参照 |
VerifyAddFixedPriceItem | 固定価格出品前にデータを検証 | 参照 |
VerifyAddItem | 出品前にデータを検証 | 参照 |
VerifyAddSecondChanceItem | セカンドチャンスオファー前にデータを検証 | 参照 |
VerifyRelistItem | 再出品前にデータを検証 | 参照 |
UploadSiteHostedPictures | eBay ピクチャーサーバーに画像をアップロード | 参照 |
ExtendSiteHostedPictures | ホスト画像の保存期間を延長 | 参照 |
注文・取引・入札(Order, Transaction & Bidding)— 12 コール
| コール名 | 説明 | 原文 |
AddOrder | 同一セラーの複数取引を1つの注文にまとめる | 参照 |
GetOrders | 注文情報を取得 | 参照 |
CompleteSale | 取引完了処理(配送情報の追加など) | 参照 |
SendInvoice | バイヤーに請求書を送信 | 参照 |
GetItemTransactions | 特定アイテムの取引情報を取得 | 参照 |
GetSellerTransactions | セラーの取引一覧を取得 | 参照 |
PlaceOffer | オークションに入札またはオファーを送信 | 参照 |
GetAllBidders | オークションの全入札者リストを取得 | 参照 |
GetBidderList | 特定バイヤーが入札中のアイテム一覧を取得 | 参照 |
GetBestOffers | Best Offer の一覧を取得 | 参照 |
RespondToBestOffer | Best Offer を承認・拒否・カウンターオファー | 参照 |
GetAdFormatLeads | クラシファイド広告のリードを取得 | 参照 |
商品情報取得(Item & Seller Retrieval)— 6 コール
| コール名 | 説明 | 原文 |
GetItem | 単一アイテムの詳細情報を取得 | 参照 |
GetItemShipping | アイテムの配送費見積もりを取得 | 参照 |
GetSellerList | セラーの出品リスト一覧を取得 | 参照 |
GetSellerEvents | セラーのリスティングイベント変更を取得 | 参照 |
GetMyeBayBuying | マイ eBay の購入状況を取得 | 参照 |
GetMyeBaySelling | マイ eBay の販売状況を取得 | 参照 |
カテゴリ・メタデータ(Category & Metadata)— 5 コール
| コール名 | 説明 | 原文 |
GetCategories | eBay カテゴリツリーを取得 | 参照 |
GetCategoryFeatures | カテゴリ固有の機能と設定を取得 | 参照 |
GetCategoryMappings | 古いカテゴリ ID → 新しいカテゴリ ID のマッピングを取得 | 参照 |
GeteBayDetails | サイト固有のメタデータ(配送サービス、通貨、地域等)を取得 | 参照 |
GetDescriptionTemplates | 出品テンプレート情報を取得 | 参照 |
アカウント・ストア管理(Account & Store)— 14 コール
| コール名 | 説明 | 原文 |
GetAccount | セラーアカウントの課金情報を取得 | 参照 |
GetUser | eBay ユーザー情報を取得 | 参照 |
GetUserContactDetails | 取引相手の連絡先情報を取得 | 参照 |
GetUserPreferences | ユーザー設定を取得 | 参照 |
SetUserPreferences | ユーザー設定を更新 | 参照 |
SetUserNotes | アイテムにユーザーメモを設定 | 参照 |
ConfirmIdentity | ユーザーの身元確認 | 参照 |
GetStore | eBay ストア情報を取得 | 参照 |
GetStoreCategoryUpdateStatus | ストアカテゴリ更新のステータスを確認 | 参照 |
SetStoreCategories | eBay ストアのカテゴリを設定 | 参照 |
GetShippingDiscountProfiles | 配送割引プロファイルを取得 | 参照 |
SetShippingDiscountProfiles | 配送割引プロファイルを設定 | 参照 |
GetTaxTable | 税率テーブルを取得 | 参照 |
SetTaxTable | 税率テーブルを設定 | 参照 |
メッセージ・フィードバック・通知(Messaging, Feedback & Notification)— 17 コール
| コール名 | 説明 | 原文 |
AddMemberMessageAAQToPartner | 取引相手にメッセージを送信(Ask a Question) | 参照 |
AddMemberMessageRTQ | バイヤーの質問に回答 | 参照 |
AddMemberMessagesAAQToBidder | 入札者に一括メッセージを送信 | 参照 |
GetMemberMessages | メンバー間メッセージを取得 | 参照 |
GetMessagePreferences | メッセージ設定を取得 | 参照 |
SetMessagePreferences | メッセージ設定を更新 | 参照 |
GetMyMessages | マイメッセージを取得 | 参照 |
DeleteMyMessages | マイメッセージを削除 | 参照 |
ReviseMyMessages | マイメッセージのステータスを更新 | 参照 |
ReviseMyMessagesFolders | マイメッセージフォルダを管理 | 参照 |
GetFeedback | フィードバック情報を取得 | 参照 |
GetItemsAwaitingFeedback | フィードバック待ちアイテムを取得 | 参照 |
LeaveFeedback | フィードバックを残す | 参照 |
RespondToFeedback | フィードバックに返信 | 参照 |
GetNotificationPreferences | 通知設定を取得 | 参照 |
SetNotificationPreferences | 通知設定を更新 | 参照 |
GetNotificationsUsage | 通知の使用状況を取得 | 参照 |
認証・ウォッチリスト・その他(Auth, WatchList & Other)— 9 コール
| コール名 | 説明 | 原文 |
FetchToken | 認証トークンを取得 | 参照 |
GetSessionID | 認証用セッション ID を取得 | 参照 |
GetTokenStatus | トークンのステータスを確認 | 参照 |
RevokeToken | トークンを無効化 | 参照 |
AddToWatchList | ウォッチリストにアイテムを追加 | 参照 |
RemoveFromWatchList | ウォッチリストからアイテムを削除 | 参照 |
GetVeROReasonCodeDetails | VeRO 報告の理由コードを取得 | 参照 |
GetVeROReportStatus | VeRO 報告のステータスを確認 | 参照 |
VeROReportItems | 知的財産権侵害アイテムを報告 | 参照 |