eBay 開発者プログラム 2026 年第 1 四半期ニュースレター

eBay Developers Program 2026年第1四半期ニュースレター

プログラムニュース (Program news)

皆様、お元気でお過ごしでしょうか。この場をお借りして、直近の四半期（2026年1月～3月）におけるeBay Developers Programのアップデートを共有させていただきます。

英国における「簡単・無料返品 (Easy and Free Returns)」の導入

6月8日 より、英国（UK）マーケットプレイスにおいて、対象となるパーツ＆アクセサリー（Parts & Accessories）出品に対する「簡単・無料返品（Easy and Free Returns）」ポリシーが導入されます。このポリシーは昨年7月に米国（US）マーケットプレイスで導入されたものと同様です。本ポリシーにより、以下の基準を満たすパーツ＆アクセサリー出品は、バイヤー（購入者）に対して30日または60日の返品期間を含む無料返品を提供することが義務付けられます。

対象となるパーツ＆アクセサリーカテゴリの固定価格（Fixed price）出品であること
商品の状態（Condition）が New（新品）または New – other（新品その他）であること
商品価格が10ポンド（£10）を超えていること（送料を除く）
商品の所在地およびバイヤーの所在地が米国内（UK内）であること（国際配送には適用されません）
ビジネスセラー（法人販売者）によって出品されていること

バイヤー都合による返品（Buyer remorse returns）の費用負担を軽減するため、eBayはセラーに対し、eBay上で購入される返品用配送ラベルを50%補助（割引）いたします。なお、この返品ラベル補助は、「説明と異なる商品（Item not as described）」の返品など、「簡単・無料返品」の対象外となる返品には適用されませんのでご注意ください。

6月8日 以降、非準拠の返品ポリシーを使用して Add API または Revise API を呼び出した場合、警告（Warning）が返されます。これらの出品について、eBayは自動的に出品を更新して返品を受け入れ、30日間の返品期間を設定し、セラーが返品送料を負担する設定に変更して、更新されたポリシー要件に準拠させます。これらの警告は、8月より Add API および Revise API におけるブロックエラー（Blocking Error）へと変更されます。また、eBayは 6月8日 より、既存の出品についても自動的に準拠させるための更新を開始します。

英国のセラーと協力し、パーツ＆アクセサリーの出品および返品ビジネスポリシーが本ポリシーに準拠していることを確認し、必要に応じてAPIロジックを更新してください。Trading API または Account v1 API の Fulfillment Policy オブジェクトを通じて準拠した返品ポリシーを作成するための具体的な情報については、統合ガイドの Support for easy returns in Parts and Accessories を参照してください。

詳細情報、基準の完全なリスト、およびFAQについては、セラーセンターの Free returns for parts and accessories ページを参照してください。

オーストラリアにおける無料出品とバイヤープロテクション

4月下旬 より、オーストラリア（AU）マーケットプレイスにおいて、直近12ヶ月間の累計売上高が25,000オーストラリアドル（AUD）以下であり、かつProサブスクリプションを保有していない対象セラーを対象に、無料出品（Free selling）の導入が順次開始されます。無料出品とは、標準の出品手数料（Standard listing fees）および販売取引に対する落札手数料（Final value fees）が発生しないことを意味します。ただし、サブタイトル（Subtitle）や最低落札価格（Reserve Price）などの出品アップグレード機能を使用した場合は、引き続きオプション手数料が請求されます。

Proサブスクリプションを持たないオーストラリアのセラーは、複数数量出品（Multiple quantity listings）、マルチバリエーション出品（Multiple-variation listings）、および定期ペイアウト（Scheduled payouts）などの一部の販売機能を利用できません。また、これらのセラーはeBay配送ラベル（eBay shipping labels）を使用することが義務付けられ、バイヤーにはeBayへ直接支払う「バイヤープロテクション手数料（Buyer Protection fee）」が課されます。バイヤーにはショッピング体験を通じて「コミコミ価格（all-in price）」（商品代金＋バイヤープロテクション手数料）が表示され、チェックアウト時の費用内訳でバイヤープロテクション手数料が個別品目として表示されます。

直近12ヶ月間の売上高が25,000 AUDを超え、かつまだeBayストアを保有していないオーストラリアのセラーは、月額利用料無料のストアプランである新しい「Pro Starter」サブスクリプションへ自動的に移行されます。すでにeBayストアを保有しているオーストラリアのセラーは、現在のサブスクリプションが維持されます。

バイヤープロテクション手数料の対象となる注文について、この新しい手数料およびそれに対する税金を表示するため、注文関連の各APIに以下の変更が行われました。

Fulfillment API: getOrder および getOrders に新しい ebayCollectedCharges.charges 配列が追加されました。この配列には、バイヤープロテクション手数料の金額と、その手数料に対する税金が表示されます。
Trading API (GetOrders):
- 注文レベルで追加の Payment コンテナが返され、注文内の1つ以上の品目に対するバイヤープロテクション手数料および適用される税金が表示されます。この追加 Payment コンテナでは、受取人（Payee）としてセラーではなくeBayが表示されます。
- バイヤープロテクション手数料に対する税金は、eBayCollectAndRemitTaxes コンテナ下の eBayCollectAndRemitTaxes.TotalTaxAmount、TaxDetails.TaxAmount、および TaxDetails.TaxOnSubtotalAmount フィールドに反映されます。
- Order.Total および Order.AmountPaid フィールドには、バイヤープロテクション手数料と適用される税金が含まれます。
Trading API (GetItemTransactions / GetSellerTransactions):
- 取引レベルで追加の Payment コンテナが返され、品目に対するバイヤープロテクション手数料および適用される税金が表示されます。受取人（Payee）としてeBayが表示されます。
- バイヤープロテクション手数料に対する税金は、eBayCollectAndRemitTaxes 内の対応する税金フィールドに反映されます。
- Transaction.AmountPaid フィールドには、バイヤープロテクション手数料と適用される税金が含まれます。
Buy Order API v1: ServiceTypeEnum に新しい BUYER_PROTECTION 値が追加されました。該当する場合、eBayは addonServices オブジェクトとしてバイヤープロテクションを追加します。serviceType の値は BUYER_PROTECTION となり、バイヤープロテクション手数料は serviceFee コンテナに、その手数料に対する税金は serviceTax コンテナに表示されます。

オーストラリア・マーケットプレイスでの無料出品に関する詳細については、Free Selling ヘルプページを参照してください。

米国における収集用コインのコンディション評価標準化

収集用コイン（Collectible coins）カテゴリでは、コインの状態（コンディション）が正確かつ明密に説明されていることが極めて重要です。状態が正確に記載されていない場合、バイヤーの信頼、価格設定、コンバージョン率、および購買意欲に直接悪影響を及ぼします。現在、eBay上のコインの出品には以下の課題があります。

コンディションの記載方法が不統一で主観的である
バイヤーが出品間で比較することが困難である
誤解、紛争、返品が発生しやすい

この問題を解決するため、eBayは米国（US）マーケットプレイスの収集用コインカテゴリにおいて、現在のシングル・トレーディングカードカテゴリと同様の標準化されたコンディション評価（Condition grading）を導入します。これにより、出品クオリティと同一比較可能性が向上し、バイヤーの信頼感が高まります。コインのコンディション評価は、以下のリーフカテゴリで利用可能になります。

Coins: US (ID 253)
Coins: World (ID 256)
Coins: Canada (ID 3377)
Coins: Ancient (ID 4733)
Coins: Medieval (ID 18466)

5月初旬 より、Metadata API の getItemConditionPolicies メソッドを通じて、コインカテゴリ向けの新しいコンディション記述子メタデータ（Condition descriptor metadata）が利用可能になります。conditionDescriptors 配列の下に、鑑定済み（Graded）および未鑑定（Raw/ungraded）コイン向けの新しい属性と値が返されます。鑑定済みコインの場合、4つの新しい属性は「Grading company（鑑定会社）」、「numeric grade（数値グレード）」、「letter grade（文字グレード）」、および「Certification number（証明番号）」となります。未鑑定コインの場合、「Uncirculated（未使用）」、「Extremely Fine to About Uncirculated」、「Fine to Very Fine」、「Below Fine」などのカスタムコインコンディションを選択する必要があります。これらの属性とその値にはすべて数値IDが割り当てられ、Trading API の ConditionDescriptors コンテナ、または Inventory API の conditionDescriptors 配列にこれらの数値IDを渡して、該当するコンディション記述子の名前と値のペアを提供する必要があります。

新しいコンディション記述子の値が利用可能になり次第、対象カテゴリでコンディション記述子が使用されていない場合、Add API および Revise API 呼び出しで警告メッセージ（Warning）が返されるようになります。

6月初旬 より、対象カテゴリでコンディション記述子が使用されていない場合、Add API および Revise API 呼び出しでブロックエラー（Blocking Error）が発生し始めます。

7月初旬 より、対象カテゴリでコンディション記述子が使用されていないこれらのコインカテゴリの既存の出品は、ブロック、非表示、または削除の対象となります。

ファッションカテゴリにおけるサイズ表記の標準化

現在、アパレルおよびフットウェア（Apparel and Footwear）のファッションカテゴリにおける「Size」商品アスペクト（Item specific）では、出品フロー中にカスタムの非標準サイズ値を入力することが許可されていますが、これは検索ヒット率、推奨資格、および全体的なバイヤーの信頼感を低下させる原因となっています。その結果、バイヤーは検索したサイズを見つけることができず（非準拠の値が検索インデックスに登録されないため）、セラーの出品パフォーマンスも本来あるべき水準より低くなってしまいます（バイヤーがこれらの出品を確実に発見できないため）。米国マーケットプレイスでは、アパレルおよびフットウェアの出品の17～21%に非標準サイズが含まれており、APIを使用して作成された出品がこれらの問題の大部分を占めています。

この問題を緩和するため、eBayはアパレルおよびフットウェアの出品において、標準サイズ値のみを使用することを義務付けます。開発者はセラーの出品をチェックし、各リーフカテゴリに定義された標準サイズ値のみが使用されていることを確認し、在庫に非標準サイズを使用しているセラーに対してガイダンスを提供する必要があります。

6月より、eBayはすべてのマーケットプレイスで非標準値を標準値へ自動的に調整し始めます。たとえば、「Size」の値として「Small」が提供された場合、eBayは自動的にその値を「S」に調整します。eBayが認識できない「Size」の値が提供された場合、その値は送信されますが、警告メッセージがトリガーされます。さらに、これまで任意であったサイズおよびコンディションが、ファッションカテゴリにおけるすべての新規出品で必須フィールド（Required fields）となります。

7月より、非標準/非準拠または欠落したサイズ値を含む Add API および Revise API 呼び出しは保留（Hold）状態となります。コンディション情報が欠落している既存の出品も、問題が解決されるまで保留状態となります。これは、セラーが問題を解決するまで、影響を受ける出品がeBay上で表示されず、購入できなくなることを意味します。

アパレルおよびフットウェアのリーフカテゴリで標準サイズ値が使用されていることを確認するため、Taxonomy API の getItemAspectsForCategory または fetchItemAspects（および Taxonomy SDK）を統合プロセスに組み込んでください。

共通充電器指令 (Common Charger Directive) のノートPCへの適用拡大

2024年末に発効したEUの「共通充電器指令 (CCD)」の一環として、EUおよび北アイルランドで特定の充電式デバイスを出品するセラーは、商品アスペクト（Item Specifics）を通じて以下の情報を提供することが求められます。

商品に充電器が付属しているかどうか
商品の充電電力範囲
商品がUSB-PD互換であるかどうか

この指令は現在、携帯型携帯電話、タブレット、デジタルカメラ、ヘッドフォン、ヘッドセット、ポータブルスピーカー、携帯型ビデオゲーム機、電子書籍リーダー、イヤホン、キーボード、マウス、およびポータブルナビゲーションシステムに適用されています。4月28日 より、この指令はノートパソコン（Laptops）にも適用されるようになります。

この指令をサポートするため、影響を受けるカテゴリの製品アスペクトに以下の変更が行われました。

Charger Included アスペクトを追加: CCD要件を満たすため、このアスペクトを含める必要があり、充電器が付属しているかどうかに応じて値を「Yes」または「No」に設定します。
Device Charging Range アスペクトを追加: CCD要件を満たすため、このアスペクトを含める必要があり、「最小-最大」形式の数値のみの範囲（例: 10-20.5、最大3桁および小数第1位）を使用します。以下に、充電範囲が10〜20.5ワットのデバイスにおける Inventory API および Trading API の例を示します。

// Inventory API (JSON) 例
"product": {
    "aspects": {
        "Device Charging Range": ["10-20.5"]
    }
}


<ItemSpecifics>
    <NameValueList>
        <Name>Device Charging Range</Name>
        <Value>10-20.5</Value>
    </NameValueList>
</ItemSpecifics>

Features アスペクトに USB-PD (fast charging) アスペクト値を追加: 製品にUSB Power Delivery規格を満たす充電器が付属している場合、このアスペクト値を Features の値の1つとして含める必要があります。

これらのアスペクト名と値のペアが Inventory API や Trading API を通じてどのように渡されるかの詳細とその他の例については、統合ガイドの Common Charger Directive トピックを参照してください。

指令の詳細およびセラーへの影響については、EU Common Charger Directive ヘルプページを参照してください。

米国への輸入に関するCPSC（米国消費者製品安全委員会）の新要件

2026年7月8日 より、米国消費者製品安全委員会（CPSC）の電子提出（eFiling）に関する新要件が有効となります。

これらの新しい規則の下では、米国に輸入される特定の種類の商品（子供向け製品、衣料品、およびその他の規制対象商品を含む）について、通関前に製品安全ドキュメントを米国税関に電子提出する必要があります。セラーは2008年以降、これらのドキュメントの保持が義務付けられていましたが、今回の新要件により出荷前の電子提出が義務化されます。

これらのドキュメントには以下が含まれます。

一般適合宣言書 (GCC: General Certificate of Conformity)
子供向け製品証明書 (CPC: Children’s Product Certificate)

これらのドキュメントは、eBay APIを使用して以下の方法で出品に添付されます。

Media API の createDocument メソッドおよび uploadDocument メソッドを使用して、セラーのアカウントにドキュメントをアップロードします。あるいは、ドキュメントのURLを提供し、eBayがそのドキュメントをダウンロードしてセラーのアカウントにアップロードする createDocumentFromUrl メソッドを使用することもできます。どちらのアプローチでも、適切な documentType の値（GENERAL_CERTIFICATE_OF_CONFORMITY または CHILDRENS_PRODUCT_CERTIFICATE のいずれか）を設定する必要があります。
Inventory API を使用している場合は、createOffer メソッドの documents 配列内で documentId フィールドを使用して出品にドキュメントを添付します。Trading API を使用している場合は、Add コールまたは Revise コールの Document.DocumentID フィールドを使用します。

ドキュメントのアップロードと出品への添付に関する詳細については、Selling Integration Guideの Managing documents トピックを参照してください。

重要な考慮事項:

この要件は、出品が作成されたeBayマーケットプレイスに関係なく、米国に輸入される特定の製品に適用されます。
2026年7月8日以降、セラーは発送前に配送業者へ安全情報を提出することが義務付けられる場合があります。eBay International ShippingプログラムまたはSpeedPAK配送サービスを使用する出品の場合、出品に添付されたコンプライアンスドキュメントが配送パートナーに送信されます。
コンプライアンスデータの欠落や誤りがあると、米国の国境での発送の遅延、保留、または不許可が発生する可能性があります。
出品管理ワークフローに Media API をまだ統合していない場合は、7月8日の施行日に先立ち統合することを強くお勧めします。

以下は、GCCおよびCPCドキュメントを必要とする製品のリストが記載されたCPSC公式ウェブサイトへのダイレクトリンクです。

APIアップデート (API updates)

今四半期にAPIに対して行われたアップデートは以下の通りです。

Account v2 APIに新しいセラーユーザー設定メソッドを追加

Account v2 API にセラーユーザー設定メソッドが追加されました。getUserPreferences および setUserPreferences メソッドは、Trading API の GetUserPreferences および SetUserPreferences コールに相当する REST API です。

Trading API コールと新しい getUserPreferences メソッドの主な違いは以下の通りです。

getUserPreferences のデフォルトの挙動はすべてのセラー設定を取得することであり、取得したい設定セットごとにブール値フィールドを含める必要はなくなりました。getUserPreferences メソッドには、取得する設定セットを選択できるカンマ区切りの複数の値をサポートする fieldgroups クエリパラメータがあります。
Trading API コールの ShowSellerPaymentPreferences ブール値フィールドは、再利用されて shippingCarrierRatePreferences に名前変更されました。レガシーな支払い方法の設定はeBay管理の支払い（managed payments）では適用されなくなりましたが、FedExおよびUPSの配送料金オプションは引き続き適用されるためです。
ShowSellerProfilePreferences は移行されますが、個別のビジネスポリシーではなく、ビジネスポリシーのオプトインブール値フィールドのみが返されます。個別のビジネスポリシーの取得には Account v1 API を使用できます。

Trading API コールと新しい setUserPreferences メソッドの主な違いは以下の通りです。

Unpaid Item（未払い商品）ケースが存在しなくなったため、UnpaidItemAssistancePreferences コンテナの名前が itemsAwaitingPaymentPreferences に変更されました。
セラーがコントロールできるのは配送業者の料金のみであるため、SellerPaymentPreferences コンテナの名前が shippingCarrierRatePreferences に変更されました。

Media APIの新しいドキュメントタイプと新URLフィールド

Media API が更新され、DocumentTypeEnum タイプに新しい SAFETY_TEST_LAB_REPORTS ドキュメントタイプが追加されました。CEまたはUL認証の文脈において、Safety Test Lab Report（安全試験公認レポート）とは、製品が特定の安全基準に対して評価されたことを実証するために、認定試験機関によって発行された公式な試験ドキュメントを指します。

image リソースのメソッドが更新され、出品画像の最大寸法バージョンにアクセスするためのURLである maxDimensionImageUrl フィールドが追加されました。

Metadata APIのアップデート

Metadata API に以下の2つのアップデートが行われました。

新しい getMinimumListingPricePolicies メソッドを追加: オークション出品の最低開始価格、固定価格出品の最低販売価格、および同じ出品において即決価格が最低開始価格を上回らなければならない最低パーセンテージ値を取得します。このメソッドは、GeteBayDetails コールで返されていた ListingStartPriceDetails コンテナの代替となります。
getCategoriesPolicies メソッドに reservePriceAllowed フィールドを追加: リーフカテゴリが、そのカテゴリ内のオークション出品に対する最低落札価格（Reserve Price）をサポートしているかどうかを示します。

Finances APIに注文収益（Order Earnings）メソッドを追加

Finances API に3つの注文収益メソッドが追加されました。getOrderEarnings メソッドは特定の特定日付範囲内に発生したすべての注文の注文収益を取得し、getOrderEarningsById メソッドは特定のeBay出品から発生したすべての注文の注文収益を取得し、getOrderEarningsSummary メソッドは特定日付範囲における複合総売上高、費用額、純注文収益額、およびバイヤー返金総額を取得します。

getOrderEarnings および getOrderEarningsById メソッドは、注文収益、売上総額、費用、バイヤー返金、送料、および税金を含む、注文レベルの詳細な財務データを返します。

注: これらのメソッドは現在、米国、中国、および香港を拠点とし、eBay USマーケットプレイスで販売しているセラーのみが利用可能です。

Finances APIに新しい getBillingActivities メソッドを追加

Finances API に新しい getBillingActivities メソッドが追加されました。このメソッドは、Trading API の GetAccount コールに相当する REST API です。この新しいメソッドはセラーの手数料とクレジットを取得し、注文ID、出品ID、および/または日付範囲によって請求アクティビティを取得するフィルタを備えています。

Buy Feed v1 APIに新しいプロモーションフィードタイプを追加

Buy Feed v1 API に新しい PROMOTION_V2 フィードタイプが追加されました。このフィードタイプは、ライブ中の割引および現在それらに関連付けられている商品の日次スナップショットを提供し、割引を説明するために使用されるフィールドのセットを返します。この新しいフィードタイプは元の PROMOTION フィードタイプを拡張し、セラーおよびカテゴリレベルのターゲティングを持つマルチオファープロモーションをサポートします。なお、このフィードタイプの出力形式は AVRO です。

レポートにおける新しいPromoted Listing指標

Sell Marketing API の Promoted Listing レポートが更新され、以下の新しい指標が追加されました。

daily_budget_payout_currency 注釈キー（annotation key）を追加。この注釈キーは campaign_id ディメンションキーと組み合わせて使用する必要があります。
avg_cost_per_sale_listingsite_currency 指標キー（metric key）を追加。この指標キーは avg_cost_per_sale 指標をサポートするレポートタイプに適用されます。
cost_per_click_listingsite_currency 指標キーを追加。この指標キーは cost_per_click 指標をサポートするレポートタイプに適用されます。
cpc_avg_cost_per_sale_listingsite_currency 指標キーを追加。この指標キーは cpc_avg_cost_per_sale 指標をサポートするレポートタイプに適用されます。

eBayの廃止および提供終了の更新 (eBay deprecation and decommission updates)

このセクションは、廃止および提供終了のアクティビティの概要です。詳細については、必ず Deprecation Status ページをご覧ください。

第1四半期に提供終了（Decommissioned）となったAPI / 操作 / フィールド

第1四半期に以下のAPI、操作、およびフィールドが提供終了となりました。

API	操作 / フィールド	代替手段
Post-Order API	20の返品メソッド、5つの問い合わせメソッド、3つのケース管理メソッド、1つのキャンセルメソッド	なし
Trading API / VeRO API	GetVeROReportStatus, GetVeROReasonCodeDetails, VeROReportItems	VeRO API
Trading API	eBayPlus, eBayPlusEligible	なし
Compliance API	全メソッド	なし
Sell Marketing API	setupQuickCampaign, launchCampaign	なし

第1四半期に非推奨（Deprecated）としてマークされたAPIフィールド

Trading API の AddItem ファミリー呼び出しで使用される eBayPlus フィールド
GetItem で返される eBayPlusEligible フィールド

2026年第2四半期に提供終了予定

以下の表は、提供終了が予定されている操作をまとめたものです。提供終了となる Post-Order API メソッドの完全なリストについては、Deprecation Status ページを参照してください。

API	操作 / フィールド	予定日	代替手段
Trading API	GetCategories	4/15	カテゴリタクソノミーには Taxonomy API、サイトレベルのメタデータには Metadata API を使用。詳細は GetCategories Migration Guide を参照。
Product Metadata API	全メソッド	4/27	Metadata API の compatibilities メソッド。
Product API	getProductCompatibilities	4/27	Metadata API の getProductCompatibilities メソッド。
Trading API	GetCategoryFeatures	5/04	Metadata API の複数のメソッド。詳細は GetCategoryFeatures Migration Guide を参照。

2026年の素晴らしいスタートが切れましたことを願っております。今年残りの期間も、コミュニティの皆様と協力できることを楽しみにしております！

今後ともよろしくお願い申し上げます。
eBay Developers Program / eBay Japan APIサポートチーム