eBay (独立発行者) (プレビュー)

eBay は、Web サイトを通じて消費者間および企業-消費者間への販売を促進する、米国の多国籍 eコマース企業です。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Artesian Software Technologies LLP
[URL] https://artesian.io
メール amit.sharma@artesian.io
Connector Metadata
発行者 Artesian Software Technologies LLP
Web サイト https://www.ebay.com/
プライバシー ポリシー https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260
カテゴリー コマース; 営業と CRM

接続を作成する

コネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ Description Required
クライアント ID - 自分の eBay clientId string クライアント ID を入力してください。 True
Client Secret securestring クライアント シークレットを入力してください。 True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

インベントリ品目を取得する

この呼び出しは、特定の SKU の在庫品目レコードを取得します。

オファーを作成する

この呼び出しは、特定の eBay マーケットプレイスの特定の在庫品目に対するオファーを作成します。

オファーを公開する

この呼び出しは、未公開オファーを公開オファー、またはライブの eBay 出品に変換するために使用されます。 オファーの一意識別子 (offerId) は、呼び出し URI の最後に渡されます。

オファーを削除する

この呼び出しはオファーを完全に削除します

オファーを取得する

この呼び出しは、特定の公開済みまたは未公開のオファーを取得します。

オファーを取得する

この呼び出しは、指定された SKU 値の既存のオファーをすべて取得します。 販売者には、検索されるオファーを特定の eBay マーケットプレイスまたは出品形式に制限するオプションがあります。

オファーを撤回する

この呼び出しは、指定されたオファーに関連付けられている単一バリエーション出品を終了するために使用されます。

オファーを更新する

この呼び出しは、公開済みまたは未公開の状態である既存のオファーを更新します。

カテゴリの品目アスペクトを取得する

この呼び出しは、指定されたリーフ カテゴリの項目を正確に説明するために適切または必要なアスペクトの一覧を返します。 各アスペクトは、eBay でそのカテゴリの品目を提供するときに、販売者が値 (またはバリエーション値) を提供する必要がある、または推奨されるアイテム属性 (たとえば、色) を識別します。

カテゴリ提案を取得する

この呼び出しは、指定されたカテゴリ ツリー内のカテゴリ ツリー リーフ ノードの配列を返します。これらは、eBay によってクエリに最も密接に対応すると見なされます。

フルフィルメント ポリシーを取得する

このメソッドは、marketplace_id クエリ パラメーターを使用して指定するマーケットプレイス用に構成されたすべてのフルフィルメント ポリシーを取得します。

フルフィルメント ポリシーを取得する

このメソッドは、フルフィルメント ポリシーの完全な詳細を取得します。 fulfillmentPolicyId パス パラメーターを使用して、取得するポリシーの ID を供給します。

品目の状態ポリシーを取得する

このメソッドは、eBay マーケットプレイス上で 1 つ、複数、またはすべての eBay カテゴリの品目状態メタデータを返します。

在庫品目の作成または置換

この呼び出しは、新しい在庫品目レコードを作成するか、既存の在庫品目レコードを置き換えます。

在庫品目を取得する

この呼び出しは、販売者のアカウントに対して定義されたすべての在庫品目レコードを取得します。

在庫場所を作成する

この呼び出しを使用して、新しい在庫場所を作成します。 オファーを作成して公開するには、すべてのオファーが場所に関連付けられている必要があるため、売り手は少なくとも 1 つの在庫場所を持っている必要があります。

在庫場所を取得する

この呼び出しは、merchantLocationKey パス パラメーターで指定された在庫場所の定義済み詳細をすべて取得します。

在庫場所を取得する

この呼び出しは、販売者のアカウントに関連付けられた各在庫場所に関して定義された詳細をすべて取得します。

支払ポリシーを取得する

このメソッドは、marketplace_id クエリ パラメーターを使用して指定するマーケットプレイス用に構成されたすべての支払ポリシーを取得します。

支払ポリシーを取得する

このメソッドは支払ポリシーの完全な詳細を取得します。 paymentPolicyId パス パラメーターを使用して、取得するポリシーの ID を供給します。

既定カテゴリ TreeId を取得する

特定の eBay マーケットプレイスで複数のカテゴリ ツリーが使用される場合がありますが、それらのツリーの 1 つがそのマーケットプレイスの既定であると見なされます。 この呼び出しは、指定された eBay マーケットプレイス ID に関連付けられた既定のカテゴリ ツリーへの参照を取得します。

返品ポリシーを取得する

このメソッドは、marketplace_id クエリ パラメーターを使用して指定するマーケットプレイス用に構成されたすべての支払ポリシーを返します。

返品ポリシーを取得する

このメソッドは、returnPolicyId パス パラメーターで指定された返品ポリシーの完全な詳細を取得します。

インベントリ品目を取得する

この呼び出しは、特定の SKU の在庫品目レコードを取得します。

パラメーター

名前 キー 必須 説明
SKU
sku True string

在庫品目レコードを取得したい商品の販売者定義値。

戻り値

名前 パス 説明
PickupAtLocationAvailability
availability.pickupAtLocationAvailability array of object

このコンテナーは、在庫品目の店舗受け取りができるマーチャントの実店舗の配列から成っています。

可用性タイプ
availability.pickupAtLocationAvailability.availabilityType string

このフィールドは、マーチャントの実店舗での在庫品目の在庫状況を示します。

単位
availability.pickupAtLocationAvailability.fulfillmentTime.unit string

値は、フルフィルメント時間を指定するために使用される時間単位を示します

価値
availability.pickupAtLocationAvailability.fulfillmentTime.value integer

このフィールドの整数値と単位フィールドの時間単位は、フルフィルメント時間を示します。

マーチャント場所キー
availability.pickupAtLocationAvailability.merchantLocationKey string

店舗引き取り在庫品目が現在置かれている、または送付される、マーチャント店舗の一意識別子。

品質
availability.pickupAtLocationAvailability.quantity integer

この整数値は、店舗受け取りが可能な在庫品目の数量を示します

オークション
availability.shipToLocationAvailability.allocationByFormat.auction integer

この整数値は、SKU の公開オークション形式のオファー用に予約されている在庫品目の数量を示します。

固定価格
availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

この整数値は、SKU の固定価格のオファーに利用可能な在庫品目の数量を示します。

AvailabilityDistributions
availability.shipToLocationAvailability.availabilityDistributions array of object

このコンテナーは、1 つ以上の倉庫場所で在庫品目の利用可能な数量を設定するために使用されます。

単位
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

値は、フルフィルメント時間を指定するために使用される時間単位を示します

価値
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

このフィールドの整数値と単位フィールドの時間単位は、フルフィルメント時間を示します。

マーチャント場所キー
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

在庫品目の数量が利用可能な在庫場所の一意識別子。

品質
availability.shipToLocationAvailability.availabilityDistributions.quantity integer

この在庫場所で入手可能な在庫品目の数量。

品質
availability.shipToLocationAvailability.quantity integer

このコンテナーは 1 つ以上の公開オファーを通じて購入できる在庫品目の「自宅への発送」総数量を設定するために使用されます。

状態
condition string

この値は、品目の状態を示します

状態の説明
conditionDescription string

この文字列フィールドは、中古品、または品目が「新品」、「タグ付き新品」、または「箱入り新品」ではない商品の状態をより明確に説明するため、販売者により使用されます。

groupIds
groupIds array of string
inventoryItemGroupKeys
inventoryItemGroupKeys array of string

この配列は、在庫品目が任意の在庫品目グループに関連付けられている場合に返されます。

Locale
locale string

このフィールドは、要求ペイロードのフィールド値で提供された自然言語を返します

身長
packageWeightAndSize.dimensions.height number

配送パッケージの実際の高さ。

Length
packageWeightAndSize.dimensions.length number

配送パッケージの実際の長さ。

単位
packageWeightAndSize.dimensions.unit string

配送パッケージの寸法を指定するために使用される測定単位。

Width
packageWeightAndSize.dimensions.width number

配送パッケージの実際の幅。

パッケージの種類
packageWeightAndSize.packageType string

この値は、在庫品目の発送に使用される配送パッケージのタイプを示します。

単位
packageWeightAndSize.weight.unit string

配送パッケージの重量を指定するために使用される測定単位。

価値
packageWeightAndSize.weight.value number

配送パッケージの実際の重量。

アスペクト
product.aspects object

これは、商品に関する詳細情報を提供し、購入者が見つけやすくなる可能性がある、品目固有の名前と値のペアのコレクションです。

ブランド
product.brand string

製品のブランド。

Description
product.description string

製品の説明。

ean
product.ean array of string

製品の欧州統一商品番号/国際統一商品番号 (EAN)。

ePID
product.epid string

製品の eBay 製品識別子 (ePID)。

imageUrls
product.imageUrls array of string

商品の画像への 1 つ以上のリンクの配列。

isbn
product.isbn array of string

商品の国際標準図書番号の値。

MPN
product.mpn string

製品の製造業者部品番号 (MPN)。

字幕
product.subtitle string

サブタイトルは検索結果に役立つキーワードを含めることがもできる、販売者が製品に関する詳細情報を提供できるようにするオプションの出品機能です。

肩書き
product.title string

インベントリ品目のタイトルは、createOrReplaceInventoryItem 呼び出しで追加または変更できます。

UPC
product.upc array of string

商品の国際標準図書番号の値。

videoIds
product.videoIds array of string

商品に対する 1 つ以上の VideoId 値の配列。

SKU
sku string

在庫品目の販売者定義の在庫管理単位 (SKU)。 販売者は、販売するすべての製品に対して一意の SKU 値を持っている必要があります。

オファーを作成する

この呼び出しは、特定の eBay マーケットプレイスの特定の在庫品目に対するオファーを作成します。

パラメーター

名前 キー 必須 説明
利用できる数量
availableQuantity integer

購入可能な在庫数。

カテゴリ ID
categoryId string

商品が一覧表示される eBay 固有のカテゴリ ID。

チャリティー ID
charityId string

eBay が割り当てた、売り上げの一定割合を受け取るチャリティーの固有 ID。

寄付金率
donationPercentage string

一覧が生成する販売ごとにチャリティー団体が受け取る購入価格の割合。

プロデューサー製品 ID
producerProductId string

品目に関連するプロデューサーの一意識別子。

製品パッケージ ID
productPackageId string

販売者が追加した製品パッケージのプロデューサーの固有 ID。

出荷パッケージ ID
shipmentPackageId string

品目を出荷する販売者が使用した任意パッケージのプロデューサーの固有 ID。

製品ドキュメント ID
productDocumentationId string

販売者が商品の小包に追加した紙の生産者の一意識別子。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

Format
format string

オファーの出品形式。

購入者の詳細を表示しない
hideBuyerDetails boolean

このフィールドは、販売者が非公開一覧を作成する場合に含まれます。

カタログ製品の詳細を含める
includeCatalogProductDetails boolean

eBay 製品カタログの詳細が一覧に適用されるかどうかを示します。

出品の説明
listingDescription string

eBay 出品の説明。

出品期間
listingDuration string

出品が有効な日数。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

ベスト オファーの有効化
bestOfferEnabled boolean

出品に対してベスト オファー機能が有効かどうかを示します。

eBay Plus 対象の場合
eBayPlusIfEligible boolean

このフィールドは、評価の高い販売者が eBay Plus プログラムにオプトインしている場合にオファーに含まれます。

フルフィルメント ポリシー ID
fulfillmentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用されるフルフィルメント ビジネス ポリシーを示します。

支払ポリシー ID
paymentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用される支払ビジネス ポリシーを示します。

製品コンプライアンス ポリシー ID
productCompliancePolicyIds array of string

このフィールドには、販売者が作成した一覧のコンプライアンス ポリシーを指定する最大 5 つの ID の配列が含まれます。

返品ポリシー ID
returnPolicyId string

オファーが公開されて eBay の一覧に変換された時点で使用される返品ビジネス ポリシー固有 ID です。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

優先順位
priority integer

このフィールドに入力された整数値は、shippingServiceType 値とともに、フルフィルメント ポリシーのどの国内または国際配送サービス オプションが更新された送料で変更されるかを設定します。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

サービスの種類
shippingServiceType string

この値は、優先度フィールドで指定された配送サービスが国内または国際配送サービスのオプションであるかどうかを示します。

テイク バック ポリシー ID
takeBackPolicyId string

テイク バック ポリシーを作成した販売者 ID。

出品開始日
listingStartDate string

このフィールドは、販売者が eBay で出品が有効になる将来の時間を指定する場合に使用できます。

ロット サイズ
lotSize integer

このフィールドは、出品がロット出品の場合にのみ適用されます。 このフィールドに渡される整数値は、ロット内のアイテムの総数です。

マーケットプレース ID
marketplaceId string

オファーが利用可能になる eBay サイトの固有 ID。

マーチャント場所キー
merchantLocationKey string

マーチャントの在庫場所の一意識別子

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

当初は小売価格で販売されていたもの
originallySoldForRetailPriceOn string

このフィールドは、オファーで取り消し価格設定機能が使用される場合に必要です。 このフィールドは、製品が eBay サイトの元の RetailPrice フィールドの価格で販売されたか、またはサードパーティの小売業者によってその価格で販売されたことを示します

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

価格設定の可視性
pricingVisibility string

このフィールドは、オファーで最小広告価格機能が使用される場合に必要です。

購入者ごとの数量制限
quantityLimitPerBuyer integer

このフィールドは、販売者が販売者ごとの購入数量に制限を設定したい場合にのみ適用および設定されます。

セカンダリ カテゴリ ID
secondaryCategoryId string

販売者が 2 つのカテゴリで商品を出品することを決定した場合に適用される、固有のセカンダリ カテゴリ ID。

SKU
sku string

eBay サイトに一覧表示される商品の販売者定義 SKU 値。

店舗カテゴリの名前
storeCategoryNames array of string

店舗カテゴリの名前

税金の適用
applyTax boolean

このコンテナーは、消費税テーブル、付加価値税率、または税の例外カテゴリ コードがオファーに適用される場合にのみ適用され使用されます。

サード パーティ税カテゴリ
thirdPartyTaxCategory string

税の例外カテゴリ コード。 このフィールドを使用すると、品目価格だけでなく、サービス/手数料にも消費税が適用されます。

VAT 税率
vatPercentage number

この値は、該当する場合、品目の VAT 率です。 VAT 率を指定すると、品目の VAT 情報が一覧の品目表示ページに表示されます。

戻り値

名前 パス 説明
オファー ID
offerId string

オファーの一意識別子

warnings
warnings array of object

このコンテナーは、呼び出しが行われ、エラーや警告が発生したときに返されます。

カテゴリー
warnings.category string

この文字列値はエラー カテゴリを示します

Domain
warnings.domain string

エラーまたは警告が発生したドメイン名。

エラー ID
warnings.errorId integer

発生した特定のエラーまたは警告を識別する固有コード。

inputRefIds
warnings.inputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の要求要素を識別する 1 つ以上の参照 ID の配列。

長いメッセージ
warnings.longMessage string

エラーまたは警告の原因となった状態の詳細な説明と、問題を修正するための情報。

Message
warnings.message string

エラーや警告の原因となる状況の説明。

outputRefIds
warnings.outputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の応答要素を識別する 1 つ以上の参照 ID の配列。

parameters
warnings.parameters array of object

さまざまな警告およびエラー メッセージは、エラーまたは警告に関するコンテキスト情報を含む 1 つ以上の変数を返します。

名称
warnings.parameters.name string

名称

価値
warnings.parameters.value string

価値

サブドメイン
warnings.subdomain string

エラーまたは警告が発生したサブドメイン名。

オファーを公開する

この呼び出しは、未公開オファーを公開オファー、またはライブの eBay 出品に変換するために使用されます。 オファーの一意識別子 (offerId) は、呼び出し URI の最後に渡されます。

パラメーター

名前 キー 必須 説明
オファー ID
offerId True string

公開するオファーの一意識別子。

戻り値

名前 パス 説明
出品 ID
listingId string

新しく作成された eBay 出品の一意識別子。

warnings
warnings array of object

このコンテナーは、オファーを撤回しようとした際に、警告が 1 つ以上あった場合に返されます。

カテゴリー
warnings.category string

この文字列値はエラー カテゴリを示します。

Domain
warnings.domain string

エラーまたは警告が発生したドメインの名前。

エラー ID
warnings.errorId integer

発生した特定のエラーまたは警告を識別する固有コード。

inputRefIds
warnings.inputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の要求要素を識別する 1 つ以上の参照 ID の配列。

長いメッセージ
warnings.longMessage string

エラーまたは警告の原因となった状態の詳細な説明と、問題を修正するための情報。

Message
warnings.message string

エラーや警告の原因となる状況の説明。

outputRefIds
warnings.outputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の応答要素を識別する 1 つ以上の参照 ID の配列。

parameters
warnings.parameters array of object

さまざまな警告およびエラー メッセージは、エラーまたは警告に関するコンテキスト情報を含む 1 つ以上の変数を返します。

名称
warnings.parameters.name string

名称

価値
warnings.parameters.value string

価値

サブドメイン
warnings.subdomain string

エラーまたは警告が発生したサブドメインの名前。

オファーを削除する

この呼び出しはオファーを完全に削除します

パラメーター

名前 キー 必須 説明
オファー ID
offerId True string

削除するオファーの一意識別子。

戻り値

返答
string

オファーを取得する

この呼び出しは、特定の公開済みまたは未公開のオファーを取得します。

パラメーター

名前 キー 必須 説明
オファー ID
offerId True string

取得するオファーの一意識別子。

戻り値

名前 パス 説明
利用できる数量
availableQuantity integer

購入者が購入できる在庫品目の数量。

カテゴリ ID
categoryId string

在庫品目が一覧表示されている主要な eBay カテゴリの一意識別子。

チャリティー ID
charity.charityId string

eBay が割り当てた、売り上げの一定割合を受け取るチャリティー団体の一意識別子。

寄付金率
charity.donationPercentage string

一覧が生成する販売ごとにチャリティー団体が受け取る購入価格の割合。

プロデューサー製品 ID
extendedProducerResponsibility.producerProductId string

品目に関連するプロデューサーの一意識別子。

製品パッケージ ID
extendedProducerResponsibility.productPackageId string

販売者が追加した製品に関連する任意パッケージのプロデューサーの固有 ID。

出荷パッケージ ID
extendedProducerResponsibility.shipmentPackageId string

品目を出荷する販売者が使用した任意パッケージのプロデューサーの一意識別子。

製品ドキュメント ID
extendedProducerResponsibility.productDocumentationId string

販売者が商品の小包に追加した紙の生産者の一意識別子。

通貨型
extendedProducerResponsibility.ecoParticipationFee.currency string

通貨の種類を表す 3 桁の文字列値。

価値
extendedProducerResponsibility.ecoParticipationFee.value string

通貨フィールドで表されるドル値の文字列表現。

Format
format string

オファーの出品形式

購入者の詳細を表示しない
hideBuyerDetails boolean

オファーに対して非公開出品機能が有効になっている場合、このフィールドは true として返されます。

カタログ製品の詳細を含める
includeCatalogProductDetails boolean

このフィールドは eBay 製品カタログの詳細が出品に適用されるかどうかを示します。

出品 ID
listing.listingId string

公開オファーに関連付けられている eBay 出品の一意識別子。

出品の状態
listing.listingStatus string

公開オファーに関連付けられている出品の状態。

販売数
listing.soldQuantity integer

公開オファーで販売された製品の数量。

出品説明
listingDescription string

eBay 出品の説明

出品期間
listingDuration string

このフィールドは出品が有効な日数を示します。

通貨型
listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
listingPolicies.bestOfferTerms.autoAcceptPrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
listingPolicies.bestOfferTerms.autoDeclinePrice.value string

通貨フィールドで表されるドル値の文字列表現。

ベスト オファーの有効化
listingPolicies.bestOfferTerms.bestOfferEnabled boolean

このコンテナーは、販売者が出品でベスト オファー機能をサポートしたい場合に使用されます。

eBay Plus 対象の場合
listingPolicies.eBayPlusIfEligible boolean

このフィールドは、評価の高い販売者が eBay Plus プログラムにオプトインしている場合にオファーに含まれます。

フルフィルメント ポリシー ID
listingPolicies.fulfillmentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用されるフルフィルメント ビジネス ポリシーを示します。

支払ポリシー ID
listingPolicies.paymentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用される支払ビジネス ポリシーを示します。

productCompliancePolicyIds
listingPolicies.productCompliancePolicyIds array of string

このフィールドには、販売者が作成した一覧のコンプライアンス ポリシーを指定する最大 5 つの ID の配列が含まれます。

返品ポリシー ID
listingPolicies.returnPolicyId string

一意識別子は、オファーが公開されて eBay 出品に変換された時点で使用される返品ビジネス ポリシーを示します。

shippingCostOverrides
listingPolicies.shippingCostOverrides array of object

このコンテナーは、販売者がフルフィルメント出品ポリシーで定義された 1 つまたは複数の国内または国際配送サービス オプションの送料を上書きしたい場合に使用されます。

通貨型
listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

通貨の種類を表す 3 桁の文字列値。

価値
listingPolicies.shippingCostOverrides.additionalShippingCost.value string

通貨フィールドで表されるドル値の文字列表現。

優先順位
listingPolicies.shippingCostOverrides.priority integer

このフィールドに入力された整数値は、shippingServiceType 値とともに、フルフィルメント ポリシーのどの国内または国際配送サービス オプションが更新された送料で変更されるかを設定します。

通貨型
listingPolicies.shippingCostOverrides.shippingCost.currency string

通貨の種類を表す 3 桁の文字列値。

価値
listingPolicies.shippingCostOverrides.shippingCost.value string

通貨フィールドで表されるドル値の文字列表現。

配送サービスの種類
listingPolicies.shippingCostOverrides.shippingServiceType string

この値は、配送サービスが国内または国際配送サービスのオプションであるかどうかを示します。

テイク バック ポリシー ID
listingPolicies.takeBackPolicyId string

テイク バック ポリシーで作成された販売者 ID。

出品開始日
listingStartDate string

このタイムスタンプは、販売者が予定された出品のために設定した日時です。

ロット サイズ
lotSize integer

このフィールドは、出品がロット出品の場合にのみ適用されます。 ロット出品とは、同じ商品を複数で出品することです。

マーケットプレース ID
marketplaceId string

オファーが利用できる、または利用可能になる予定の eBay サイトの一意識別子。

マーチャント場所キー
merchantLocationKey string

在庫場所の一意識別子。

オファー ID
offerId string

オファーの一意識別子。

通貨型
pricingSummary.auctionReservePrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
pricingSummary.auctionReservePrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
pricingSummary.auctionStartPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
pricingSummary.auctionStartPrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
pricingSummary.minimumAdvertisedPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
pricingSummary.minimumAdvertisedPrice.value string

通貨フィールドで表されるドル値の文字列表現。

当初は小売価格で販売されていたもの
pricingSummary.originallySoldForRetailPriceOn string

このフィールドは、オファーで取り消し価格設定機能が使用される場合に必要です。 このフィールドは、製品が eBay サイトの元の RetailPrice フィールドの価格で販売されたか、またはサードパーティの小売業者によってその価格で販売されたことを示します。

通貨型
pricingSummary.originalRetailPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
pricingSummary.originalRetailPrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
pricingSummary.price.currency string

通貨の種類を表す 3 桁の文字列値。

価値
pricingSummary.price.value string

通貨フィールドで表されるドル値の文字列表現。

価格設定の可視性
pricingSummary.pricingVisibility string

このフィールドは、オファーで最小広告価格機能が使用される場合に必要です。

購入者ごとの数量制限
quantityLimitPerBuyer integer

このフィールドは、販売者が販売者ごとの在庫品目の購入数量に制限を設定したい場合にのみ適用されます。

セカンダリ カテゴリ ID
secondaryCategoryId string

販売者が 2 つのカテゴリで商品を出品することを決定した場合に適用される、セカンダリ カテゴリの一意識別子。

SKU
sku string

販売者が定義した、オファー中の商品の SKU 値。

Status
status string

値はオファーの状態を指定します。

店舗カテゴリの名前
storeCategoryNames array of string

店舗カテゴリの名前

税金の適用
tax.applyTax boolean

このフィールドは、販売者がアカウント レベルの消費税を参照したい場合に含まれます

サード パーティ税カテゴリ
tax.thirdPartyTaxCategory string

税の例外カテゴリ コード。 このフィールドを使用すると、品目価格だけでなく、サービス/手数料にも消費税が適用されます。

VAT 税率
tax.vatPercentage number

この値は、該当する場合、品目の VAT 率です。 VAT 率を指定すると、品目の VAT 情報が一覧の品目表示ページに表示されます。

オファーを取得する

この呼び出しは、指定された SKU 値の既存のオファーをすべて取得します。 販売者には、検索されるオファーを特定の eBay マーケットプレイスまたは出品形式に制限するオプションがあります。

パラメーター

名前 キー 必須 説明
SKU
sku True string

販売者定義の SKU 値

マーケットプレース ID
marketplace_id string

eBay マーケティング の一意識別子。

Format
format string

オファーの出品形式。

Limit
limit string

データのページごとに返すレコードの最大数。

ページ
offset string

取得するページ番号。

戻り値

名前 パス 説明
Href
href string

オファーの現在のページへの URL。

Limit
limit integer

各結果ページに表示されるオファーの数。

next string

オファーの次のページへの URL。

オファー
offers array of object

このコンテナーは、SKU 値に対する 1 つ以上の販売者のオファーの配列です。

利用できる数量
offers.availableQuantity integer

購入可能な在庫品目の数量。

カテゴリ ID
offers.categoryId string

在庫品目が一覧表示される eBay カテゴリの固有 ID。

チャリティー ID
offers.charity.charityId string

eBay が割り当てた、売り上げの一定割合を受け取るチャリティー団体の一意識別子。

寄付金率
offers.charity.donationPercentage string

販売ごとにチャリティー団体が受け取る購入価格の割合。

プロデューサー製品 ID
offers.extendedProducerResponsibility.producerProductId string

品目に関連するプロデューサーの一意識別子。

製品パッケージ ID
offers.extendedProducerResponsibility.productPackageId string

販売者が追加した製品パッケージの固有 ID。

出荷パッケージ ID
offers.extendedProducerResponsibility.shipmentPackageId string

品目を出荷する販売者が使用した任意パッケージのプロデューサーの一意識別子。

製品ドキュメント ID
offers.extendedProducerResponsibility.productDocumentationId string

販売者が商品の小包に追加した紙の生産者の一意識別子。

通貨型
offers.extendedProducerResponsibility.ecoParticipationFee.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.extendedProducerResponsibility.ecoParticipationFee.value string

通貨フィールドで表されるドル値の文字列表現。

Format
offers.format string

この値はオファーの出品形式を設定します

購入者の詳細を表示しない
offers.hideBuyerDetails boolean

オファーに対して非公開出品機能が有効になっている場合、このフィールドは true として返されます。

カタログ製品の詳細を含める
offers.includeCatalogProductDetails boolean

このフィールドは eBay 製品カタログの詳細が出品に適用されるかどうかを示します。

出品 ID
offers.listing.listingId string

公開オファーに関連付けられている eBay 出品の一意識別子。

出品の状態
offers.listing.listingStatus string

公開オファーに関連付けられている出品の状態。

販売数
offers.listing.soldQuantity integer

公開オファーで販売された製品数。

出品の説明
offers.listingDescription string

eBay 出品の説明。

出品期間
offers.listingDuration string

出品が有効な日数を示します。

通貨型
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value string

通貨フィールドで表されるドル値の文字列表現。

ベスト オファーの有効化
offers.listingPolicies.bestOfferTerms.bestOfferEnabled boolean

このフィールドは出品に対してベスト オファー機能が有効かどうかを示します。

eBay Plus 対象の場合
offers.listingPolicies.eBayPlusIfEligible boolean

このフィールドは、評価の高い販売者が eBay Plus プログラムにオプトインしている場合にオファーに含まれ、true に設定されます

フルフィルメント ポリシー ID
offers.listingPolicies.fulfillmentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用されるフルフィルメント ビジネス ポリシーを示します。

支払ポリシー ID
offers.listingPolicies.paymentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用される支払ビジネス ポリシーを示します。

productCompliancePolicyIds
offers.listingPolicies.productCompliancePolicyIds array of string

このフィールドには、販売者が作成した一覧のコンプライアンス ポリシーを指定する最大 5 つの ID の配列が含まれます。

返品ポリシー ID
offers.listingPolicies.returnPolicyId string

一意識別子は、オファーが公開されて eBay 出品に変換された時点で使用される返品ビジネス ポリシーを示します。

shippingCostOverrides
offers.listingPolicies.shippingCostOverrides array of object

このコンテナーは、販売者がフルフィルメント一覧ポリシーで定義された 1 つまたは複数の国内または国際配送サービス オプションの送料または追加料金を上書きしたい場合に使用されます。

通過
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

通過

価値
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value string

価値

優先度
offers.listingPolicies.shippingCostOverrides.priority integer

優先度

通過
offers.listingPolicies.shippingCostOverrides.shippingCost.currency string

通過

価値
offers.listingPolicies.shippingCostOverrides.shippingCost.value string

価値

shippingServiceType
offers.listingPolicies.shippingCostOverrides.shippingServiceType string

shippingServiceType

テイク バック ポリシー ID
offers.listingPolicies.takeBackPolicyId string

テイク バック ポリシーを作成した販売者 ID。

出品開始日
offers.listingStartDate string

販売者が予定された出品のために設定した日付/時間。

ロット サイズ
offers.lotSize integer

このフィールドは、出品がロット出品の場合にのみ適用され返されます。

マーケットプレース ID
offers.marketplaceId string

オファーが利用できる、または利用可能になる予定の eBay サイトの一意識別子。

マーチャント場所キー
offers.merchantLocationKey string

在庫場所の一意識別子。

オファー ID
offers.offerId string

オファーの一意識別子。

通貨型
offers.pricingSummary.auctionReservePrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.pricingSummary.auctionReservePrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
offers.pricingSummary.auctionStartPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.pricingSummary.auctionStartPrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
offers.pricingSummary.minimumAdvertisedPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.pricingSummary.minimumAdvertisedPrice.value string

通貨フィールドで表されるドル値の文字列表現。

当初は小売価格で販売されていたもの
offers.pricingSummary.originallySoldForRetailPriceOn string

このフィールドは、オファーで取り消し価格設定機能が使用される場合に必要です。 このフィールドは、製品が eBay サイトの元の RetailPrice フィールドの価格で販売されたか、またはサードパーティの小売業者によってその価格で販売されたことを示します。

通貨型
offers.pricingSummary.originalRetailPrice.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.pricingSummary.originalRetailPrice.value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
offers.pricingSummary.price.currency string

通貨の種類を表す 3 桁の文字列値。

価値
offers.pricingSummary.price.value string

通貨フィールドで表されるドル値の文字列表現。

価格設定の可視性
offers.pricingSummary.pricingVisibility string

このフィールドは、オファーで最小広告価格機能が使用される場合に必要です。

購入者ごとの数量制限
offers.quantityLimitPerBuyer integer

このフィールドは、販売者が販売者ごとの在庫品目の購入数量に制限を設定したい場合にのみ適用され設定されます。

セカンダリ カテゴリ ID
offers.secondaryCategoryId string

セカンダリ カテゴリの一意識別子。

SKU
offers.sku string

販売者が定義した、オファー中の商品の SKU 値。

Status
offers.status string

値はオファーの状態を指定します。

storeCategoryNames
offers.storeCategoryNames array of string

このコンテナーは、販売者が eBay 店舗用に設定した 1 つまたは 2 つの eBay 店舗カテゴリに在庫品目の配置を選択する場合に返されます

税金の適用
offers.tax.applyTax boolean

このフィールドは、販売者が注文の消費税を計算するためにアカウント レベルの消費税テーブルを参照したい場合に含まれます。

サード パーティ税カテゴリ
offers.tax.thirdPartyTaxCategory string

税の例外カテゴリ コード。

VAT 税率
offers.tax.vatPercentage number

該当する場合、品目の付加価値税 (VAT) 率値です。

prev string

オファーの前のページを取得する URL。

規模
size integer

結果の現在のページで表示されているオファーの数。

トータル
total integer

指定された SKU 値に対して存在するオファーの総数。

オファーを撤回する

この呼び出しは、指定されたオファーに関連付けられている単一バリエーション出品を終了するために使用されます。

パラメーター

名前 キー 必須 説明
オファー ID
offerId True string

撤回するオファーの一意識別子。

戻り値

名前 パス 説明
出品 ID
listingId string

撤回されたオファーに関連付けられている eBay 出品の一意識別子。

warnings
warnings array of object

このコンテナーは、オファーを撤回しようとした際に、警告が 1 つ以上あった場合に返されます。

カテゴリー
warnings.category string

この文字列値はエラー カテゴリを示します

Domain
warnings.domain string

この文字列値はエラー カテゴリを示します

エラー ID
warnings.errorId integer

発生した特定のエラーまたは警告を識別する固有コード。

inputRefIds
warnings.inputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の要求要素を識別する 1 つ以上の参照 ID の配列。

長いメッセージ
warnings.longMessage string

エラーまたは警告の原因となった状態の詳細な説明と、問題を修正するための情報。

Message
warnings.message string

エラーや警告の原因となる状況の説明。

outputRefIds
warnings.outputRefIds array of string

このコンテナーは、オファーを撤回しようとした際に、警告が 1 つ以上あった場合に返されます。

parameters
warnings.parameters array of object

さまざまな警告およびエラー メッセージは、エラーまたは警告に関するコンテキスト情報を含む 1 つ以上の変数を返します。

名称
warnings.parameters.name string

名称

価値
warnings.parameters.value string

価値

サブドメイン
warnings.subdomain string

エラーまたは警告が発生したサブドメインの名前。

オファーを更新する

この呼び出しは、公開済みまたは未公開の状態である既存のオファーを更新します。

パラメーター

名前 キー 必須 説明
オファー ID
offerId True string

更新するオファーの一意識別子。

利用できる数量
availableQuantity integer

購入可能な在庫数。

カテゴリ ID
categoryId string

商品が一覧表示される eBay 固有のカテゴリ ID。

チャリティー ID
charityId string

eBay が割り当てた、売り上げの一定割合を受け取るチャリティーの固有 ID。

寄付金率
donationPercentage string

一覧が生成する販売ごとにチャリティー団体が受け取る購入価格の割合。

プロデューサー製品 ID
producerProductId string

品目に関連するプロデューサーの一意識別子。

製品パッケージ ID
productPackageId string

販売者が追加した製品パッケージのプロデューサーの固有 ID。

出荷パッケージ ID
shipmentPackageId string

品目を出荷する販売者が使用した任意パッケージのプロデューサーの固有 ID。

製品ドキュメント ID
productDocumentationId string

販売者が商品の小包に追加した紙の生産者の一意識別子。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

購入者の詳細を表示しない
hideBuyerDetails boolean

このフィールドは、販売者が非公開一覧を作成する場合に含まれます。

カタログ製品の詳細を含める
includeCatalogProductDetails boolean

eBay 製品カタログの詳細が一覧に適用されるかどうかを示します。

出品の説明
listingDescription string

eBay 出品の説明。

出品期間
listingDuration string

出品が有効な日数。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

ベスト オファーの有効化
bestOfferEnabled boolean

出品に対してベスト オファー機能が有効かどうかを示します。

eBay Plus 対象の場合
eBayPlusIfEligible boolean

このフィールドは、評価の高い販売者が eBay Plus プログラムにオプトインしている場合にオファーに含まれます。

フルフィルメント ポリシー ID
fulfillmentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用されるフルフィルメント ビジネス ポリシーを示します。

支払ポリシー ID
paymentPolicyId string

一意識別子は、オファーが公開されて eBay の一覧に変換された時点で使用される支払ビジネス ポリシーを示します。

製品コンプライアンス ポリシー ID
productCompliancePolicyIds array of string

このフィールドには、販売者が作成した一覧のコンプライアンス ポリシーを指定する最大 5 つの ID の配列が含まれます。

返品ポリシー ID
returnPolicyId string

オファーが公開されて eBay の一覧に変換された時点で使用される返品ビジネス ポリシー固有 ID です。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

優先順位
priority integer

このフィールドに入力された整数値は、shippingServiceType 値とともに、フルフィルメント ポリシーのどの国内または国際配送サービス オプションが更新された送料で変更されるかを設定します。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

サービスの種類
shippingServiceType string

この値は、優先度フィールドで指定された配送サービスが国内または国際配送サービスのオプションであるかどうかを示します。

テイク バック ポリシー ID
takeBackPolicyId string

テイク バック ポリシーを作成した販売者 ID。

出品開始日
listingStartDate string

このフィールドは、販売者が eBay で出品が有効になる将来の時間を指定する場合に使用できます。

ロット サイズ
lotSize integer

このフィールドは、出品がロット出品の場合にのみ適用されます。 このフィールドに渡される整数値は、ロット内のアイテムの総数です。

マーチャント場所キー
merchantLocationKey string

マーチャントの在庫場所の一意識別子

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

当初は小売価格で販売されていたもの
originallySoldForRetailPriceOn string

このフィールドは、オファーで取り消し価格設定機能が使用される場合に必要です。 このフィールドは、製品が eBay サイトの元の RetailPrice フィールドの価格で販売されたか、またはサードパーティの小売業者によってその価格で販売されたことを示します

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

通貨型
currency string

通貨の種類を表す 3 桁の文字列値。

価値
value string

通貨フィールドで表されるドル値の文字列表現。

価格設定の可視性
pricingVisibility string

このフィールドは、オファーで最小広告価格機能が使用される場合に必要です。

購入者ごとの数量制限
quantityLimitPerBuyer integer

このフィールドは、販売者が販売者ごとの購入数量に制限を設定したい場合にのみ適用および設定されます。

セカンダリ カテゴリ ID
secondaryCategoryId string

販売者が 2 つのカテゴリで商品を出品することを決定した場合に適用される、固有のセカンダリ カテゴリ ID。

店舗カテゴリの名前
storeCategoryNames array of string

店舗カテゴリの名前

税金の適用
applyTax boolean

このコンテナーは、消費税テーブル、付加価値税率、または税の例外カテゴリ コードがオファーに適用される場合にのみ適用され使用されます。

サード パーティ税カテゴリ
thirdPartyTaxCategory string

税の例外カテゴリ コード。 このフィールドを使用すると、品目価格だけでなく、サービス/手数料にも消費税が適用されます。

VAT 税率
vatPercentage number

この値は、該当する場合、品目の VAT 率です。 VAT 率を指定すると、品目の VAT 情報が一覧の品目表示ページに表示されます。

戻り値

名前 パス 説明
オファー ID
offerId string

オファーの一意識別子

warnings
warnings array of object

このコンテナーは、呼び出しが行われ、エラーや警告が発生したときに返されます。

カテゴリー
warnings.category string

この文字列値はエラー カテゴリを示します

Domain
warnings.domain string

エラーまたは警告が発生したドメイン名。

エラー ID
warnings.errorId integer

発生した特定のエラーまたは警告を識別する固有コード。

inputRefIds
warnings.inputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の要求要素を識別する 1 つ以上の参照 ID の配列。

長いメッセージ
warnings.longMessage string

エラーまたは警告の原因となった状態の詳細な説明と、問題を修正するための情報。

Message
warnings.message string

エラーや警告の原因となる状況の説明。

outputRefIds
warnings.outputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の応答要素を識別する 1 つ以上の参照 ID の配列。

parameters
warnings.parameters array of object

さまざまな警告およびエラー メッセージは、エラーまたは警告に関するコンテキスト情報を含む 1 つ以上の変数を返します。

名称
warnings.parameters.name string

名称

価値
warnings.parameters.value string

価値

サブドメイン
warnings.subdomain string

エラーまたは警告が発生したサブドメイン名。

カテゴリの品目アスペクトを取得する

この呼び出しは、指定されたリーフ カテゴリの項目を正確に説明するために適切または必要なアスペクトの一覧を返します。 各アスペクトは、eBay でそのカテゴリの品目を提供するときに、販売者が値 (またはバリエーション値) を提供する必要がある、または推奨されるアイテム属性 (たとえば、色) を識別します。

パラメーター

名前 キー 必須 説明
カテゴリ ツリー ID
category_tree_id True string

指定されたカテゴリのアスペクトが要求されている eBay カテゴリ ツリー固有 ID。

カテゴリ ID
category_id True string

アスペクトが要求されているリーフ カテゴリの一意識別子。

戻り値

名前 パス 説明
アスペクト
aspects array of object

特定のリーフ カテゴリの品目を説明するのに適した品目アスペクトの一覧

適用可能なアスペクト
aspects.aspectConstraint.aspectApplicableTo array of string

この値は、aspects.localizedAspectName フィールドによって識別されるアスペクトが、製品アスペクトであるか、または製品の特定インスタンスに基づいて値が変化する品目/インスタンスアスペクトであるかを示します。

アスペクト データ型
aspects.aspectConstraint.aspectDataType string

アスペクト データ型。

バリエーションに有効なアスペクト
aspects.aspectConstraint.aspectEnabledForVariations boolean

true の値は、このアスペクトを使用して品目のバリエーションを識別できることを示します。

アスペクト形式
aspects.aspectConstraint.aspectFormat string

aspectDataType の値が特定の書式設定を必要とするデータ型を識別する場合にのみ返されます。

アスペクトの最大長
aspects.aspectConstraint.aspectMaxLength integer

品目のアスペクト値の最大長。

アスペクト モード
aspects.aspectConstraint.aspectMode string

このアスペクトの値が販売者によって指定されなければならない方法。

必要なアスペクト
aspects.aspectConstraint.aspectRequired boolean

true の値は、指定されたカテゴリの品目ムを提供するときにこのアスペクトが必要であることを示します。

アスペクト使用率
aspects.aspectConstraint.aspectUsage string

値は、対応するアスペクトが推奨されるかオプションであるかを示します。

予定所要日
aspects.aspectConstraint.expectedRequiredByDate string

アスペクトが必要になる以降の予定日。

アスペクト カーディナリティへの品目
aspects.aspectConstraint.itemToAspectCardinality string

このアスペクトが、指定されたカテゴリの品目に対して単一または複数の値を受け入れることができるかどうかを示します。

aspectValues
aspects.aspectValues array of object

このアスペクトの任意の制約とともに有効な値の一覧。

localizedValue
aspects.aspectValues.localizedValue string

このアスペクトのローカライズ値。

valueConstraints
aspects.aspectValues.valueConstraints array of object

localizedValue フィールドの値が現在のアスペクトでいつ利用可能であるかを特定する依存関係の一覧が含まれます。

applicableForLocalizedAspectName
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName string

現在のアスペクト値が依存するコントロール アスペクトの名前。

applicableForLocalizedAspectValues
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues array of string

このアスペクトの値が依存するコントロール アスペクトの値の一覧が含まれます。

ローカライズ済みアスペクト名
aspects.localizedAspectName string

このアスペクトのローカライズ名。

検索件数
aspects.relevanceIndicator.searchCount integer

アスペクトの最近の検索数。

カテゴリ提案を取得する

この呼び出しは、指定されたカテゴリ ツリー内のカテゴリ ツリー リーフ ノードの配列を返します。これらは、eBay によってクエリに最も密接に対応すると見なされます。

パラメーター

名前 キー 必須 説明
カテゴリ ツリー ID
category_tree_id True string

提案されたノードが要求されている eBay カテゴリ ツリーの一意識別子。

検索語句
q True string

販売中の品目を説明する検索語句。

戻り値

名前 パス 説明
categorySuggestions
categorySuggestions array of object

指定されたキーワードに対応する 1 つ以上の提案されたカテゴリに関する詳細が含まれます。

カテゴリ ID
categorySuggestions.category.categoryId string

カテゴリ ツリー内の eBay カテゴリの一意識別子。

カテゴリ名
categorySuggestions.category.categoryName string

categoryId で識別されるカテゴリの名前。

カテゴリ ツリー ノードの上位
categorySuggestions.categoryTreeNodeAncestors array of object

指定されたカテゴリ ツリーで提案されたカテゴリの場所を説明する、カテゴリ参照の順序付きリストの配列。

categoryId
categorySuggestions.categoryTreeNodeAncestors.categoryId string

eBay 上位カテゴリの一意識別子。

categoryName
categorySuggestions.categoryTreeNodeAncestors.categoryName string

categoryId で識別される上位カテゴリの名前。

categorySubtreeNodeHref
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref string

上位カテゴリ ノード下のサブツリーを取得する getCategorySubtree 呼び出しの href 部分。

categoryTreeNodeLevel
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel integer

カテゴリ ツリーの階層における上位カテゴリ ノードの絶対レベル。

カテゴリ ツリー ノード レベル
categorySuggestions.categoryTreeNodeLevel integer

カテゴリ ツリーの階層における上位カテゴリ ノードの絶対レベル。

関連性
categorySuggestions.relevancy string

このフィールドは、内部または将来の使用にのみ確保されます。

カテゴリ ツリー ID
categoryTreeId string

提案が返される eBay カテゴリ ツリーの一意識別子。

カテゴリ ツリー バージョン
categoryTreeVersion string

categoryTreeId によって識別されるカテゴリ ツリーのバージョン。

フルフィルメント ポリシーを取得する

このメソッドは、marketplace_id クエリ パラメーターを使用して指定するマーケットプレイス用に構成されたすべてのフルフィルメント ポリシーを取得します。

パラメーター

名前 キー 必須 説明
マーケットプレース ID
marketplace_id True string

取得するポリシーの eBay マーケットプレース ID

戻り値

名前 パス 説明
fulfillmentPolicies
fulfillmentPolicies array of object

指定されたマーケットプレイスに対して定義された販売者のフルフィルメント ポリシーの一覧。

カテゴリの種類
fulfillmentPolicies.categoryTypes array of object

このコンテナーは、フルフィルメント ポリシーが自動車または非自動車の出品に適用されるかどうかに適用されます。

名称
fulfillmentPolicies.categoryTypes.name string

ポリシーが適用されるカテゴリ タイプ

Description
fulfillmentPolicies.description string

フルフィルメント ポリシーの販売者定義の説明。

貨物輸送
fulfillmentPolicies.freightShipping boolean

true が返された場合、販売者は 150 lbs を超える大型商品の貨物輸送を提供しています。

フルフィルメント ポリシー ID
fulfillmentPolicies.fulfillmentPolicyId string

フルフィルメント ポリシー用に eBay が割り当てた固有 ID。

グローバル配送
fulfillmentPolicies.globalShipping boolean

true が返された場合、販売者は eBay のグローバル配送プログラムを使用して、品目を海外の場所に発送します。

単位
fulfillmentPolicies.handlingTime.unit string

DAY などの時間測定単位。

価値
fulfillmentPolicies.handlingTime.value integer

単位フィールドで指定された時間測定単位の値。

ローカル ピックアップ
fulfillmentPolicies.localPickup boolean

true が返された場合、このポリシーでローカル ピックアップを利用できます。

マーケットプレース ID
fulfillmentPolicies.marketplaceId string

このフルフィルメント ポリシーが適用される eBay マーケットプレースの ID。

件名
fulfillmentPolicies.name string

このフルフィルメント ポリシーの販売者定義名。 同じマーケットプレイスに割り当てられたポリシーの名前は一意である必要があります。

ピックアップ ドロップオフ
fulfillmentPolicies.pickupDropOff boolean

true が返された場合、販売者は「クリック アンド コレクト」オプションを提供しています。

shippingOptions
fulfillmentPolicies.shippingOptions array of object

配列では、ポリシーで利用可能な国内および国際配送オプションに関する詳細情報を提供します。

原価タイプ
fulfillmentPolicies.shippingOptions.costType string

このフィールドは、原価モデルが FLAT_RATE か CALCULATED かを定義します

通貨型
fulfillmentPolicies.shippingOptions.insuranceFee.currency string

金額を設定する値フィールドに適用される基本通貨。

価値
fulfillmentPolicies.shippingOptions.insuranceFee.value string

指定された通貨の金額。

optionType
fulfillmentPolicies.shippingOptions.optionType string

optionType

通過
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency string

通過

価値
fulfillmentPolicies.shippingOptions.packageHandlingCost.value string

価値

rateTableId
fulfillmentPolicies.shippingOptions.rateTableId string

rateTableId

shippingServices
fulfillmentPolicies.shippingOptions.shippingServices array of object

shippingServices

通過
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency string

通過

価値
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value string

価値

buyerResponsibleForPickup
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup boolean

buyerResponsibleForPickup

buyerResponsibleForShipping
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping boolean

buyerResponsibleForShipping

通過
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency string

通過

価値
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value string

価値

freeShipping
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping boolean

freeShipping

shippingCarrierCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode string

shippingCarrierCode

通過
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency string

通過

価値
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value string

価値

shippingServiceCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode string

shippingServiceCode

regionExcluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

regionName
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

regionName

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

regionName
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

regionName

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder integer

sortOrder

通過
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency string

通過

価値
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value string

価値

例外の地域
fulfillmentPolicies.shipToLocations.regionExcluded array of object

販売者が発送しない地域を指定する regionName 値の配列。

regionName
fulfillmentPolicies.shipToLocations.regionExcluded.regionName string

regionName

regionType
fulfillmentPolicies.shipToLocations.regionExcluded.regionType string

regionType

含まれる地域
fulfillmentPolicies.shipToLocations.regionIncluded array of object

販売者が発送する地域を指定する regionName フィールドの配列。

regionName
fulfillmentPolicies.shipToLocations.regionIncluded.regionName string

regionName

regionType
fulfillmentPolicies.shipToLocations.regionIncluded.regionType string

regionType

Href
href string

このフィールドは今後使用するためのものです。

Limit
limit integer

このフィールドは今後使用するためのものです。

next string

このフィールドは今後使用するためのものです。

ページ
offset integer

このフィールドは今後使用するためのものです。

prev string

このフィールドは今後使用するためのものです。

トータル
total integer

結果セットで取得されるフルフィルメント ポリシーの総数。

フルフィルメント ポリシーを取得する

このメソッドは、フルフィルメント ポリシーの完全な詳細を取得します。 fulfillmentPolicyId パス パラメーターを使用して、取得するポリシーの ID を供給します。

パラメーター

名前 キー 必須 説明
フルフィルメント ポリシー ID
fulfillmentPolicyId True string

取得するフルフィルメント ポリシー ID

戻り値

名前 パス 説明
categoryTypes
categoryTypes array of object

このコンテナーは、フルフィルメント ポリシーが自動車出品または非自動車の出品に適用されるかどうかに適用されます。

件名
categoryTypes.name string

ポリシーが適用されるカテゴリ タイプ名。

Description
description string

フルフィルメント ポリシーの販売者定義の説明。 この説明は販売者のみが使用するものであり、eBay のページには表示されません。

貨物輸送
freightShipping boolean

true が返された場合、販売者は貨物輸送を提供しています。

フルフィルメント PolicyId
fulfillmentPolicyId string

フルフィルメント ポリシー用に eBay が割り当てた固有 ID。

グローバル配送
globalShipping boolean

true が返された場合、販売者は eBay のグローバル配送プログラムを使用して、品目を海外の場所に発送します。

単位
handlingTime.unit string

単位に指定した値に値フィールドで指定した値を適用すると、時間の範囲が定義されます。

価値
handlingTime.value integer

単位フィールドで指定された時間測定単位の値。

ローカル ピックアップ
localPickup boolean

true が返された場合、このポリシーでローカル ピックアップを利用できます。

マーケットプレース ID
marketplaceId string

このフルフィルメント ポリシーが適用される eBay マーケットプレース ID。

件名
name string

このフルフィルメント ポリシーの販売者定義名。

ピックアップ ドロップオフ
pickupDropOff boolean

true が返された場合、販売者は「クリック アンド コレクト」オプションを提供しています。

shippingOptions
shippingOptions array of object

この配列は、ポリシーで利用可能な国内および国際配送オプションに関する詳細情報を提供するのに使用されます。

原価タイプ
shippingOptions.costType string

このフィールドは、原価モデルが FLAT_RATE か CALCULATED かを定義します

オプションの種類
shippingOptions.optionType string

このフィールドは、対応する配送サービス オプションが国内または国際かを示すために使用されます。

通貨型
shippingOptions.packageHandlingCost.currency string

金額を設定する値フィールドに適用される基本通貨。

価値
shippingOptions.packageHandlingCost.value string

指定された通貨の金額。

評価テーブル ID
shippingOptions.rateTableId string

このフィールドは、販売者が国内または国際配評価テーブルをフルフィルメント ビジネス ポリシーに関連付ける場合に使用されます。

shippingServices
shippingOptions.shippingServices array of object

この配列は、ポリシーに対して定義される国内または国際配送サービス オプションから成っています。

通過
shippingOptions.shippingServices.additionalShippingCost.currency string

通過

価値
shippingOptions.shippingServices.additionalShippingCost.value string

価値

buyerResponsibleForPickup
shippingOptions.shippingServices.buyerResponsibleForPickup boolean

このフィールドは、全額支払い後に購入した自動車を引き取ることが購入者の責任である場合、自動車出品に含める必要があります。

buyerResponsibleForShipping
shippingOptions.shippingServices.buyerResponsibleForShipping boolean

このフィールドは、全額支払い後に購入した自動車の配送を手配することが購入者の責任である場合、自動車出品に含める必要があります

通過
shippingOptions.shippingServices.cashOnDeliveryFee.currency string

通過

価値
shippingOptions.shippingServices.cashOnDeliveryFee.value string

価値

freeShipping
shippingOptions.shippingServices.freeShipping boolean

このフィールドは、販売者が購入者に送料無料オプションを提供する場合に含まれます。

shippingCarrierCode
shippingOptions.shippingServices.shippingCarrierCode string

このフィールドは、配送業者を設定または表示します。

通過
shippingOptions.shippingServices.shippingCost.currency string

通過

価値
shippingOptions.shippingServices.shippingCost.value string

価値

shippingServiceCode
shippingOptions.shippingServices.shippingServiceCode string

このフィールドは、国内または国際配送サービス オプションを設定または表示します。

regionExcluded
shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

regionName
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

regionName

regionType
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

regionName
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

regionName

regionType
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
shippingOptions.shippingServices.sortOrder integer

このフィールドに設定された整数値は、配送サービスの順序を制御します。

regionExcluded
shipToLocations.regionExcluded array of object

販売者が発送しない地域を指定する regionName 値の配列。

地域の名前
shipToLocations.regionExcluded.regionName string

eBay で定義されている、地域の名前を示す文字列。

地域タイプ
shipToLocations.regionExcluded.regionType string

今後使用するために予約されます。

regionIncluded
shipToLocations.regionIncluded array of object

販売者が発送する地域を指定する regionName フィールドの配列。

地域の名前
shipToLocations.regionIncluded.regionName string

eBay で定義されている、地域の名前を示す文字列。

地域タイプ
shipToLocations.regionIncluded.regionType string

今後使用するために予約されます。

品目の状態ポリシーを取得する

このメソッドは、eBay マーケットプレイス上で 1 つ、複数、またはすべての eBay カテゴリの品目状態メタデータを返します。

パラメーター

名前 キー 必須 説明
マーケットプレース ID
marketplace_id True string

ポリシー情報が取得される eBay マーケットプレイス ID。

フィルター
filter string

カテゴリ ツリーの選択されたセクションのみのポリシー情報を返すことで、応答を制限します。

戻り値

名前 パス 説明
itemConditionPolicies
itemConditionPolicies array of object

カテゴリ ID の一覧と、一覧表示された各カテゴリで品目の状態を示す方法に関するポリシー。

カテゴリ ID
itemConditionPolicies.categoryId string

品目状態ポリシーが適用されるカテゴリ ID。

カテゴリ ツリー ID
itemConditionPolicies.categoryTreeId string

応答セットに使用されるカテゴリ ツリーのルート ノードを示す値。

必須の品目状態
itemConditionPolicies.itemConditionRequired boolean

このフラグは、指定されたカテゴリの出品に品目状態を記載する必要があるかどうかを示します。

itemConditions
itemConditionPolicies.itemConditions array of object

カテゴリで許可されている品目状態の値。

conditionDescription
itemConditionPolicies.itemConditions.conditionDescription string

人間が読み取れる状態のラベル。

conditionId
itemConditionPolicies.itemConditions.conditionId string

選択されている品目状態の ID 値。

使用状況
itemConditionPolicies.itemConditions.usage string

使用状況

warnings
warnings array of object

要求の結果として生成された警告一覧。

カテゴリー
warnings.category string

このエラーまたは警告のカテゴリ タイプ。

Domain
warnings.domain string

サービスまたはアプリケーションを含むドメイン名。

エラー ID
warnings.errorId integer

識別子発生した特定のエラー状態を一意に識別する正の整数。

inputRefIds
warnings.inputRefIds array of string

エラーに関連付けられている特定の要求要素を識別します (ある場合)。 inputRefId の応答は形式固有です。

長いメッセージ
warnings.longMessage string

100-200 文字程度の長さのメッセージの拡張バージョンです (必須ではありません)。

Message
warnings.message string

エンド ユーザーとアプリ開発者にとって使いやすい、デバイスに依存しないメッセージ。

outputRefIds
warnings.outputRefIds array of string

エラーに関連付けられている特定の応答要素を識別します (ある場合)。

parameters
warnings.parameters array of object

さまざまな警告およびエラー メッセージは、エラーまたは警告に関するコンテキスト情報を含む 1 つ以上の変数を返します。

名称
warnings.parameters.name string

名称

価値
warnings.parameters.value string

価値

サブドメイン
warnings.subdomain string

ドメインのサブシステムまたはサブディビジョンの名前。

在庫品目の作成または置換

この呼び出しは、新しい在庫品目レコードを作成するか、既存の在庫品目レコードを置き換えます。

パラメーター

名前 キー 必須 説明
SKU
sku True string

在庫品目の販売者定義の値。

コンテンツ言語
Content-Language True string

ヘッダーは、要求ペイロードのフィールド値で使用される自然言語を設定します。

タイプ
availabilityType string

マーチャントの物理店舗での在庫品目の在庫状況。

単位
unit string

フルフィルメント時間を指定するために使用される時間単位。

価値
value integer

フルフィルメント時間の値。

マーチャント場所キー
merchantLocationKey string

店舗引き取り在庫品目が現在置かれている、または送付される、マーチャントの店舗固有 ID。

品質
quantity integer

店舗引き取りが可能な在庫品目の数量。

単位
unit string

フルフィルメント時間を指定するために使用される時間単位。

価値
value integer

フルフィルメント時間の値。

マーチャント場所キー
merchantLocationKey string

店舗引き取り在庫品目が現在置かれている、または送付される、マーチャントの店舗固有 ID。

品質
quantity integer

この在庫場所で入手可能な在庫品目の数量。

品質
quantity integer

1 つ以上の公開オファーを通じて購入できる在庫品目の「自宅への発送」総数量。

状態
condition string

品目の状態。

状態の説明
conditionDescription string

在庫品目の状態説明。

身長
height number

配送パッケージの実際の高さ。

Length
length number

配送パッケージの実際の長さ。

単位
unit string

配送パッケージの寸法を指定するために使用される測定単位。

Width
width number

配送パッケージの実際の幅。

パッケージの種類
packageType string

在庫品目の発送に使用される配送パッケージの値。

単位
unit string

配送パッケージの重量を指定するために使用される測定単位。

価値
value number

配送パッケージの実際の重量。

アスペクト
aspects object

これは、商品に関する詳細情報を提供し、購入者が見つけやすくなる可能性がある、品目固有の名前と値のペアのコレクションです。

ブランド
brand string

製品のブランド。

Description
description string

製品の説明です。

EAN 品目
ean array of string

EAN

ePID
epid string

製品の eBay 製品識別子。

画像 URL
imageUrls array of string

画像 URL

ISBN 品目
isbn array of string

ISBN

MPN
mpn string

製品の製造業者部品番号

字幕
subtitle string

検索結果に役立つキーワードを含めることがもできる、販売者が製品に関する詳細情報を提供できるようにするオプションの出品機能。

肩書き
title string

インベントリ品目のタイトルを追加または変更できます。

UPC 品目
upc array of string

UPC

ビデオ ID
videoIds array of string

videoIds

戻り値

名前 パス 説明
warnings
warnings array of object

このコンテナーは、1 つ以上の警告またはエラーがトリガーされた場合に呼び出し応答ペイロードで返されます。

カテゴリー
warnings.category string

この文字列値はエラー カテゴリを示します。

Domain
warnings.domain string

エラーまたは警告が発生したドメインの名前。

エラー ID
warnings.errorId integer

発生した特定のエラーまたは警告を識別する固有コード。

inputRefIds
warnings.inputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の要求要素を識別する 1 つ以上の参照 ID の配列。

長いメッセージ
warnings.longMessage string

エラーまたは警告の原因となった状態の詳細な説明と、問題を修正するための情報。

Message
warnings.message string

エラーや警告の原因となる状況の説明。

outputRefIds
warnings.outputRefIds array of string

エラーまたは警告 (ある場合) に最も密接に関連する特定の応答要素を識別する 1 つ以上の参照 ID の配列。

parameters
warnings.parameters array of object

さまざまな警告およびエラー メッセージは、エラーまたは警告に関するコンテキスト情報を含む 1 つ以上の変数を返します。

名称
warnings.parameters.name string

名称

価値
warnings.parameters.value string

価値

サブドメイン
warnings.subdomain object

エラーや警告の原因となる状況の説明。

在庫品目を取得する

この呼び出しは、販売者のアカウントに対して定義されたすべての在庫品目レコードを取得します。

パラメーター

名前 キー 必須 説明
Limit
limit string

データのページごとに返すレコードの最大数。

ページ
offset string

取得するページ番号。

戻り値

名前 パス 説明
Href
href string

これは、在庫品目の現在のページへの URL です。

inventoryItems
inventoryItems array of object

このコンテナーは、1 つ以上の在庫品目の配列です。

pickupAtLocationAvailability
inventoryItems.availability.pickupAtLocationAvailability array of object

このコンテナーは、在庫品目の店舗受け取りができるマーチャントの実店舗の配列から成っています。

availabilityType
inventoryItems.availability.pickupAtLocationAvailability.availabilityType string

在庫品目の可用性の状態

unit
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit string

フルフィルメント時間を指定するために使用される時間単位

価値
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value integer

このフィールドの整数値と単位フィールドの時間単位は、フルフィルメント時間を示します。

merchantLocationKey
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey string

店舗引き取り在庫品目が現在置かれている、または送付される、マーチャント店舗の一意識別子。

quantity
inventoryItems.availability.pickupAtLocationAvailability.quantity integer

quantity

オークション
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction integer

この整数値は、SKU の公開オークション形式のオファー用に予約されている在庫品目の数量を示します。

固定価格
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

この値は、SKU の固定価格のオファーに利用可能な在庫品目の数量を示します。

availabilityDistributions
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions array of object

このコンテナーは、1 つ以上の倉庫場所で在庫品目の利用可能な数量を設定するために使用されます。

unit
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

unit

価値
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

価値

merchantLocationKey
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

merchantLocationKey

quantity
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity integer

quantity

品質
inventoryItems.availability.shipToLocationAvailability.quantity integer

このコンテナーは 1 つ以上の公開オファーを通じて購入できる在庫品目の「自宅への発送」総数量を設定するために使用されます

状態
inventoryItems.condition string

この値は、品目の状態を示します。

状態の説明
inventoryItems.conditionDescription string

この文字列フィールドは、販売者が品目の状態をより明確に説明するために使用します

groupIds
inventoryItems.groupIds array of string

この配列は、在庫品目が任意の在庫品目グループに関連付けられている場合に返されます。

inventoryItemGroupKeys
inventoryItems.inventoryItemGroupKeys array of string

この配列は、在庫品目が任意の在庫品目グループに関連付けられている場合に返されます。

Locale
inventoryItems.locale string

このフィールドは、要求ペイロードのフィールド値で提供された自然言語を返します。

身長
inventoryItems.packageWeightAndSize.dimensions.height number

配送パッケージの実際の高さ。

Length
inventoryItems.packageWeightAndSize.dimensions.length number

配送パッケージの実際の長さ。

単位
inventoryItems.packageWeightAndSize.dimensions.unit string

配送パッケージの寸法を指定するために使用される測定単位。

Width
inventoryItems.packageWeightAndSize.dimensions.width number

配送パッケージの実際の幅。

Width
inventoryItems.packageWeightAndSize.packageType string

在庫品目の発送に使用される配送パッケージの種類。

単位
inventoryItems.packageWeightAndSize.weight.unit string

配送パッケージの重量を指定するために使用される測定単位。

価値
inventoryItems.packageWeightAndSize.weight.value number

配送パッケージの実際の重量。

アスペクト
inventoryItems.product.aspects object

これは、商品に関する詳細情報を提供し、購入者が見つけやすくなる可能性がある、品目固有の名前と値のペアのコレクションです。

ブランド
inventoryItems.product.brand string

製品のブランド。 このフィールドは、多くの場合、製造部品番号によって特定の製品を識別するために mpn フィールドとペアになっています。

Description
inventoryItems.product.description string

製品の説明。

ean
inventoryItems.product.ean array of string

製品の欧州統一商品番号/国際統一商品番号。

ePID
inventoryItems.product.epid string

製品の eBay 製品識別子 (ePID)。

imageUrls
inventoryItems.product.imageUrls array of string

商品の画像への 1 つ以上のリンクの配列。

isbn
inventoryItems.product.isbn array of string

商品の国際標準図書番号の値。

MPN
inventoryItems.product.mpn string

製品の製造業者部品番号

字幕
inventoryItems.product.subtitle string

サブタイトルは検索結果に役立つキーワードを含めることがもできる、販売者が製品に関する詳細情報を提供できるようにするオプションの出品機能です。

肩書き
inventoryItems.product.title string

在庫品目のタイトルを追加または変更できます

UPC
inventoryItems.product.upc array of string

製品のユニバーサル製品コード値。

videoIds
inventoryItems.product.videoIds array of string

商品に対する 1 つ以上の VideoId 値の配列。

SKU
inventoryItems.sku string

在庫品目の販売者定義の在庫管理単位。

Limit
limit integer

各結果ページに表示される在庫品目の数。

next string

在庫品目の次のページへの URL。

prev string

在庫品目の前のページへの URL。

規模
size integer

利用可能な結果のページ総数。

トータル
total integer

販売者のアカウントに存在する在庫品目の総数。

在庫場所を作成する

この呼び出しを使用して、新しい在庫場所を作成します。 オファーを作成して公開するには、すべてのオファーが場所に関連付けられている必要があるため、売り手は少なくとも 1 つの在庫場所を持っている必要があります。

パラメーター

名前 キー 必須 説明
マーチャント場所キー
merchantLocationKey True string

在庫場所に関するマーチャント定義の固有キー

Address Line 1
addressLine1 string

番地の 1 行目。

住所行 2
addressLine2 string

番地の 2 行目。

都市
city string

在庫場所がある都市。

Country
country string

住所が存在する国コード。

county string

住所が存在する群。

Postal Code
postalCode string

住所の郵便番号。

都道府県
stateOrProvince string

在庫場所がある都道府県。

経度
latitude string

地理座標の緯度コンポーネント。

緯度
longitude string

地理座標の経度コンポーネント。

場所の追加情報
locationAdditionalInformation string

在庫場所に関する追加情報。

場所の手順
locationInstructions string

店舗の在庫場所に関する特別な集荷指示。

locationTypes
locationTypes array of string

場所の種類

場所 Web URL
locationWebUrl string

在庫場所に関連付けられた Web サイト アドレス。

マーチャント場所のステータス
merchantLocationStatus string

在庫場所のステータスは、有効または無効にすることができます。

件名
name string

在庫場所の名前。

Day of Week
dayOfWeekEnum string

店舗場所が通常の営業時間である日。

close
close string

店舗の終了時刻。

開く
open string

店舗の開始時刻。

電話番号
phone string

店舗の在庫場所の電話番号。

date string

店舗場所に特別な営業時間があることを示す特定の日付値。

close
close string

店舗の終了時刻。

開く
open string

店舗の開始時刻。

戻り値

返答
string

在庫場所を取得する

この呼び出しは、merchantLocationKey パス パラメーターで指定された在庫場所の定義済み詳細をすべて取得します。

パラメーター

名前 キー 必須 説明
マーチャント場所キー
merchantLocationKey True string

在庫場所に関するマーチャント定義の固有キー (ID)。

戻り値

名前 パス 説明
Address Line 1
location.address.addressLine1 string

番地の 1 行目。

住所行 2
location.address.addressLine2 string

番地の 2 行目。

市区町村
location.address.city string

在庫場所がある市区町村。

Country
location.address.country string

住所が存在する国コード

location.address.county string

住所が存在する群。

Postal Code
location.address.postalCode string

住所の郵便番号。

都道府県
location.address.stateOrProvince string

在庫場所が所在する都道府県。

経度
location.geoCoordinates.latitude string

地理座標の緯度コンポーネント。

緯度
location.geoCoordinates.longitude string

地理座標の経度コンポーネント。

場所 Id
location.locationId string

場所用に eBay が割り当てた固有 ID。

場所の追加情報
locationAdditionalInformation string

このテキスト フィールドは、在庫場所に関する追加情報を提供します。

場所の手順
locationInstructions string

このフィールドは、マーチャントが店舗場所に関する特別な集荷指示を提供するために使用されます。

locationTypes
locationTypes array of string

このコンテナーは、在庫場所の機能を定義します。

場所 Web URL
locationWebUrl string

このフィールドは在庫場所に関連付けられた Web サイト アドレスを示します。

マーチャント場所キー
merchantLocationKey string

在庫場所の一意識別子。

マーチャント場所のステータス
merchantLocationStatus string

このフィールドは在庫場所が有効か無効かを示します

件名
name string

在庫場所の名前。

operatingHours
operatingHours array of object

このコンテナーは、ある店舗場所の曜日ごとの通常営業時間を示します。

週の列挙
operatingHours.dayOfWeekEnum string

店舗場所で通常営業時間の曜日ごとに値が必要です。

間隔
operatingHours.intervals array of object

このコンテナーは、店舗の営業日の開店/閉店時間を定義するために使用されます。

close
operatingHours.intervals.close string

close

開く
operatingHours.intervals.open string

開く

電話番号
phone string

在庫場所の電話番号。

SpecialHours
specialHours array of object

このコンテナーは、特定の曜日または日付における店舗場所の特別営業時間を示します。

specialHours.date string

店舗場所で特別営業時間の特定曜日ごとに日付が必要です。

間隔
specialHours.intervals array of object

このコンテナーは、店舗の特定曜日の開店/閉店時間を定義するために使用されます。

close
specialHours.intervals.close string

close

開く
specialHours.intervals.open string

開く

在庫場所を取得する

この呼び出しは、販売者のアカウントに関連付けられた各在庫場所に関して定義された詳細をすべて取得します。

パラメーター

名前 キー 必須 説明
ページ
offset string

最初の場所を返す前に、結果セットでスキップする場所の数を指定します。

Limit
limit string

データのページごとに返すレコードの最大数。

戻り値

名前 パス 説明
Href
href string

結果セットからの結果の現在のページの URI。

Limit
limit integer

結果セットから 1 ページに返される品目の数。

next string

検索結果の次のページの URI。

ページ
offset string

最初に返された結果を一覧表示する前に、結果セットでスキップされた結果の数。

prev string

結果の前ページの URI。

トータル
total integer

結果セット内で取得した品目の合計数。

場所
locations array of object

マーチャントの在庫場所の 1 つ以上の配列。

Address Line 1
locations.location.address.addressLine1 string

番地の 1 行目。

住所行 2
locations.location.address.addressLine2 string

番地の 2 行目。

都市
locations.location.address.city string

在庫場所がある市区町村。

Country
locations.location.address.country string

住所が存在する国コード。

locations.location.address.county string

住所が存在する群。

Postal Code
locations.location.address.postalCode string

住所の郵便番号。

都道府県
locations.location.address.stateOrProvince string

在庫場所が所在する都道府県。

経度
locations.location.geoCoordinates.latitude string

地理座標の緯度コンポーネント。

緯度
locations.location.geoCoordinates.longitude string

地理座標の経度コンポーネント。

場所 Id
locations.location.locationId string

場所用に eBay が割り当てた固有 ID。

場所の追加情報
locations.locationAdditionalInformation string

このフィールドは、在庫場所に関する追加情報を提供します。

場所の手順
locations.locationInstructions string

フィールドは、マーチャントが店舗場所に関する特別な集荷指示を提供するために使用されます。

locationTypes
locations.locationTypes array of string

このコンテナーは、在庫場所の機能を定義します。

場所 Web URL
locations.locationWebUrl string

フィールドは在庫場所に関連付けられた Web サイト アドレスを示します。

マーチャント場所キー
locations.merchantLocationKey string

在庫場所の一意識別子。

マーチャント場所のステータス
locations.merchantLocationStatus string

フィールドは在庫場所が有効か無効かを示します。

件名
locations.name string

在庫場所の名前。

operatingHours
locations.operatingHours array of object

このコンテナーは、ある店舗場所の曜日ごとの通常営業時間を示します。

dayOfWeekEnum
locations.operatingHours.dayOfWeekEnum string

dayOfWeekEnum

間隔
locations.operatingHours.intervals array of object

このコンテナーは、店舗の営業日の開店/閉店時間を定義するために使用されます。

close
locations.operatingHours.intervals.close string

close

開く
locations.operatingHours.intervals.open string

開く

電話番号
locations.phone string

在庫場所の電話番号。

specialHours
locations.specialHours array of object

このコンテナーは、特定の曜日または日付における店舗場所の特別営業時間を示します。

日にち
locations.specialHours.date string

日にち

間隔
locations.specialHours.intervals array of object

このコンテナーは、店舗の特定曜日の開店と閉店時間を定義するために使用されます。

close
locations.specialHours.intervals.close string

close

開く
locations.specialHours.intervals.open string

開く

支払ポリシーを取得する

このメソッドは、marketplace_id クエリ パラメーターを使用して指定するマーケットプレイス用に構成されたすべての支払ポリシーを取得します。

パラメーター

名前 キー 必須 説明
マーケットプレース ID
marketplace_id string

取得するポリシーの eBay マーケットプレース ID

戻り値

名前 パス 説明
Href
href string

このフィールドは今後使用するためのものです。

Limit
limit integer

このフィールドは今後使用するためのものです。

next string

このフィールドは今後使用するためのものです。

ページ
offset integer

このフィールドは今後使用するためのものです。

paymentPolicies
paymentPolicies array of object

指定されたマーケットプレイスに対して定義された販売者の支払ビジネス ポリシーの一覧。

categoryTypes
paymentPolicies.categoryTypes array of object

このコンテナーは、フルフィルメント ポリシーが自動車または非自動車の出品に適用されるかどうかに適用されます。

default
paymentPolicies.categoryTypes.default boolean

default

名称
paymentPolicies.categoryTypes.name string

名称

通貨型
paymentPolicies.deposit.amount.currency string

金額を設定する値フィールドに適用される基本通貨。

価値
paymentPolicies.deposit.amount.value string

指定された通貨の金額。

単位
paymentPolicies.deposit.dueIn.unit string

これらの値は、DAY などの時間測定単位を表します。

価値
paymentPolicies.deposit.dueIn.value integer

単位フィールドで指定された時間測定単位の値。

Description
paymentPolicies.description string

支払ポリシーの販売者定義の説明。

単位
paymentPolicies.fullPaymentDueIn.unit string

DAY などの時間測定単位。

価値
paymentPolicies.fullPaymentDueIn.value integer

単位フィールドで指定された時間測定単位の値。

即時支払
paymentPolicies.immediatePay boolean

このフィールドが true として返された場合、購入者からの即時支払が必要です

マーケットプレース ID
paymentPolicies.marketplaceId string

支払ビジネス ポリシーが適用される eBay マーケットプレース ID。

件名
paymentPolicies.name string

このフルフィルメント ポリシーの販売者定義名。

支払指示
paymentPolicies.paymentInstructions string

このフィールドは一部の古い支払ビジネス ポリシーのために返される場合がありますが、支払指示は支払ビジネス ポリシーではサポートされなくなりました。 このフィールドが返された場合、それは無視することができ、これらの支払指示は、対応するビジネス ポリシーを使用するどのリストにも表示されません。

paymentMethods
paymentPolicies.paymentMethods array of object

このコンテナーは、支払ビジネス ポリシーで受け入れられる支払方法を表示するために返されます。

paymentMethodType
paymentPolicies.paymentMethods.paymentMethodType string

支払方法のタイプ

支払ポリシー ID
paymentPolicies.paymentPolicyId string

支払ビジネス ポリシー用に eBay が割り当てた固有 ID。

prev string

このフィールドは今後使用するためのものです。

トータル
total integer

結果セットで取得される支払ビジネス ポリシーの総数。

支払ポリシーを取得する

このメソッドは支払ポリシーの完全な詳細を取得します。 paymentPolicyId パス パラメーターを使用して、取得するポリシーの ID を供給します。

パラメーター

名前 キー 必須 説明
支払ポリシー ID
payment_policy_id True string

取得する支払ポリシー ID。

戻り値

名前 パス 説明
categoryTypes
categoryTypes array of object

このコンテナーは、フルフィルメント ポリシーが自動車または非自動車の出品に適用されるかどうかに適用されます。

件名
categoryTypes.name string

ポリシーが適用されるカテゴリ タイプ。

通貨型
deposit.amount.currency string

金額を設定する値フィールドに適用される基本通貨。

価値
deposit.amount.value string

指定された通貨の金額。

単位
deposit.dueIn.unit string

DAY などの時間測定単位。

価値
deposit.dueIn.value integer

単位フィールドで指定された時間測定単位の値。

Description
description string

支払ポリシーの販売者定義の説明。

単位
fullPaymentDueIn.unit string

DAY などの時間測定単位。

価値
fullPaymentDueIn.value integer

単位フィールドで指定された時間測定単位の値。

即時支払
immediatePay boolean

このフィールドが true として返された場合、購入者からの即時支払が必要です

マーケットプレース ID
marketplaceId string

支払ビジネス ポリシーが適用される eBay マーケットプレースの ID。

件名
name string

支払ビジネス ポリシーが適用される eBay マーケットプレースの ID。

支払指示
paymentInstructions string

このフィールドは一部の古い支払ビジネス ポリシーのために返される場合がありますが、支払指示は支払ビジネス ポリシーではサポートされなくなりました

paymentMethods
paymentMethods array of object

このコンテナーは、支払ビジネス ポリシーで受け入れられる支払方法を表示するために返されます。

支払方法のタイプ
paymentMethods.paymentMethodType string

オフライン サポートでの支払方法のタイプ

支払ポリシー ID
paymentPolicyId string

支払ビジネス ポリシー用に eBay が割り当てた固有 ID。

既定カテゴリ TreeId を取得する

特定の eBay マーケットプレイスで複数のカテゴリ ツリーが使用される場合がありますが、それらのツリーの 1 つがそのマーケットプレイスの既定であると見なされます。 この呼び出しは、指定された eBay マーケットプレイス ID に関連付けられた既定のカテゴリ ツリーへの参照を取得します。

パラメーター

名前 キー 必須 説明
マーケットプレース ID
marketplace_id True string

カテゴリ ツリー ID が要求されている eBay マーケットプレイス ID。

言語の承諾
Accept-Language True string

販売者が応答に好む自然言語を示すために使用されるヘッダー。

戻り値

名前 パス 説明
カテゴリ ツリー ID
categoryTreeId string

指定されたマーケットプレイスの eBay 固有のカテゴリ ツリー ID。

カテゴリ ツリー バージョン
categoryTreeVersion string

categoryTreeId によって識別されるカテゴリ ツリーのバージョン。

返品ポリシーを取得する

このメソッドは、marketplace_id クエリ パラメーターを使用して指定するマーケットプレイス用に構成されたすべての支払ポリシーを返します。

パラメーター

名前 キー 必須 説明
マーケットプレース ID
marketplace_id True string

取得するポリシーの eBay マーケットプレース ID。

戻り値

名前 パス 説明
Href
href string

このフィールドは今後使用するためのものです。

Limit
limit integer

このフィールドは今後使用するためのものです。

next string

このフィールドは今後使用するためのものです。

ページ
offset integer

このフィールドは今後使用するためのものです。

prev string

このフィールドは今後使用するためのものです。

returnPolicies
returnPolicies array of object

指定されたマーケットプレイスに対して定義された販売者の返品ビジネス ポリシーの一覧。

categoryTypes
returnPolicies.categoryTypes array of object

このコンテナーは、返品ポリシーが適用されるカテゴリ グループを示します。

名称
returnPolicies.categoryTypes.name string

名称

Description
returnPolicies.description string

返品ビジネス ポリシーの販売者定義の説明。

返品メソッド
returnPolicies.internationalOverride.returnMethod string

このフィールドは、国際返品の場合に、販売者が購入者に交換品を提供するかどうかを設定/示します。

単位
returnPolicies.internationalOverride.returnPeriod.unit string

これらの列挙値は、DAY などの時間測定単位を表します。

価値
returnPolicies.internationalOverride.returnPeriod.value integer

DAY などの時間測定単位。

受理された返品
returnPolicies.internationalOverride.returnsAccepted boolean

true に設定されている場合、販売者は国際返品を受け付けます。

返品料負担者
returnPolicies.internationalOverride.returnShippingCostPayer string

このフィールドは、返品された商品の送料を誰が負担するのかを示します。

マーケットプレース ID
returnPolicies.marketplaceId string

この返品ビジネス ポリシーが適用される eBay マーケットプレース ID。

件名
returnPolicies.name string

この支払ビジネス ポリシーの販売者定義名。

払い戻し方法
returnPolicies.refundMethod string

販売者が購入者の返品を受け入れることを示す場合、この値は MONEY_BACK に設定されます。

返品方法
returnPolicies.returnInstructions string

このテキストベースのフィールドには、販売者が指定した返品手順の詳細が表示されます。

返品メソッド
returnPolicies.returnMethod string

このフィールドは、販売者が「返金」の代わりに代替品を提供する意思がある場合にのみ返されます。

単位
returnPolicies.returnPeriod.unit string

DAY などの時間測定単位。

価値
returnPolicies.returnPeriod.value integer

単位フィールドで指定された時間測定単位の値。

返品ポリシー ID
returnPolicies.returnPolicyId string

返品ビジネス ポリシー用に eBay が割り当てた固有 ID。

受理された返品
returnPolicies.returnsAccepted boolean

このフィールドが true として返される場合、販売者は返品を受け入れます。

返品料負担者
returnPolicies.returnShippingCostPayer string

このフィールドは、返品された商品の送料を誰が負担するのかを示します。

トータル
total integer

結果セットで取得される返品ビジネス ポリシーの総数。

返品ポリシーを取得する

このメソッドは、returnPolicyId パス パラメーターで指定された返品ポリシーの完全な詳細を取得します。

パラメーター

名前 キー 必須 説明
返品ポリシー ID
return_policy_id True string

取得する返品ポリシー ID。

戻り値

名前 パス 説明
categoryTypes
categoryTypes array of object

このコンテナーは、返品ポリシーが適用されるカテゴリ グループを示します。

件名
categoryTypes.name string

ポリシーが適用されるカテゴリ タイプ

Description
description string

返品ビジネス ポリシーの販売者定義の説明。

返品メソッド
internationalOverride.returnMethod string

このフィールドは、国際返品の場合に、販売者が購入者に交換品を提供するかどうかを設定/示します。

単位
internationalOverride.returnPeriod.unit string

DAY などの時間測定単位。

価値
internationalOverride.returnPeriod.value integer

単位フィールドで指定された時間測定単位の値。

受理された返品
internationalOverride.returnsAccepted boolean

単位フィールドで指定された時間測定単位の値。

返品料負担者
internationalOverride.returnShippingCostPayer string

このフィールドは、返品された商品の送料を誰が負担するのかを示します。

マーケットプレース ID
marketplaceId string

返品ビジネス ポリシーが適用される eBay マーケットプレースの ID。

件名
name string

この支払ビジネス ポリシーの販売者定義名。

払い戻し方法
refundMethod string

販売者が購入者の返品を受け入れることを示す場合、この値は MONEY_BACK に設定されます。

返品方法
returnInstructions string

このテキストベースのフィールドには、販売者が指定した返品手順の詳細が表示されます。 このフィールドは、返品ビジネス ポリシーが設定されている場合にのみ返されます。

返品メソッド
returnMethod string

このフィールドは、販売者が「返金」の代わりに代替品を提供する意思がある場合にのみ返されます

単位
returnPeriod.unit string

DAY などの時間測定単位。

価値
returnPeriod.value integer

単位フィールドで指定された時間測定単位の値。

返品ポリシー ID
returnPolicyId string

返品ビジネス ポリシー用に eBay が割り当てた固有 ID。 この ID は、ポリシーの作成時に生成されます。

受理された返品
returnsAccepted boolean

このフィールドが true として返される場合、販売者は返品を受け入れます。

返品料負担者
returnShippingCostPayer string

このフィールドは、返品された商品の送料を誰が負担するのかを示します。

定義

string

これは基本的なデータ型 '文字列' です。