FAQ

Q: Sandbox（テスト環境）で出品した商品が、eBayのサイトで見つかりません。なぜですか？

A: Sandbox環境は本番環境（Production）とは完全に隔離されています。Sandboxで出品した商品は、本番のeBayサイト（例: ebay.com）には表示されません。Sandboxでの出品を確認するには、必ずSandbox専用のサイト（https://sandbox.ebay.com）にアクセスし、テストユーザーのアカウントでログインして確認してください。

Q: テストユーザーはいくつ作成できますか？

A: 開発者ポータルを通じて、必要な数だけテストユーザー（バイヤー役、セラー役）を作成することができます。出品と購入のフローをテストするためには、少なくとも2つの異なるテストユーザー（1つはセラー、もう1つはバイヤー）を作成することをお勧めします。

Q: ユーザーアクセストークン（User Access Token）の有効期限はどのくらいですか？

A: OAuthのユーザーアクセストークンの有効期限は発行から2時間です。トークンが期限切れになった場合は、同時に発行された「リフレッシュトークン（Refresh Token）」を使用して、ユーザーに再度ログインを求めることなく新しいアクセストークンを取得してください。リフレッシュトークンの有効期限は通常18ヶ月です。

Q: APIを呼び出すと「HTTP 403」エラーが発生し、デジタル署名（Digital Signature）が必要だと言われます。

A: EU（欧州連合）またはUK（英国）に拠点を置くセラーに関連する特定のAPI（Finances APIや返金関連のAPIなど）を呼び出す場合、HTTPヘッダーにデジタル署名を含めることが義務付けられています。詳細な手順については、「デジタル署名ガイド」を参照し、x-ebay-signature-key や Signature ヘッダーを正しく実装してください。

Q: 商品を出品するには、Inventory APIとTrading APIのどちらを使うべきですか？

A: 新規開発の場合は、最新の技術（RESTful）に基づいたInventory APIの使用を強く推奨します。Inventory APIは在庫管理と出品（オファー）を分離して管理できるため、小売業の在庫管理モデルに適しています。ただし、オークション形式など一部の特定の機能を利用したい場合や、既存のシステムがXMLベースである場合は、Trading APIを使用することも可能です。

Q: 商品検索に使っていたFinding APIが動かなくなりました。

A: Finding APIは廃止（Deprecated/Decommissioned）されました。今後は、RESTfulなBrowse API（Buy APIの一部）を使用してください。Browse APIを使用することで、キーワード検索、画像検索、カテゴリ検索などが可能です。

Q: 出品中の商品情報を変更（Revise）する際、制限はありますか？

A: はい、あります。特にオークション形式で既に入札が入っている場合や、出品終了まで12時間を切っている場合は、変更できる項目に厳しい制限がかかります。また、固定価格出品であっても、すべてを変更できるわけではありません。API呼び出しは1日あたり最大250回までの修正制限がある点にも注意してください。

Q: バリエーション設定（色やサイズ違い）のある商品はどうやって作成しますか？

A: 以下の方法で作成できます：

• Inventory APIの場合: createOrReplaceInventoryItemGroup メソッドを使用して、複数のSKUをグループ化し、バリエーション出品を作成します。
• Trading APIの場合: AddFixedPriceItem コールを使用し、Variations コンテナ内に各バリエーションの詳細を定義します。

Q: eBayカタログ製品（ePID）とは何ですか？必ず使用する必要がありますか？

A: eBayカタログ製品は、eBayが保持する製品のマスターデータです。特定のカテゴリ（家電製品、自動車部品など）では、出品時にePID（eBay Product ID）またはGTIN（JAN/UPCコードなど）を指定してカタログと紐付けることが必須となっています。これにより、商品仕様が自動入力され、SEO効果も高まります。

Q: 開発中に技術的な問題が発生した場合、どこに問い合わせればよいですか？

A: eBay Developers Programに参加しているすべての開発者は、無料でテクニカルサポートを利用できます。開発者ポータルの「Support」ページからチケットを作成してください。また、まずは「AI-Assisted Support」ツールを試すことで、即座に回答が得られる場合もあります。

Q: EU圏へ販売する際、エネルギー効率ラベル（EEK）の登録はどうすればよいですか？

A: 対象となるカテゴリ（家電、タイヤ等）については、出品アスペクト（Item Specifics）に「EPREL登録番号」を入力することで、自動的にエネルギーラベル画像と製品データシートが表示されるようになりました。Trading APIやInventory APIの専用フィールドを使用するよりも、アスペクトへの入力が推奨される場合があります。