eBay 開発者プログラム 2024 年第 2 四半期ニュースレター
プログラム ニュース
皆様お元気ですか。この機会に、eBay Developers Program で過去四半期 (2024 年 4 月 - 6 月) に発生した更新情報をお知らせします。
新しい GPSR スキーマが 7 月にリリース予定
一般製品安全規則 (GPSR) は 2024 年 12 月 13 日 に発効し、7 月中に eBay はすべての GPSR 要件をサポートする新しい API エンドポイントと要素をリリースします。GPSR 要件の詳細については、GPSR Seller Center ページ を参照してください。次のセクションでは、GPSR 要件と、これらの要件をサポートする新しい API エンドポイントとスキーマについてまとめています。
製品メーカーおよび責任者
2024 年 12 月 13 日 までに、EU 加盟国または北アイルランドで事業を展開している、またはこれらの国に商品を発送している販売者は、商品メーカーの連絡先の詳細を提供する必要があります。販売者は、メーカーの郵送先住所とメールアドレスを提供する必要があります。この情報の提供をサポートするために、Trading API の AddItem 呼び出しファミリーと、Inventory API のオファー関連のメソッドに Manufacturer コンテナが追加されます。商品メーカーが EU 加盟国に拠点を置いていない場合は、販売者は EU または北アイルランドに拠点を置く責任者の少なくとも 1 人の郵送先住所とメールアドレスも提供する必要があります。この情報の提供をサポートするために、Trading API の AddItem 呼び出しファミリーと、Inventory API のオファー関連のメソッドに Responsible Persons 配列が追加されます。
メタデータ API に新しい getRegulatoryPolicies メソッドが追加され、特定のマーケットプレイスにカテゴリーを出品するために メーカー や 責任者 が推奨されるか必須であるかが示されます。新しい getRegulatoryPolicies メソッドは、特定のマーケットプレイスにカテゴリーを出品するために危険物ラベル、エネルギー効率ラベル、および製品安全ラベルが推奨されるか必須であるかも示します。
Economic Operator コンテナの廃止
メーカー コンテナと 責任者 配列の導入により、取引 API の EconomicOperator コンテナと 在庫 API の economicOperator コンテナは廃止されます。開発者/販売者は、代わりに製造元 コンテナおよび/または責任者 配列を使用することが求められます。
製品安全の絵文字とステートメント
GPSR のもう 1 つの要件は、該当する場合に製品安全の絵文字とステートメントを提供することです。これには、子供が窒息する危険がある小さな部品を含むおもちゃやゲームなどの製品が含まれます。この情報の提供をサポートするために、Trading API の AddItem ファミリーの呼び出しと、Inventory API のオファー関連のメソッドに、製品安全 コンテナーが追加されます。この 製品安全 コンテナーには、出品に 1 つ以上の絵文字とステートメントを追加するための 絵文字 コンテナーと ステートメント コンテナーが含まれます。新しい getProductSafetyLabels メソッドが Metadata API に追加され、さまざまな eBay マーケットプレイスのさまざまな出品カテゴリに関連付けられた特定の絵文字とステートメントに関連付けられた英数字 ID を返します。これらの英数字IDは、Trading APIおよびInventory APIを通じてピクトグラムやステートメントを出品に追加するときに必要になります。
出品への規制文書の追加
Media API に 3 つの新しいメソッドが追加され、販売者のアカウントへの規制文書のアップロードがサポートされます。販売者は、Trading API の AddItem ファミリーの呼び出しで新しい Documents 配列を使用し、Inventory API のオファー関連のメソッドを使用して、出品に規制文書を追加します。販売者は、新しい Media API エンドポイントを使用して文書が正常にアップロードされると作成される eBay 生成の文書 ID を提供する必要があります。規制文書の種類には、次のものが含まれますが、これらに限定されません。
- ユーザー ガイドまたはマニュアル
- トラブルシューティング ガイド
- インストール手順
- 安全データシート
新しい Media API エンドポイントでは、1 つの文書で複数の言語がサポートされます。
マーケティング関連製品のブランド変更
7 月に、eBay マーケティング関連製品のブランド名が変更されます。これには、プロモート リスト キャンペーンとアイテム プロモーションが含まれます。
プロモート リスト の場合:
- プロモート リスト アドバンス は、優先キャンペーン戦略によるプロモート リスト と呼ばれます。
- プロモート リスト スタンダード は、一般キャンペーン戦略によるプロモート リスト と呼ばれます。
- オフサイト広告 は、プロモート オフサイト と呼ばれます。
アイテム プロモーション は、セラー ハブと eBay ヘルプ ページで割引 と呼ばれます。新しい製品名を反映するためにフィールドの説明を微調整する以外、これらの名前の変更は Sell Marketing API のエンドポイントには影響しません。マーケティングおよびプロモーション ツールの変更と機能強化の詳細については、2024 Summer Seller Update の記事をご覧ください。
eBay Vault が PSA Vault に移行中
Professional Sports Authenticator (PSA) とのパートナーシップの一環として、eBay Vault は PSA Vault に移行しています。名前の変更と PSA による管理以外、変更は最小限にとどまると予想されており、変更がある場合はお知らせします。移行の詳細と FAQ については、PSA Vault の概要と FAQ を参照してください。PSA Vault の仕組みに関する最新情報については、PSA Vault と eBay の連携方法 ヘルプ ページを参照してください。
カテゴリ ID 173651 でカタログ製品が必須に
eBay Motors US の場合、Auto Performance Tuning Devices Software カテゴリ (ID 173651) の出品には eBay カタログ製品が必要です。このカテゴリで eBay カタログ製品を必須にすると、違法な排出ガス制御無効化デバイスの出品を排除するのに役立ちます。詳細については、eBay の 排出制御無効化デバイス ポリシー を参照してください。
取引 API では、アイテムの追加/修正呼び出しの ProductListingDetails.ProductReferenceID フィールドを介して eBay 製品 ID (ePID) を渡すことができます。在庫 API では、在庫アイテム オブジェクトの product.epid フィールドを介して ePID を渡すことができます。
トランザクション ID の変更
これまで、レガシー API では、オークション出品で発生する販売は 1 件だけであるため、オークション出品から生成された販売のトランザクション ID 値は '0' でした。7 月より、オークション出品に対して 0 以外のトランザクション ID が返されるようになります。この変更により、すべての販売形式でトランザクション ID の一貫性が保たれ、最新の API への移行が容易になります。開発者は、アプリケーションがこの変更を問題なく処理できることを確認する必要があります。
API の更新
この四半期に API に次の更新が行われました。
Sell Marketing API の更新
- スマート ターゲティングのコンセプトは、Promoted Listings Advanced (PLA) キャンペーンで導入されました。
- オークション出品を、Promoted LIsting Standard キャンペーンの一部として追加できるようになりました。
Buy Feed v1 API の新しい PROMOTION フィード
Buy Feed v1 API の消費者向けに、新しい PROMOTION フィードが利用できるようになりました。このフィード タイプは、アクティブなアイテム プロモーションの詳細と、各プロモーションの一部であるアイテムのリストを提供します。
Buy API が PL アフィリエイト リンクをサポートするようになりました
Browse API と Buy Feed Beta API が更新され、ポーランド マーケットプレイスの eBay パートナー ネットワーク (ePN) アフィリエイト リンクが返されるようになりました。
Catalog API はイタリアで有効になっています
カタログ API がイタリアのマーケットプレイスで有効になりました。イタリアのマーケットプレイスを検索するには、ユーザーは必須の X-EBAY-C-MARKETPLACE-ID ヘッダーの値を EBAY_IT に設定する必要があります。
注文に対する新しい規制運営手数料
英国、オーストリア、ベルギー、フランス、イタリア、アイルランド、オランダ、ポーランド、スペイン、スイスのすべての注文に対して、新しい規制運営手数料が追加されました。この手数料は、Finances API と Trading API に表示されます。
ビデオの保存期間が 30 日に短縮されました
出品者のアカウントにアップロードされた動画の保存期間が 365 日から 30 日に短縮されました。この保存期間は、現在アクティブな出品に関連付けられていない動画にのみ適用されます。
eBay の廃止および廃止に関する更新
以下の API/メソッド/フィールドは廃止されており、廃止される予定です。詳細については、廃止ステータス ページを参照してください。
- GetSuggestedCategories 呼び出しは非推奨であり、2024 年 7 月 1 日 に廃止される予定です。
- Listing Recommendation API は非推奨であり、2024 年 7 月 31 日 に廃止される予定です。
- ProductInfo および SMSSubscription コンテナーは非推奨であり、2024 年 8 月 に廃止される予定です。
- GetCategorySuggestions、GetVeROReasonCodeDetails、GetVeROReportStatus、VeROReportItems 呼び出しは非推奨となり、2025 年 1 月 に廃止されます。
- Finding API と Shopping API は非推奨となり、2025 年 2 月 5 日 に廃止されます。
GetSellerDashboard 呼び出しは、2024 年 4 月 2 日 に廃止されました。
皆様にとって素晴らしい上半期であったことを願っており、2024 年の残りの期間もコミュニティと連携して作業できることを楽しみにしています。