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

1. 商品はeBay Motorsに固定価格設定で出品されており、物理的に米国内に所在しています。
2. 商品は米国の購入者に発送されます。
3. 商品の価格は10ドル以上です。
4. 商品の状態は「新品」または「その他」です。

このポリシーの詳細については、「P&A返品ポリシー」セラーセンターのニューストピックをご覧ください。

ファッション中古品の商品状態が拡大

「中古」商品の3つの状態が、レディースハンドバッグ、アクセサリー、ジュエリー、靴を含む159のリーフカテゴリーに拡大されます。これらのカテゴリーにおけるこれらの状態のサポートは、オーストラリアでは7月23日より、eBayマーケットプレイス全体では8月5日より開始されます。
「中古」商品の状態に使用する3つの状態ID（取引APIで使用）と状態列挙型（在庫APIで使用）は以下のとおりです。

メタデータ API の getItemConditionPolicies メソッドのアイテム状態メタデータが、新しくサポートされたリーフ カテゴリに合わせて更新されました。

1. 商品の状態が「オープンボックス」に設定されている（取引APIではコンディションID 1500、在庫APIではNEW_OTHER）
2. 送料無料
3. 30日間返品無料

1. 「説明と異なる商品」の割合が4%未満
2. 「商品未受領」の割合が1%未満
3. 3ヶ月ごとに最低25件のオープンボックス取引

ニューメキシコ州の輸入規制
2025年4月のセラーアップデートで発表されたとおり、メキシコへ商品を発送するセラーは、メキシコへの発送を担当する配送業者に以下の情報を提供する必要があります。

1. 受取人の氏名
2. 受取人のメールアドレス
3. 受取人の電話番号
4. 受取人のメキシコ納税者番号（RFC）または国民ID（CURP）。メキシコ在住の購入者は、これらの納税者番号のいずれかを提供する必要があり、この納税者番号情報は注文レポートに記載されています。
5. 商品の詳細な説明

API アップデート
今四半期、API に以下のアップデートが行われました。

Media API に新しい画像メソッドが追加されました
eBay 画像サービス (EPS) 画像をセラーアカウントにアップロードできるように、Media API に以下の 3 つの新しいメソッドを含む新しい画像リソースが追加されました。

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

メタデータ API に、特定の eBay マーケットプレイスで使用されるデフォルト通貨を返す新しい getCurrencies メソッドが追加されました。
さらに、getCategoryPolicies メソッドに eanSupport、isbnSupport、upcSupport フィールドが追加されました。これらの 3 つのフィールドは、eBay マーケットプレイスのリーフカテゴリの出品がそれぞれ EAN、ISBN、UPC 値をサポートしているか、あるいは必須であるかを示します。
最後に、getMotorsListingPolicies メソッドが以下の 2 つのフィールドで更新されました。

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

Buy Feed v1 API に新しい CBT フィードタイプが追加されました
Buy Feed v1 API に、新しい越境取引フィードタイプ「CBT_ITEM_ALL_ACTIVE」が追加されました。このフィードタイプを使用すると、主要な eBay マーケットプレイス（米国、英国、ドイツなど）から取得した出品が、ダウンロードされたフィードファイルに含まれるようになります。現在、このフィードタイプは eBay Austria と eBay Ireland のマーケットプレイスでサポートされています。
TSV gzip ファイルを返す他のフィードタイプとは異なり、CBT_ITEM_ALL_ACTIVE フィードタイプのファイルは Avro 形式で返されます。
新しい CBT_ITEM_ALL_ACTIVE フィードタイプをサポートするために、以下のスキーマ変更が導入されました。

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

updateCampaignBudget メソッドの動作変更
Sell マーケティング API の updateCampaignBudget メソッドに 2 つの動作変更が実装されました。updateCampaignBudget メソッドは、Promoted LISTing Priority キャンペーンの 1 日あたりの予算を更新するために使用されます。
updateCampaignBudget メソッドは、1 日あたりキャンペーンごとに最大 15 回使用して、1 日のクリック単価予算を更新できます。警告メッセージが2つ追加されました。1つは14回目の更新時、もう1つは15回目（最終更新時）に表示されます。16回目の更新ではブロックエラーが発生し、ユーザーはキャンペーンの次回更新を翌暦日まで待つ必要があります。
この方法を使用する場合は、1日の予算を少なくとも0.50米ドル増減する必要があります。そうでない場合、エラーが発生します。

共通充電器指令 フェーズ2
2024年末に発効したEUの共通充電器指令（CCD）に基づき、EUおよび北アイルランドで特定の充電式機器（携帯電子機器など）を出品するセラーは、商品情報を通じて以下の情報を提供することが求められています。

1. 商品に充電器が付属しているかどうか
2. 商品の充電電力範囲
3. 商品がUSB-PDに対応しているかどうか

省エネラベルの更新
EU加盟国および北アイルランドにおける省エネラベル（EEK）の要件が、スマートフォンおよびタブレットのカテゴリーにも適用されるようになりました。
スマートフォンおよびタブレットのEEK情報の指定方法は、家電製品のカテゴリーと同様です。EEK情報の指定方法の詳細については、「省エネ情報」のトピックをご覧ください。
メタデータAPIのgetRegulatoryPoliciesメソッドを使用すると、EEK情報をサポート、推奨、または必須とするカテゴリーを確認できます。
Finances APIの更新
Finances APIに以下の3つの更新が行われました。

1. 5年間の期限制限：getPayoutsメソッドおよびgetPayoutメソッドは、5年以上前の販売者への支払いを取得できなくなりました。また、getPayoutSummaryメソッドで返される件数と金額には、5年以上前の販売者への支払いは考慮されません。getTransactionsメソッドおよびgetTransferメソッドは、5年以上前の取引を取得できなくなりました。また、getTransactionSummaryメソッドで返される件数と金額には、5年以上前の取引は考慮されません。
2. 36か月の日付範囲制約：getPayouts、getPayoutSummary、getTransactions、getTransactionSummaryメソッドにおける日付範囲フィルター。
3. 新しいREGULATORY_OPERATING_FEE：該当する場合、この新しい手数料は、特定のマーケットプレイスの規制要件に関連する費用を賄うためにセラーに請求されます。この手数料の詳細については、eBay UKのヘルプトピックをご覧ください。

1. 商品 API の addProducts、findProductsByCompatibility、getProductSubmissions の各呼び出し
2. 商品メタデータ API の getProductMetadataBulk、getProductSearchDataVersion、getProductSearchNames、getProductSearchValues、getProductSearchValuesBulk の各呼び出し
3. 取引 API の GetCategoryMappings の各呼び出し