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

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

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

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

半期に一度のアンケート

半期に一度のアンケートは7月20日まで実施しています。アンケートにはこちらから直接アクセスできます。また、developer.ebay.comの上部にあるバナーからもリンクをご利用いただけます。まだ回答されていない方は、ぜひご協力をお願いいたします。皆様からのフィードバックを心よりお待ちしております。

すべての開発者に無料サポートを開放

eBay Developers Program は現在、すべての開発者に 無料サポート を提供しています。まずはサポートページの AI-Assisted Support ツールを使用して、質問の解決を試みてください。質問に対する十分な回答が得られない場合は、無料でテクニカルサポートチケットを作成して進めることができます。サポート時間を購入する必要はなくなりました。

APIライセンス契約の更新

更新された APIライセンス契約が、2025年6月24日 にポータルに掲載されました。詳細なデータ保護措置や国際規制への準拠など、APIライセンス契約に大幅な強化を加えました。制限付きAPI（Restricted APIs）およびAIコンテンツの使用には、重要な制限が適用されています。すべての開発者は APIライセンス契約を完全に遵守することが求められますので、更新されたドキュメントを必ずご一読ください。

自動車パーツ＆アクセサリー（P&A）の新返品ポリシー

7月15日 より、米国マーケットプレイスのパーツ＆アクセサリー（Parts & Accessories）出品（基準を満たすもの）は、バイヤーに対して30日以上の返品期間を含む無料返品を提供する必要があります。このポリシーの基準は以下の通りです。

eBay Motorsに固定価格形式で出品されており、商品が物理的に米国内にあること。
商品が米国内のバイヤーに発送されること。
商品の価格が10ドルを超えていること。
商品の状態（Condition）が New（新品）または New Other（新品その他）であること。

7月15日 以降、eBay APIを通じて作成または修正されるすべての出品について、使用される返品ポリシーが必要に応じて自動的に更新され、返品送料の負担者がセラーに、返品期間が30日に設定されます。このアクションがeBayによって行われたことを示す警告（Warning）がAPIレスポンスで返されます。8月下旬 からは、非準拠の返品ポリシーを使用してパーツ＆アクセサリー出品を作成または修正しようとするAPI呼び出しはブロックされます。開発者は返品ポリシーに必要な更新を行い、API呼び出しを再試行する必要があります。

eBayはセラーに対し、eBay返品用配送ラベルを50%割引で提供します。

大型商品を含むパーツ＆アクセサリーカテゴリは、この要件の対象外となります。

このポリシーの詳細については、P&A Returns Policy Seller Center News Topic を参照してください。

ファッション中古コンディションの拡大

3つの「Pre-owned（中古）」商品コンディションが、レディースハンドバッグ、アクセサリー、ジュエリー、靴を含む追加の159のリーフカテゴリに拡大されます。これらのカテゴリにおけるこれらのコンディションのサポートは、オーストラリアでは7月23日に、全世界のeBayマーケットプレイスでは8月5日に開始されます。

念のため、「Pre-owned」商品コンディションに使用する3つの Condition ID（Trading APIで使用）および Condition Enum（Inventory APIで使用）を以下に示します。

コンディション名	Condition ID 値	Condition Enum 値
Pre-owned - Excellent（中古 - 非常に良い）	2990	PRE_OWNED_EXCELLENT
Pre-owned - Good（中古 - 良い）	3000	USED_EXCELLENT
Pre-owned - Fair（中古 - 可）	3010	PRE_OWNED_FAIR

Metadata API の getItemConditionPolicies メソッドにおける商品コンディションのメタデータは、新しくサポートされたリーフカテゴリ向けに更新されています。

認定オープンボックス（Certified Open Box）プログラム

2025年5月のセラーアップデートで発表された通り、eBayはバイヤーの信頼を高めるための「認定オープンボックス（Certified Open Box）」プログラムを開始しました。このプログラムは、すべての「標準以上（Above Standard）」および「トップレイテッドセラー（Top Rated Seller）」に開放されています。対象カテゴリには、携帯電話、スマートウォッチ、ノートパソコン、掃除機、家電製品、タブレット、ヘッドフォン、工具、ビデオゲーム機が含まれます。出品要件は以下の通りです。

商品の状態が「Open Box（開封済み未使用）」に設定されていること（Trading APIではCondition ID 1500、Inventory APIでは NEW_OTHER）。
送料無料/配送無料であること。
30日間の無料返品。

セラーは以下のサービス指標も満たす必要があります。

「説明と異なる商品（Item Not as Described）」率が4%未満であること。
「未着商品（Item Not Received）」率が1%未満であること。
3ヶ月ごとに最低25件のオープンボックス取引があること。

詳細および対象カテゴリの完全なリストについては、2025年5月のセラーアップデートを参照してください。

メキシコ輸入規制の新規制

2025年4月のセラーアップデートで発表された通り、商品をメキシコに発送するセラーは、メキシコへの配送を取り扱う配送業者に対して以下の情報を提供する必要があります。

受取人の氏名（フルネーム）
受取人のメールアドレス
受取人の電話番号
受取人のメキシコ納税者番号（RFC）または国民ID（CURP）。メキシコのバイヤーはいずれかの納税者IDを提供する必要があり、この納税者ID情報は注文レポート（Order Report）で確認できるはずです。
詳細な商品説明

APIアップデート (API updates)

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

Media APIに新しい画像メソッドを追加

Media API に新しい image リソースと以下の3つの新しいメソッドが追加され、セラーのアカウントへのeBay Picture Services (EPS) 画像のアップロードがサポートされました。

createImageFromFile: このメソッドは、multipart/form-dataを使用して画像ファイルをeBay Picture Services (EPS) にアップロードし、APIを通じた出品作成時に使用できるEPS画像URLを返します。サポートされているファイルタイプについては、createImageFromFile のリファレンスドキュメントを参照してください。
createImageFromUrl: このメソッドのリクエストペイロードで画像URLを指定し、その画像ファイルがeBayによって正常にダウンロードされると、その画像のeBay Picture Services (EPS) バージョンが作成され、EPS画像URLがレスポンスで返されます。サポートされているファイルタイプについては、createImageFromUrl のリファレンスドキュメントを参照してください。
getImage: このメソッドは、画像に関連付けられたEPS画像URLと画像の有効期限を取得するために使用されます。EPS URLは、eBay出品で30日以上使用されていない場合、セラーのアカウントから削除されます。

Metadata APIのアップデート

Metadata API に新しい getCurrencies メソッドが追加され、特定のeBayマーケットプレイスで使用されるデフォルトの通貨を返すようになりました。

さらに、getCategoryPolicies メソッドに eanSupport、isbnSupport、および upcSupport フィールドが追加されました。これら3つのフィールドは、eBayマーケットプレイスのリーフカテゴリ内の出品が、それぞれEAN、ISBN、またはUPC値をサポートしているか、あるいは必須としているかを示します。

最後に、getMotorsListingPolicies メソッドが更新され、以下の2つのフィールドが追加されました。

kTypeSupported: 自動車カテゴリが、パーツ＆アクセサリー商品に適合する車やトラックを識別するための「Kタイプ」値の使用をサポートしているかどうかを示すブール値フィールドです。Kタイプ値の使用をサポートしているのは、英国、ドイツ、オーストラリア、フランス、イタリア、スペインのマーケットプレイスのみです。
minItemCompatibility: このフィールドの整数値は、パーツ＆アクセサリー商品に対して指定する必要がある適合車両またはアプリケーションの最小数を示します。

Buy Feed v1 APIに新しいCBTフィードタイプを追加

Buy Feed v1 API に、CBT_ITEM_ALL_ACTIVE という新しい越境取引（Cross-Border Trade）フィードタイプが追加されました。このフィードタイプを使用すると、主要なeBayマーケットプレイス（例：米国、英国、ドイツ）から調達された出品が、ダウンロードされたフィードファイルに含まれます。現在、このフィードタイプはeBayオーストリアおよびeBayアイルランドのマーケットプレイスでサポートされています。

TSV形式のgzip圧縮ファイルを返す他のフィードタイプとは異なり、CBT_ITEM_ALL_ACTIVE フィードタイプのファイルはAvro形式で返されます。

新しい CBT_ITEM_ALL_ACTIVE フィードタイプをサポートするために、以下のスキーマ変更が導入されました。

getAccess メソッドに listingMarketplaceConstraints 配列が追加されました。この配列には、CBT_ITEM_ALL_ACTIVE フィードタイプで出品が利用可能なeBayマーケットプレイスとカテゴリがリストされます。
FormatEnum タイプにAVRO列挙値が追加され、CBT_ITEM_ALL_ACTIVE フィードがAvro形式であることを示します。
DimensionKeyEnum にLISTING_MARKETPLACE_IDおよびLISTING_CATEGORY列挙値が追加されました。これらの列挙値は CBT_ITEM_ALL_ACTIVE フィードに適用されます。

updateCampaignBudgetメソッドの挙動変更

Sell Marketing API の updateCampaignBudget メソッドに対して、2つの挙動変更が実装されました。updateCampaignBudget メソッドは、Promoted Listingsプライオリティキャンペーンの日次予算を更新するために使用されます。

updateCampaignBudget メソッドは、1つのキャンペーンにつき1暦日あたり最大15回まで、日次クリック単価予算の更新に使用できます。2つの警告メッセージが追加されました。1つ目はその日の14回目の更新時にトリガーされ、2つ目はその日の15回目（最後）の更新時にトリガーされます。16回目の試行ではブロッキングエラーが発生し、ユーザーは次の暦日までそのキャンペーンの更新を待つ必要があります。

また、このメソッドのユーザーは、日次予算を少なくとも0.50米ドル増減させる必要があります。そうでない場合、エラーが発生します。

共通充電器指令 (Common Charger Directive) フェーズ2

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

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

このプロジェクトの「フェーズ2」において、eBayはCCD情報の提供に使用される商品アスペクトに変更を加えました。これらの変更は4月に展開され、影響を受けるカテゴリの getItemAspectsForCategory メソッドで返されるメタデータが更新されました。以下の表は、「フェーズ1」から「フェーズ2」への変更点を網羅しています。

フェーズ1: CCDアスペクトの変更点	フェーズ2: CCDアスペクトの変更点
Features アスペクトの新しい値として Charger Included および Charger Not Included を追加	新しいアスペクト Charger Included（充電器付属）を追加。サポートされる値は Yes/No
Charging Power Range アスペクトを追加	アスペクト名を更新: Device Charging Range（デバイス充電範囲）。値は 10-20.5（ワット単位）などの充電範囲
Features アスペクトの新しい値として USB-PD compatible を追加	アスペクト値を更新: Features アスペクトの新しい値として USB-PD (fast charging) が USB-PD compatible を置き換え

Inventory API や Trading API を通じてこれらのアスペクト（別名：Item Specifics）を渡す方法の例など、詳細については、Common Charger Directive 統合ガイドのトピックを参照してください。

CCD関連のメタデータを返すことに加えて、getItemAspectsForCategory メソッドは aspectAdvancedDataType フィールドで更新されました。このフィールドは Device Charging Range アスペクトに対して NUMERIC_RANGE の値で返され、アスペクトの値として数値範囲が期待されることを示します。

エネルギー効率ラベルの更新

EU諸国および北アイルランドにおけるエネルギー効率ラベル (EEK) の要件が、スマートフォンおよびタブレットカテゴリにも適用されるようになりました。

スマートフォンおよびタブレットのEEK情報を指定する方法は、家電カテゴリでの方法と同様です。EEK情報の指定に関する詳細については、Energy Efficiency information トピックを参照してください。

Metadata API の getRegulatoryPolicies メソッドを使用して、どのカテゴリがEEK情報をサポート、推奨、または必須としているかを確認できます。

Finances APIのアップデート

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

5年の時間制限 : getPayouts および getPayout メソッドは、5年以上前のセラーペイアウトを取得できなくなりました。また、getPayoutSummary メソッドで返されるカウントおよび金額には、5年以上前のセラーペイアウトは考慮されません。getTransactions および getTransfer メソッドは、5年以上前の取引を取得できなくなりました。また、getTransactionSummary メソッドで返されるカウントおよび金額には、5年以上前の取引は考慮されません。
36ヶ月の日付範囲制限 : getPayouts、getPayoutSummary、getTransactions、および getTransactionSummary メソッドの日付範囲フィルタに適用されます。
新しい REGULATORY_OPERATING_FEE : 該当する場合、特定のマーケットプレイスにおける規制要件に関連するコストをカバーするために、この新しい手数料がセラーに請求されます。この手数料の詳細については、eBay UKヘルプトピックを参照してください。

Buy Feed Beta APIのポーランド・アフィリエイトリンク対応

getItemFeed および getItemSnapshotFeed メソッドは、itemAffiliateWebUrl フィールドを通じてeBayポーランド・マーケットプレイスのアフィリエイトリンクを（該当する場合）返すようになりました。

Developer Analytics APIの新しいカウントフィールド

getRateLimits メソッドは、アプリケーション（ユーザーコンテキストなし）が現在の期間中にエンドポイント/リソースを呼び出した回数を示す新しい count フィールドを返すようになりました。また、getUserRateLimits メソッドは、アプリケーションが現在の期間中にeBayユーザーに代わってエンドポイント/リソースを呼び出した回数を示す新しい count フィールドを返すようになりました。

検索APIの検索文字列制限

Marketplace Insights API の search メソッドまたは Browse API の search メソッドの q クエリパラメータで指定された100文字を超える検索文字列は、自動的に切り捨てられ、予期しない結果が生じる可能性があります。

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

第2四半期に以下のAPIが提供終了（Decommissioned）となりました。

Product API の addProducts、findProductsByCompatibility、および getProductSubmissions 呼び出し
Product Metadata API の getProductMetadataBulk、getProductSearchDataVersion、getProductSearchNames、getProductSearchValues、および getProductSearchValuesBulk 呼び出し
Trading API の GetCategoryMappings 呼び出し

Trading API の ExtendSiteHostedPictures 呼び出しは、2025年7月28日 に提供終了となります。

GetCategoryFeatures 呼び出しは非推奨（Deprecated）として発表されており、2026年5月4日 に提供終了となります。GetCategoryFeatures の代替として使用される新しい Metadata API メソッドの詳細については、GetCategoryFeatures Migration Guide を参照してください。

GetCategories 呼び出しは非推奨として発表されており、2026年3月31日 に提供終了となります。新しいREST API代替手段への移行に関する詳細については、GetCategories Migration Guide を参照してください。

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