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

原文リンク: https://developer.ebay.com/updates/newsletter/q1_2025

プログラムニュース

皆様お元気でお過ごしでしょうか。この機会に、直近の四半期 (2025 年 1 月 - 3 月) の eBay 開発者プログラムの最新情報をいくつかご紹介します。

新しい販売 API ガイドが利用可能になりました

最近、販売アプリページからアクセスできる 6 つの新しい販売 API ガイドをリリースしました。各ガイドは詳細なユースケースで構成され、使いやすさと理解度を高めるために設計された一貫したテンプレートに従っています。利用可能なガイドは次のとおりです。

アパレルカテゴリーの新しい中古品の条件

中古アパレルのリーフカテゴリーで、3種類の中古品コンディション（「中古 - 普通」（ID 3010）、「中古 - 良い」（ID 3000）、「中古 - 非常に良い」（ID 2990））が新たにサポートされるようになりました。この変更は全世界で展開されています。

状態 ID 3000 は新しいものではありませんが、影響を受けるカテゴリの状態の説明が「_中古_」から「_中古 - 良好_」に変更されました。 getItemAspectsForCategory メソッドと fetchItemAspects メソッドが更新され、新しい条件と再利用された条件 ID 3000 が表示されるようになりました。Inventory API の 2 つの新しい条件をサポートするために、PRE_OWNED_EXCELLENT と PRE_OWNED_FAIR が ConditionEnum タイプに値として追加されました。

API の更新

この四半期には、API に対して次の更新が行われました。

Media API の新しい createDocumentFromUrl メソッド

Media API が新しい createDocumentFromUrl メソッドで強化されました。このメソッドを使用すると、指定された URL からドキュメントをダウンロードでき、ダウンロードに成功すると、eBay がそのドキュメントをセラーのアカウントにアップロードします。このメソッドのリクエストでは、ユーザーは documentType 値を指定し、languages 配列を使用してドキュメントの言語を指定する必要があります。

createDocumentFromUrl呼び出しが成功すると、documentIdフィールドが返され、この値はInventory APIのdocuments.documentIdフィールド、またはDocument.DocumentIDフィールドで使用されます。 Trading API を使用して、出品にドキュメントを添付します。

メタデータ API の 6 つの新しいメソッド

メタデータAPIに最近6つのメソッドが追加されました。これらのメソッドは、指定されたeBayマーケットプレイスにおける様々なリーフカテゴリレベルのメタデータを提供します。これら6つのエンドポイントはすべて、1回の呼び出しでマーケットプレイス上のすべてのリーフカテゴリのメタデータを提供できます。また、ユーザーは最大50個のリーフカテゴリを含む包括的なフィルターを設定することもできます。これらのエンドポイントについて、以下で簡単に説明します。

getListingTypePolicies: カテゴリがサポートする出品タイプと出品期間を取得します。
getCategoryPolicies: カテゴリでサポートされているオフライン支払い方法、カテゴリのオークション最低落札価格、カテゴリが即時支払いをサポートしているかどうかを示すブール値など、さまざまなメタデータを取得します。
getClassifiedAdPolicies: カテゴリが分類広告をサポートしているかどうかなど、分類広告出品に関するメタデータを取得します。
getMotorsListingPolicies: 自動車およびパーツとアクセサリの出品に関連するメタデータを取得します。
getShippingPolicies: 最大定額送料や、カテゴリがグローバル配送プログラム (英国のみ) または eBay 国際配送 (米国のみ) をサポートしているかどうかを示すブール値など、配送に関連するメタデータを取得します。
getSiteVisibilityPolicies: カテゴリが出品マーケットプレイス以外の他の eBay マーケットプレイスでアクティブなサイトの可視性をサポートしているかどうかを示すメタデータを取得します。

GPSR 連絡先のオプションとして連絡先 URL が追加されました

次のコンテナーに、GPSR 連絡先オプションとして連絡先 URL フィールドが追加されました:

Inventory API コンテナーと regulatory.responsiblePersons 配列。
Trading API の Regulatory.Manufacturer コンテナと ResponsiblePersons.ResponsiblePerson コンテナ。

GPSR 連絡先情報が必要なカテゴリーの場合、販売者は、電子メールアドレス、電話番号、または連絡先 URL のうち 1 つ以上を提供するオプションがあります。

参照 API の更新

Q1 の 参照 API、getItemByLegacyId、getItems、および getItemsByItemGroup メソッドに次の変更が加えられました。

manufacturer コンテナと responsiblePersons 配列に contactUrl フィールドが追加されました。出品者は、メールアドレスと電話番号に加えて、GPSR 連絡先の連絡先 URL を出品情報に記載することもできます。
「get item」メソッドのリクエストに quantity クエリパラメータが追加されました。このパラメータを使用すると、ユーザーは 1 より大きい数量を指定でき、指定した数量が shippingOptions コンテナで返される配送料に反映されます。
販売者が商品の即時支払いを要求しているかどうかを示す immediatePay フィールドが追加されました。

英国の新しい購入者保護制度に対応したAPIアップデート

eBay UKマーケットプレイスで個人販売者から商品を購入する購入者には、購入者保護手数料が課金されるようになりました。この新しい手数料と、この手数料に課される税金を表示するために、注文関連のAPIに以下の変更が加えられました。

フルフィルメントAPI: getOrderとgetOrdersに新しいebayCollectedCharges.charges配列が追加されました。この配列には、購入者保護手数料とその手数料に対する税金が加算された金額が表示されます。
Trading API の GetOrders: この呼び出しには次の変更が加えられました: 注文レベルで追加の Payment コンテナが返され、注文内の1つ以上の明細項目の購入者保護手数料と手数料に適用される税金が表示されます。追加の Payment コンテナには、販売者ではなくeBayが Payee として表示されます。
GetItemTransactions および GetSellerTransactions: これらの呼び出しには次の変更が加えられました。購入者保護手数料と注文明細の手数料に対して適用される税金を表示するために、追加の Payment コンテナーがトランザクションレベルで返されます。追加の 支払い コンテナーには、販売者の代わりに eBay が 受取人 として表示されます。
Buy Order API v1：新しいBUYER_PROTECTION値がChargeTypeEnumに追加されました。該当する場合、eBayは購入者保護をaddonServicesオブジェクトとして追加します。 serviceType の値は BUYER_PROTECTION になり、購入者保護料金は serviceFee コンテナに表示され、その料金に対する税金は serviceTax コンテナに表示されます。

英国の購入者保護手数料に関する詳細は、購入者保護手数料のヘルプトピックをご覧ください。

2つの新しい製品安全ピクトグラムが追加されました

eBayは現在、2つの新しい製品安全ピクトグラム（_CEマーク_と_コイン型電池を含む_）をサポートしています。getProductSafetyLabelsメソッドが更新され、これらの新しいピクトグラムが返されるようになりました。商品安全ピクトグラムは、Item.Regulatory.ProductSafety.Pictogramコンテナ（Trading API）またはregulatory.productSafetyコンテナ（Inventory API）を使用して出品リストに追加できます。

3つの新しい税識別タイプが追加されました

Trading API と Fulfillment API の注文管理呼び出しに、次の 3 つの新しい税識別子タイプが追加されました。

CURP: この値は、税 ID タイプが CURP 番号であることを示します。
RFC: この値は、税 ID タイプが RFC 番号であることを示します。
RUT: この値は、税 ID タイプが税務登録番号であることを示します。

eBay 配送国際配送 API

eBay 配送国際配送 API の初期バージョンは、第 1 四半期にリリースされました。この API を使用すると、中華圏を拠点とする eBay セラーは eBay 注文の配送を作成、管理、追跡できます。これは、中華圏を拠点とするセラーのみが利用できる制限付き API であり、特別な OAuth スコープが必要です。

プロモーションフィードタイプに新しいフィールドが追加されました

promotionSourceType フィールドが プロモーション フィードタイプで返されるようになりました。このフィールドは、割引が販売者によって独自に作成されたか、または複数の販売者による割引イベントのために eBay によって作成されたかを示します。

eBay の廃止と廃止に関する最新情報

Shopping API と Finding API はどちらも第1四半期に廃止されました。これらのAPIを以前ご利用だった方は、eBay出品情報の検索にBrowse APIの代替手段をご検討ください。以下のTrading APIは第1四半期に廃止されました。

GetBestOffers
GetBidderList
GetMyMessages
GetUserDisputes

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