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

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

プログラムニュース

皆様お元気でいらっしゃることを願っています。この機会に、eBay 開発者プログラムで過去四半期 (2023 年 10 月 - 12 月) に発生したいくつかの更新情報をお知らせしたいと思います。

開発者アンケート

この秋の開発者アンケートにご参加いただいた皆様、ありがとうございました。皆様からのフィードバックは私たちにとって非常に貴重であり、問題に対処し、開発者プログラムをあらゆる面で改善するのに役立ちます。近い将来、さらに多くのアンケートが実施される予定ですので、ご期待ください。アンケートへの招待状は、各開発者アカウントに登録されている連絡先メールアドレスに送信されます。

トレーディングカードの状態評価の義務

新規出品に対するコンディショングレーディングの義務付けは、第 4 四半期に発効しました。非スポーツトレーディングカードシングル (183050)、コレクタブルカードゲーム個別カード (183454)、スポーツトレーディングカードシングル (261328) カテゴリのすべての新規トレーディングカード出品のアイテムコンディションは、グレーディング済み(コンディション ID 2750) または グレーディングなし (コンディション ID 4000) のいずれかである必要があり、その他のアイテムコンディションは受け入れられません。これらのアイテムコンディションが該当するコンディション記述子メタデータとともに使用されていない場合、次の操作は失敗します。

トレーディング API 呼び出し: AddItem、AddFixedPriceItem、AddItems、RelistItem、RelistFixedPriceItem、VerifyAddItem、 VerifyRelistItem、および VerifyFixedPriceItem
Inventory API メソッド: bulkPublishOffer、publishOffer、および publishOfferByInventoryItemGroup
Sell Feed API アップロードフィードタイプ: LMS_ADD_ITEM、LMS_ADD_FIXED_PRICE_ITEM、LMS_RELIST_ITEM、LMS_RELIST_FIXED_PRICE_ITEM、LMS_VERIFY_ADD_ITEM、および LMS_VERIFY_ADD_FIXED_PRICE_ITEM

2024 年 1 月 22 日 以降、アクティブなトレーディングカードのリストは、グレーディング済み (コンディション ID 2750) または グレーディングなし (コンディション ID 4000) のアイテムコンディションでリストを更新し、該当するコンディション記述子メタデータを追加しない限り、修正できなくなります。これらのアイテム条件が、該当する条件記述子メタデータとともに使用されていない場合、次の操作は失敗します。

Trading API 呼び出し: ReviseItem および ReviseFixedPriceItem
Inventory API メソッド: updateOffer
Sell Feed API アップロードフィードタイプ: LMS_REVISE_ITEMおよび LMS_REVISE_FIXED_PRICE_ITEM

コンディション記述子メタデータは、Item.ItemSpecifics コンテナ (Trading API) または conditionDescriptors 配列 (Inventory API) を通じて提供されます。グレーディング済み カードの場合はプロのグレーダーとグレードが必要で、グレーディングなし カードの場合はカードコンディションが必要です。メタデータ API の getItemConditionPolicies メソッドを使用して、条件記述子の名前と値のペアを提供するために使用される数値識別子を取得する必要があります。

改訂されたトレーディングコールの作成ガイド

改訂されたトレーディング API 呼び出しガイドが公開されました。ガイドの外観が近代化され、開発者ポータルの他のガイドと同じスタイル、ナビゲーション、検索が使用されています。

API の更新

過去数か月間に、API に次の更新が行われました。

オフサイトの Promoted Listings 広告に対する API のサポート

Sell Marketing API が強化され、オフサイトの Promoted Listings 広告がサポートされるようになりました。オフサイトの広告は主要な検索エンジンに表示され、クリック単価のみがサポートされている資金調達モデルです。オフサイトの広告キャンペーンは、通常の「オンサイト」PLA キャンペーンと同じ方法で作成されます。オフサイトの広告の有効化に関連する主要なスキーマの変更は次のとおりです。

PLA キャンペーンを ON_SITE または OFF_SITE として指定するために、channels フィールドが createCampaign メソッドに追加されました。
オフサイト広告の Promoted Listings レポートをサポートするために、channels フィールドが createReportTask メソッドに追加されました。
販売者が最適な 1 日の予算を決定できるように、新しい suggestBudget メソッドが追加されました。

この機能はすべての販売者が利用できるわけではありませんが、Account API v1のgetAdvertisingEligibilityメソッドを使用すると、販売者がオフサイト広告の対象かどうかを確認できます。このメソッドのレスポンスでは、programType の値は OFFSITE_ADS として表示され、status の値は ELIGIBLE または INELIGIBLE として表示されます。現在、販売者は一度に 1 つのアクティブなオフサイト広告キャンペーンに制限されています。オフサイト広告キャンペーンの詳細については、オフサイト広告統合ガイドのトピックを参照してください。

PLA キャンペーンの新しい動的入札率

Sell Marketing API は、PLA キャンペーンのキーワードに対して動的入札レートを使用する機能をサポートするようになりました。動的入札レートを使用すると、セラーは eBay がキーワード入札レートを毎日設定および調整することに同意することになります。動的入札レートの有効化に関連する主なスキーマ変更は次のとおりです。

biddingStrategy フィールドが createCampaign メソッドに追加され、動的入札を有効にする値として DYNAMIC が指定されます。
updateBiddingStrategy メソッドは、入札戦略を FIXED から DYNAMIC に、またはその逆に変更するために作成されました。

PL レポートメタデータメソッドにフィルターが追加されました

2 つの新しいクエリパラメータ funding_model と channel が getReportMetadata と getReportMetadataForReportType メソッドに追加されました。これら 2 つの新しいフィルタを使用すると、ユーザーは資金調達モデルとチャネルに基づいて特定のメタデータのみを取得できます。これらのフィルターを使用して、売上単価レポートのメタデータ、オンサイトのクリック単価レポートのメタデータ、またはオフサイトのクリック単価レポートのメタデータのみを取得できます。

Finances API で返される慈善団体および税金の情報

Finances API に次の 2 つの更新が加えられました。

donations コンテナが getTransactions レスポンスに追加されました。
taxes コンテナが getTransactions レスポンスに追加されました。

新しい userId フィールドが Browse API に追加されました。

新しい seller.userId フィールドが Browse API の getItem、getItemByLegacyId、および getItemsByItemGroup メソッドの応答に追加されました。この新しい ID は、eBay ユーザー名のように変更できない、販売者の不変 ID です。

Order API に新しい itemOnHold ブール値が追加されました

新しい itemOnHold ブールフィールドが、Order V2 API レスポンスと Order V1 API の getPurchaseOrder レスポンスに追加されました。このフィールドは、eBay ポリシー違反により、ラインアイテムに関連付けられた出品が保留になっている場合に true として返されます。

getTrafficReport に追加された新しいメトリック

Sell Analytics API の getTrafficReport メソッドに、新しい指標 TOTAL_IMPRESSION_TOTAL が追加されました。この値は、セラーの出品が任意のページまたはフローに表示された合計回数であり、セラーハブのパフォーマンス/トラフィックページの値と一致します。

アクションされたリスティングの API の変更

eBay 出品データを取得する多数の「GET」操作が更新され、特定の出品が非表示になっていることを示す警告やフラグが表示されるようになりました。

API	操作	スキーマおよび/または動作の変更
取引	GetItem	新しい Item.HideFromSearch ブール値。
在庫	getOffer / getOffers	新しい listing.listingOnHold ブール値。
フルフィルメント	getOrder / getOrders	リストのアイテム ID 値は lineItems.title フィールドに表示されます。

eBay の廃止および廃止に関する最新情報

以下の API/メソッド/フィールドは、最近廃止されると発表されました。詳細については、廃止ステータスページを参照してください。

GetOrders 呼び出しは非推奨となり、2024 年 1 月 31 日 に廃止される予定です。
Trading API の多数の応答フィールドは非推奨となり、2024 年 1 月 31 日 に廃止されます。
GetSellerDashboard 呼び出しは非推奨であり、2024 年 4 月 2 日 に廃止される予定です。
suppressViolation メソッドは非推奨となり、2024 年 1 月 30 日 に廃止される予定です。
GetSuggestedCategories 呼び出しは非推奨となり、2024 年 7 月 1 日 に廃止される予定です。

皆様にとって素晴らしい一年であったことを願っております。2024 年にコミュニティの皆様と協力できることを楽しみにしています。