アカウント・ストア管理

Trading API — アカウント・ストア管理(Account & Store)

アカウント・ストア管理カテゴリには、eBay ユーザーアカウント、ストア設定、配送割引、税率テーブルを管理する 14 のコールが含まれます。セラーのビジネス設定全般を制御します。

RESTful 代替: アカウント管理には Account API(Sell)、ユーザー情報には Identity API(Commerce)も利用可能です。

よくある利用シナリオ

  • アカウント残高確認: GetAccount で手数料明細と残高を取得し、ダッシュボードに表示
  • ストアカテゴリ管理: GetStore でストア情報を表示 → SetStoreCategories でカテゴリ構成を更新
  • 配送割引設定: GetShippingDiscountProfiles で既存プロファイルを確認 → SetShippingDiscountProfiles で新規ルール(合算配送、数量割引等)を追加
  • 税率管理: GetTaxTable / SetTaxTable で州ごとの税率を管理
  • セラー設定の同期: GetUserPreferences で現在の設定を取得 → SetUserPreferences で一括更新(Best Offer 自動承認/拒否、不在設定等)

ユーザー情報(4 コール)

GetUser

eBay ユーザーの詳細情報を取得します。登録日、フィードバックスコア、セラーステータス、eBay ストア情報、出品制限などが含まれます。自分自身または他のユーザー(公開情報のみ)の情報を取得可能。

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

GetUserContactDetails

取引関係にある他のユーザーの連絡先情報(名前、電話番号、住所)を取得します。アクティブなオークションの入札者・セラー間でのみ利用可能。プライバシー保護のため、取引関係がない場合はアクセスできません。

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

GetUserPreferences / SetUserPreferences

セラーの各種設定を取得・更新します。管理可能な設定:Best Offer の自動承認/拒否条件、不在設定、配送設定、プロモーション設定、返品ポリシー設定など。出品ツールのセラー設定画面に利用。

GetUserPreferences → | SetUserPreferences →

アカウント・認証(2 コール)

GetAccount

セラーアカウントの課金情報を取得します。手数料明細(出品手数料、落札手数料、ストア利用料など)、支払い情報、アカウント残高が含まれます。指定期間の明細を取得可能。

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

ConfirmIdentity

ユーザーの身元確認を行います。eBay のサインイン認証フローと組み合わせて使用し、認証されたユーザーの ID を確認します。

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

ユーザーメモ(1 コール)

SetUserNotes

マイ eBay のアイテムにプライベートメモを追加・更新・削除します。セラー/バイヤーが個人的な覚書を残すために使用。メモは他のユーザーには表示されません。

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

ストア管理(3 コール)

GetStore

eBay ストアの情報を取得します。ストア名、説明、ロゴ URL、カスタムカテゴリ構成、ストアテーマなどが含まれます。

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

SetStoreCategories

eBay ストアのカスタムカテゴリを追加・移動・削除・名前変更します。カテゴリは最大 3 階層まで設定可能。大規模な変更は非同期処理となります。

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

GetStoreCategoryUpdateStatus

SetStoreCategories が非同期で処理された場合、その完了ステータスを確認します。タスク ID を指定して進行状況を取得。

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

配送割引・税率(4 コール)

GetShippingDiscountProfiles / SetShippingDiscountProfiles

配送割引プロファイルを取得・設定します。合算配送(複数アイテム購入時の送料割引)、数量割引、重量ベースの割引ルールなどを管理可能。出品時にこれらのプロファイルを適用します。

GetShippingDiscountProfiles → | SetShippingDiscountProfiles →

GetTaxTable / SetTaxTable

セラーの税率テーブルを取得・設定します。州/地域ごとの税率と、配送料への税適用有無を管理。出品時にこのテーブルが自動適用されます。

GetTaxTable → | SetTaxTable →

トップに戻る