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

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

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

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

新しい通知トピック（Notification Topics）ページの追加

開発者ポータルに新しい「Notification Topics」ページが追加されました（https://developer.ebay.com/develop/api/sell/notification_events）。このページでは、Notification API を通じて購読可能な通知トピックの完全なリストを網羅しています。トピックは論理的な順序でグループ化されており、通知イベントペイロードのすべてのフィールドがドキュメント化されています。

なお、一部の通知トピックには特別な API スコープが必要であり、すべてのユーザーが利用できるとは限らないことにご注意ください。Notification API との統合およびトピックの購読に関する詳細については、販売コミュニケーションガイド (Sell Communication Guide) を参照してください。

新しいリファレンスドキュメント体験

すべてのモダン API ドキュメントセットが 1 つのページからアクセスできるようになり、機能グループ別および「Sell」と「Buy」のタブ下に整理されました。販売（Sell）と購入（Buy）の両方のユースケースに対応する API は、「Sell」と「Buy」の両方のタブ下に表示されます。

英国における「簡単・無料返品 (Easy and Free Returns)」の正式運用

英国（UK）マーケットプレイスにおいて、対象となるパーツ＆アクセサリー（Parts & Accessories）出品に対する「簡単・無料返品（Easy and Free Returns）」ポリシーの導入が完了いたしました。本ポリシーにより、該当するパーツ＆アクセサリー出品は、バイヤー（購入者）に対して 30日または 60日の返品期間を含む無料返品を提供することが義務付けられます。

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

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

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

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

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

5月中旬 より、オーストラリア（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 ヘルプページを参照してください。

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

以下のコインカテゴリおよびその配下のリーフカテゴリにおいて、コンディション記述子（Condition descriptors）が使用されていない場合、Add API および Revise API 呼び出しでブロックエラー（Blocking Error）が発生するようになりました。

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

コインカテゴリ向けの新しいコンディション記述子メタデータ（Condition descriptor metadata）は、Metadata API の getItemConditionPolicies メソッドを通じて利用可能です。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 を渡して、該当するコンディション記述子の名前と値のペアを提供する必要があります。

コンディション評価属性を持たないこれらのコインカテゴリの既存の出品は、非表示または削除の対象となります。

収集用コインカテゴリでは、コインの状態（コンディション）が正確かつ明密に説明されていることが極めて重要です。状態が正確に記載されていない場合、バイヤーの信頼、価格設定、コンバージョン率、および購買意欲に直接悪影響を及ぼします。コインのコンディション評価に関する詳細については、eBay の coin condition guidelines ヘルプページを参照してください。

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

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

この問題を緩和するため、eBay はすべての eBay マーケットプレイスにおいてカスタムの非標準サイズ値のサポート終了に向けて取り組んでいます。7月より、商品アスペクトにカスタム/非標準の Size 値を含めて Add API または Revise API 呼び出しが行われた場合、eBay は以下のいずれかの処理を行います。

非標準値を標準値へ自動的に変換します。これが実行されるには、eBay がカスタム値を認識しマッピングを持っている必要があり、作成/修正された出品に対して eBay がこの更新を行ったことを示す警告メッセージがトリガーされます。たとえば、「Size」の値として「Small」が提供された場合、eBay は自動的にその値を「S」に変換します。警告コード 21920466 を確認してください。
非標準の Size 値での出品の作成/修正を許可しますが、eBay がその値を認識できない場合、Size 値が非標準であり、標準値に変更する必要があること、およびできるだけ早く更新しないと検索から非表示になるか削除される対象となることを示す警告メッセージがトリガーされます。警告コード 21920467 を確認してください。

8月より、非標準/非準拠または欠落したサイズ値を含むすべての Add API および Revise API 呼び出しは、エラーで失敗するわけではありませんが、問題が解決されるまで新しく作成された出品または修正された出品が保留（Hold）状態となります。これは、セラーが問題を解決するまで、影響を受ける出品が eBay 上で表示されず、購入できなくなることを意味します。すべての既存の出品も同様の措置の対象となります。eBay が値を認識しているかどうかにかかわらず、非標準の Size 値に対しては警告コード 21920467 が返されます。eBay は非標準 Size 値から標準 Size 値への自動変換を停止します。

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

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

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

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

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

これらのアスペクト名と値のペアが 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 配送サービスを使用する出品の場合、出品に添付されたコンプライアンスドキュメントが配送パートナーに送信されます。
コンプライアンスデータの欠落や誤りがあると、米国の国境での発送の遅延、保留、または不許可が発生する可能性があります。

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

未着（INR）および配送遅延に対するセラー保護

8月より、eBay は米国および英国マーケットプレイスにおける国内注文に対するセラー保護を拡大します。配送業者の遅延など、セラーの管理外の遅延によって配達が遅れた場合に、バイヤーが未着商品（INR: Item Not Received）の問い合わせを行った際、セラーは保護されるようになります。変更点の概要は以下の通りです。

eBay はセラーの評価（Seller Rating）を保護します。
商品がまだ輸送中である場合、eBay はバイヤーに対して待機するよう促し、セラーが配送業者と協力するための時間を確保します。
待機期間中、セラーはバイヤーに返金する義務はなく、このリクエストに対する返金オプションは一時的に利用できなくなります。
配送業者が商品を配達するのに十分な時間があったにもかかわらずまだ到着しない場合、eBay はセラーに返金を要請します。

これは、対象となる出品を保有し、eBay 配送ラベルを使用して国内注文を期日通りに発送した米国および英国のセラーに適用されます。

8月の導入に合わせて、本取り組みをサポートするために Post-Order API に変更が行われます。詳細は以下の通りです。

INR 問い合わせメソッド

注文品目に対して INR 問い合わせが提出された場合、Post-Order API の getInquiry メソッドの state フィールドは ON_HOLD の値で返されるようになります。これは、INR 問い合わせが待機期間中にあり、バイヤーから返金が要求された場合でもセラーが返金を発行することを期待されない状態であることを示します。さらに、以下の 3つの新しいフィールドが追加されます。

resolutionEstimate.resolutionEstimateDate: 配送遅延の原因を eBay が調査しているために問い合わせが保留（On hold）になった場合に、このフィールドが返され始めます。ここに含まれるタイムスタンプは、eBay が問題を解決すると予想されるおおよその日付となります。調査結果に基づき、セラーはこの日時以降にバイヤーへ返金する（または eBay がバイヤーに返金した場合は eBay へ返金分を償還する）責任が発生する場合があります。
inquiryDetails.provisionalRefund.refundProvided: 商品がバイヤーへまだ輸送中である間に、eBay がバイヤーへ仮返金（Provisional refund）を発行したかどうかを示す新しいブール値フィールドです。
inquiryDetails.provisionalRefund.refundReversed: 商品が配達された後に、仮返金が後から取り消された（Reversed）かどうかを示す新しいブール値フィールドです。

返品メソッド

INR 問い合わせが提出された注文品目が最終的にバイヤーによって返品された場合、待機期間中に eBay が仮返金を発行した可能性があるケースに対応するため、Post-Order API の getReturn メソッドに以下の 2つの新しいフィールドが追加されます。

detail.refundInfo.provisionalRefund.refundProvided: バイヤーによって返品リクエストが作成される前に、バイヤーが以前に仮返金を受け取っていたかどうかを示す新しいブール値フィールドです。
inquiryDetails.provisionalRefund.refundReversed: 商品がバイヤーに配達された後に、仮返金が後から取り消されたかどうかを示す新しいブール値フィールドです。

APIアップデート (API updates)

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

新カテゴリ向けコンディション記述子メタデータ

Metadata API の getItemConditionPolicies メソッドが更新され、米国コインカテゴリおよび認定リサイクル（解体）自動車パーツ向けのコンディション記述子（Condition descriptor）の名前と値の識別子が返されるようになりました。

以下の米国コインカテゴリおよびその配下のリーフカテゴリでは、新しいコンディション記述子の名前と値のペアの使用が義務化されています。

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

認定リサイクル自動車パーツの場合、コンディション記述子の使用は現時点では義務化されていませんが、「説明と異なる商品」ケースや返品を回避するために使用することが強く推奨されます。

影響を受けるコインおよびパーツ＆アクセサリーのリーフカテゴリについて、コンディション記述子の名前と値の識別子は itemcondition.conditiondescriptors 配列で返されます。conditiondescriptorid フィールドの値は出品 API でコンディション記述子名を設定するために使用され、conditiondescriptorvalueid フィールドの値は各コンディション記述子名に対応するコンディション記述子値を設定するために使用されます。

Media APIに新しいドキュメントタイプを追加

Media API に新しいドキュメントタイプが追加され、エネルギー効率ラベル（EEK）のサポート、および 2026年7月8日より開始された米国への特定製品の発送前に製品証明書の提供を求める消費者製品安全委員会（CPSC）の義務化要件に対応いたしました。追加された 4つの新しいドキュメントタイプの詳細は以下の通りです。

EEK_ENERGY_LABEL: 製造元または認可されたサードパーティによって提供されるエネルギー効率ラベル（PDF または画像）をアップロードするために使用されます。ラベルには、EU および英国の規制で義務付けられている製品のエネルギー評価と消費指標が表示されます。eBay の出品において、このドキュメントタイプは常に EEK_PRODUCT_INFORMATION_SHEET とペアにする必要があります。
EEK_PRODUCT_INFORMATION_SHEET: 製造元または認可されたサードパーティによって提供される製品情報シートまたはフィッシュ（PDF または画像）をアップロードするために使用されます。ドキュメントには、EU および英国の規制で義務付けられている技術仕様とエネルギーパフォーマンスの詳細が含まれます。eBay の出品において、このドキュメントタイプは常に EEK_ENERGY_LABEL とペアにする必要があります。
GENERAL_CERTIFICATE_OF_CONFORMITY: 一般用消費財に必要な証明書（GCC）をアップロードするために使用され、製造元または輸入業者の試験に基づき製品が適用されるすべての米国 CPSC 安全規則に準拠していることを証明します。このドキュメントは、特定の製品を米国へ発送する際に必要となる場合があります。影響を受ける製品のリストについては、CPSC 公式サイトの GCC ドキュメントを必要とする製品ページを参照してください。
CHILDRENS_PRODUCT_CERTIFICATE: 12歳以下の子供向け製品に必要な証明書（CPC）をアップロードするために使用され、第三者機関による試験に基づき製品が適用されるすべての米国 CPSC 安全規則に準拠していることを証明します。このドキュメントは、12歳以下の子供向けに意図された特定の製品を米国へ発送する際に必要となる場合があります。影響を受ける製品のリストについては、CPSC 公式サイトの CPC ドキュメントを必要とする製品ページを参照してください。

Sell Marketing APIにおけるPromoted Listingのアップデート

Sell Marketing API の Promoted Listing キャンペーンに関して、以下のアップデートが行われました。

Promoted Listing プライオリティストラテジーキャンペーンは特定のセラーに制限されなくなり、Sell Marketing API を使用してプライオリティおよびジェネラル両方のストラテジーキャンペーンを作成できるようになりました。
createCampaign、cloneCampaign、pauseCampaign、updateCampaignIdentification、および updateAdRateStrategy メソッドにおいて、特定のキャンペーン管理シナリオをサポートするための新しいエラーコードが追加されました。

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

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

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

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

API	操作 / フィールド	代替手段
Trading API	GetCategories	カテゴリタクソノミーには Taxonomy API、サイトレベルのメタデータには Metadata API を使用。詳細は GetCategories Migration Guide を参照。
Trading API	GetCategoryFeatures	Metadata API。詳細は GetCategoryFeatures Migration Guide を参照。

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

以下の表は、第3四半期に提供終了が予定されている操作をまとめたものです。

API	操作 / フィールド	予定日	代替手段
Product Metadata API	全メソッド	7/15	Metadata API の compatibilities リソース下のメソッド。
Product API	全メソッド	8/15	Catalog API および Metadata API の getProductCompatibilities メソッド。
Trading API	UploadSiteHostedPictures	9/30	Media API の createImageFromFile および createImageFromUrl メソッド。

第2四半期に非推奨（Deprecated）としてマークされたAPI

GetShippingDiscountProfiles および SetShippingDiscountProfiles コールは、2027年1月19日 に提供終了となります。代替操作は、Account API v2 の combined_shipping_rules リソース下のメソッドとなります。

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

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