eBay 開発者プログラム 2025 年第 4 四半期ニュースレター
eBay Developers Program 2025年第4四半期ニュースレター
プログラムニュース (Program news)
皆様、お元気でお過ごしでしょうか。この場をお借りして、直近の四半期(2025年10月~12月)におけるeBay Developers Programのアップデートを共有させていただきます。
5つの新しいBuy APIユースケースガイドを公開
新しいガイドページに、以下の5つの新しいBuy APIユースケースガイドが追加されました。
- 在庫の発見および更新ガイド (Inventory Discovery and Refresh Guide)
- マーケティングおよび割引ガイド (Marketing and Discounts Guide)
- マーケットプレイスメタデータガイド (Marketplace Metadata Guide)
- チェックアウト/入札ガイド (Checkout/Bid Guide)
- Buyその他のAPIガイド (Buy Other APIs Guide)
新しいガイドページに馴染みがない方のために説明しますと、このページはeBay APIを活用した皆様のビジネスユースケースにより沿った形で構成されています。SellタブとBuyタブがあり、切り替えることでそれぞれのアプリケーション構築について深く掘り下げることができます。なお、両方のコンテキストに関連する共通のガイドもいくつかあり、それらは両方のタブに表示されます。
原産国 (Country of Origin) アスペクトの更新
Country of Origin(原産国)は現在、関税計算や米国在住のバイヤーに対する出品の可視性管理において重要となっています。11月1日より、米国外から米国へ発送されるすべての出品には、Country of Origin アスペクトを設定することが期待されます。このアスペクトが設定されていない新規およびアクティブな出品について、信頼できる原産国情報が入手可能な場合、eBayは米国への輸入適格な出品にこのアスペクトを追加します。
セラーによって提供された Country of Origin は優先され、eBayが提供した Country of Origin を上書きします。
以下の点にご留意ください:
- アスペクト名は各eBayマーケットプレイス向けにローカライズされています。必ず getItemAspectsForCategory または fetchItemAspects メソッドを使用して、出品マーケットプレイスに相当する Country of Origin アスペクトを取得してください。
- Country of Origin アスペクトは、10月に Country/Region of Manufacture アスペクトを置き換えました。
- ファッションやジュエリーなどのカテゴリで使用されていた元の Country of Origin アスペクトの名前は、Materials Sourced From に変更されました。このアスペクトは任意ですが、該当する場合は含める必要があります。
EEKラベル用の新しいEPRELアスペクト
エネルギー効率 (EEK) ラベルを特徴とする製品向けに、新しい EPREL Registration Number アスペクトが利用可能になりました。有効なEPREL (European Product Registry for Energy Labelling) 登録番号が提供された場合、エネルギー効率ラベルや製品データシートなどのEEK情報が自動的に取得され、出品に表示されます。
EU規制要件 では、セラーがEU諸国および北アイルランド内で事業を行っている、および/またはそれらの地域へ発送する場合、家電製品、スマートフォン、タブレット、タイヤなどの製品グループに対してエネルギー効率ラベルを提供することを期待しています。Metadata API の getRegulatoryPolicies メソッドを使用して、どのeBayリーフカテゴリがエネルギー効率ラベルをサポートしているかを確認できます。エネルギー効率ラベルをサポートするリーフカテゴリは、APIレスポンスの supportedAttributes.name フィールドに ENERGY_EFFICIENCY の値を表示します。開発者は、getItemAspectsForCategory メソッドまたは fetchItemAspects メソッドと Taxonomy SDK を使用して、どのリーフカテゴリがEEKラベルをサポートしているかを確認することもできます。
製品の EPREL Registration Number は、製品のエネルギー効率ラベルにあるQRコードをスキャンするか、製品のGTIN値を使用して直接 EPRELデータベース で検索することで見つけることができます。
EPREL Registration Number アスペクトの使用は、Trading API の EnergyEfficiencyLabel コンテナや Inventory API の energyEfficiencyLabel コンテナを使用する代わりの方法であることに注意してください。両方が提供された場合、それらのコンテナのいずれかが EPREL Registration Number アスペクトよりも優先されます。
eBay for Charityがカナダとドイツに拡大
eBay for Charity プログラムが、ドイツおよびカナダ(英語版およびフランス語版)のマーケットプレイスに拡大されました。eBay for Charity に関する詳細情報は、以下のページを参照してください。
- 米国およびカナダマーケットプレイス : ebayforcharity
- ドイツマーケットプレイス : ebayfuercharity.de
このプログラムの拡大に伴い、Trading API の Charity コンテナおよび Inventory API の charity コンテナが、ドイツおよびカナダのマーケットプレイスでチャリティ出品を有効にするために使用できるようになりました。
eBay Plusの変更
ドイツまたはオーストラリアのマーケットプレイスで出品をeBay Plusの対象にするために、セラーは Trading API の eBayPlus フィールドや Inventory API の eBayPlusIfEligible フィールドを含める必要がなくなりました。このフィールドが含まれている場合、無視され破棄されます。eBayは、バイヤーが有効なeBay Plusサブスクリプションを持っているかどうか、および出品がプログラムの要件を満たしているかどうかに基づいて、どの出品がeBay Plusの資格があるかを判断します。出品要件については、eBay AUヘルプトピック または eBay Germany eBay Plus ページを参照してください。
これら2つのeBayマーケットプレイスのセラーは、eBayアカウントで管理するeBay Plus設定もなくなりました。
APIライセンス契約の更新
対象者 (Covered Persons) および 個人データの転送 (Transfers of Personal Data) に関する新しい条項が追加されました。APIライセンス契約 の データ処理補足 (Data Processing Addendum) セクションにある セクション 3.g.4 を参照してください。
APIアップデート (API updates)
今四半期にAPIに対して行われたアップデートは以下の通りです。
AI対応Inventory Mapping APIのリリース
GraphQL Inventory Mapping API がすべての開発者に利用可能になりました。このAPIは、既存の製品データから生成されたAIによる推奨事項を使用して、セラーが高品質なeBay出品を作成するのを支援します。このAPIにより、セラーやサードパーティパートナーは既存の製品データを使用してeBay出品プレビューを作成し、その後eBayのListing APIを使用して出品を作成することができます。
Inventory Mapping API を使用してeBay出品プレビューを作成する詳細については、出品作成ガイド の 出品プレビューの作成 (Create listing previews) セクションを参照してください。また、新しい GraphQL Explorerツール を通じてAPIを試すこともできます。
最近のブログ記事 Explore the Inventory Mapping API もぜひご一読ください。
新しいFeedback API
今四半期に新しい Feedback API がリリースされました。この新しいREST APIは、Trading API の GetFeedback、GetItemsAwaitingFeedback、LeaveFeedback、および RespondToFeedback 呼び出しに対する、より堅牢で現代的な代替手段です。
この新しいAPIの詳細については、販売コミュニケーションガイド の Feedback APIの使用 (Using the Feedback API) セクションを参照してください。
新しいMessage API
今四半期に新しい Message API がリリースされました。この新しいREST APIは、Trading API の AddMemberMessageAAQToPartner、AddMemberMessageRTQ、AddMemberMessagesAAQToBidder、DeleteMyMessages、GetMemberMessages、GetMyMessages、および ReviseMyMessages 呼び出しに対する、より堅牢で現代的な代替手段です。
この新しいAPIの詳細については、販売コミュニケーションガイド の Message APIを使用したコミュニケーション管理 (Managing communications using the Message API) セクションを参照してください。
新しい配送メタデータメソッド
Metadata API に5つの新しい配送メタデータメソッドが追加されました。これらのメソッドはすべて、Trading API の GeteBayDetails 呼び出しの代替として使用できます。
- getShippingServices: 指定されたマーケットプレイスでサポートされている国内および国際配送サービスのリストを取得します。このメソッドは ShippingServiceDetails コンテナの代替として使用できます。
- getShippingCarriers: 指定されたマーケットプレイスで国内および国際的に活動しているサポートされている配送業者のリストを取得します。このメソッドは ShippingCarrierDetails コンテナの代替として使用できます。
- getShippingLocations: 指定されたマーケットプレイスでサポートされている配送先のリストを取得します。このメソッドは ShippingLocationDetails コンテナの代替として使用できます。
- getExcludeShippingLocations: 指定されたマーケットプレイスで除外配送先として指定できる地理的および特別な国内の場所のリストを取得します。このメソッドは ExcludeShippingLocationDetails コンテナの代替として使用できます。
- getHandlingTimes: 指定されたマーケットプレイスでサポートされているハンドリングタイム(出荷までの日数)のリストを取得します。このメソッドは DispatchTimeMaxDetails コンテナの代替として使用できます。
Notification APIに9つの新しいトピックを追加
以下の9つの新しいトピックが Notification API を通じて購読可能になりました。
- ORDER_CONFIRMATION : このトピックを購読すると、バイヤーがオークションまたは固定価格商品のチェックアウトプロセスを完了したときにセラーに通知が送信されます。
-
OFFER_ACTIVITY : このトピックを購読すると、出品のオファーアクティビティが発生したときにバイヤーまたはセラーにオファー関連の通知が送信されます。送信される可能性のある4つの通知は以下の通りです:
- BUYER_OFFER (セラーにのみ送信)
- BUYER_COUNTER_OFFER (セラーにのみ送信)
- SELLER_OFFER (バイヤーにのみ送信)
- SELLER_COUNTER_OFFER (バイヤーにのみ送信)
-
AUCTION_ACTIVITY : このトピックを購読すると、オークションアクティビティに関連する通知が入札者とセラーに送信されます。送信される可能性のある4つの通知は以下の通りです:
- BID_PLACED (バイヤーにのみ送信)
- BID_RECEIVED (セラーにのみ送信)
- OUTBID (バイヤーにのみ送信)
- AUCTION_WON (バイヤーにのみ送信)
- ITEM_MARKED_SHIPPED : このトピックを購読すると、商品を発送済みとしてマークしたセラーに通知が送信されます。
- FEEDBACK_RECEIVED : このトピックを購読すると、取引相手からフィードバックを受け取ったときにユーザーに通知が送信されます。
- FEEDBACK_LEFT : このトピックを購読すると、取引相手にフィードバックを残したときにユーザーに通知が送信されます。
- FEEDBACK_STAR_CHANGED : このトピックを購読すると、フィードバックの星評価(Star Rating)が変更されたときにユーザーに通知が送信されます。
- BUYER_QUESTION : このトピックを購読すると、バイヤーがアクティブな出品について質問したときにセラーに通知が送信されます。
- NEW_MESSAGE : このトピックを購読すると、eBayまたは他のeBayユーザーから新しいメッセージを受信したときにユーザーに通知が送信されます。
Catalog APIの新しい互換性サポート
Catalog API の getProduct メソッドのレスポンスに、新しい compatibilityCount フィールドが追加されました。このフィールドは、パーツ&アクセサリー製品がいくつの自動車と互換性があるかを示すために、条件付きで返されます。
Buy Marketing APIで利用可能な新しいメソッド
以下の2つのメソッドが Buy Marketing API に追加されました。
- getMostWatchedItems: このメソッドは、特定のリーフカテゴリで最もウォッチ数の多い出品を取得します。ユーザーは取得する出品数を最大50まで制御できます。このメソッドは、Merchandising API の getMostWatchedItems 呼び出しの代替手段です。
- getSimilarItems: このメソッドは、リクエスト内の商品と類似した商品を取得します。ユーザーは取得する出品数を最大50まで制御できます。商品の終了日や購入形式でフィルタリングするオプションもあり、ユーザーは1つまたはカテゴリIDを除外することもできます。このメソッドは、Merchandising API の getSimilarItems 呼び出しの代替手段です。
Buy Marketing API は、特定のスコープを必要とする制限付きAPIです。
新しい一括売上税メソッドの追加
Account API v1 に bulkCreateOrReplaceSalesTax メソッドが追加されました。このメソッドを使用すると、セラーは複数の米国領土および/またはカナダの州に対して、複数の消費税率設定を追加または修正できます。この新しいメソッドは既存の createOrReplaceSalesTax メソッドを補完し、Account API v1 の sales_tax メソッドを、Trading API の SetTaxTable 呼び出しと同等の機能にします。
Browse検索メソッドへの新しい警告追加
Browse API の search メソッドに、新しい警告(ID 12519)が追加されました。これは、同じリクエストで itemLocationRegion と deliveryCountry の両方が filter 値として使用された場合の挙動に対応するものです。互換性のない itemLocationRegion と deliveryCountry の値が提供された場合、この警告がトリガーされ、マーケットプレイスのデフォルトのロケーション動作が使用されます。
米国、英国での2日間のセラーオファーのサポート終了
米国および英国のマーケットプレイスにおけるセラー主導のオファーの期間は、2日間に設定できなくなり、4日間のみとなります。Negotiation API の sendOfferToInterestedBuyers を使用している開発者は、この変更がそのメソッドの offerDuration コンテナの挙動にどのように影響するかを認識しておく必要があります。offerDuration コンテナはリクエストで省略することが望ましく、その場合eBayは自動的に米国および英国マーケットプレイスでサポートされている唯一の期間である4日間にデフォルト設定します。offerDuration コンテナを使用する場合、offerDuration.value の値は、米国および英国マーケットプレイスでは「4」に設定し、この機能をサポートする他のすべてのeBayマーケットプレイスでは「2」に設定する必要があります。
新しいLeads APIが利用可能に
今四半期に新しい Leads API がリリースされました。この新しいREST APIは、Trading API の GetAdFormatLeads 呼び出しの現代的な代替手段です。getAllClassifiedLeads メソッドは、セラーのすべてのアクティブなクラシファイド広告出品を検索し、日付範囲および/またはステータスによってセールスリードを取得します。getClassifiedLeadsByItemId メソッドも同様に機能しますが、検索は指定された1つのクラシファイド広告出品のみを対象とします。
eBayの廃止および提供終了の更新 (eBay deprecation and decommission updates)
このセクションは、廃止および提供終了のアクティビティの概要に過ぎません。詳細については、必ず Deprecation Status ページをご覧ください。
提供終了(Decommissioned)API
第4四半期に提供終了となったAPIはありません。
非推奨(Deprecated)API
以下のAPIは、第4四半期に非推奨としてマークされました:
- UploadSiteHostedPictures
- 以下の5つのPost-Order APIメソッド:
2026年第1四半期に提供終了予定
以下の表は、提供終了となる操作をまとめたものです。提供終了となるPost-Order APIメソッドの完全なリストについては、Deprecation Status ページを参照してください。
| 操作 | 日付 |
|---|---|
| 16のPost-Order API返品メソッド | 2026年1月20日 |
| 3つの返品および1つの問い合わせPost-Order APIメソッド | 2026年2月2日 |
| GetVeROReportStatus, GetVeROReasonCodeDetails, および VeROReportItems | 2026年2月2日 |
| 3つのケース管理、1つの返品、および1つのキャンセルPost-Order APIメソッド | 2026年3月2日 |
| 4つの問い合わせPost-Order APIメソッド | 2026年3月16日 |
| GetCategories | 2026年3月31日 |
皆様にとって素晴らしい第4四半期とホリデーシーズンの始まりであったことを願っております!2026年もコミュニティの皆様と協力できることを楽しみにしております!