出品の作成

出品の作成 (Listing Creation)

概要

このガイドでは、eBayで新規出品を作成するための様々な方法について解説します。単一SKU製品の個別出品の作成、複数のバリエーションを持つ出品（複数SKU）の管理、一括出品作成、および既存のeBayカタログ製品に基づいた出品の生成について説明します。

以下の3つのAPIのいずれかを使用して出品を作成できます。

Inventory API：このRESTベースのAPIを使用すると、セラーは在庫保管場所（Location）、在庫アイテムレコード（Inventory Item）、およびオファーオブジェクト（Offer）を管理できます。オファーが公開されると、セラーは在庫アイテムレコードや公開されたオファーオブジェクトに対してモジュール式の変更を加えることで、アクティブな出品に変更を反映させることができます。
Sell Feed API：このRESTベースのAPIを使用すると、セラーは LMS_ADD_FIXED_PRICE_ITEM または LMS_ADD_ITEM フィードタイプを使用してeBay出品の一括アップロードを行うことができます。
Trading API：このXMLベースのAPIを使用すると、セラーは AddItem または AddFixedPriceItem コールで1つの出品を作成できます（AddItems コールでは最大5つの出品を作成可能）。

APIのユースケース

単一SKU出品の作成
複数SKU出品の作成
一括出品の作成
eBayカタログ製品を使用した出品の作成
マジカルリスティング（Magical Listing）の出品プレビュー作成

単一SKU出品の作成

Inventory API と Trading API の両方を使用して、1つの単一SKU出品を作成できます。必要な手順は各APIによって異なるため、以下で個別に説明します。新しい統合を検討している場合、eBayは Inventory API の使用を推奨します。

Inventory APIを使用した単一SKU出品の作成

以下のフロー図は、Inventory API を使用して単一SKUのeBay出品を作成する方法を視覚的に表現しています。

Inventory API で出品を公開するには、location オブジェクト、inventory_item オブジェクト、および offer オブジェクトが必要です。ユーザーは inventory_item オブジェクトと location オブジェクトのどちらを先に作成するかを選択できますが、offer オブジェクトを公開する前にこれら両方が必要となります。論理的なフローは以下の通りです。

場所（Location）の作成: createInventoryLocation メソッドを使用して、location と location type を作成します。セラーが定義する場所の識別子（merchantLocationKey）は、createInventoryLocation URIの末尾に指定します。
アイテムの定義: createOrReplaceInventoryItem メソッドを使用してアイテムを定義します。inventory_item オブジェクトの主要なフィールドについて以下に簡単に説明します。
1. SKU：セラーが定義する在庫管理単位（SKU）をパスパラメータとして渡します。
2. タイトルと説明：出品タイトル（product.title）と出品説明（product.description）は product コンテナの下に渡します。オプションで、セラーはサブタイトル（product.subtitle）を定義することもできます。
3. 商品アスペクト：商品の product.aspects（旧称：Item Specifics）を名前と値のペアとして渡します。
4. 画像：少なくとも1つの画像URLを product.imageUrls 配列に渡す必要があります。
5. 出品動画：出品動画の固有識別子を product.videoIds 配列に渡して、商品動画を出品に添付できます。
6. 製品識別子：product コンテナは、eBay製品ID（epid）や国際取引商品番号（GTIN）値などの製品識別子を提供するためにも使用されます。
7. 商品の状態（コンディション）：商品の状態（condition）は、ほとんどのカテゴリで一般的に必須です。conditionDescription フィールドは新品以外のアイテムに関する詳細情報を提供するために使用され、conditionDescriptors 配列はグレーディング済みおよび未グレーディングのシングルトレーディングカードに関する適切な情報を提供するために使用されます。
8. 製品の在庫状況：セラーは、一般的な shipToLocationAvailability.quantity、場所固有の availabilityDistributions.quantity、および/または pickupAtLocationAvailability を設定するオプションがあります。
オファーの定義: createOffer メソッドを使用してSKUのオファーを定義します。offer オブジェクトの主要なフィールドについて以下に簡単に説明します。
1. SKU：sku 値は、オファーで使用される製品を指定するために必要です。
2. eBayマーケットプレイス：marketplaceId フィールドは、オファーが公開されるeBayマーケットプレイスを示すために必要です。
3. 形式と期間：出品フォーマット（format）は AUCTION または FIXED_PRICE に設定できます。
4. 商品の場所：merchantLocationKey フィールドは商品の場所を定義します。
5. eBayおよびストアカテゴリ：出品カテゴリ（別名：リーフカテゴリ）は categoryId フィールドで設定します。オプションで、セラーは secondaryCategoryId を選択でき、eBayストアオーナーは storeCategoryNames 配列を使用してオファーを1つまたは2つのカスタムストアカテゴリに整理できます。
6. 価格：固定価格出品の価格は pricingSummary.price で指定し、オークション出品の開始価格は pricingSummary.auctionStartPrice で指定します。オークション出品で 即決価格（Buy It Now） オプションを有効にする場合は、pricingSummary.price を含めることで、入札が始まる前にバイヤーがこの価格で購入して商品を入手できるようにすることも可能です。セラーはオークション出品に対してオプションで pricingSummary.auctionReservePrice（最低落札価格）を設定することもできます。
7. 利用可能な数量：アイテムの利用可能な数量は availableQuantity フィールドを通じて設定されますが、このフィールドが省略された場合、inventory item オブジェクトで設定された一般的な数量または場所固有の数量が代わりに使用されます。
8. 出品説明：出品説明は listingDescription フィールドを通じて設定されますが、このフィールドが省略された場合、inventory item オブジェクトの product.description フィールドのテキストが代わりに使用されます。
9. ビジネスポリシー：Inventory API ではビジネスポリシーの使用が必須であるため、出品に使用する支払い、返品ポリシー、および配送のビジネスポリシーを指定するために、paymentPolicyId、returnPolicyId、および fulfillmentPolicyId フィールドを含める必要があります。
10. 規制情報：regulatory コンテナを使用して、必要に応じて製品の manufacturer（製造者）または responsiblePersons（責任者）の連絡先情報、hazmat（危険物）情報、productSafety（製品安全）情報、energyEfficiencyLabel（エネルギー効率ラベル）情報、または documents（文書）などの規制情報を提供します。
11. カスタムポリシー：listingPolicies.productCompliancePolicyIds 配列、regionalProductCompliancePolicies.countryPolicies.policyIds 配列、regionalTakeBackPolicies.countryPolicies.policyIds 配列、または listingPolicies.takeBackPolicyId フィールドを使用して、グローバルまたは国固有の回収（Take-back）ポリシーまたは製品コンプライアンスポリシーを設定します。
12. ベストオファー：オプションで、バイヤーからのベストオファー（価格交渉）を受け入れたい場合は bestOfferTerms コンテナを使用します。
13. チャリティ出品：オプションで、charity コンテナを使用して、各販売の収益の一部を登録された非営利団体に寄付することができます。
オファーの公開: publishOffer メソッドのパスパラメータにオファーの固有識別子を渡して、オファーを公開します。オファーの公開呼び出しが成功すると、新しくアクティブになった出品の listingId が返されます。

Trading APIを使用した単一SKU出品の作成

単一SKU出品は、Trading API の AddItem、AddFixedPriceItem、または AddItems コールを使用して作成できます。AddItem はすべての出品タイプをサポートしています。名前が示すように、AddFixedPriceItem は固定価格出品のみをサポートします。AddItems のインターフェースは AddItem と同じですが、1つのリクエストペイロードで最大5つの新しい出品を定義できます。

上記の3つのコールに加えて、VerifyAddItem コールと VerifyAddFixedPriceItem コールがあり、それぞれ AddItem と AddFixedPriceItem のテストコールとして使用できます。ペイロード、ロジック、検証チェック、およびエラー/警告は VerifyAddItem および VerifyAddFixedPriceItem コールと同じですが、唯一の違いは「Verify」バージョンでは実際に出品を公開したり手数料が発生したりしない点です。

出品には多くのフィールドを定義する必要があり、以下のプロセスでは論理的な順序で説明します。AddItem について言及していますが、この情報は AddFixedPriceItem および AddItems にも適用されます。

マーケットプレイス固有の情報を設定し、商品の場所を提供します。これに使用されるフィールドについて以下に簡単に説明します。
1. eBayマーケットプレイス：出品が公開されるeBayマーケットプレイスを指定します。これは X-EBAY-API-SITEID HTTPヘッダーまたは Site フィールドで行えます。ヘッダーにはeBayマーケットプレイスにマッピングされる数値のサイトIDが必要ですが、Site フィールドには列挙値が必要であることに注意してください。マーケットプレイスの列挙値とサイトIDの両方は、SiteCodeType 定義で見つけることができます。
2. 商品の場所：Country フィールドは必須です。その後、セラーは PostalCode フィールドを提供するオプションがあり、あるいは Location フィールドを通じて市区町村と州を提供することもできます。
3. 通貨：Currency も必要であり、指定されたeBayマーケットプレイスで使用される標準通貨である必要があります。
4. eBayおよびストアカテゴリ：出品カテゴリ（別名：リーフカテゴリ）は PrimaryCategory.CategoryID フィールドで設定します。オプションで、セラーは SecondaryCategory.CategoryID を選択でき、eBayストアオーナーは Storefront コンテナを使用して出品を1つまたは2つのカスタムストアカテゴリに整理できます。
5. ローカル出品の距離：セラーがeBay MotorsのLocal Market listingを通じて自動車を販売している場合、ListingDetails.LocalListingDistance フィールドを使用して、車両が利用可能であり、関心のある地元のバイヤーに公開されるエリアの半径（マイル単位）を設定できます。
商品の詳細を設定します。主要なフィールドについて以下に簡単に説明します。
1. タイトルと説明：Title と Description を定義します。オプションで、SubTitle や SellerProvidedTitle（自動車におけるサブタイトルの同等物）を含めることができます。
2. 商品の状態（コンディション）：商品の状態はほとんどのカテゴリで一般的に必須であり、Trading APIでは ConditionID フィールドを使用して商品の状態を設定します。ConditionDescription フィールドは新品以外のアイテムに関する詳細情報を提供するために使用でき、ConditionDescriptors コンテナはグレーディング済みおよび未グレーディングのシングルトレーディングカードに関する適切な情報を提供するために使用する必要があります。
3. 商品アスペクト：ItemSpecifics.NameValueList コンテナを使用して、商品の商品アスペクト（別名：Item Specifics）の名前と値のペアを提供します。
4. 画像：少なくとも1つの画像URLを PictureDetails.PictureURL 配列を通じて提供する必要があります。
5. 出品動画：出品動画の固有識別子を VideoDetails.VideoID フィールドに渡して、商品動画を出品に関連付けることができます。
6. 製品識別子：ProductListingDetails コンテナは、eBay製品ID（ePID）や国際取引商品番号（GTIN）値などの製品識別子を提供するために使用されます。
オファーの詳細と機能を設定します。主要なフィールドについて以下に簡単に説明します。
1. 形式と期間：ListingType フィールドは出品形式を設定し、ListingDuration フィールドは出品期間を設定します。
2. 価格：固定価格出品の価格は BuyItNowPrice フィールドで指定し、オークション出品の開始価格は StartPrice フィールドで指定します。オークション出品で 即決価格（Buy It Now） オプションを有効にする場合は、BuyItNowPrice フィールドを含めることもでき、入札が始まる前にバイヤーがこの価格で購入して商品を入手できるようになります。セラーはオークション出品に対してオプションで ReservePrice（最低落札価格）を設定することもできます。
3. 利用可能な数量：アイテムの利用可能な数量は Quantity フィールドを通じて設定します。
4. ビジネスポリシー：Trading API でのビジネスポリシーの使用は任意です。セラーのアカウントがビジネスポリシーにオプトインしている場合、セラーは SellerProfiles コンテナを使用して、出品に使用する支払い、返品ポリシー、および配送/フルフィルメントのビジネスポリシーを指定する必要があります。セラーのアカウントがビジネスポリシーからオプトアウトしている場合は、ビジネスポリシーの代わりに出品レベルの支払い、返品ポリシー、および配送フィールドが使用されます。
5. 支払い情報：セラーがビジネスポリシーを使用していない場合、バイヤーからの即時支払い（該当する場合）を受け取るために、true に設定された AutoPay フィールドを含める必要があります。1つ以上の PaymentMethods フィールドは、オフライン支払いをサポートする出品の場合にのみ必要となります。
6. 自動車の支払い詳細：頭金が必要な自動車の出品の場合、セラーは PaymentDetails コンテナを使用して、頭金の金額、その期日、および車両販売価格の残額をバイヤーに期待する時期を指定します。
7. 返品ポリシー：セラーがビジネスポリシーを使用していない場合、アイテムの返品ポリシーの詳細を提供するために ReturnPolicy コンテナを含める必要があります。返品を受け付けない場合でも「返品ポリシー」と見なされ、ほとんどのeBayカテゴリで返品ポリシーが必要です。
8. 配送情報：セラーがビジネスポリシーを使用していない場合、ShippingDetails コンテナおよびその他の配送関連フィールドを通じて配送情報を提供する必要があります。配送とフルフィルメントについては ステップ4 で詳しく説明します。
9. 規制情報：Regulatory コンテナを使用して、必要に応じて製品の Manufacturer（製造者）または ResponsiblePerson（責任者）の連絡先情報、Hazmat（危険物）情報、ProductSafety（製品安全）情報、EnergyEfficiencyLabel（エネルギー効率ラベル）情報、または Documents（文書）などの規制情報を提供します。
10. カスタムポリシー：CustomPolicies コンテナを使用して、グローバルまたは国固有の回収（Take-back）ポリシーまたは製品コンプライアンスポリシーを設定します。
11. ベストオファー：オプションで、バイヤーからのベストオファー（価格交渉）を受け入れたい場合は、BestOfferDetails.BestOfferEnabled フィールドを含め、true に設定します。また、ListingDetails.BestOfferAutoAcceptPrice および/または ListingDetails.MinimumBestOfferPrice フィールドを使用して、価格に基づいてベストオファーを自動的に承認または拒否する価格しきい値を設定することもできます。
12. チャリティ出品：オプションで、Charity コンテナを使用して、各販売の収益の一部を登録された非営利団体に寄付することができます。
配送/フルフィルメントの詳細を設定します。これらのフィールドは、セラーがビジネスポリシーを使用していない場合に必須です。主要なフィールドについて以下に簡単に説明します。
1. ハンドリングタイム（出荷までの日数）：DispatchTimeMax フィールドを使用して、バイヤーの支払いが完了してからセラーが商品を発送するまでに確約する営業日数を設定します。通常の値は0、1、2です。セラーが即日発送を確約する場合、バイヤーの支払いがその営業日の締め切り時間前に完了していれば、その同じ営業日に商品を発送する必要があります。
2. 配送サービスオプション：利用可能な各国内配送サービスオプションには ShippingServiceOptions コンテナが使用され、利用可能な各国際配送サービスオプションには InternationalShippingServiceOption コンテナが使用されます。国内配送サービスオプションは最大4つ、国際配送サービスオプションは最大5つまで指定できます。定額配送が使用され、送料レートテーブル（Rate Table）が使用されていない場合、各配送サービスのコストもこれらのコンテナで提供されます。
3. 自動車のフルフィルメント：BuyerResponsibleForShipping フィールドは自動車の出品に使用され、ほとんどの場合、これは true に設定されます。これは、バイヤーが車両を引き取るか、サードパーティの貨物配送サービスを手配する責任があることを意味します。
4. 梱包手数料：ShippingDetails.CalculatedShippingRate コンテナは、セラーがバイヤーに国内または国際的な梱包手数料を請求する場合にのみ使用され、かつセラーが国内および/または国際配送に計算済み配送（Calculated Shipping）を使用している場合にのみ使用されます。
5. 配送先と除外配送地域：ShipToLocations および ShippingDetails.ExcludeShipToLocation フィールドは、セラーがどこに配送し、どこに配送しないかを指定するために連携して使用されます。例えば、セラーはある地域の多くの地理的エリアや国に配送するが、すべてには配送しない場合があります。そのセラーは <ShiptoLocations> フィールドを使用して値を Worldwide に設定し、その後 <ExcludeShipToLocation> フィールドを含めて値を Africa や Central America and Caribbean に設定するかもしれません。
6. 配送割引プロファイル：InternationalPromotionalShippingDiscount、InternationalShippingDiscountProfileID、PromotionalShippingDiscount、および ShippingDiscountProfileID フィールドは、出品に配送割引を適用するために使用されます。配送割引は、Seller Hub の Marketing タブの下、または Trading API の SetShippingDiscountProfiles コールを通じて設定されます。
7. 送料レートテーブル：RateTableDetails コンテナを使用して、出品に国内および/または国際送料レートテーブルを適用し、定額配送料を制御できます。詳細については、「送料レートテーブルの使用」のヘルプトピックを参照してください。
8. 配送パッケージの詳細：ShippingPackageDetails コンテナは、配送パッケージのタイプ、重量、および寸法を提供するために使用されます。
9. 配送ビジネスポリシーのコスト上書き：ShippingServiceCostOverrideList コンテナは、セラーがビジネスポリシーを使用しているが、1つ以上の国内および/または国際配送サービスオプションのコストを上書きしたい場合に使用されます。セラーがビジネスポリシーを使用していない場合、このコンテナは適用されません。
コールを実行して出品を公開します。成功したコールは、新しくアクティブになった出品の ItemID と、出品に対して適用された出品関連手数料を返します。

複数SKU出品の作成

マルチバリエーション出品（別名：複数SKU出品）は、同じアイテムの複数のバリエーションを含むeBay出品です。例えば、セラーは同じ種類のTシャツを複数の色とサイズの組み合わせで販売する場合があります。

Inventory API と Trading API の両方を使用して、複数SKU出品を作成できます。必要な手順は各APIによって異なるため、以下で個別に説明します。

Inventory APIを使用したマルチバリエーション出品の作成

以下のフロー図は、Inventory API を使用して複数SKUのeBay出品を作成する方法を視覚的に表現しています。

マルチバリエーション出品を作成するために Inventory API で実行する必要がある手順は以下の通りです。

createOrReplaceInventoryItem または bulkCreateOrReplaceInventoryItem メソッドを使用して、inventory item group オブジェクトに入り、マルチバリエーション出品内のバリエーションとなる各SKUに対して個別の inventory item オブジェクトを作成します。各 inventory item オブジェクトを作成する際は、以下に従ってください。
```
"aspects": {
    "Color": ["Blue"],
    "Size": ["Large"]
}
```
1. product.aspects フィールドには、その特定のSKUに固有のアスペクトのみを提供してください。inventory item group の共通アスペクトは createOrReplaceInventoryItemGroup メソッドで設定されます。したがって、SKUが「Blue（青）」で「Large（Lサイズ）」のTシャツである場合、aspectsフィールドは上記のようになります。
2. inventory item オブジェクトに product.title と product.description を設定できますが、実際にeBay出品で使用されるのは inventory item group オブジェクト内の同等のフィールドです。
3. 理想的には、product.imageUrls 配列を通じて提供される画像は、その特定のバリエーションの固有のアスペクトを反映しているべきです。多くの場合、提供される画像はその特定のバリエーションの色を示します。
4. eBay出品には最大1つの商品動画しか設定できないため、inventory item オブジェクトの product.videoIds フィールドは使用せず、代わりに inventory item group オブジェクトで設定することを推奨します。
createOffer または bulkCreateOffer を使用して、inventory item group 内の各SKUに対して offer オブジェクトを作成します。各 offer オブジェクトを作成する際は、以下に従ってください。
1. categoryId の値は、同じeBay出品に含まれるため、すべてのSKUで同じである必要があります。
2. format の値は、すべてのSKUで FIXED_PRICE に設定する必要があります。
3. listingDuration の値は、すべてのSKUで GTC（キャンセルされるまで有効）に設定する必要があります。
4. すべてのSKUで、同じ支払い（paymentPolicyId）、返品（returnPolicyId）、およびフルフィルメント（fulfillmentPolicyId）ビジネスポリシーを使用する必要があります。
5. pricingSummary.price の値はすべてのSKUで同じにすることができますが、同じ出品内のバリエーションでわずかに異なる価格を設定することも許可されています。
createOrReplaceInventoryItemGroup メソッドを使用して、inventory item group オブジェクトを作成および設定します。inventory item group オブジェクトを作成する際は、以下に従ってください。
1. inventory item group オブジェクトの名前は、createOrReplaceInventoryItemGroup URIの末尾にセラー定義の名前を渡すことで指定します。
2. variantSKUs 配列を使用して、inventory item group に属し、結果として作成されるマルチバリエーション出品内のバリエーションとなる各SKUを定義します。
3. aspects フィールドを使用して、inventory item group のすべての共通商品アスペクトを定義します。各バリエーションの固有または「変化する（pivoting）」アスペクトは、実際には inventory item オブジェクトで定義されていることに留意してください。
4. variesBy.specifications 配列で、「変化する（pivoting）」アスペクトと、その inventory item group 内のSKUによってカバーされるすべてのアスペクト値を定義します。例えば、バリエーションが色とサイズによって異なる場合、1つは Color、もう1つは Size に設定された2つの variesBy.specifications.name フィールドを持ち、対応する variesBy.specifications.values 配列には、その inventory item group 内のSKUを通じて利用可能なすべての色とサイズが含まれます。
5. variesBy.aspectsImageVariesBy フィールドは、セラーが各SKUの違いを示す画像を各SKUに提供したい場合に使用されます。一般的に、このフィールドの値は Color に設定され、inventory item group 内の各SKUに対して、そのSKUの色を示す少なくとも1つの画像が提供されます。
publishOfferByInventoryItemGroup メソッドを使用して、マルチバリエーション出品を公開します。複数SKU出品が正常に公開されると、レスポンスで新しくアクティブになった出品の listingId が返されます。

Trading APIを使用したマルチバリエーション出品の作成

Trading API でマルチバリエーション出品を作成するには、AddFixedPriceItem コールを使用する必要があります。Trading API で単一SKUの固定価格出品を作成するための一般的なガイドラインに従うことに加えて、AddFixedPriceItem リクエストペイロードを以下のように設定します。

出品の一部となる各バリエーションに対して、Variations.Variation ノードが必要です。このコンテナの設定に関する詳細は以下の通りです。
1. Variation.VariationSpecifics コンテナを通じて、各バリエーションの固有（または変化する）アスペクトを提供します。例えば、バリエーションが色とサイズで異なる場合、1つの VariationSpecifics.NameValueList.Name フィールドの値は Color、もう1つは Size となり、各バリエーションの実際の Color と Size の値は対応する VariationSpecifics.NameValueList.Value フィールドに表示されます。すべてのバリエーションに共通の商品アスペクト（別名：Item Specifics）は、ItemSpecifics コンテナを通じて指定します。
2. Variation.Quantity と Variation.StartPrice フィールドを通じて、各バリエーションの数量と価格を提供します。Item.Quantity と Item.StartPrice フィールドは、マルチバリエーション出品には使用しないでください。
3. 各バリエーションの Variation.SKU を提供します。このフィールドが使用されない場合、eBayはその固有のアスペクト（例：「Blue, Large」）に基づいて各バリエーションのSKU値を自動的に生成することに注意してください。
4. VariationProductListingDetails コンテナを使用して、SKUのeBay製品ID（ePID）または国際取引商品番号（GTIN）を提供します。
Variations.VariationSpecificsSet コンテナでは、「変化する（pivoting）」アスペクトと、出品に含まれるSKUによってカバーされるすべてのアスペクト値を定義します。例えば、バリエーションが色とサイズによって異なる場合、1つは Color、もう1つは Size に設定された2つの VariationSpecificsSet.NameValueList.Name フィールドを持ち、対応する VariationSpecificsSet.NameValueList.Value フィールドには、出品内のSKUを通じて利用可能なすべての色とサイズが含まれます。
Variations.Pictures コンテナは、セラーが各SKUの違いを示す画像を各SKUに提供したい場合に使用されます。一般的に、Variations.Pictures.VariationSpecificName フィールドの値は Color に設定され、Variations.Pictures.VariationSpecificPictureSet コンテナを使用して、出品内のSKUの各固有色を示す1つ以上の画像URLを提供します。
AddFixedPriceItem コールを実行して、マルチバリエーション出品を公開します。成功したコールは、新しくアクティブになった出品の ItemID と、出品に対して適用された出品関連手数料を返します。

一括出品の作成

Inventory API と Sell Feed API の両方が一括出品作成をサポートしています。必要な手順は各APIによって異なるため、以下で個別に説明します。

Inventory APIを使用した一括出品の作成

以下のフロー図は、Inventory API の3つのバルク（一括）メソッドを使用して最大25個の新しい出品を作成する方法を視覚的に表現しています。

Inventory API の3つのバルクメソッドを使用して最大25個の出品を作成するために必要な手順は以下の通りです。

bulkCreateOrReplaceInventoryItem メソッドを使用して、最大25個の在庫アイテムレコードを定義します。このメソッドのペイロードは、1つではなく最大25個の在庫アイテムレコードを作成できる点、および createOrReplaceInventoryItem メソッドのようにSKU値をパスパラメータとするのではなく、各在庫アイテムレコードのリクエストペイロード内で requests.sku フィールドを指定する点を除き、createOrReplaceInventoryItem メソッドと同一です。
bulkCreateOffer メソッドを使用して、25個のSKUに対して最大25個のオファーを定義します。このメソッドのペイロードは、1つではなく最大25個のオファーを作成できる点、および createOffer メソッドのようにSKU値をパスパラメータとするのではなく、各オファーのリクエストペイロード内で requests.sku フィールドを指定する点を除き、createOffer メソッドと同一です。
bulkPublishOffer メソッドを使用して、25個のSKUに対して最大25個のオファーを公開します。このメソッドのペイロードは、1つではなく最大25個のオファーを公開できる点、および publishOffer メソッドのようにoffer_id値をパスパラメータとするのではなく、各オファーのリクエストペイロード内で各 requests.offerId 値を指定する点を除き、publishOffer メソッドと同一です。正常に公開された各オファーに対して、個別の listingId フィールドがレスポンスで返されます。

これらの3つのバルクAPIは同期的に動作し、返されるHTTPステータスコードは以下のように異なります。

200 OK：リクエストペイロード内のすべての在庫アイテムまたはオファーが正常に作成されたか、オファーがeBay出品として正常に公開されました。
207 Multi-status：リクエストペイロード内の一部の在庫アイテムまたはオファーが正常に作成されたか、一部のオファーがeBay出品として正常に公開されました。レスポンス内の statusCode フィールドは、どのオブジェクトが失敗したかを示します。
400 Bad Request：無効または欠落しているデータが原因で、リクエストが完全に失敗したことを示すステータスコードです。

Sell Feed APIを使用した一括出品の作成

Sell Feed API を使用すると、セラーは様々なフィードファイルやレポートをアップロードおよびダウンロードできます。一括出品作成に使用される2つのフィードタイプは、LMS_ADD_ITEM と LMS_ADD_FIXED_PRICE_ITEM です。これらのフィードファイルのサイズ制限は15 MBで、ファイルはeBayによって非同期に処理されます。すべてのアップロードタスクのステータスは、一意の「タスクID」で追跡されます。

以下のフロー図は、Sell Feed API を使用して複数の新規出品を作成する方法を視覚的に表現しています。

複数の出品を作成するために Sell Feed API で実行する必要がある手順は以下の通りです。

createTask メソッドを使用してタスクをステージング（準備）します。X-EBAY-C-MARKETPLACE-ID ヘッダーを使用して出品マーケットプレイスを設定し、リクエストペイロードの feedType 値を LMS_ADD_ITEM または LMS_ADD_FIXED_PRICE_ITEM に設定します。マルチバリエーション出品を作成する場合は、LMS_ADD_FIXED_PRICE_ITEM を使用する必要があります。コールが成功すると、タスクの getTask URIがLocationレスポンスヘッダーに返されます。
getTask メソッドを使用してタスクのステータスを確認します。status フィールドに返される値は CREATED である必要があります。この値が表示されたら、次のステップに進みます。
uploadFile メソッドを使用して、LMS_ADD_ITEM または LMS_ADD_FIXED_PRICE_ITEM フィードファイルをアップロードします。createTask メソッドで返されたものと同じタスクIDを、このメソッドのパスパラメータとして使用します。uploadFile メソッドにはリクエストペイロードはありませんが、XMLデータファイルをアップロードすることになります。XMLファイルの作成とアップロードの詳細については、「uploadFile リファレンスドキュメント」および/または「データファイルの作成（Create the data file）」トピックを参照してください。uploadFile コールが成功した場合、HTTPステータスコード 202 Accepted が返されるはずです。アップロードされたファイルは非同期に処理されるため、ファイルサイズによっては処理に時間がかかる場合があります。
別の getTask メソッド（同じタスクIDを使用）を実行してステータスを確認します。今回は、COMPLETED または COMPLETED_WITH_ERROR の値を確認します。COMPLETED_WITH_ERROR は通常、1つ以上の出品が正常に作成されなかったことを示すため、COMPLETED が望ましいです。また、uploadSummary コンテナも確認してください。すべての出品が正常にアップロードされた場合、uploadSummary.failureCount フィールドの値は0になるはずです。
getResultFile メソッド（同じタスクIDをパスパラメータとして使用）を使用して、出品作成タスクの結果を示すファイルを取得します。完全に成功したタスクでは、新しく作成された出品のアイテムID値が表示されます。正常に作成されなかった出品がある場合は、1つ以上の出品に関する問題を示すErrorsコンテナが表示されるはずです。

eBayカタログ製品を使用した出品の作成

市販製品の出品を作成する場合、eBayが製品カタログで同じ製品を定義している可能性が十分にあります。この場合、セラーはeBay製品ID（ePID）または国際取引商品番号（GTIN）値を提供して特定のeBayカタログ製品と照合させることができ、eBayはそのカタログ製品の詳細（製品のタイトル、説明、アスペクトの名前と値のペア、ストックフォトを含む）を使用して出品を自動入力（プリフィル）します。また、eBayはこの製品を正しいeBayリーフカテゴリに配置します。

Inventory API と Trading API の両方を使用して、eBayカタログ製品を採用して出品を作成できます。必要な手順は各APIによって異なるため、以下で個別に説明します。

Inventory APIを使用したeBayカタログ製品の採用

以下のフロー図は、Inventory API を使用して出品を作成するためにeBayカタログ製品を検索して使用する方法を視覚的に表現しています。

eBayカタログ製品に基づいて出品を作成するために Inventory API で実行する必要がある手順は以下の通りです。

（任意ですが推奨）製品に一致するeBayカタログ製品が存在するかどうかを最初に確認したい場合は、Catalog API の search メソッドを使用します。このメソッドには多数のフィルタが用意されていますが、一致する製品を検索する2つの一般的な方法は、q クエリパラメータで製品名を提供するか、gtin クエリパラメータでUPC、ISBN、またはEAN値を提供することです。特にGTIN値ではなく q クエリパラメータを使用した場合、検索結果として複数のeBayカタログ製品が返される可能性があるため、productSummaries 配列の下に返される製品の詳細を確認する必要があります。カタログ製品が製品と完全に一致すると思われる場合は、ステップ2に進みます。
createOrReplaceInventoryItem または bulkCreateOrReplaceInventoryItem メソッドの product コンテナを使用して、epid（最適）、upc、ean、isbn 値、または brand/mpn ペアのいずれかを使用して製品を特定します。eBayカタログ製品に基づいて新しいアイテムの出品を作成する場合、title、description、または aspects を含む他の情報を product コンテナの下に提供すべきではありません。これらのデータはeBayカタログ製品から取得されるためです。ただし、アイテムが中古である場合や少しでも変更が加えられている場合は、imageUrls 配列を通じて実際のアイテムの写真を追加し、実際のアイテムの詳細を反映するように description を修正することをお勧めします。
createOffer または bulkCreateOffer メソッドを使用して在庫アイテムのオファーを作成する際、eBayが inventory item および offer オブジェクトにカタログ製品の詳細を自動入力（プリフィル）するためには、includeCatalogProductDetails フィールドを含め、true に設定する必要があります。
オファーを公開する前に、getInventoryItem および getOffer メソッドを使用して在庫アイテムと offer オブジェクトを確認します。createOrReplaceInventoryItem を使用して在庫アイテムを調整したり、updateOffer を使用してオファーを調整したりします。
publishOffer を使用して出品を公開します。

注：eBayカタログ製品はマルチバリエーション出品にも使用できるため、上記のプロセスと同様ですが、各在庫アイテムと各 offer オブジェクトに対して同じ手順を実行する必要があります。

Trading APIを使用したeBayカタログ製品の採用

eBayカタログ製品に基づいて出品を作成するために Trading API で実行する必要がある手順は以下の通りです。

（任意ですが推奨）製品に一致するeBayカタログ製品が存在するかどうかを最初に確認したい場合は、Catalog API の search メソッドを使用します。このメソッドには多数のフィルタが用意されていますが、一致する製品を検索する2つの一般的な方法は、q クエリパラメータで製品名を提供するか、gtin クエリパラメータでUPC、ISBN、またはEAN値を提供することです。特に q クエリパラメータを使用した場合、検索結果として複数のeBayカタログ製品が返される可能性があるため、productSummaries 配列の下に返される製品の詳細を確認する必要があります。カタログ製品が製品と完全に一致すると思われる場合は、ステップ2に進みます。
AddItem および AddFixedPriceItem コールの ProductListingDetails コンテナを使用して、ProductReferenceID（ePID）値、UPC 値、EAN 値、ISBN 値、または BrandMPN ペアのいずれかを使用してeBayカタログ製品を特定します。eBayカタログ製品に基づいて新しいアイテムの出品を作成する場合、以下の情報はカタログ製品から取得されるため、Addコールで提供すべきではありません。
1. Title
2. Description
3. ItemSpecifics
ただし、アイテムが中古である場合や少しでも変更が加えられている場合は、PictureDetails コンテナを通じて実際のアイテムの写真を追加し、実際のアイテムの詳細を反映するように Description を修正することをお勧めします。
Addコールを実行して出品を公開したら、GetItem を呼び出して出品が期待通りに表示されているか検証することをお勧めします。

注：eBayカタログ製品はマルチバリエーション出品にも使用できるため、同様のプロセスに従いますが、以下の例外があります。
1) AddItem コールはマルチバリエーション出品をサポートしていないため、AddFixedPriceItem コールを使用する必要があること。
2) 各バリエーションのePIDまたはGTINは、ProductListingDetails コンテナではなく、Variation.VariationProductListingDetails コンテナを通じてバリエーションレベルで渡されることです。

マジカルリスティングの出品プレビュー作成

GraphQLベースの Inventory Mapping API は、既存の製品データから生成されたAIによる推奨事項を使用して、セラーが高品質な出品を作成するのを支援します。このAPIにより、セラーやサードパーティパートナーは既存の製品データを使用してeBay出品プレビューを作成し、その後eBayのListing APIを使用して出品を作成することができます。以下のフロー図は、出品プレビューを生成する方法と、その後の他のeBay APIを使用して出品作成の手順を示しています。

重要： 出品プレビューは、下書きやライブ出品ではありません。これは外部の製品詳細から生成された情報であり、セラーが次のステップで出品を作成するために使用できます。セラーは他のeBay APIを使用して出品を作成する前に、このデータの出力を確認することが求められます。

ビジネスユースケース

Inventory Mapping API は、セラーの最小限の入力で出品プレビューを作成します。このAPIの一般的なユースケースは以下の通りです。

新規セラーの在庫設定: 新規セラーは、タイトルや画像を提供するだけですぐに開始できます。これにより参入障壁が下がり、遅延なくeBayでのプレゼンスを構築できます。
ストアや他のマーケットプレイスで出品を管理しているセラー: メタデータがeBayの構造と一致しないマルチチャネルセラーのために、APIは画像URL、タイトル、セラー定義カテゴリ、およびカスタムアスペクトを使用した在庫のインポートをサポートします。これにより時間を節約し、手作業によるやり直しを減らし、外部システムからの移行や同期を簡素化します。
コモディティ商品を提供するセラー: 標準化された識別子（例：書籍のISBN、電子機器のUPC）を持つ製品の場合、APIはGTINなどの製品IDを受け入れて関連詳細を取得し、製品を検証し、クロスチャネル出品をスピードアップします。これにより出品の正確性が向上し、大量在庫のカタログベースのワークフローをサポートします。

手順

出品プレビューと出品を作成する手順：

startListingPreviewsCreation ミューテーションを呼び出し、外部製品データを使用して各製品のプレビューを生成します。
以下のいずれかの方法でタスクステータスを監視します。
- タスクステータスをポーリングする
- Notification API のトピック LISTING_PREVIEW_CREATION_TASK_STATUS を購読し、出品プレビューの準備ができたときに通知を受け取る
タスクが正常に完了したら、listingPreviewsCreationTaskById クエリ（タスクIDを使用）を呼び出して出品プレビューを取得します。
- タスクIDは StartListingPreviewsCreation ミューテーションのレスポンスで返されます
- listingPreviewsCreationTaskById クエリの出力には、出品プレビューの詳細（カテゴリ、アスペクト、利用可能な場合はePID、AIが提案したタイトル/説明、および mappingReferenceId）が含まれます
出品プレビューを確認し、出品を作成します。
注: mappingReferenceId は、Inventory Mapping API によって提供された推奨事項を一意に識別するものであり、セラーは作成された出品を関連付けるためにこれを使用し、出品の作成または修正時に参照する必要があります。
- Trading APIを使用した単一SKU出品 の作成
- Trading APIを使用したマルチバリエーション出品 の作成
- Sell Feed APIを使用した一括出品 の作成

コードサンプル

Inventory API用の倉庫ロケーション（Warehouse Location）の作成

curl -X POST "https://api.ebay.com/sell/inventory/v1/location/W********1"
-H "Authorization: Bearer OAUTH_token"
-H "Content-Type: application/json"
-d '{
    "location": {
        "address": {
            "postalCode": "95008",
            "stateOrProvince": "CA",
            "country": "US"
        }
    },
    "name": "testWarehouse1",
    "merchantLocationStatus": "ENABLED",
    "locationTypes": [
        "WAREHOUSE"
    ]
}'

Sell Feed APIを使用した一括アイテム作成アップロードのステージング

curl -X POST "https://api.ebay.com/sell/feed/v1/task"
-H "Authorization: Bearer OAUTH_token"
-H "Content-Type: application/json"
-H "X-EBAY-C-MARKETPLACE-ID: EBAY_US"
-d '{
  "schemaVersion": "1421",
  "feedType": "LMS_ADD_ITEM"
}'

エラーハンドリング

Inventory API の publishOffer、bulkPublishOffer、または publishOfferByInventoryItemGroup メソッドには、エラーの性質に基づいてトリガーされるエラーコードがいくつかあり、それぞれエラーメッセージのテキストやトラブルシューティング手順が異なります。エラーメッセージの違いや解決方法の詳細については、「Inventory APIエラー詳細」トピックを参照してください。
Inventory API では、ビジネスポリシーの使用が必須です。Account API v1 を使用してセラーのビジネスポリシーを作成および管理でき、同APIの OptInToProgram メソッドを使用してセラーのアカウントをビジネスポリシーにオプトインできます。publishOffer、bulkPublishOffer、または publishOfferByInventoryItemGroup メソッドは、オファーに対して 支払い（payment）、返品（return）、および フルフィルメント（fulfillment） のビジネスポリシーが指定されていない場合、失敗します。
各eBayリーフカテゴリには通常、そのカテゴリのアイテムに必須となる多数のアイテムスペック（別名：アスペクト）があるため、必須のアイテムスペックのリストを取得するために、Taxonomy API の getItemAspectsForCategory および fetchItemAspects メソッドを積極的に使用することをお勧めします。
無効なeBayカテゴリIDまたは非リーフカテゴリIDはエラーを引き起こします。Taxonomy API の getCategoryTree または getCategorySubtree メソッドを使用して、eBayカテゴリIDを取得し、どのカテゴリがリーフカテゴリであるかを確認してください。
JavaScriptは、セラー定義のテキストベースフィールド（アイテム説明など）では使用できず、エラーを引き起こします。
Trading API を使用しており、かつセラーがビジネスポリシーにオプトインしていない場合、セラーがアイテムの返品を受け付けないのであれば、ReturnPolicy コンテナを使用し、ReturnPolicy.ReturnsAcceptedOption フィールドの値を ReturnsNotAccepted に設定する必要があります。
異なるeBayリーフカテゴリでサポートされる商品の状態は異なるため、Metadata API の getItemConditionPolicies メソッドを使用して、リーフカテゴリでサポートされている商品の状態を確認することをお勧めします。
Sell Feed API を使用する場合、createTask メソッドの feedType フィールドで指定されたフィードタイプは、uploadFile メソッドを通じてアップロードされる実際のオブジェクトタイプと一致する必要があります。

ベストプラクティス

Inventory API では、新しいeBay出品を作成する前に、location オブジェクト、inventory item/inventory item group、および offer オブジェクトが必要です。これらのオブジェクト内には、オブジェクトの作成時には任意のフィールドが多数ありますが、これらの同じフィールドは、publishOffer、bulkPublishOffer、または publishOfferByInventoryItemGroup メソッドを通じて実際にオファーを公開する際には必須となります。詳細については、「オファー公開時の必須フィールド」を参照してください。これらのフィールドに精通し、オブジェクトの最初の作成時にそれらを含めておくことで、公開メソッドの使用時にエラーが発生するのを防ぐことをお勧めします。
特に固定価格の複数数量出品を頻繁に使用するセラーには、在庫切れ設定（Out of Stock control） 機能にオプトインすることをお勧めします。セラーがこの機能を使用すると、数量が0になった場合でも出品は最大90日間維持され、セラーは在庫を補充する機会を得ることができます。アクティブな出品が「在庫切れ（Out-of-Stock）」の間、検索結果からは非表示になるため、購入希望者が利用可能な数量のない出品を見ることはありません。
Trading API のSandbox環境を使用する代わりの方法として、VerifyAddItem および VerifyAddFixedPricedItem コールを使用して、アイテムが実際にリストされる前に本番環境でアイテムオブジェクトの有効性をテストできます。これらのコールは、AddItem および AddFixedPriceItem コールと同じロジックと検証を使用しますが、出品手数料が発生するリスクはありません。
セラーは、Taxonomy API の getCategorySuggestions メソッドを使用して、タイトルや説明にクエリで指定されたキーワードが含まれる出品数が最も多いカテゴリのリストを返すことができます。これにより、セラーは出品に最も正確なカテゴリを選択でき、適切なオーディエンスに確実に届けることができます。
急いでおらず利用可能な最も安い配送オプションを希望するバイヤーと、急いでいて送料が少々高くても構わないバイヤーの両方を満足させるために、セラーは複数の国内配送サービスオプションを提供することを検討すべきです。
新品以外のアイテムの場合、セラーは Inventory API の conditionDescription フィールド、または Trading API の ConditionDescription フィールドを使用して、アイテムの状態に関する詳細を提供することを強くお勧めします。この情報を提供することで、「説明と著しく異なる（SNAD: Significantly Not As Described）」としての返品やケースを減らすことができます。
EUまたは北アイルランド内で販売しているセラーは、カテゴリレベルのEU規制要件を認識しておく必要があります。getRegulatoryPolicies メソッドを使用して、どのカテゴリで製品安全ラベル、危険物ラベル、エネルギー効率ラベル、および製品製造者の連絡先情報が必須または推奨されているかを確認でき、getExtendedProducerResponsibilityPolicies メソッドを使用して、どのカテゴリでエコ参加料金、回収（Take-back）ポリシー、および修理スコアが必須または推奨されているかを確認できます。
新品で確立された製品を販売しているセラーの場合、Catalog API の search メソッドを使用してeBayの製品カタログでその製品を検索し、その後 Inventory API の product.epid フィールド、または Trading API の ProductListingDetails.ProductReferenceID フィールドを使用して、eBayカタログ製品に基づいて製品データ情報を「自動入力（プリフィル）」することをお勧めします。
すべての出品には少なくとも1枚の商品の写真が必要ですが、セラーは各商品に多数の写真を使用することをお勧めします。すべての写真はeBayの 写真ポリシー（Picture Policy） に準拠する必要があります。
トップレイテッドセラー（Top Rated Seller）は、30日または60日の返品を提供し、ハンドリングタイムを0または1営業日に設定することをお勧めします。これらの基準を満たすすべての出品には Top Rated Plus バッジが付与されます。Top Rated Plus バッジは検索順位に良い影響を与え、セラーへの信頼を高めるのに役立ちます。
Inventory API では ビジネスポリシー の使用が必須であるため、offer オブジェクトで指定/使用する前に、支払い（payment）、返品（return）、および フルフィルメント（fulfillment） のビジネスポリシーを十分に確認することをお勧めします。Account API v1 のGETビジネスポリシーメソッドを使用して、eBayマーケットプレイスでセラーに定義されているすべてのビジネスポリシーを取得できます。