アカウント・ストア管理
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
セラーの税率テーブルを取得・設定します。州/地域ごとの税率と、配送料への税適用有無を管理。出品時にこのテーブルが自動適用されます。