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

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

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

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

新しいガイド体験で5つの新ガイドが利用可能に

以下の2つの新しいガイドが、新しいガイドのランディングページに追加されました。

  • 出品作成ガイド (Listing Creation Guide): このAPIユースケースガイドでは、個別の単一SKUおよび複数SKU出品の作成、一括出品の作成、および既存のeBayカタログ製品に基づいた出品の生成について説明しています。
  • 出品管理ガイド (Listing Management Guide): このAPIユースケースガイドでは、eBayのアクティブな出品の修正、再出品、取得、および終了方法について説明しています。

以下の3つのガイドは新しいものではありませんが、新しいガイド体験に合わせて再フォーマットされました。これらのガイドの以前のバージョンをブックマークしている場合は、ブックマークを更新することをお勧めします。

  • eBay REST利用ガイド (Using eBay REST Guide): このガイドでは、eBay REST APIの開始方法と使用方法に関する高レベルの情報を提供します。
  • 認可ガイド (Authorization Guide): このガイドでは、API呼び出しを行う際のOAuthトークンの生成と使用について知っておくべきことすべてを網羅しています。
  • デジタル署名ガイド (Digital Signatures Guide): このガイドでは、対象となるAPI呼び出しのHTTPペイロードにデジタル署名を作成して追加するための全プロセスをカバーしています。デジタル署名は、EU/UKのセラーに代わってAPI呼び出しを行う開発者にのみ必要です。

データ取り扱いの変更

特定のユーザーに対するデータ取り扱い要件に対応するため、eBayのAPI統合が変更されます。この変更は、中国（およびその領土）、ロシア、北朝鮮、キューバ、イラン、ベネズエラのいずれかの管轄区域で活動するサードパーティ開発者に影響します。公開eBayユーザー名を使用/返す公開eBay APIフィールドは不変のユーザーIDに置き換えられ、特定のユーザーの財務データは保護されます。この変更の詳細と影響を受ける公開APIフィールドの完全なリストは、Data Handling Compliance ドキュメントで確認できます。

米国での準拠したP&A出品の作成

7月より、eBayは「Free and Easy（無料かつ簡単）」な返品ポリシーを導入しました。これにより、米国マーケットプレイスのパーツ＆アクセサリー（Parts & Accessories）出品で特定の基準を満たすものは、バイヤーに対して30日または60日の返品期間を含む無料返品を提供する必要があります。詳細情報、基準の完全なリスト、およびFAQの完全なセットについては、セラーセンターの Boost buyer trust with new P&A returns policy ページを参照してください。

Add（追加）およびRevise（修正）APIは、すでに非準拠の出品に対して警告を返しており、これらの警告は10月7日頃からブロッキングエラーに変更されます。セラーと協力して、米国のパーツ＆アクセサリー出品がこのポリシーに準拠していることを確認してください。Trading API または Account v1 API の Fulfillment Policy オブジェクトを通じて準拠した返品ポリシーを作成するための具体的な情報については、統合ガイドのトピック Support for easy returns in Parts and Accessories を参照してください。

コストを相殺するために、eBayはセラーに対し、eBay返品用配送ラベルを50%割引で提供します。

原産国/製造地域アスペクトの変更

米国に商品を発送するeBayセラーは、米国の関税要件に沿った透明性のある配送体験を実現するために、商品がどこで製造されたかに関する情報を出品に提供する必要があります。開発者とセラーが認識しておくべき2つの重要な点は以下の通りです。

  • 9月12日 時点で、ファッションやジュエリーなどのカテゴリ内の Country of Origin（原産国） アスペクトは Materials Sourced From（素材調達元） に変更されました。
  • 10月 には、Country/Region of Manufacture（製造国/地域） アスペクト（eBayカテゴリの大部分に適用）が Country of Origin（原産国） に変更されます。米国に発送するすべてのeBayマーケットプレイスのすべての出品について、Country/Region of Manufacture の代わりにそのアスペクト名を使用する必要があります。

開発者は、getItemAspectsForCategory メソッドまたは fetchItemAspects メソッドと Taxonomy SDK を使用（または継続使用）して、影響を受けるカテゴリの Country/Region of Manufacturer から Country of Origin アスペクト名への切り替えを監視することをお勧めします。

すべてのMedia API POST呼び出しに対する短時間呼び出し制限

Media API のすべてのPOSTメソッドには、5秒間に50リクエストという短時間呼び出し制限があります。この短時間呼び出し制限を超えるとエラーが発生します。これは新しい挙動ではありませんが、このレート制限を超過することによるエラーの発生を防ぐため、今四半期にドキュメントで明記されました。この注記はすべてのPOSTメソッドのリファレンスドキュメントに追加され、API Call Limits ページにも追加されました。

カテゴリID 173651でカタログ製品の編集が可能に

排出ガス制御無効化装置ポリシー の一環として、Tuning devices and software feature カテゴリ（カテゴリID 173651）の商品は、eBayカタログ製品を参照する必要があります。これまで、セラーはカタログ製品の詳細を一切編集できませんでしたが、今後は必要に応じてタイトルや説明を修正できるようになりました。ただし、製品の商品スペック（Item Specifics）への変更は引き続き行えません。API固有の詳細情報については、Tuning devices and software 統合ガイドのトピックを参照してください。

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

3つの「Pre-owned（中古）」商品コンディションが、レディースハンドバッグ、アクセサリー、ジュエリー、靴を含む追加の159のリーフカテゴリに世界的に展開されました。

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

Condition Name Condition ID value Condition Enum value
Pre-owned - Excellent 2990 PRE_OWNED_EXCELLENT
Pre-owned - Good 3000 USED_EXCELLENT
Pre-owned - Fair 3010 PRE_OWNED_FAIR

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

Refurbished（整備済み）プログラムがより多くのカテゴリに展開

eBay Refurbished Program は第3四半期も成長を続け、2025年には500以上のリーフカテゴリがプログラムに追加され、リーフカテゴリの総数は2200を超えました。eBay Refurbished Program には、Certified Refurbished（ID 2000）、Excellent - Refurbished（ID 2010）、Very Good - Refurbished（ID 2020）、Good - Refurbished（ID 2030）の4つの異なる整備済み商品コンディションがあります。セラーは、これら4つの整備済み商品コンディションのいずれかを使用する前に、申請と審査プロセスを経る必要があります。

eBay Refurbished Program は、以下のバーティカル（分野）のリーフカテゴリに適用されます：Home & Garden、Business & Industrial、Electronics、Fashion、Motors、Jewelry & Watches、Lifestyles、Collectibles。eBay Refurbished Program をサポートするすべてのリーフカテゴリでは、Seller Refurbished（ID 2500）の商品コンディションは使用できなくなり、セラーはコンディションをUsed（ID 3000）に変更するか、適用可能で資格がある場合は新しい整備済みコンディションのいずれかを使用する必要があります。

eBay Refurbished Program に関する詳細は、eBay Refurbished Program セラーセンターページで確認できます。これには、申請へのリンクや、2025年だけでプログラムの一部となった500以上のリーフカテゴリを含むダウンロード可能なスプレッドシートへのリンクが含まれます。Metadata API の getItemConditionPolicies メソッドを使用して、eBay Refurbished Program でサポートされているすべてのリーフカテゴリを取得できます。

セラー向けの新しい自動フィードバック機能

フィードバックスコアと肯定的なフィードバックの割合は、セラーにとって非常に重要な指標です。ほとんどの取引は順調に進み、セラーは素晴らしいサービスを提供しますが、すべてのバイヤーがフィードバックを提供することでその素晴らしいサービスを認めるわけではありません。2025年9月3日より、以下の基準を満たす成功した販売取引について、セラーは自動的にフィードバックを受け取るようになります。

  • 追跡付きで注文を発送し、予定配送範囲内に到着した
  • バイヤーが問題を報告していない
  • バイヤーがフィードバックを残していない

通常、バイヤーがまだフィードバックを残していない場合、販売取引から7日後にeBayから自動的に肯定的なフィードバックがセラーに送信されます。自動フィードバックが既に行われた後にバイヤーが肯定的なフィードバックを残した場合、バイヤーのフィードバックコメントがeBayのフィードバックコメントを置き換えます。各販売取引について、バイヤーはeBayがセラーに自動フィードバックを残したことを知らないため、フィードバックを残す意欲を削がれることはありません。

APIアップデート (API updates)

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

注文APIでのマルチウェアハウス機能のサポート

複数の倉庫を持ち、eBayのマルチウェアハウス機能を実装しているセラーのために、Fulfillment API および Trading API の注文管理メソッドは、バイヤーの場所に最も近い倉庫の場所を返すようになりました。

どの出品APIを使用するかに関わらず、Inventory API の createInventoryLocation メソッドを使用して FULFILLMENT_CENTER ロケーション（完全な住所付き）を作成し、その後 createOrReplaceSkuLocationMapping メソッドを使用して複数の FULFILLMENT_CENTER ロケーションを出品にマッピングする必要があります。createOrReplaceSkuLocationMapping メソッドはSKUレベルで FULFILLMENT_CENTER ロケーションをマッピングするため、複数SKU出品の場合は createOrReplaceSkuLocationMapping メソッドを複数回使用する必要があることに注意してください。Inventory API または Trading API のどちらを使用する場合でも、複数の倉庫を出品に関連付けるプロセスの詳細については、2024年第4四半期ニュースレター を参照してください。

マルチウェアハウス機能で設定された出品の場合、バイヤーに最も近い FULFILLMENT_CENTER ロケーションの住所は、Fulfillment API の getOrder および getOrders メソッドでは itemLocation コンテナで返され、Trading API の GetOrders、GetSellerTransactions、および GetItemTransactions 呼び出しでは Item.Location フィールドで返されます。

Fulfillment APIでのeBay Guaranteed Fitサポート

eBay US Motors P&A出品向けの eBay Guaranteed Fit プログラムの一環として、バイヤーの車両アスペクトは、Fulfillment API の getOrder および getOrders メソッドの compatibilityProperties 配列で返されます。eBay Guaranteed Fit プログラムを利用するために、バイヤーは車両の年式、メーカー、モデル、トリム（グレード）を提供することが期待されており、これらのアスペクトは、セラーが車両と部品またはアクセサリーとの適合性を検証できるように注文詳細で返されます。

注文APIでMotors/Caramelチェックアウト詳細を返却

eBayの Secure Purchase プログラムを使用してeBay US Motorsで購入された自動車の場合、この購入の詳細は、Trading API の GetOrders および GetItemTransactions の新しい MotorPurchase コンテナを通じて返されます。Secure Purchase を使用すると、バイヤーは自動車の残金を安全に支払い、融資や保険を簡単に取得でき、税金の支払いや車両所有権などのDMV関連タスクをeBayに代行させることさえできます。多数のFAQを含む詳細情報については、Secure Purchase トピックを参照してください。

FeedおよびMetadata APIでのCAFRとBEFRのサポート

eBayカナダ (https://www.cafr.ebay.ca/) および eBayベルギー (https://www.befr.ebay.be/) サイトのフランス語版が、Sell Feed API および Metadata API のすべてのメソッドでサポートされるようになりました。Sell Feed API を使用してこれらのeBayマーケットプレイスのいずれかで商品を出品/修正する場合でも、Metadata API を使用してこれらのeBayマーケットプレイスのいずれかから出品メタデータを取得する場合でも、以下のHTTPヘッダーを設定する必要があります。

  • eBayカナダ (フランス語) : X-EBAY-C-MARKETPLACE-ID ヘッダーを含めて値を EBAY_CA に設定し、Accept-Language ヘッダーを含めて値を fr-CA に設定します。
  • eBayベルギー (フランス語) : X-EBAY-C-MARKETPLACE-ID ヘッダーを含めて値を EBAY_BE に設定し、Accept-Language ヘッダーを含めて値を fr-BE に設定します。

Media APIで新しいドキュメントタイプをサポート

Media API の document リソースは、createDocument および createDocumentFromUrl メソッドにおいて、ACCESSIBILITY_INFORMATION を documentType 値としてサポートするようになりました。ACCESSIBILITY_INFORMATION ドキュメントタイプは、「製品のアクセシビリティ機能に関する詳細を提供し、障害を持つ個人や特別なニーズを持つ個人が使用できることを保証する」ドキュメントとして説明されています。

Promoted Listingキャンペーンレポートの更新

今四半期、Sell Marketing API のPromoted Listingレポートに対して以下の更新が行われました。

  • すべてのキャンペーン reportType 値について、dimensionKey 値が seller_keyword_id に設定されている場合、以下の annotationKeys 値が利用可能になります：
    • keyword_bid
    • keyword_status
  • すべてのキャンペーン reportType 値について、dimensionKey 値が campaign_id に設定されている場合、以下の annotationKeys 値が利用可能になります：
    • campaign_status
    • daily_budget (CPCキャンペーンのみ)
    • daily_budget_status (CPCキャンペーンのみ)
  • すべてのキャンペーン reportType 値について、dimensionKey 値が listing_id に設定されている場合、listing_status が新しくサポートされる annotationKeys 値となります。
  • reportType 値が CAMPAIGN_PERFORMANCE_REPORT に設定され、dimensionKey 値が campaign_id に設定されている場合、以下の annotationKeys 値が利用可能になります：
    • listing_strategy
    • budget_strategy
  • reportType 値が TRANSACTION_REPORT に設定されている場合、sales_type dimensionKey 値がCPCとCPSの両方の資金モデルで利用可能になりました。

Inventory Mapping APIの新しいリファレンスドキュメント

新しいGraphQL Inventory Mapping API 向けの新しいリファレンスドキュメント体験が完全に公開されました。このAPIは現在も一部のパートナーに制限されていることに注意してください。すでにこのAPIを使用している開発者の皆様におかれましては、新しいリファレンスドキュメントがInventory Mapping Playbookに取って代わり、Playbookはアーカイブされたことにご留意ください。

Browse API Itemメソッドにチャリティ詳細を追加

charityTerms コンテナが、getItem、getItembyLegacyId、および getItemsByItemGroup メソッドで返されるようになりました。この新しいコンテナが返されるためには、出品がチャリティ出品であり、fieldgroups 値の1つが CHARITY_DETAILS に設定されている必要があります。新しい charityTerms コンテナ内のチャリティ情報には、charityOrgId、name、donationPercentage、website、およびチャリティロゴ画像用の imageUrl が含まれます。

Notification APIに2つの新しいトピックを追加

Notification API に以下の2つの新しいトピックが追加されました。

  • BUYER_REQUESTED_PURCHASE_QUOTE: バイヤーが注文の支払いの前に注文の合計金額をリクエストした際に通知を受け取りたいセラーが購読できるトピックです。セラーは通常、注文合計がリクエストされた際にこのバイヤーに請求書を送信します。
  • LISTING_PREVIEW_CREATION_TASK_STATUS: Inventory Mapping API を通じて出品プレビューを生成させているセラーが購読できるトピックで、出品プレビュータスクが完了するたびに送信されます。
    注: この通知トピックは、制限付きの Inventory Mapping API にアクセスできる開発者のみが使用できます。

eBay Delivery International Shipping APIの強化

eBay Delivery International Shipping API が強化され、4つの新しいメソッドを持つ新しい bundle リソースが追加されました。セラーはこれらのメソッドを使用して、注文内の複数のパッケージのバンドルを作成、バンドルの取得、バンドルのキャンセル、またはバンドルラベルの取得を行うことができます。ConsignTypeEnum タイプも4つの新しい列挙値で更新されました。

注: このAPIは、大中華圏を拠点とするeBayセラーの配送とフルフィルメントをサポートする一部の開発者に制限されています。

新しいBest OfferステータスとしてSellerAccept列挙値を追加

Trading API の BestOfferStatusCodeType に、新しい SellerAccept 列挙値が追加されました。GetBestOffers レスポンスにおいて、この新しい列挙値は、セラーがバイヤーのオファーを受け入れたが、バイヤーの支払いがまだ行われていないことを示すために返されます。バイヤーが支払いを完了すると、ステータスは Accepted に変わります。

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

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

  • Trading API の ExtendSiteHostedPictures 呼び出し
  • Product API の findCompatibilitiesBySpecification 呼び出し

さらに、Compliance API における ASPECTS_ADOPTION コンプライアンスタイプのサポート、および Trading API の UploadSiteHostedPictures 呼び出しにおける ExtensionInDays フィールドのサポートが終了しました。

第3四半期に以下のAPIが非推奨（Deprecated）としてマークされました。

極めて低い使用率または使用されていないため、以下の Platform Notificationイベントタイプ が提供終了となり、ユーザーはこれらのイベントを購読できなくなりました：AccountSuspended, BuyerNoShow, AccountSummary, EBNOrderCanceled, EBNOrderPickedUp, EmailAddressChanged, PasswordChanged, PasswordHintChanged, および PaymentDetailChanged。

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

トップに戻る