アカウント v1 API（Account v1 API）

Account v1 API を使用すると、セラーは eBay セラーアカウントの設定を管理できます。ビジネスポリシー（フルフィルメント、支払い、返品ポリシー）の管理、カスタムポリシーの作成、セラープログラムのオプトイン/オプトアウト、売上税テーブルの設定、アカウント情報の取得が含まれます。

バージョン: v1.9.3

ベースURL: https://api.ebay.com/sell/account/v1

認証（OAuth スコープ）

この API は 認可コード（Authorization Code） フローを使用します。

リソース一覧

Account v1 API は以下のリソース、合計 37 エンドポイントで構成されています。

advertising_eligibility（1 エンドポイント）

GET /advertising_eligibility

getAdvertisingEligibility — eBay 広告プログラムに対する販売者の適格性ステータスを確認します。

レスポンス: 200 / 400 / 500

custom_policy — カスタムポリシー（4 エンドポイント）

GET /custom_policy/

getCustomPolicies — 販売者のカスタムポリシーリストを取得します。

レスポンス: 200 / 400 / 500

POST /custom_policy/

createCustomPolicy — 新しいカスタムポリシーを作成します。タイプ: PRODUCT_COMPLIANCE（最大 60 個）、TAKE_BACK（最大 18 個）。

レスポンス: 201 / 400 / 409 / 500

GET /custom_policy/{custom_policy_id}

getCustomPolicy — 特定のカスタムポリシーを取得します。

レスポンス: 200 / 400 / 404 / 500

PUT /custom_policy/{custom_policy_id}

updateCustomPolicy — カスタムポリシーを更新します。name、label、description フィールドを常に含めてください。

レスポンス: 204 / 400 / 404 / 409 / 500

fulfillment_policy — フルフィルメントポリシー（6 エンドポイント）

GET /fulfillment_policy

getFulfillmentPolicies — 指定マーケットプレイスのすべてのフルフィルメントポリシーを取得。

レスポンス: 200 / 400 / 500

POST /fulfillment_policy/

createFulfillmentPolicy — 新しいフルフィルメントポリシーを作成します。

レスポンス: 201 / 400 / 500

GET /fulfillment_policy/get_by_policy_name

getFulfillmentPolicyByName — ポリシー名でフルフィルメントポリシーを取得します。

レスポンス: 200 / 400 / 500

GET /fulfillment_policy/{fulfillmentPolicyId}

getFulfillmentPolicy — 特定のフルフィルメントポリシーの詳細を取得します。

レスポンス: 200 / 400 / 404 / 500

PUT /fulfillment_policy/{fulfillmentPolicyId}

updateFulfillmentPolicy — フルフィルメントポリシーを更新します。完全なペイロードが必要です。

レスポンス: 200 / 400 / 404 / 500

DELETE /fulfillment_policy/{fulfillmentPolicyId}

deleteFulfillmentPolicy — フルフィルメントポリシーを削除します。

レスポンス: 204 / 400 / 404 / 409 / 500

kyc（1 エンドポイント）

GET /kyc

getKYC — KYC オンボーディング要件の確認。現在は全セラーがオンボーディング済みのため、204 No Content を返します。

レスポンス: 200 / 204 / 400 / 500

payment_policy — 支払いポリシー（6 エンドポイント）

GET /payment_policy

getPaymentPolicies — 指定マーケットプレイスのすべての支払いポリシーを取得。

レスポンス: 200 / 400 / 500

POST /payment_policy

createPaymentPolicy — 新しい支払いポリシーを作成します。

レスポンス: 201 / 400 / 500

GET /payment_policy/get_by_policy_name

getPaymentPolicyByName — ポリシー名で支払いポリシーを取得します。

レスポンス: 200 / 400 / 500

GET /payment_policy/{payment_policy_id}

getPaymentPolicy — 特定の支払いポリシーの詳細を取得します。

レスポンス: 200 / 400 / 404 / 500

PUT /payment_policy/{payment_policy_id}

updatePaymentPolicy — 支払いポリシーを更新します。完全なペイロードが必要です。

レスポンス: 200 / 400 / 404 / 500

DELETE /payment_policy/{payment_policy_id}

deletePaymentPolicy — 支払いポリシーを削除します。

レスポンス: 204 / 400 / 404 / 409 / 500

payments_program — 支払いプログラム（2 エンドポイント）

GET /payments_program/{marketplace_id}/{payments_program_type}

getPaymentsProgram — 指定した支払いプログラムへのオプトイン状況を返します。

注: 全セラーで新しい支払いフローが有効のため、現在は適用されません。

レスポンス: 200 / 400 / 404 / 500

GET /payments_program/{marketplace_id}/{payments_program_type}/onboarding

getPaymentsProgramOnboarding — 支払いプログラムのオンボーディングステータスを取得します。

レスポンス: 200 / 400 / 404 / 500

privilege（1 エンドポイント）

GET /privilege

getPrivileges — セラーの現在の権限セット（登録完了状況、販売制限）を取得します。

レスポンス: 200 / 400 / 500

program — セラープログラム（3 エンドポイント）

GET /program/get_opted_in_programs

getOptedInPrograms — オプトイン済みのセラープログラムリストを取得します。

レスポンス: 200 / 400 / 404 / 500

POST /program/opt_in

optInToProgram — セラーを eBay セラープログラムにオプトインします。処理に最大 24 時間かかる場合があります。

レスポンス: 200 / 400 / 404 / 409 / 500

POST /program/opt_out

optOutOfProgram — セラープログラムからオプトアウトします。

レスポンス: 200 / 400 / 404 / 409 / 500

rate_table（1 エンドポイント）

GET /rate_table

getRateTables — 配送料率表を取得します。US、CA、UK、DE、AU、FR、IT、ES のマーケットプレイスをサポート。セラーはアカウントに最大 40 個の料率表を定義できます。

レスポンス: 200 / 400 / 500

return_policy — 返品ポリシー（6 エンドポイント）

GET /return_policy

getReturnPolicies — 指定マーケットプレイスのすべての返品ポリシーを取得。

レスポンス: 200 / 400 / 500

POST /return_policy

createReturnPolicy — 新しい返品ポリシーを作成します。自動車の出品には適用されません。

レスポンス: 201 / 400 / 500

GET /return_policy/get_by_policy_name

getReturnPolicyByName — ポリシー名で返品ポリシーを取得します。

レスポンス: 200 / 400 / 500

GET /return_policy/{return_policy_id}

getReturnPolicy — 特定の返品ポリシーの詳細を取得します。

レスポンス: 200 / 400 / 404 / 500

PUT /return_policy/{return_policy_id}

updateReturnPolicy — 返品ポリシーを更新します。完全なペイロードが必要です。

レスポンス: 200 / 400 / 404 / 500

DELETE /return_policy/{return_policy_id}

deleteReturnPolicy — 返品ポリシーを削除します。

レスポンス: 204 / 400 / 404 / 409 / 500

sales_tax — 売上税テーブル（5 エンドポイント）

注: 売上税テーブルは US と CA のマーケットプレイスでのみ使用可能。米国では eBay が全 50 州 + DC の売上税を自動処理するため、セラーは一部の米国領土（AS、GU、MP、PW、VI）のみ設定可能です。

GET /sales_tax

getSalesTaxes — 特定の国のすべての売上税テーブルエントリを取得します。

レスポンス: 200 / 400 / 500

POST /bulk_create_or_replace_sales_tax

bulkCreateOrReplaceSalesTax — 売上税テーブルエントリを一括作成/更新します（OpenAPI のみ）。

レスポンス: 200 / 207 / 400 / 500

GET /sales_tax/{countryCode}/{jurisdictionId}

getSalesTax — 特定の税管轄区域のエントリを取得します。

レスポンス: 200 / 204 / 400 / 404 / 500

PUT /sales_tax/{countryCode}/{jurisdictionId}

createOrReplaceSalesTax — 税管轄区域のエントリを作成/更新します。

レスポンス: 204 / 400 / 404 / 500

DELETE /sales_tax/{countryCode}/{jurisdictionId}

deleteSalesTax — 税管轄区域のエントリを削除します。

レスポンス: 204 / 400 / 404 / 500

subscription（1 エンドポイント）

GET /subscription

getSubscription — セラーアカウントに関連するサブスクリプションリストを取得します。

レスポンス: 200 / 400 / 500

エンドポイント一覧（全 37 エンドポイント）

スキーマ数: 52（詳細は OpenAPI 仕様を参照）