その他のAPI

その他の API ガイド

概要

その他の API を活用することで、セラーは出品機能を強化し、eBay のポリシーを遵守しつつ、セラーとバイヤー双方のエクスペリエンスを向上させることができます。これらの API は、商品詳細をグローバルに翻訳するツール、出品が基準を満たしているかどうかの確認、広告キャンペーンの最適化、ユーザープロファイルへの安全なアクセスなどを提供します。さらに、オファーの管理、バイヤーの関心の追跡、知的財産侵害の報告、および中華圏向けの国際物流をサポートする API も含まれています。

API のユースケース

出品タイトルと説明の翻訳
- サポートされている言語
出品のポリシー遵守状況の確認
ベストオファー、セカンドチャンスオファー、セールスリードの管理
知的財産権侵害の確認
中華圏における配送とフルフィルメントの管理
セラーのアカウントおよびビジネス情報の取得

出品タイトルと説明の翻訳

Translation API は、迅速かつ正確な翻訳を提供し、マーケットプレイスでの可視性を高め、グローバルな出品展開を促進します。サポートされている翻訳の完全なリストについては、後述の表を参照してください。

Translation API を使用して、商品タイトルまたは商品説明をある言語から別の言語に翻訳する手順は以下のとおりです。

翻訳したいエンティティに応じて、translationContext フィールドを ITEM_TITLE または ITEM_DESCRIPTION に設定します。
from フィールドに入力テキストの言語を、to フィールドにターゲット言語を指定します。その際、下の表で定義されているサポート対象の言語ペアであることを確認してください。
text フィールドに翻訳するテキストを入力します。その際、translationContext の値に基づく文字数制限を遵守してください。
レスポンスの translations.translatedText フィールドから翻訳されたテキストを取得します。これには、to フィールドで指定した言語への翻訳結果が反映されています。

サポートされている言語

現在サポートされている翻訳は、以下の表のとおりです。（括弧内）の列挙値は、実際のリクエストペイロードで使用します。

翻訳元	翻訳先
(en) 英語	(de) ドイツ語, (zh) 中国語（北京語）, (ja) 日本語, (fr) フランス語, (it) イタリア語, (pt) ポルトガル語, (es) スペイン語, (ru) ロシア語
(de) ドイツ語	(en) 英語, (fr) フランス語, (it) イタリア語, (es) スペイン語, (pl) ポーランド語
(fr) フランス語	(en) 英語, (de) ドイツ語, (it) イタリア語, (es) スペイン語
(it) イタリア語	(en) 英語, (de) ドイツ語, (fr) フランス語, (es) スペイン語
(es) スペイン語	(en) 英語, (de) ドイツ語, (fr) フランス語, (it) イタリア語
(pl) ポーランド語	(de) ドイツ語
(zh) 中国語（北京語）	(en) 英語
(ja) 日本語	(en) 英語

出品のポリシー遵守状況の確認

Compliance API は、出品が eBay のポリシーに適合していることを確認するための体系的な仕組みをセラーに提供します。これにより、ペナルティや出品の削除を防ぐことができ、ポリシーに違反している出品や違反のリスクがある出品に関する貴重なインサイトが得られます。

Compliance API の 2 つのメソッドの概要は以下のとおりです。

getListingViolationsSummary を使用して、出品違反数の compliance types（コンプライアンスタイプ）を指定します。複数のタイプを指定する場合はカンマで区切ります。指定しない場合、すべてのコンプライアンスタイプのカウントが返されます。
getListingViolations メソッドを使用して、ポリシーに適合していない出品を取得します。特定のコンプライアンスタイプに違反している出品を取得したい場合は、compliance_type フィルタを使用できます。さらに、offset パラメータと limit パラメータを使用してページネーションを管理します。

ベストオファー、セカンドチャンスオファー、セールスリードの管理

eBay Trading API は、ベストオファー（Best Offers）、セカンドチャンスオファー（Second Chance Offers）、およびセールスリード（Sales Leads）を管理するための堅牢な機能を提供し、セラーが販売機会を最大化できるようにします。

ベストオファーの管理

セラーは、Inventory API の autoAcceptPrice と autoDeclinePrice、および Trading API の Item.ListingDetails.BestOfferAutoAcceptPrice と Item.ListingDetails.MinimumBestOfferPrice を使用して、オファーへの応答を自動化できます。これらの設定により交渉が簡素化され、カウンターオファーの管理や取引の成立を効率的に行えます。

以下の図は、ベストオファーの管理に使用される Trading API 呼び出しを図示したものです。

eBay のベストオファー機能により、セラーはバイヤーと価格交渉を行うことができ、販売の可能性が高まります。この機能は、Inventory API で listingPolicies.bestOfferTerms.bestOfferEnabled を true に設定するか、Trading API で Item.BestOfferDetails.BestOfferEnabled を true に設定することで有効化できます。
セラーは GetBestOffers 呼び出しを使用して、販売中の商品に関するベストオファーの詳細情報を取得し、アクティブなオファーに焦点を当てることができます。BestOfferID を使用して特定のオファー詳細にアクセスするか、ItemID のみを使用して商品のすべてのベストオファー ID を表示できます。これらの識別子がない場合、セラーは自分に関連するアクティブなベストオファーのリストを受け取ります。BestOfferCodeType フィールドは重要であり、オファーがバイヤーの最初のオファー（BuyerBestOffer）、バイヤーのカウンターオファー（BuyerCounterOffer）、セラーのカウンターオファー（SellerCounterOffer）のいずれであるかを示します。このフィールドを理解することは、セラーがオファーを効果的に管理し、対応するのに役立ちます。
セラーは RespondToBestOffer を使用して、ベストオファーとカウンターオファーを効果的に管理します。セラーはベストオファーに対して承諾、拒否、またはカウンターオファーを行うことができ、柔軟な交渉を促進し、販売成立の可能性を高めます。

セカンドチャンスオファーの作成

セカンドチャンスオファーは、セラーが同一商品を複数在庫持っており、その商品がオークション出品中に多数の競争入札を受けた場合に使用されます。セラーは、オークション終了時の最高入札額と同額以下の価格で、その入札者の 1 人以上に同じ商品をオファーすることができます。

以下の図は、セカンドチャンスオファーを作成する手順を図示したものです。

GetAllBidders Trading API 呼び出しをオークション出品に対して使用すると、そのオークション中に競争入札を行った入札者を確認できます。
AddSecondChanceItem 呼び出しは、競争入札者に商品を購入する機会を提供するために使用されます。
BuyItNowPrice フィールドに入力する価格は、ユーザーがオークション中に行った最高入札価格より高くてはなりません。
オファー期間は duration フィールドで設定し、1、3、5、または 7 日間のいずれかを選択できます。

注: VerifyAddSecondChanceItem を使用して、実際に再出品することなくセカンドチャンスオファーの作成をシミュレーションしてください。これにより、セラーはオファーを公開する前に詳細を確認して正確性を確保できるため、エラーが減少し、バイヤーの信頼が高まります。

セールスリードの管理

GetAdFormatLeads を使用してクラシファイド広告（Classified Ads）からセールスリード情報にアクセスし、リード数や関心のあるバイヤーの連絡先詳細を取得します。このフォーマットは、入札形式ではなく、不動産や自動車などの商品において潜在的なバイヤーとセラーを結び付けます。リードを正常に取得するには、ItemID がサポートされているカテゴリのクラシファイド広告出品と一致していることを確認してください。

知的財産権侵害の確認

Verified Rights Owner (VeRO) Program API は、知的財産権の所有者に対し、知的財産を侵害している eBay 出品を報告することで権利を保護する体系的な仕組みを提供します。このサービスは、権利所有者が商標、著作権、その他の知的財産を保護し、無許可の出品に迅速に対処するために不可欠です。

VeRO API は、以下のフローを通じて知的財産権を管理するための合理化されたプロセスを可能にします。

VeRO 理由コードを管理するには、getVeroReasonCode 関数を使用して特定のコードの詳細を取得し、getVeroReasonCodes 関数を使用してすべてのコード、または特定のマーケットプレイスに固有のコードにアクセスします。
createVeroReport メソッドは、eBay 上で知的財産権を侵害しているとされる商品に対処するための VeRO レポートを作成し、送信します。必要な主要フィールドには、商品の一意の識別子である itemId と、侵害の種類を指定する veroReasonCodeId が含まれます。
getVeroReport を使用して、送信された VeRO レポートとその商品に関するステータス情報を取得します。
getVeroReportItems メソッドを使用して、VeRO レポートを通じて報告された 1 つ以上の出品のレポートステータスを取得できます。

中華圏における配送とフルフィルメントの管理

中華圏向けの eDelivery International Shipping (eDIS) API は、同地域のセラーに配送とフルフィルメントのプロセスを効果的に管理するための包括的なツールを提供します。有効な eDIS アカウントがあれば、セラーはさまざまなメソッドを使用してパッケージの作成、住所設定、追跡、苦情（クレーム）管理を行い、配送業務を効率化できます。

eDIS API は、セラーの配送と物流を効率化するための包括的な機能群を提供します。パッケージ、住所、追跡、コスト、苦情、および追加サービスの効率的な管理を可能にします。

発送元住所と返送先住所は、createAddressPreference メソッドを使用して eDIS アカウント上で作成できます。これらの住所は getAddressPreferences で取得できます。
配送ラベルは、getLabels を使用して PDF ファイルに変換するための Base64 形式で取得でき、getHandoverSheet は集荷リクエストに関連するパッケージの引き渡しシートへのアクセスを提供します。
パッケージ管理には、配送詳細を指定してパッケージを作成する createPackage、パッケージ情報にアクセスする getPackage、特定の注文ラインアイテム ID にリンクされたパッケージを取得する getPackagesByLineItemID が含まれます。パッケージは cancelPackage を使用してキャンセルし、clonePackage で再配送用に複製し、confirmPackage で確定し、キャンセル後に deletePackage で削除できます。一括操作は、複数のパッケージを同時に処理するための bulkCancelPackages、bulkConfirmPackages、および bulkDeletePackages によって容易になります。
パッケージのステータスと場所の追跡は getTracking で行い、追跡番号を使用して追跡イベントの詳細を提供し、効果的な出荷監視を可能にします。
createComplaint メソッドは、集荷の遅延や紛失などの配送問題に関連する苦情の申し立てを容易にし、問題が効率的に報告され対処されるようにします。

セラーのアカウントおよびビジネス情報の取得

Identity API は、開発者が認証済みユーザー（個人アカウントとビジネスアカウントの両方を含む）のアカウントプロファイル情報にアクセスする方法を提供します。このサービスにより、開発者は eBay ログイン機能をアプリケーションに統合でき、機密性の高い個人特定情報（PII）を保存する必要をなくしながら、関連するアカウントデータへのアクセスを確保できます。返されるデータはスコープによって制御され、ビジネスユニットによって承認された一部の開発者が利用できます。

Identity API は、ユーザーアクセストークンを必要とする getUser メソッドを通じて、認証済みユーザーのアカウントプロファイル情報に安全にアクセスするための重要な機能を提供します。取得される情報は適用されるスコープによって異なります。ビジネスアカウントの場合、デフォルトのスコープは commerce.Identity.Read-only で、businessAccount コンテナ内のすべての公開情報フィールドを提供します。個人アカウントの場合、individualAccount コンテナ内のフィールドはスコープに依存し、デフォルトのスコープでは eBay ユーザー ID などの公開詳細のみが返されます。さらに、API は、アカウントタイプ（BUSINESS または INDIVIDUAL）、住所、国コード、主要連絡先、主要電話番号などのビジネスアカウント詳細、および個人アカウント詳細、登録マーケットプレイス ID、アカウントステータス（CONFIRMED、UNCONFIRMED、ACCOUNTONHOLD、または UNDETERMINED）を含む包括的なアカウント情報を提供します。

コードサンプル

eBay 出品のベストオファーの取得

curl -X POST "https://api.ebay.com/ws/api.dll"
-H "X-EBAY-API-SITEID:0"
-H "X-EBAY-API-COMPATIBILITY-LEVEL:967"
-H "X-EBAY-API-CALL-NAME:GetBestOffers"
-H "X-EBAY-API-IAF-TOKEN:"

英語タイトルのスペイン語への翻訳

curl -X POST "https://api.ebay.com/commerce/translation/v1_beta/translate"
-H "Authorization:Bearer OAUTH_token"
-H "Content-Type:application/json"
{
    "from": "en",
    "to": "es",
    "text": [
        "Apple Watch Series 10 GPS + Cellular 42mm Smartwatch Aluminium Case - Excellent"
    ],
    "translationContext": "ITEM_TITLE"
}

エラー処理

Translation API を使用する場合、指定されたソース言語と出力言語の組み合わせがサポートされていることを確認してください。API の概要にある「サポートされている言語」の表を確認して、API が翻訳ユースケースに対応しているかどうかを確認してください。
getListingViolationsSummary または getListingViolations メソッドで 1 つ以上の compliance_type 値でフィルタリングする場合、提供された値がサポートされていること、および複数の値がカンマで区切られていることを確認してください。
findListingRecommendations メソッドで 1 つ以上の出品 ID 値を提供する場合、提供されたすべての ID がアクティブな出品のものであることを確認してください。
AddSecondChanceItem のオファー詳細が正確であることを確認するには、期間がサポートされていること、およびオファー価格がオークション中のユーザーの入札額を超えていないことを検証してください。
createVeroReport メソッドで VeRO レポートを作成する場合、正しい itemId と veroReasonCodeId 値を使用していることを確認してください。
eDIS API で createPackage などのメソッドを使用する場合は、作成および追跡のエラーを避けるために、パッケージの寸法と重量が正確であることを確認してください。

ベストプラクティス

Translation API は、その言語に堪能でない eBay マーケットプレイスに商品を出品する際に役立ちます。
Recommendation API とその findListingRecommendations メソッドを使用して定期的に出品の推奨事項を確認し、販売速度を向上させ、Promoted Listings（広告）を通じて可視性を最適化してください。
競争の激しいオークション出品があり、同一商品を複数在庫持っている場合は、AddSecondChanceItem 呼び出しを活用してください。
eBay ログイン機能を有効にして、機密性の高い個人特定情報の保存を回避し、データ侵害のリスクを最小限に抑え、プライバシーコンプライアンスを確保してください。適切なスコープを使用して、関連するデータのみを取得するようにしてください。