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 を供給します。 |
|
既定カテゴリ Tree |
特定の 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 |
取得するオファーの一意識別子。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
利用できる数量
|
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
これは基本的なデータ型 '文字列' です。