eBay （獨立發行商） （預覽版）
eBay 是一家美國跨國電子商務公司，透過其網站促進消費者對消費者和企業對消費者的銷售。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 自流軟件技術有限責任公司 |
| URL | https://artesian.io |
| amit.sharma@artesian.io |
| 連接器中繼資料 | |
|---|---|
| Publisher | 自流軟件技術有限責任公司 |
| 網站 | https://www.ebay.com/ |
| 隱私權原則 | https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260 |
| 類別 | 商;銷售和客戶關係管理 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 客戶端 ID - 您的 eBay clientId | 字串 | 請輸入客戶端 ID。 | 對 |
| 用戶端密碼 | securestring | 請輸入客戶端密碼。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| GET 庫存物品 |
此呼叫會擷取指定 SKU 的庫存項目記錄。 |
| 刪除優惠 |
此呼叫將永久刪除優惠 |
| 取得付款政策 |
此方法會擷取您使用 marketplace_id 查詢參數為市集設定的所有付款政策。 |
| 取得履行政策 |
此方法會擷取您使用 marketplace_id 查詢參數為市集設定的所有履行政策。 |
| 取得履行政策 |
此方法會擷取履行原則的完整詳細資料。 使用 fulfillmentPolicyId 路徑參數提供您要擷取的政策 ID。 |
| 取得庫存位置 |
此呼叫會擷取 merchantLocationKey 路徑參數所指定的庫存位置的所有已定義詳細資料。 |
| 取得庫存位置 |
此呼叫會擷取與賣家帳戶相關聯的每個庫存位置的所有定義詳細資料。 |
| 取得庫存物品 |
此呼叫會擷取為賣家帳戶定義的所有庫存項目記錄。 |
| 取得退貨政策 |
此方法會擷取使用marketplace_id查詢參數為您指定的市集設定的所有退貨政策。 |
| 取得退貨政策 |
這個方法會擷取 returnPolicyId 路徑參數所指定的傳回原則的完整詳細資料。 |
| 取得項目條件原則 |
此方法會傳回 eBay 市集上一個、多個或所有 eBay 類別的項目條件中繼資料。 |
|
取得預設類別 Tree |
給定的 eBay 市集可能會使用多個類別樹狀結構，但其中一個樹會被視為該市集的預設值。 此呼叫會擷取與指定 eBay 市集識別碼相關聯之預設類別樹狀結構的參考。 |
| 取得類別的專案方面 |
此呼叫會傳回適當或必要的層面清單，以準確描述指定分葉類別中的專案。 每個方面都識別了一個商品屬性（例如顏色），賣家在 eBay 上提供該類別中的商品時，將被要求或鼓勵提供價值（或變化值）。 |
| 建立優惠方案 |
此呼叫會為特定 eBay 市集上的特定庫存項目建立報價。 |
| 建立庫存位置 |
使用此呼叫來建立新的庫存位置。 若要建立和發佈優惠，賣家必須至少有一個庫存位置，因為每個優惠都必須與一個位置相關聯。 |
| 建立或取代庫存項目 |
此呼叫會建立新的庫存品項記錄或取代現有的庫存品項記錄。 |
| 撤回要約 |
此呼叫可用來結束與指定供應專案相關聯的單一變數清單。 |
| 更新優惠 |
此呼叫會更新可能處於已發佈或未發佈狀態的現有供應專案。 |
| 獲取付款政策 |
此方法會擷取付款原則的完整詳細資料。 使用 paymentPolicyId 路徑參數提供您要擷取的政策 ID。 |
| 獲取優惠 |
此呼叫會擷取特定已發佈或未發佈的供應專案。 |
| 獲取優惠 |
此呼叫會擷取指定 SKU 值的所有現有供應專案。 賣家可以選擇將檢索到的報價限制為特定的 eBay 市場或列表格式。 |
| 獲取類別建議 |
此呼叫會傳回指定類別樹狀結構中類別樹狀結構分葉節點的陣列，eBay 認為這些節點最接近查詢。 |
| 發佈優惠方案 |
此呼叫用於將未發佈的報價轉換為已發佈的報價或即時 eBay 清單。 供應專案的唯一識別碼 （offerId） 會在呼叫 URI 結尾傳入。 |
GET 庫存物品
此呼叫會擷取指定 SKU 的庫存項目記錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
您要擷取其庫存項目記錄的產品的賣方定義值。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
取貨地點可用性
|
availability.pickupAtLocationAvailability | array of object |
此貨櫃由商家的實體商店陣列組成，其中庫存商品可供店內取貨。 |
|
可用性類型
|
availability.pickupAtLocationAvailability.availabilityType | string |
此欄位表示商家實體商店庫存商品的可用性狀態。 |
|
單位
|
availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
此值表示用來指定履行時間的時間單位 |
|
價值觀
|
availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
此欄位中的整數值以及單位欄位中的時間單位將指示履行時間。 |
|
商家位置鍵
|
availability.pickupAtLocationAvailability.merchantLocationKey | string |
商家的商店專屬識別碼，即 In-Store Pickup 庫存商品目前所在或將傳送到的位置。 |
|
數量
|
availability.pickupAtLocationAvailability.quantity | integer |
此整數值表示可用於 In-Store 取貨的庫存品項數量 |
|
拍賣
|
availability.shipToLocationAvailability.allocationByFormat.auction | integer |
此整數值表示為SKU的已發佈拍賣格式優惠保留的庫存專案數量。 |
|
固定價格
|
availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
此整數值表示可用於 SKU 固定價格優惠方案的庫存項目數量。 |
|
可用性分佈
|
availability.shipToLocationAvailability.availabilityDistributions | array of object |
此貨櫃用於在一個或多個倉庫位置設定庫存品項的可用數量。 |
|
單位
|
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 |
此貨櫃可用來設定庫存品項的「出貨到家」總數量，這些庫存品項可透過一或多個已發佈的優惠購買。 |
|
狀況
|
condition | string |
此值表示項目的狀況 |
|
條件說明
|
conditionDescription | string |
賣家使用此字串欄位來更清楚地描述二手商品的狀況，或不是「全新」、「帶標籤的新品」或「包裝盒內新品」的商品的狀況。 |
|
群組ID
|
groupIds | array of string | |
|
inventoryItemGroup索引鍵
|
inventoryItemGroupKeys | array of string |
如果庫存項目與任何庫存項目群組相關聯，則會傳回此陣列。 |
|
Locale
|
locale | string |
此欄位會傳回在要求承載的欄位值中提供的自然語言 |
|
高度
|
packageWeightAndSize.dimensions.height | number |
託運包裹的實際高度。 |
|
長度
|
packageWeightAndSize.dimensions.length | number |
託運包裹的實際長度。 |
|
單位
|
packageWeightAndSize.dimensions.unit | string |
用於指定託運包裹尺寸的測量單位。 |
|
寬度
|
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 |
產品描述。 |
|
伊恩
|
product.ean | array of string |
產品的歐洲商品編號/國際商品編號 （EAN）。 |
|
電子PID
|
product.epid | string |
產品的 eBay 產品識別碼 （ePID）。 |
|
影像網址
|
product.imageUrls | array of string |
一或多個產品影像連結的陣列。 |
|
國際標準書號
|
product.isbn | array of string |
產品的國際標準書號值。 |
|
MPN
|
product.mpn | string |
產品的製造商零件編號 （MPN）。 |
|
副標題
|
product.subtitle | string |
字幕是一項可選的清單功能，允許賣家提供有關產品的更多信息，可能包括可能有助於搜尋結果的關鍵字。 |
|
Title
|
product.title | string |
庫存項目的標題可以透過 createOrReplaceInventoryItem 呼叫來新增或修改。 |
|
UPC的
|
product.upc | array of string |
產品的國際標準書號值。 |
|
視訊標識符
|
product.videoIds | array of string |
產品的一或多個 VideoId 值陣列。 |
|
SKU
|
sku | string |
賣家定義的庫存商品的 Stock-Keeping 單位 （SKU）。 賣家應該為他們銷售的每種產品提供唯一的 SKU 值。 |
刪除優惠
取得付款政策
此方法會擷取您使用 marketplace_id 查詢參數為市集設定的所有付款政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
市集識別碼
|
marketplace_id | string |
您要擷取的保單的 eBay 市集 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
赫雷夫
|
href | string |
此欄位供將來使用。 |
|
限制
|
limit | integer |
此欄位供將來使用。 |
|
Next
|
next | string |
此欄位供將來使用。 |
|
Offset
|
offset | integer |
此欄位供將來使用。 |
|
付款政策
|
paymentPolicies | array of object |
為指定市集定義的賣方付款業務政策清單。 |
|
類別類型
|
paymentPolicies.categoryTypes | array of object |
此容器會指出出貨政策是否適用於機動車輛或非機動車輛清單。 |
|
預設
|
paymentPolicies.categoryTypes.default | boolean |
預設 |
|
名稱
|
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，則買方需要立即付款 |
|
市集識別碼
|
paymentPolicies.marketplaceId | string |
付款業務政策適用的 eBay 市場 ID。 |
|
名稱
|
paymentPolicies.name | string |
賣家定義的此履行政策名稱。 |
|
付款指示
|
paymentPolicies.paymentInstructions | string |
雖然某些較舊的付款業務政策可能會傳回此欄位，但付款業務政策不再支援付款指示。 如果傳回此欄位，則可以忽略該欄位，且這些付款指示將不會顯示在任何使用對應業務政策的清單中。 |
|
paymentMethods
|
paymentPolicies.paymentMethods | array of object |
此容器會傳回，以顯示付款業務原則所接受的付款方式。 |
|
paymentMethodType
|
paymentPolicies.paymentMethods.paymentMethodType | string |
付款方式類型 |
|
付款原則識別碼
|
paymentPolicies.paymentPolicyId | string |
支付業務政策的唯一 eBay 分配 ID。 |
|
上一篇
|
prev | string |
此欄位供將來使用。 |
|
總數
|
total | integer |
在結果集中擷取的付款業務原則總數。 |
取得履行政策
此方法會擷取您使用 marketplace_id 查詢參數為市集設定的所有履行政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
市集識別碼
|
marketplace_id | True | string |
您要擷取的保單的 eBay 市集 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
履行政策
|
fulfillmentPolicies | array of object |
為指定市集定義的賣家履行政策清單。 |
|
類別類型
|
fulfillmentPolicies.categoryTypes | array of object |
此容器會指出出貨政策是否適用於機動車或非機動車輛清單。 |
|
名稱
|
fulfillmentPolicies.categoryTypes.name | string |
原則適用的類別類型 |
|
Description
|
fulfillmentPolicies.description | string |
賣家定義的履行政策說明。 |
|
貨運
|
fulfillmentPolicies.freightShipping | boolean |
如果退回為真，賣家為超過 150 磅的大件物品提供貨運服務。 |
|
履行政策識別碼
|
fulfillmentPolicies.fulfillmentPolicyId | string |
履行政策的唯一 eBay 分配 ID。 |
|
全球航運
|
fulfillmentPolicies.globalShipping | boolean |
如果退回為 true，賣家將使用 eBay 的全球運輸計劃將商品運送到國際地點。 |
|
單位
|
fulfillmentPolicies.handlingTime.unit | string |
時間測量單位，例如 DAY。 |
|
價值觀
|
fulfillmentPolicies.handlingTime.value | integer |
單位欄位中指定的時間測量單位值。 |
|
本地接送
|
fulfillmentPolicies.localPickup | boolean |
如果傳回為 true，則此政策可使用本地取件。 |
|
市集識別碼
|
fulfillmentPolicies.marketplaceId | string |
適用此履行政策的 eBay 市場的 ID。 |
|
名稱
|
fulfillmentPolicies.name | string |
賣家定義的此履行政策名稱。 指派給相同市集的原則的名稱必須是唯一的。 |
|
接送服務
|
fulfillmentPolicies.pickupDropOff | boolean |
如果返回為 true，賣家會提供「點擊取貨」選項。 |
|
運送選項
|
fulfillmentPolicies.shippingOptions | array of object |
該陣列提供了有關該保單可用的國內和國際運輸選項的詳細資訊。 |
|
成本類型
|
fulfillmentPolicies.shippingOptions.costType | string |
此欄位定義運送成本模型是FLAT_RATE還是 CALCULATED |
|
貨幣
|
fulfillmentPolicies.shippingOptions.insuranceFee.currency | string |
套用至值欄位以建立貨幣金額的基本貨幣。 |
|
價值觀
|
fulfillmentPolicies.shippingOptions.insuranceFee.value | string |
以指定貨幣表示的貨幣金額。 |
|
選項類型
|
fulfillmentPolicies.shippingOptions.optionType | string |
選項類型 |
|
貨幣
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency | string |
貨幣 |
|
value
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.value | string |
value |
|
rateTableId
|
fulfillmentPolicies.shippingOptions.rateTableId | string |
rateTableId |
|
運送服務
|
fulfillmentPolicies.shippingOptions.shippingServices | array of object |
運送服務 |
|
貨幣
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency | string |
貨幣 |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value | string |
value |
|
buyerResponsibleForPickup
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
buyerResponsibleForPickup |
|
buyerResponsibleForShipping
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
buyerResponsibleForShipping |
|
貨幣
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
貨幣 |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
value |
|
免費送貨
|
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping | boolean |
免費送貨 |
|
shippingCarrierCode
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode | string |
shippingCarrierCode |
|
貨幣
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency | string |
貨幣 |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value | string |
value |
|
shippingService代碼
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode | string |
shippingService代碼 |
|
地區不包括
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
地區不包括 |
|
regionName （區域名稱）
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
regionName （區域名稱） |
|
區域類型
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
區域類型 |
|
地區包含
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
地區包含 |
|
regionName （區域名稱）
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
regionName （區域名稱） |
|
區域類型
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
區域類型 |
|
排序順序
|
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder | integer |
排序順序 |
|
貨幣
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency | string |
貨幣 |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value | string |
value |
|
排除的地區
|
fulfillmentPolicies.shipToLocations.regionExcluded | array of object |
regionName 值陣列，指定賣家未出貨的區域。 |
|
regionName （區域名稱）
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionName | string |
regionName （區域名稱） |
|
區域類型
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionType | string |
區域類型 |
|
包含的地區
|
fulfillmentPolicies.shipToLocations.regionIncluded | array of object |
regionName 欄位陣列，指定賣家出貨的區域。 |
|
regionName （區域名稱）
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionName | string |
regionName （區域名稱） |
|
區域類型
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionType | string |
區域類型 |
|
赫雷夫
|
href | string |
此欄位供將來使用。 |
|
限制
|
limit | integer |
此欄位供將來使用。 |
|
Next
|
next | string |
此欄位供將來使用。 |
|
Offset
|
offset | integer |
此欄位供將來使用。 |
|
上一篇
|
prev | string |
此欄位供將來使用。 |
|
總數
|
total | integer |
在結果集中擷取的履行原則總數。 |
取得履行政策
此方法會擷取履行原則的完整詳細資料。 使用 fulfillmentPolicyId 路徑參數提供您要擷取的政策 ID。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
履行政策識別碼
|
fulfillmentPolicyId | True | string |
您要擷取的履行政策 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
類別類型
|
categoryTypes | array of object |
此貨櫃會指出出貨政策是否適用於機動車輛清單或非機動車輛清單。 |
|
名稱
|
categoryTypes.name | string |
原則適用的類別類型名稱。 |
|
Description
|
description | string |
賣家定義的履行政策說明。 此描述僅供賣家使用，不會在任何 eBay 頁面上公開。 |
|
貨運
|
freightShipping | boolean |
如果退回為真，賣家提供貨運。 |
|
履行原則標識符
|
fulfillmentPolicyId | string |
履行政策的唯一 eBay 分配 ID。 |
|
全球航運
|
globalShipping | boolean |
如果退回為 true，賣家將使用 eBay 的全球運輸計劃將商品運送到國際地點。 |
|
單位
|
handlingTime.unit | string |
當您將值欄位中指定的值套用至單位指定的值時，會定義時間跨度。 |
|
價值觀
|
handlingTime.value | integer |
單位欄位中指定的時間測量單位值。 |
|
本地接送
|
localPickup | boolean |
如果傳回為 true，則此政策可使用本地取件。 |
|
市集識別碼
|
marketplaceId | string |
eBay 市集 ID。 |
|
名稱
|
name | string |
賣家為此履行政策定義的唯一名稱。 |
|
接送服務
|
pickupDropOff | boolean |
如果返回為 true，賣家會提供「點擊取貨」選項。 |
|
運送選項
|
shippingOptions | array of object |
此陣列用於提供有關保單可用的國內和國際運輸選項的詳細資訊。 |
|
成本類型
|
shippingOptions.costType | string |
此欄位定義運送成本模型是FLAT_RATE還是 CALCULATED |
|
選項類型
|
shippingOptions.optionType | string |
此欄位用於指示對應的託運服務選項是國內還是國際。 |
|
貨幣
|
shippingOptions.packageHandlingCost.currency | string |
套用至值欄位以建立貨幣金額的基礎貨幣。 |
|
價值觀
|
shippingOptions.packageHandlingCost.value | string |
以指定貨幣表示的貨幣金額。 |
|
費率表識別碼
|
shippingOptions.rateTableId | string |
如果賣家想要將國內或國際運費表與履行業務政策建立關聯，則會使用此欄位。 |
|
運送服務
|
shippingOptions.shippingServices | array of object |
此陣列包含為保單定義的國內或國際託運服務選項。 |
|
貨幣
|
shippingOptions.shippingServices.additionalShippingCost.currency | string |
貨幣 |
|
value
|
shippingOptions.shippingServices.additionalShippingCost.value | string |
value |
|
buyerResponsibleForPickup
|
shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
如果買方有責任在全額付款後提走所購買的機動車輛，則機動車輛清單應包含此欄位。 |
|
buyerResponsibleForShipping
|
shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
如果買方有責任在全額付款後安排運送所購買的機動車輛，則機動車輛清單應包含此欄位 |
|
貨幣
|
shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
貨幣 |
|
value
|
shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
value |
|
免費送貨
|
shippingOptions.shippingServices.freeShipping | boolean |
如果賣家向買家提供免費送貨選項，則會包含此欄位。 |
|
shippingCarrierCode
|
shippingOptions.shippingServices.shippingCarrierCode | string |
此欄位設定/指示承運商。 |
|
貨幣
|
shippingOptions.shippingServices.shippingCost.currency | string |
貨幣 |
|
value
|
shippingOptions.shippingServices.shippingCost.value | string |
value |
|
shippingService代碼
|
shippingOptions.shippingServices.shippingServiceCode | string |
此欄位設定/指示國內或國際託運服務選項。 |
|
地區不包括
|
shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
地區不包括 |
|
regionName （區域名稱）
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
regionName （區域名稱） |
|
區域類型
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
區域類型 |
|
地區包含
|
shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
地區包含 |
|
regionName （區域名稱）
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
regionName （區域名稱） |
|
區域類型
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
區域類型 |
|
排序順序
|
shippingOptions.shippingServices.sortOrder | integer |
此欄位中設定的整數值控制託運服務的順序。 |
|
地區不包括
|
shipToLocations.regionExcluded | array of object |
regionName 值陣列，指定賣家未出貨的區域。 |
|
區域名稱
|
shipToLocations.regionExcluded.regionName | string |
表示區域名稱的字串，由 eBay 定義。 |
|
區域類型
|
shipToLocations.regionExcluded.regionType | string |
保留供未來使用。 |
|
地區包含
|
shipToLocations.regionIncluded | array of object |
regionName 欄位陣列，指定賣家出貨的區域。 |
|
區域名稱
|
shipToLocations.regionIncluded.regionName | string |
表示區域名稱的字串，由 eBay 定義。 |
|
區域類型
|
shipToLocations.regionIncluded.regionType | string |
保留供未來使用。 |
取得庫存位置
此呼叫會擷取 merchantLocationKey 路徑參數所指定的庫存位置的所有已定義詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
商家位置鍵
|
merchantLocationKey | True | string |
商家定義的庫存位置的唯一金鑰 （ID）。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地址行 1
|
location.address.addressLine1 | string |
街道地址的第一行。 |
|
地址行 2
|
location.address.addressLine2 | string |
街道地址的第二行。 |
|
城
|
location.address.city | string |
庫存位置所在的城市。 |
|
國家
|
location.address.country | string |
地址所在的國家/地區代碼 |
|
縣
|
location.address.county | string |
地址所在的縣。 |
|
郵遞區號
|
location.address.postalCode | string |
地址的郵政編碼。 |
|
州或省
|
location.address.stateOrProvince | string |
庫存位置所在的州/省。 |
|
緯度
|
location.geoCoordinates.latitude | string |
地理座標的緯度元件。 |
|
經度
|
location.geoCoordinates.longitude | string |
地理座標的經度元件。 |
|
位置標識號
|
location.locationId | string |
該位置的唯一 eBay 分配 ID。 |
|
位置 附加信息
|
locationAdditionalInformation | string |
此文字欄位提供有關庫存位置的其他資訊。 |
|
地點說明
|
locationInstructions | string |
商家會使用該欄位來提供商店位置的特殊取貨指示。 |
|
location類型
|
locationTypes | array of string |
此容器定義了庫存位置的功能。 |
|
位置網址
|
locationWebUrl | string |
此欄位會顯示與庫存位置相關聯的網站位址。 |
|
商家位置鍵
|
merchantLocationKey | string |
庫存位置的唯一識別碼。 |
|
商家位置狀態
|
merchantLocationStatus | string |
此欄位指出庫存位置是啟用還是停用 |
|
名稱
|
name | string |
庫存位置的名稱。 |
|
營業時間
|
operatingHours | array of object |
此容器顯示商店位置在一週中幾天的正常營業時間。 |
|
週枚舉
|
operatingHours.dayOfWeekEnum | string |
商店位置具有正常營業時間的每一週都需要一個值。 |
|
間隔
|
operatingHours.intervals | array of object |
此容器用於定義商店工作日的開門/關門時間。 |
|
關閉
|
operatingHours.intervals.close | string |
關閉 |
|
開啟
|
operatingHours.intervals.open | string |
開啟 |
|
電話
|
phone | string |
庫存位置的電話號碼。 |
|
特別營業時間
|
specialHours | array of object |
此容器顯示商店位置在特定日期的特殊營業時間。 |
|
Date
|
specialHours.date | string |
對於商店位置具有特殊營業時間的每個特定日期，都需要一個日期值。 |
|
間隔
|
specialHours.intervals | array of object |
此容器用於定義商店在特定日期的開門/關門時間。 |
|
關閉
|
specialHours.intervals.close | string |
關閉 |
|
開啟
|
specialHours.intervals.open | string |
開啟 |
取得庫存位置
此呼叫會擷取與賣家帳戶相關聯的每個庫存位置的所有定義詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Offset
|
offset | string |
指定在傳回第一個位置之前，要在結果集中略過的位置數目。 |
|
|
限制
|
limit | string |
每頁資料要傳回的記錄數目上限。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
赫雷夫
|
href | string |
結果集目前結果頁面的 URI。 |
|
限制
|
limit | integer |
從結果集在單一頁面上傳回的專案數。 |
|
Next
|
next | string |
下一頁結果的 URI。 |
|
Offset
|
offset | string |
在列出第一個傳回的結果之前，結果集中略過的結果數目。 |
|
上一篇
|
prev | string |
URI 的結果。 |
|
總數
|
total | integer |
在結果集中擷取的專案總數。 |
|
地點
|
locations | array of object |
一或多個商家庫存位置的陣列。 |
|
地址行 1
|
locations.location.address.addressLine1 | string |
街道地址的第一行。 |
|
地址行 2
|
locations.location.address.addressLine2 | string |
街道地址的第二行。 |
|
城市
|
locations.location.address.city | string |
庫存位置所在的城市。 |
|
國家
|
locations.location.address.country | string |
地址所在的國家/地區代碼。 |
|
縣
|
locations.location.address.county | string |
地址所在的縣。 |
|
郵遞區號
|
locations.location.address.postalCode | string |
地址的郵政編碼。 |
|
州或省
|
locations.location.address.stateOrProvince | string |
庫存位置所在的州/省。 |
|
緯度
|
locations.location.geoCoordinates.latitude | string |
地理座標的緯度元件。 |
|
經度
|
locations.location.geoCoordinates.longitude | string |
地理座標的經度元件。 |
|
位置標識號
|
locations.location.locationId | string |
該位置的唯一 eBay 分配 ID。 |
|
位置 附加信息
|
locations.locationAdditionalInformation | string |
此欄位提供有關庫存位置的其他資訊。 |
|
地點說明
|
locations.locationInstructions | string |
商家使用此欄位來提供商店位置的特殊取貨指示。 |
|
location類型
|
locations.locationTypes | array of string |
此容器定義了庫存位置的功能。 |
|
位置網址
|
locations.locationWebUrl | string |
此欄位顯示與庫存位置相關聯的網站地址。 |
|
商家位置鍵
|
locations.merchantLocationKey | string |
庫存位置的唯一識別碼。 |
|
商家位置狀態
|
locations.merchantLocationStatus | string |
此欄位指示庫存位置是啟用還是停用。 |
|
名稱
|
locations.name | string |
庫存位置的名稱。 |
|
營業時間
|
locations.operatingHours | array of object |
此容器顯示商店位置在一週中幾天的正常營業時間。 |
|
dayOfWeek列舉
|
locations.operatingHours.dayOfWeekEnum | string |
dayOfWeek列舉 |
|
間隔
|
locations.operatingHours.intervals | array of object |
此容器用於定義商店工作日的開門/關門時間。 |
|
關閉
|
locations.operatingHours.intervals.close | string |
關閉 |
|
開啟
|
locations.operatingHours.intervals.open | string |
開啟 |
|
電話
|
locations.phone | string |
庫存位置的電話號碼。 |
|
特別營業時間
|
locations.specialHours | array of object |
此容器顯示商店位置在特定日期的特殊營業時間。 |
|
date
|
locations.specialHours.date | string |
date |
|
間隔
|
locations.specialHours.intervals | array of object |
此容器用於定義商店在特定日期的開門和關門時間。 |
|
關閉
|
locations.specialHours.intervals.close | string |
關閉 |
|
開啟
|
locations.specialHours.intervals.open | string |
開啟 |
取得庫存物品
此呼叫會擷取為賣家帳戶定義的所有庫存項目記錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
限制
|
limit | string |
每頁資料要傳回的記錄數目上限。 |
|
|
Offset
|
offset | string |
要擷取的頁碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
赫雷夫
|
href | string |
這是庫存項目目前頁面的URL。 |
|
inventoryItems
|
inventoryItems | array of object |
此容器是一或多個庫存項目的陣列。 |
|
pickupAtLocation可用性
|
inventoryItems.availability.pickupAtLocationAvailability | array of object |
此貨櫃由商家的實體商店陣列組成，其中庫存商品可供店內取貨。 |
|
availabilityType
|
inventoryItems.availability.pickupAtLocationAvailability.availabilityType | string |
庫存品項的可用性狀態 |
|
單位
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
用於指定履行時間的時間單位 |
|
value
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
此欄位中的整數值以及單位欄位中的時間單位將指示履行時間。 |
|
merchantLocationKey
|
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey | string |
商家的商店 In-Store Pickup 庫存商品目前所在或將傳送到的專屬識別碼。 |
|
數量
|
inventoryItems.availability.pickupAtLocationAvailability.quantity | integer |
數量 |
|
拍賣
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction | integer |
此整數值表示為SKU的已發佈拍賣格式優惠保留的庫存專案數量。 |
|
固定價格
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
此值表示可用於 SKU 固定價格優惠的庫存項目數量。 |
|
可用性分發
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions | array of object |
此貨櫃用於在一個或多個倉庫位置設定庫存品項的可用數量。 |
|
單位
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
單位 |
|
value
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
value |
|
merchantLocationKey
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
merchantLocationKey |
|
數量
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
數量 |
|
數量
|
inventoryItems.availability.shipToLocationAvailability.quantity | integer |
此貨櫃可用來設定庫存品項的「出貨到家」總數量，這些庫存品項可透過一或多個已發佈的報價購買 |
|
狀況
|
inventoryItems.condition | string |
此值表示項目的狀況。 |
|
條件說明
|
inventoryItems.conditionDescription | string |
賣家使用此字串欄位來更清楚地描述商品的狀況 |
|
群組ID
|
inventoryItems.groupIds | array of string |
如果庫存項目與任何庫存項目群組相關聯，則會傳回此陣列。 |
|
inventoryItemGroup索引鍵
|
inventoryItems.inventoryItemGroupKeys | array of string |
如果庫存項目與任何庫存項目群組相關聯，則會傳回此陣列。 |
|
Locale
|
inventoryItems.locale | string |
此欄位會傳回在要求承載的欄位值中提供的自然語言。 |
|
高度
|
inventoryItems.packageWeightAndSize.dimensions.height | number |
運送包裹的實際高度。 |
|
長度
|
inventoryItems.packageWeightAndSize.dimensions.length | number |
運送包裹的實際長度。 |
|
單位
|
inventoryItems.packageWeightAndSize.dimensions.unit | string |
用於指定託運包裹尺寸的測量單位。 |
|
寬度
|
inventoryItems.packageWeightAndSize.dimensions.width | number |
運送包裹的實際寬度。 |
|
寬度
|
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 |
產品描述。 |
|
伊恩
|
inventoryItems.product.ean | array of string |
產品的歐洲商品編號/國際商品編號。 |
|
電子PID
|
inventoryItems.product.epid | string |
產品的 eBay 產品識別碼 （ePID）。 |
|
影像網址
|
inventoryItems.product.imageUrls | array of string |
一或多個產品影像連結的陣列。 |
|
國際標準書號
|
inventoryItems.product.isbn | array of string |
產品的國際標準書號值。 |
|
MPN
|
inventoryItems.product.mpn | string |
產品的製造商零件編號。 |
|
副標題
|
inventoryItems.product.subtitle | string |
字幕是一項可選的清單功能，允許賣家提供有關產品的更多信息，可能包括可能有助於搜尋結果的關鍵字。 |
|
Title
|
inventoryItems.product.title | string |
可以新增或修改庫存項目的標題 |
|
UPC的
|
inventoryItems.product.upc | array of string |
產品的通用產品代碼值。 |
|
視訊標識符
|
inventoryItems.product.videoIds | array of string |
產品的一或多個 VideoId 值陣列。 |
|
SKU
|
inventoryItems.sku | string |
賣方定義 Stock-Keeping 庫存品項的單位。 |
|
限制
|
limit | integer |
將顯示在每個結果頁面上的庫存項目數量。 |
|
Next
|
next | string |
庫存項目下一頁的URL。 |
|
上一篇
|
prev | string |
庫存項目上一頁的網址。 |
|
大小
|
size | integer |
可用的結果總頁數。 |
|
總數
|
total | integer |
T賣家帳戶存在的庫存項目總數。 |
取得退貨政策
此方法會擷取使用marketplace_id查詢參數為您指定的市集設定的所有退貨政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
市集識別碼
|
marketplace_id | True | string |
您要擷取之保單的 eBay 市集 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
赫雷夫
|
href | string |
此欄位供將來使用。 |
|
限制
|
limit | integer |
此欄位供將來使用。 |
|
Next
|
next | string |
此欄位供將來使用。 |
|
Offset
|
offset | integer |
此欄位供將來使用。 |
|
上一篇
|
prev | string |
此欄位供將來使用。 |
|
returnPolicies
|
returnPolicies | array of object |
為指定市集定義的賣方退貨業務政策清單。 |
|
類別類型
|
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 |
此欄位表示誰負責支付退回物品的運費。 |
|
市集識別碼
|
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 |
單位欄位中指定的時間測量單位值。 |
|
退貨政策標識符
|
returnPolicies.returnPolicyId | string |
退貨業務政策的唯一 eBay 分配 ID。 |
|
接受退貨
|
returnPolicies.returnsAccepted | boolean |
如果此欄位傳回為 true，則賣方接受退貨。 |
|
退貨運費付款人
|
returnPolicies.returnShippingCostPayer | string |
此欄位表示誰負責支付退回物品的運費。 |
|
總數
|
total | integer |
在結果集中擷取的傳回商務原則總數。 |
取得退貨政策
這個方法會擷取 returnPolicyId 路徑參數所指定的傳回原則的完整詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
退貨政策標識符
|
return_policy_id | True | string |
您要擷取的傳回原則識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
類別類型
|
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 |
此欄位表示誰負責支付退回物品的運費。 |
|
市集識別碼
|
marketplaceId | string |
此退貨業務政策適用的 eBay 市場的 ID。 |
|
名稱
|
name | string |
此付款業務政策的賣方定義名稱。 |
|
退款方式
|
refundMethod | string |
如果賣家表示他們將接受買家退貨，則此值將設定為MONEY_BACK。 |
|
退貨說明
|
returnInstructions | string |
此文字型欄位提供賣家指定退貨指示的更多詳細資訊。 只有在為退貨業務政策設定時，才會傳回此欄位。 |
|
傳回方式
|
returnMethod | string |
只有在賣家願意提供替代商品作為「退款」的替代方案時，才會傳回此欄位 |
|
單位
|
returnPeriod.unit | string |
時間測量單位，例如 DAY。 |
|
價值觀
|
returnPeriod.value | integer |
單位欄位中指定的時間測量單位值。 |
|
退貨政策標識符
|
returnPolicyId | string |
退貨業務政策中唯一的 eBay 分配的 ID。 此 ID 會在建立原則時產生。 |
|
接受退貨
|
returnsAccepted | boolean |
如果此欄位傳回為 true，則賣方接受退貨。 |
|
退貨運費付款人
|
returnShippingCostPayer | string |
此欄位表示誰負責支付退回物品的運費。 |
取得項目條件原則
此方法會傳回 eBay 市集上一個、多個或所有 eBay 類別的項目條件中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
市集識別碼
|
marketplace_id | True | string |
擷取保單資訊的 eBay 市集 ID。 |
|
Filter
|
filter | string |
僅傳回類別樹狀結構所選區段的原則資訊，以限制回應。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
itemConditionPolicies
|
itemConditionPolicies | array of object |
類別 ID 清單，以及如何在每個列出的類別中指出項目狀況的原則。 |
|
類別識別碼
|
itemConditionPolicies.categoryId | string |
項目條件政策適用的類別 ID。 |
|
類別樹狀結構識別碼
|
itemConditionPolicies.categoryTreeId | string |
指出用於回應集之種類樹狀結構的根節點的值。 |
|
需要的項目條件
|
itemConditionPolicies.itemConditionRequired | boolean |
此旗標表示您是否必須在指定種類的清單中列出項目條件。 |
|
itemConditions
|
itemConditionPolicies.itemConditions | array of object |
類別中允許的項目條件值。 |
|
條件說明
|
itemConditionPolicies.itemConditions.conditionDescription | string |
條件的人類可讀標籤。 |
|
條件標識
|
itemConditionPolicies.itemConditions.conditionId | string |
所選項目條件的 ID 值。 |
|
使用方式
|
itemConditionPolicies.itemConditions.usage | string |
使用方式 |
|
警告
|
warnings | array of object |
因要求而產生的警告清單。 |
|
類別
|
warnings.category | string |
此錯誤或警告的類別類型。 |
|
網域
|
warnings.domain | string |
包含服務或應用程式的網域名稱。 |
|
錯誤標識碼
|
warnings.errorId | integer |
唯一識別所發生特定錯誤狀況的正整數。 |
|
inputRefIds
|
warnings.inputRefIds | array of string |
識別與錯誤相關聯的特定要求元素 （如果有的話）。 inputRefId 的回應是特定於格式的。 |
|
長訊息
|
warnings.longMessage | string |
訊息的擴充版本，長度應約為 100-200 個字元，但不需要如此。 |
|
Message
|
warnings.message | string |
最終用戶和應用程序開發人員友好的設備不可知消息。 |
|
輸出參考標識符
|
warnings.outputRefIds | array of string |
識別與錯誤相關聯的特定回應元素 （如果有的話）。 |
|
parameters
|
warnings.parameters | array of object |
各種警告和錯誤訊息會傳回一或多個變數，其中包含有關錯誤或警告的內容資訊。 |
|
名稱
|
warnings.parameters.name | string |
名稱 |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
網域子系統或子部門的名稱。 |
取得預設類別 TreeId
給定的 eBay 市集可能會使用多個類別樹狀結構，但其中一個樹會被視為該市集的預設值。 此呼叫會擷取與指定 eBay 市集識別碼相關聯之預設類別樹狀結構的參考。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
市集識別碼
|
marketplace_id | True | string |
要求類別樹狀結構 ID 的 eBay 市集 ID。 |
|
接收语言（Accept-Language）
|
Accept-Language | True | string |
標頭，用來指出賣方偏好的回應自然語言。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
類別樹狀結構 ID
|
categoryTreeId | string |
指定市集的 eBay 唯一類別樹狀結構 ID。 |
|
類別樹狀結構版本
|
categoryTreeVersion | string |
categoryTreeId所識別的類別樹狀結構版本。 |
取得類別的專案方面
此呼叫會傳回適當或必要的層面清單，以準確描述指定分葉類別中的專案。 每個方面都識別了一個商品屬性（例如顏色），賣家在 eBay 上提供該類別中的商品時，將被要求或鼓勵提供價值（或變化值）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
類別樹狀結構識別碼
|
category_tree_id | True | string |
eBay 類別樹狀結構 從中請求指定類別方面的唯一 ID。 |
|
類別識別碼
|
category_id | True | string |
分葉類別唯一識別碼，要求其層面。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
方面
|
aspects | array of object |
適用於描述特定葉類別中項目的項目層面清單 |
|
適用方面
|
aspects.aspectConstraint.aspectApplicableTo | array of string |
此值指出 aspects.localizedAspectName 欄位所識別的層面是產品層面還是項目/執行個體層面，其值會根據產品的特定實例而變化。 |
|
方面資料類型
|
aspects.aspectConstraint.aspectDataType | string |
Aspect 資料類型。 |
|
為變化啟用的方面
|
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 |
指出此層面是否可以接受指定類別中項目的單一或多個值。 |
|
aspect值
|
aspects.aspectValues | array of object |
有效值的清單，以及此層面的任何條件約束。 |
|
本地化值
|
aspects.aspectValues.localizedValue | string |
這方面的本地化價值。 |
|
valueConstraints （值限制）
|
aspects.aspectValues.valueConstraints | array of object |
包含相依性清單，可識別 localizedValue 欄位的值何時可用於目前層面。 |
|
applicableForLocalizedAspectName
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName | string |
目前方面值所相依的控制項方面名稱。 |
|
適用ForLocalizedAspectValues
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues | array of string |
包含此層面值所相依的控制項層面值清單。 |
|
當地語系化方面名稱
|
aspects.localizedAspectName | string |
此方面的本地化名稱。 |
|
搜尋計數
|
aspects.relevanceIndicator.searchCount | integer |
該方面的最近搜尋次數。 |
建立優惠方案
此呼叫會為特定 eBay 市集上的特定庫存項目建立報價。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
可用數量
|
availableQuantity | integer |
可供購買的庫存數量。 |
|
|
類別識別碼
|
categoryId | string |
eBay 產品將列出的唯一類別 ID。 |
|
|
慈善機構編號
|
charityId | string |
eBay 分配的慈善組織的唯一 ID，該組織將獲得一定比例的銷售收入。 |
|
|
捐款百分比
|
donationPercentage | string |
該慈善組織將收到的清單產生的每筆銷售的購買價格百分比。 |
|
|
生產者產品識別碼
|
producerProductId | string |
與項目相關的生產者的唯一識別碼。 |
|
|
產品套件識別碼
|
productPackageId | string |
賣家新增的產品包裝生產商的唯一 ID。 |
|
|
貨件包裹 ID
|
shipmentPackageId | string |
賣方用來運送商品的任何包裝生產商的唯一 ID。 |
|
|
產品文件ID
|
productDocumentationId | string |
賣方添加到物品包裹中的任何紙張的生產者的唯一標識符。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
格式
|
format | string |
優惠的清單格式。 |
|
|
隱藏買家詳細資料
|
hideBuyerDetails | boolean |
如果賣家想要建立私人清單，則會包含此欄位。 |
|
|
包含目錄產品詳細資料
|
includeCatalogProductDetails | boolean |
指出是否將 eBay 產品目錄詳細資料套用至清單。 |
|
|
房源說明
|
listingDescription | string |
eBay 列表的描述。 |
|
|
上市期限
|
listingDuration | string |
清單將處於有效狀態的天數。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
啟用最佳優惠
|
bestOfferEnabled | boolean |
指出是否已為清單啟用最佳優惠方案功能。 |
|
|
eBay Plus（如果符合條件）
|
eBayPlusIfEligible | boolean |
如果 Top-Rated 賣家選擇加入 eBay Plus 計劃，則此欄位將包含在報價中。 |
|
|
履行政策識別碼
|
fulfillmentPolicyId | string |
唯一識別碼表示在報價發佈並轉換為 eBay 清單後將使用的履行業務政策。 |
|
|
付款原則識別碼
|
paymentPolicyId | string |
唯一識別碼表示一旦報價發布並轉換為 eBay 列表，將使用的支付業務政策。 |
|
|
產品合規性原則識別碼
|
productCompliancePolicyIds | array of string |
此欄位包含最多五個ID的陣列，指定賣家為清單建立的合規原則。 |
|
|
退貨政策標識符
|
returnPolicyId | string |
傳回業務政策唯一 ID，一旦報價發佈並轉換為 eBay 清單，就會使用該 ID。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
Priority
|
priority | integer |
輸入此欄位的整數值以及 shippingServiceType 值可設定出貨政策中的國內或國際運送服務選項將根據更新的運送成本進行修改。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
服務類型
|
shippingServiceType | string |
此值指出優先順序欄位中指定的託運服務是國內還是國際託運服務選項。 |
|
|
收回原則識別碼
|
takeBackPolicyId | string |
建立收回政策的賣家 ID。 |
|
|
上市開始日期
|
listingStartDate | string |
如果賣家想要指定未來清單在 eBay 上生效的時間，則可以使用此欄位。 |
|
|
手數
|
lotSize | integer |
此欄位僅適用於清單為地段清單時。 傳遞至此欄位的整數值是批次中的項目總數。 |
|
|
市集識別碼
|
marketplaceId | string |
eBay 網站的唯一 ID，將提供優惠。 |
|
|
商家位置鍵
|
merchantLocationKey | string |
商家庫存位置的唯一識別碼 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
最初以零售價出售
|
originallySoldForRetailPriceOn | string |
如果將在優惠中使用刪除線定價功能，則需要此欄位。 此欄位表示產品已以 eBay 網站上原始 RetailPrice 欄位中的價格出售，或由第三方零售商以該價格出售 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
定價可見性
|
pricingVisibility | string |
如果優惠中使用「最低廣告價格」功能，則需要此欄位。 |
|
|
每個買家的數量限制
|
quantityLimitPerBuyer | integer |
此欄位僅在賣家希望對每個賣家的購買數量設定限制時才適用並設定。 |
|
|
次要類別識別碼
|
secondaryCategoryId | string |
唯一的次要類別 ID，如果賣家決定在兩個類別下列出商品，則適用。 |
|
|
SKU
|
sku | string |
賣家定義的產品 SKU 價值，將在 eBay 網站上列出。 |
|
|
商店類別名稱
|
storeCategoryNames | array of string |
商店類別名稱 |
|
|
適用稅金
|
applyTax | boolean |
只有在將銷售稅表、Value-Added 稅率或稅金例外類別代碼套用至供應專案時，才適用和使用此容器。 |
|
|
第三方稅務類別
|
thirdPartyTaxCategory | string |
稅務例外類別代碼。 如果使用此欄位，銷售稅也將適用於服務/費用，而不僅僅是商品價格。 |
|
|
增值稅百分比
|
vatPercentage | number |
此值是商品的增值稅稅率 （如果有的話）。 指定增值稅百分比時，商品的增值稅資訊會顯示在清單的「檢視商品」頁面上。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
供應項目標識碼
|
offerId | string |
供應專案的唯一識別碼 |
|
警告
|
warnings | array of object |
此容器會在呼叫時傳回，並發生錯誤和/或警告。 |
|
類別
|
warnings.category | string |
此字串值表示錯誤類別 |
|
網域
|
warnings.domain | string |
發生錯誤或警告的網域名稱。 |
|
錯誤標識碼
|
warnings.errorId | integer |
識別所發生特定錯誤或警告的唯一代碼。 |
|
inputRefIds
|
warnings.inputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定要求元素 （） （如果有的話）。 |
|
長訊息
|
warnings.longMessage | string |
造成錯誤或警告之狀況的詳細說明，以及如何更正問題的資訊。 |
|
Message
|
warnings.message | string |
造成錯誤或警告之狀況的說明。 |
|
輸出參考標識符
|
warnings.outputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定回應元素 （如果有的話）。 |
|
parameters
|
warnings.parameters | array of object |
各種警告和錯誤訊息會傳回一或多個變數，其中包含有關錯誤或警告的內容資訊。 |
|
名稱
|
warnings.parameters.name | string |
名稱 |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
發生錯誤或警告的子網域名稱。 |
建立庫存位置
使用此呼叫來建立新的庫存位置。 若要建立和發佈優惠，賣家必須至少有一個庫存位置，因為每個優惠都必須與一個位置相關聯。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
商家位置鍵
|
merchantLocationKey | True | string |
商家定義的庫存位置的唯一金鑰。 |
|
地址行 1
|
addressLine1 | string |
街道地址的第一行。 |
|
|
地址行 2
|
addressLine2 | string |
街道地址的第二行。 |
|
|
城市
|
city | string |
庫存位置所在的城市。 |
|
|
國家
|
country | string |
地址所在的國家/地區代碼。 |
|
|
縣
|
county | string |
地址所在的縣。 |
|
|
郵遞區號
|
postalCode | string |
地址的郵政編碼。 |
|
|
州或省
|
stateOrProvince | string |
庫存位置所在的州/省。 |
|
|
緯度
|
latitude | string |
地理座標的緯度元件。 |
|
|
經度
|
longitude | string |
地理座標的經度元件。 |
|
|
位置 附加信息
|
locationAdditionalInformation | string |
有關庫存位置的其他資訊。 |
|
|
地點說明
|
locationInstructions | string |
商店庫存位置的特殊取貨指示。 |
|
|
location類型
|
locationTypes | array of string |
位置類型 |
|
|
位置網址
|
locationWebUrl | string |
與庫存位置相關聯的網站地址。 |
|
|
商家位置狀態
|
merchantLocationStatus | string |
庫存位置狀態可以啟用或停用。 |
|
|
名稱
|
name | string |
庫存位置的名稱。 |
|
|
週中天次
|
dayOfWeekEnum | string |
當天，商店位置有固定營業時間。 |
|
|
關閉
|
close | string |
商店關門時間。 |
|
|
開啟
|
open | string |
店鋪開業時間。 |
|
|
電話
|
phone | string |
商店庫存位置的電話號碼。 |
|
|
Date
|
date | string |
商店位置具有特殊營業時間的特定日期值。 |
|
|
關閉
|
close | string |
商店關門時間。 |
|
|
開啟
|
open | string |
店鋪開業時間。 |
傳回
- response
- string
建立或取代庫存項目
此呼叫會建立新的庫存品項記錄或取代現有的庫存品項記錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
賣方定義的庫存項目值。 |
|
內容語言
|
Content-Language | True | string |
標頭會設定將在要求承載的欄位值中使用的自然語言。 |
|
類型
|
availabilityType | string |
商家實體店庫存商品的庫存狀態。 |
|
|
單位
|
unit | string |
用於指定履行時間的時間單位。 |
|
|
價值觀
|
value | integer |
履行時間價值。 |
|
|
商家位置鍵
|
merchantLocationKey | string |
商家的商店專屬 ID In-Store 取貨庫存商品目前所在或將傳送到的位置。 |
|
|
數量
|
quantity | integer |
可用於 In-Store 取貨的庫存品項數量。 |
|
|
單位
|
unit | string |
用於指定履行時間的時間單位。 |
|
|
價值觀
|
value | integer |
履行時間價值。 |
|
|
商家位置鍵
|
merchantLocationKey | string |
商家的商店專屬 ID In-Store 取貨庫存商品目前所在或將傳送到的位置。 |
|
|
數量
|
quantity | integer |
此庫存位置可用的庫存品項數量。 |
|
|
數量
|
quantity | integer |
可透過一或多個已發佈優惠購買的庫存品項的「出貨到家」總數量。 |
|
|
狀況
|
condition | string |
物品的狀況。 |
|
|
條件說明
|
conditionDescription | string |
庫存品項的條件描述。 |
|
|
高度
|
height | number |
運輸包裹的實際高度。 |
|
|
長度
|
length | number |
運送包裹的實際長度。 |
|
|
單位
|
unit | string |
用於指定託運包裹尺寸的測量單位。 |
|
|
寬度
|
width | number |
託運包裹的實際寬度。 |
|
|
包裝類型
|
packageType | string |
用於運送庫存品項的運送包裹價值。 |
|
|
單位
|
unit | string |
用來指定託運包裹重量的測量單位。 |
|
|
價值觀
|
value | number |
運送包裹的實際重量。 |
|
|
方面
|
aspects | object |
這是商品特定名稱值對的集合，可提供有關產品的更多資訊，並可能使買家更容易找到。 |
|
|
品牌
|
brand | string |
產品品牌。 |
|
|
Description
|
description | string |
產品說明。 |
|
|
EAN項目
|
ean | array of string |
EAN的 |
|
|
電子PID
|
epid | string |
eBay 產品識別碼。 |
|
|
圖片網址
|
imageUrls | array of string |
圖片網址 |
|
|
ISBN 項目
|
isbn | array of string |
國際標準書號 |
|
|
MPN
|
mpn | string |
產品的製造商零件編號。 |
|
|
副標題
|
subtitle | string |
可選的列表功能，允許賣家提供有關產品的更多信息，可能包括可能有助於搜索結果的關鍵字。 |
|
|
Title
|
title | string |
可以新增或修改庫存項目的標題。 |
|
|
UPC 項目
|
upc | array of string |
UPC的 |
|
|
視訊識別碼
|
videoIds | array of string |
視訊標識符 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
警告
|
warnings | array of object |
如果觸發一或多個警告或錯誤，則會在呼叫回應承載中傳回此容器。 |
|
類別
|
warnings.category | string |
此字串值指出錯誤類別。 |
|
網域
|
warnings.domain | string |
發生錯誤或警告的網域名稱。 |
|
錯誤標識碼
|
warnings.errorId | integer |
識別所發生的特定錯誤或警告的唯一代碼。 |
|
inputRefIds
|
warnings.inputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定要求元素 （） （如果有的話）。 |
|
長訊息
|
warnings.longMessage | string |
造成錯誤或警告之狀況的詳細說明，以及如何更正問題的資訊。 |
|
Message
|
warnings.message | string |
造成錯誤或警告之狀況的說明。 |
|
輸出參考標識符
|
warnings.outputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定回應元素 （如果有的話）。 |
|
parameters
|
warnings.parameters | array of object |
各種警告和錯誤訊息會傳回一或多個變數，其中包含有關錯誤或警告的內容資訊。 |
|
名稱
|
warnings.parameters.name | string |
名稱 |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | object |
造成錯誤或警告之狀況的說明。 |
撤回要約
此呼叫可用來結束與指定供應專案相關聯的單一變數清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
供應項目標識碼
|
offerId | True | string |
要撤回的優惠的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
清單 ID
|
listingId | string |
與已撤回的報價相關聯的 eBay 清單的唯一識別碼。 |
|
警告
|
warnings | array of object |
如果有一或多個警告與嘗試撤回優惠相關聯，則會傳回此容器。 |
|
類別
|
warnings.category | string |
此字串值表示錯誤類別 |
|
網域
|
warnings.domain | string |
此字串值表示錯誤類別 |
|
錯誤標識碼
|
warnings.errorId | integer |
識別所發生的特定錯誤或警告的唯一代碼。 |
|
inputRefIds
|
warnings.inputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定要求元素 （） （如果有的話）。 |
|
長訊息
|
warnings.longMessage | string |
造成錯誤或警告之狀況的詳細說明，以及如何更正問題的資訊。 |
|
Message
|
warnings.message | string |
造成錯誤或警告之狀況的說明。 |
|
輸出參考標識符
|
warnings.outputRefIds | array of string |
如果有一或多個警告與嘗試撤回優惠相關聯，則會傳回此容器。 |
|
parameters
|
warnings.parameters | array of object |
各種警告和錯誤訊息會傳回一或多個變數，其中包含錯誤或警告的相關內容資訊。 |
|
名稱
|
warnings.parameters.name | string |
名稱 |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
發生錯誤或警告的子網域名稱。 |
更新優惠
此呼叫會更新可能處於已發佈或未發佈狀態的現有供應專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
供應項目標識碼
|
offerId | True | string |
您要更新之供應專案的唯一識別碼。 |
|
可用數量
|
availableQuantity | integer |
可供購買的庫存數量。 |
|
|
類別識別碼
|
categoryId | string |
eBay 產品將列出的唯一類別 ID。 |
|
|
慈善機構編號
|
charityId | string |
eBay 分配的慈善組織的唯一 ID，該組織將獲得一定比例的銷售收入。 |
|
|
捐款百分比
|
donationPercentage | string |
該慈善組織將收到的清單產生的每筆銷售的購買價格百分比。 |
|
|
生產者產品識別碼
|
producerProductId | string |
與項目相關的生產者的唯一識別碼。 |
|
|
產品套件識別碼
|
productPackageId | string |
賣家新增的產品包裝生產商的唯一 ID。 |
|
|
貨件包裹 ID
|
shipmentPackageId | string |
賣方用來運送商品的任何包裝生產商的唯一 ID。 |
|
|
產品文件ID
|
productDocumentationId | string |
賣方添加到物品包裹中的任何紙張的生產者的唯一標識符。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
隱藏買家詳細資料
|
hideBuyerDetails | boolean |
如果賣家想要建立私人清單，則會包含此欄位。 |
|
|
包含目錄產品詳細資料
|
includeCatalogProductDetails | boolean |
指出是否將 eBay 產品目錄詳細資料套用至清單。 |
|
|
房源說明
|
listingDescription | string |
eBay 列表的描述。 |
|
|
上市期限
|
listingDuration | string |
清單將處於有效狀態的天數。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
啟用最佳優惠
|
bestOfferEnabled | boolean |
指出是否已為清單啟用最佳優惠方案功能。 |
|
|
eBay Plus（如果符合條件）
|
eBayPlusIfEligible | boolean |
如果 Top-Rated 賣家選擇加入 eBay Plus 計劃，則此欄位將包含在報價中。 |
|
|
履行政策識別碼
|
fulfillmentPolicyId | string |
唯一識別碼表示在報價發佈並轉換為 eBay 清單後將使用的履行業務政策。 |
|
|
付款原則識別碼
|
paymentPolicyId | string |
唯一識別碼表示一旦報價發布並轉換為 eBay 列表，將使用的支付業務政策。 |
|
|
產品合規性原則識別碼
|
productCompliancePolicyIds | array of string |
此欄位包含最多五個ID的陣列，指定賣家為清單建立的合規原則。 |
|
|
退貨政策標識符
|
returnPolicyId | string |
傳回業務政策唯一 ID，一旦報價發佈並轉換為 eBay 清單，就會使用該 ID。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
Priority
|
priority | integer |
輸入此欄位的整數值以及 shippingServiceType 值可設定出貨政策中的國內或國際運送服務選項將根據更新的運送成本進行修改。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
服務類型
|
shippingServiceType | string |
此值指出優先順序欄位中指定的託運服務是國內還是國際託運服務選項。 |
|
|
收回原則識別碼
|
takeBackPolicyId | string |
建立收回政策的賣家 ID。 |
|
|
上市開始日期
|
listingStartDate | string |
如果賣家想要指定未來清單在 eBay 上生效的時間，則可以使用此欄位。 |
|
|
手數
|
lotSize | integer |
此欄位僅適用於清單為地段清單時。 傳遞至此欄位的整數值是批次中的項目總數。 |
|
|
商家位置鍵
|
merchantLocationKey | string |
商家庫存位置的唯一識別碼 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
最初以零售價出售
|
originallySoldForRetailPriceOn | string |
如果將在優惠中使用刪除線定價功能，則需要此欄位。 此欄位表示產品已以 eBay 網站上原始 RetailPrice 欄位中的價格出售，或由第三方零售商以該價格出售 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
貨幣
|
currency | string |
代表貨幣類型的三位數字串值。 |
|
|
價值觀
|
value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
|
定價可見性
|
pricingVisibility | string |
如果優惠中使用「最低廣告價格」功能，則需要此欄位。 |
|
|
每個買家的數量限制
|
quantityLimitPerBuyer | integer |
此欄位僅在賣家希望對每個賣家的購買數量設定限制時才適用並設定。 |
|
|
次要類別識別碼
|
secondaryCategoryId | string |
唯一的次要類別 ID，如果賣家決定在兩個類別下列出商品，則適用。 |
|
|
商店類別名稱
|
storeCategoryNames | array of string |
商店類別名稱 |
|
|
適用稅金
|
applyTax | boolean |
只有在將銷售稅表、Value-Added 稅率或稅金例外類別代碼套用至供應專案時，才適用和使用此容器。 |
|
|
第三方稅務類別
|
thirdPartyTaxCategory | string |
稅務例外類別代碼。 如果使用此欄位，銷售稅也將適用於服務/費用，而不僅僅是商品價格。 |
|
|
增值稅百分比
|
vatPercentage | number |
此值是商品的增值稅稅率 （如果有的話）。 指定增值稅百分比時，商品的增值稅資訊會顯示在清單的「檢視商品」頁面上。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
供應項目標識碼
|
offerId | string |
供應專案的唯一識別碼 |
|
警告
|
warnings | array of object |
此容器會在呼叫時傳回，並發生錯誤和/或警告。 |
|
類別
|
warnings.category | string |
此字串值表示錯誤類別 |
|
網域
|
warnings.domain | string |
發生錯誤或警告的網域名稱。 |
|
錯誤標識碼
|
warnings.errorId | integer |
識別所發生特定錯誤或警告的唯一代碼。 |
|
inputRefIds
|
warnings.inputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定要求元素 （） （如果有的話）。 |
|
長訊息
|
warnings.longMessage | string |
造成錯誤或警告之狀況的詳細說明，以及如何更正問題的資訊。 |
|
Message
|
warnings.message | string |
造成錯誤或警告之狀況的說明。 |
|
輸出參考標識符
|
warnings.outputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定回應元素 （如果有的話）。 |
|
parameters
|
warnings.parameters | array of object |
各種警告和錯誤訊息會傳回一或多個變數，其中包含有關錯誤或警告的內容資訊。 |
|
名稱
|
warnings.parameters.name | string |
名稱 |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
發生錯誤或警告的子網域名稱。 |
獲取付款政策
此方法會擷取付款原則的完整詳細資料。 使用 paymentPolicyId 路徑參數提供您要擷取的政策 ID。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
付款原則識別碼
|
payment_policy_id | True | string |
您要擷取的付款政策 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
類別類型
|
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，則買方需要立即付款 |
|
市集識別碼
|
marketplaceId | string |
適用付款業務政策的 eBay 市場的 ID。 |
|
名稱
|
name | string |
適用付款業務政策的 eBay 市場的 ID。 |
|
付款指示
|
paymentInstructions | string |
雖然某些較舊的付款業務政策可能會傳回此欄位，但付款業務政策不再支援付款指示 |
|
paymentMethods
|
paymentMethods | array of object |
此容器會傳回，以顯示付款業務原則所接受的付款方式。 |
|
付款方式類型
|
paymentMethods.paymentMethodType | string |
離線支援的付款方式類型 |
|
付款原則識別碼
|
paymentPolicyId | string |
eBay 指派的唯一 ID，用於付款業務保單。 |
獲取優惠
此呼叫會擷取特定已發佈或未發佈的供應專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
供應項目標識碼
|
offerId | True | string |
要擷取之選件的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
可用數量
|
availableQuantity | integer |
可供買方購買的庫存品項數量。 |
|
類別識別碼
|
categoryId | string |
庫存項目所列的主要 eBay 類別的唯一識別碼。 |
|
慈善機構編號
|
charity.charityId | string |
eBay 分配的慈善組織的唯一識別碼，該組織將獲得一定比例的銷售收入。 |
|
捐款百分比
|
charity.donationPercentage | string |
該慈善組織將收到的清單產生的每筆銷售的購買價格百分比。 |
|
生產者產品識別碼
|
extendedProducerResponsibility.producerProductId | string |
與項目相關的生產者的唯一識別碼。 |
|
產品套件識別碼
|
extendedProducerResponsibility.productPackageId | string |
賣家新增的產品相關的任何包裝生產商的唯一 ID。 |
|
貨件包裹 ID
|
extendedProducerResponsibility.shipmentPackageId | string |
賣家用來運送商品的任何包裝生產商的唯一識別碼。 |
|
產品文件ID
|
extendedProducerResponsibility.productDocumentationId | string |
賣方添加到物品包裹中的任何紙張的生產者的唯一標識符。 |
|
貨幣
|
extendedProducerResponsibility.ecoParticipationFee.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
extendedProducerResponsibility.ecoParticipationFee.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
格式
|
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 |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
啟用最佳優惠
|
listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
如果賣家想要在其清單上支援「最佳優惠」功能，則會使用此容器。 |
|
eBay Plus（如果符合條件）
|
listingPolicies.eBayPlusIfEligible | boolean |
如果 Top-Rated 賣家選擇加入 eBay Plus 計劃，則此欄位將包含在報價中。 |
|
履行政策識別碼
|
listingPolicies.fulfillmentPolicyId | string |
唯一識別碼表示在報價發佈並轉換為 eBay 清單後將使用的履行業務政策。 |
|
付款原則識別碼
|
listingPolicies.paymentPolicyId | string |
唯一識別碼表示一旦報價發布並轉換為 eBay 列表，將使用的支付業務政策。 |
|
productCompliancePolicyIds
|
listingPolicies.productCompliancePolicyIds | array of string |
此欄位包含最多五個ID的陣列，指定賣家為清單建立的合規原則。 |
|
退貨政策標識符
|
listingPolicies.returnPolicyId | string |
唯一識別碼表示報價發佈並轉換為 eBay 清單後將使用的退貨業務政策。 |
|
shippingCostOverrides
|
listingPolicies.shippingCostOverrides | array of object |
如果賣家希望覆寫履行清單政策中定義的一或多個國內或國際運輸服務選項的運輸成本，則使用此貨櫃。 |
|
貨幣
|
listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
Priority
|
listingPolicies.shippingCostOverrides.priority | integer |
輸入此欄位的整數值以及 shippingServiceType 值可設定出貨政策中的國內或國際運送服務選項將根據更新的運送成本進行修改。 |
|
貨幣
|
listingPolicies.shippingCostOverrides.shippingCost.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
listingPolicies.shippingCostOverrides.shippingCost.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
運輸服務類型
|
listingPolicies.shippingCostOverrides.shippingServiceType | string |
此值表示託運服務是國內還是國際託運服務選項。 |
|
收回原則識別碼
|
listingPolicies.takeBackPolicyId | string |
賣家 ID 建立的收回政策。 |
|
上市開始日期
|
listingStartDate | string |
此時間戳記是賣家為排定清單設定的日期/時間。 |
|
手數
|
lotSize | integer |
此欄位僅適用於清單是地段清單。 批次清單是具有相同產品多個數量的清單。 |
|
市集識別碼
|
marketplaceId | string |
提供或將提供優惠的 eBay 網站的唯一識別碼。 |
|
商家位置鍵
|
merchantLocationKey | string |
庫存位置的唯一識別碼。 |
|
供應項目標識碼
|
offerId | string |
優惠的唯一識別碼。 |
|
貨幣
|
pricingSummary.auctionReservePrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
pricingSummary.auctionReservePrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
pricingSummary.auctionStartPrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
pricingSummary.auctionStartPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
pricingSummary.minimumAdvertisedPrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
pricingSummary.minimumAdvertisedPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
最初以零售價出售
|
pricingSummary.originallySoldForRetailPriceOn | string |
如果將在優惠中使用刪除線定價功能，則需要此欄位。 此欄位表示產品已以 eBay 網站上原始 RetailPrice 欄位中的價格出售，或由第三方零售商以該價格出售。 |
|
貨幣
|
pricingSummary.originalRetailPrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
pricingSummary.originalRetailPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
pricingSummary.price.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
pricingSummary.price.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
定價可見性
|
pricingSummary.pricingVisibility | string |
如果優惠中將使用最低廣告價格功能，則需要此欄位。 |
|
每個買家的數量限制
|
quantityLimitPerBuyer | integer |
只有在賣家希望對每個賣家的庫存商品購買數量設定限制時，此欄位才適用。 |
|
次要類別識別碼
|
secondaryCategoryId | string |
次要類別的唯一識別碼，如果賣家決定將商品列在兩個類別下，則適用。 |
|
SKU
|
sku | string |
優惠中產品的賣方定義SKU值。 |
|
地位
|
status | string |
此值會指定供應專案的狀態。 |
|
商店類別名稱
|
storeCategoryNames | array of string |
商店類別名稱 |
|
適用稅金
|
tax.applyTax | boolean |
如果賣家想要參考其帳戶層級的銷售稅，則會包含此欄位 |
|
第三方稅務類別
|
tax.thirdPartyTaxCategory | string |
稅務例外類別代碼。 如果使用此欄位，銷售稅也將適用於服務/費用，而不僅僅是商品價格。 |
|
增值稅百分比
|
tax.vatPercentage | number |
此值是商品的增值稅稅率 （如果有的話）。 指定增值稅百分比時，商品的增值稅資訊會顯示在清單的「檢視商品」頁面上。 |
獲取優惠
此呼叫會擷取指定 SKU 值的所有現有供應專案。 賣家可以選擇將檢索到的報價限制為特定的 eBay 市場或列表格式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
賣家定義的 SKU 值 |
|
市集識別碼
|
marketplace_id | string |
eBay 市場的唯一標識符。 |
|
|
格式
|
format | string |
優惠的清單格式。 |
|
|
限制
|
limit | string |
每頁資料要傳回的記錄數目上限。 |
|
|
Offset
|
offset | string |
要擷取的頁碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
赫雷夫
|
href | string |
目前優惠頁面的URL。 |
|
限制
|
limit | integer |
每個結果頁面上將顯示的選件數。 |
|
Next
|
next | string |
下一頁優惠的URL。 |
|
offers
|
offers | array of object |
此容器是SKU值的一或多個賣方優惠的陣列。 |
|
可用數量
|
offers.availableQuantity | integer |
可供購買的庫存項目數量。 |
|
類別識別碼
|
offers.categoryId | string |
庫存項目列出的 eBay 類別唯一 ID。 |
|
慈善機構編號
|
offers.charity.charityId | string |
eBay 分配的慈善組織的唯一標識符，該組織將獲得一定比例的銷售收入。 |
|
捐款百分比
|
offers.charity.donationPercentage | string |
慈善組織將從每次銷售中獲得的購買價格百分比。 |
|
生產者產品識別碼
|
offers.extendedProducerResponsibility.producerProductId | string |
與項目相關的生產者的唯一識別碼。 |
|
產品套件識別碼
|
offers.extendedProducerResponsibility.productPackageId | string |
賣家新增的包裝產品的唯一 ID。 |
|
貨件包裹 ID
|
offers.extendedProducerResponsibility.shipmentPackageId | string |
賣家用來運送商品的任何包裝生產商的唯一識別碼。 |
|
產品文件ID
|
offers.extendedProducerResponsibility.productDocumentationId | string |
賣方添加到物品包裹中的任何紙張的生產者的唯一標識符。 |
|
貨幣
|
offers.extendedProducerResponsibility.ecoParticipationFee.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.extendedProducerResponsibility.ecoParticipationFee.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
格式
|
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 |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
啟用最佳優惠
|
offers.listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
此欄位指出是否為清單啟用最佳優惠方案功能。 |
|
eBay Plus（如果符合條件）
|
offers.listingPolicies.eBayPlusIfEligible | boolean |
此欄位包含在報價中，如果 Top-Rated 賣家選擇加入 eBay Plus 計劃，則設定為 true |
|
履行政策識別碼
|
offers.listingPolicies.fulfillmentPolicyId | string |
唯一識別碼表示在報價發佈並轉換為 eBay 清單後將使用的履行業務政策。 |
|
付款原則識別碼
|
offers.listingPolicies.paymentPolicyId | string |
唯一識別碼表示一旦報價發布並轉換為 eBay 列表，將使用的支付業務政策。 |
|
productCompliancePolicyIds
|
offers.listingPolicies.productCompliancePolicyIds | array of string |
此欄位包含最多五個ID的陣列，指定賣家為清單建立的合規原則。 |
|
退貨政策標識符
|
offers.listingPolicies.returnPolicyId | string |
唯一識別碼表示報價發佈並轉換為 eBay 清單後將使用的退貨業務政策。 |
|
shippingCostOverrides
|
offers.listingPolicies.shippingCostOverrides | array of object |
如果賣家希望覆寫出貨清單政策中定義的一或多個國內或國際託運服務選項的運費或附加費，則使用此貨櫃。 |
|
貨幣
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
貨幣 |
|
value
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
value |
|
priority
|
offers.listingPolicies.shippingCostOverrides.priority | integer |
priority |
|
貨幣
|
offers.listingPolicies.shippingCostOverrides.shippingCost.currency | string |
貨幣 |
|
value
|
offers.listingPolicies.shippingCostOverrides.shippingCost.value | string |
value |
|
shippingServiceType
|
offers.listingPolicies.shippingCostOverrides.shippingServiceType | string |
shippingServiceType |
|
收回原則識別碼
|
offers.listingPolicies.takeBackPolicyId | string |
建立收回政策的賣家 ID。 |
|
上市開始日期
|
offers.listingStartDate | string |
賣家為排定的清單設定的日期/時間。 |
|
手數
|
offers.lotSize | integer |
此欄位僅在清單為批次清單時適用並傳回。 |
|
市集識別碼
|
offers.marketplaceId | string |
提供或將提供優惠的 eBay 網站的唯一識別碼。 |
|
商家位置鍵
|
offers.merchantLocationKey | string |
庫存位置的唯一識別碼。 |
|
供應項目標識碼
|
offers.offerId | string |
優惠的唯一識別碼。 |
|
貨幣
|
offers.pricingSummary.auctionReservePrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.pricingSummary.auctionReservePrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
offers.pricingSummary.auctionStartPrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.pricingSummary.auctionStartPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
offers.pricingSummary.minimumAdvertisedPrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.pricingSummary.minimumAdvertisedPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
最初以零售價出售
|
offers.pricingSummary.originallySoldForRetailPriceOn | string |
如果將在優惠中使用刪除線定價功能，則需要此欄位。 此欄位表示產品已以 eBay 網站上原始 RetailPrice 欄位中的價格出售，或由第三方零售商以該價格出售。 |
|
貨幣
|
offers.pricingSummary.originalRetailPrice.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.pricingSummary.originalRetailPrice.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
貨幣
|
offers.pricingSummary.price.currency | string |
代表貨幣類型的三位數字串值。 |
|
價值觀
|
offers.pricingSummary.price.value | string |
貨幣欄位中表示的美元值的字串表示法。 |
|
定價可見性
|
offers.pricingSummary.pricingVisibility | string |
如果優惠中使用「最低廣告價格」功能，則需要此欄位。 |
|
每個買家的數量限制
|
offers.quantityLimitPerBuyer | integer |
此欄位僅在賣家希望對每個賣家的庫存商品購買數量設定限制時才適用並設定。 |
|
次要類別識別碼
|
offers.secondaryCategoryId | string |
次要類別的唯一識別碼。 |
|
SKU
|
offers.sku | string |
優惠中產品的賣方定義SKU值。 |
|
地位
|
offers.status | string |
此值會指定供應專案的狀態。 |
|
storeCategory名稱
|
offers.storeCategoryNames | array of string |
如果賣家選擇將庫存項目放入賣家為其 eBay 商店設定的一兩個 eBay 商店類別中，則會退回此容器 |
|
適用稅金
|
offers.tax.applyTax | boolean |
如果賣家想要參考其帳戶層級的銷售稅表來計算訂單的銷售稅，則會包含此欄位。 |
|
第三方稅務類別
|
offers.tax.thirdPartyTaxCategory | string |
稅務例外類別代碼。 |
|
增值稅百分比
|
offers.tax.vatPercentage | number |
商品的增值稅 （VAT） 稅率值 （如果有）。 |
|
上一篇
|
prev | string |
優惠方案上一頁的URL。 |
|
大小
|
size | integer |
目前結果頁面上顯示的選件數目。 |
|
總數
|
total | integer |
指定SKU值存在的選件總數。 |
獲取類別建議
此呼叫會傳回指定類別樹狀結構中類別樹狀結構分葉節點的陣列，eBay 認為這些節點最接近查詢。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
類別樹狀結構識別碼
|
category_tree_id | True | string |
eBay 類別樹狀結構唯一識別碼，要求其建議節點。 |
|
搜尋字詞
|
q | True | string |
描述要出售的商品的搜尋字詞。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
category建議
|
categorySuggestions | array of object |
包含與所提供關鍵字相對應的一或多個建議類別的詳細資訊。 |
|
類別識別碼
|
categorySuggestions.category.categoryId | string |
eBay 類別在其類別樹狀結構中的唯一識別碼。 |
|
類別名稱
|
categorySuggestions.category.categoryName | string |
categoryId 所識別的類別名稱。 |
|
類別樹狀結構節點祖先
|
categorySuggestions.categoryTreeNodeAncestors | array of object |
類別參照的排序清單陣列，描述建議類別在指定類別樹狀結構中的位置。 |
|
categoryId
|
categorySuggestions.categoryTreeNodeAncestors.categoryId | string |
eBay 祖先類別的唯一識別碼。 |
|
類別名稱
|
categorySuggestions.categoryTreeNodeAncestors.categoryName | string |
categoryId 所識別的上階類別名稱。 |
|
categorySubtreeNodeHref
|
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref | string |
getCategorySubtree 呼叫的 href 部分，可擷取上階類別節點下方的子樹狀結構。 |
|
categoryTreeNodeLevel
|
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel | integer |
上階類別節點在其類別樹狀結構階層中的絕對層級。 |
|
類別樹狀結構節點層級
|
categorySuggestions.categoryTreeNodeLevel | integer |
上階類別節點在其類別樹狀結構階層中的絕對層級。 |
|
相關性
|
categorySuggestions.relevancy | string |
此欄位保留供內部或將來使用。 |
|
類別樹狀結構識別碼
|
categoryTreeId | string |
傳回建議的 eBay 類別樹狀結構的唯一識別碼。 |
|
類別樹狀結構版本
|
categoryTreeVersion | string |
categoryTreeId所識別的類別樹狀結構版本。 |
發佈優惠方案
此呼叫用於將未發佈的報價轉換為已發佈的報價或即時 eBay 清單。 供應專案的唯一識別碼 （offerId） 會在呼叫 URI 結尾傳入。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
供應項目標識碼
|
offerId | True | string |
要發佈之供應專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
清單 ID
|
listingId | string |
新建立的 eBay 清單的唯一識別碼。 |
|
警告
|
warnings | array of object |
如果有一或多個警告與嘗試撤回優惠相關聯，則會傳回此容器。 |
|
類別
|
warnings.category | string |
此字串值指出錯誤類別。 |
|
網域
|
warnings.domain | string |
發生錯誤或警告的網域名稱。 |
|
錯誤標識碼
|
warnings.errorId | integer |
識別所發生的特定錯誤或警告的唯一代碼。 |
|
inputRefIds
|
warnings.inputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定要求元素 （） （如果有的話）。 |
|
長訊息
|
warnings.longMessage | string |
造成錯誤或警告之狀況的詳細說明，以及如何更正問題的資訊。 |
|
Message
|
warnings.message | string |
造成錯誤或警告之狀況的說明。 |
|
輸出參考標識符
|
warnings.outputRefIds | array of string |
一或多個參考標識碼的陣列，可識別與錯誤或警告最密切相關的特定回應元素 （如果有的話）。 |
|
parameters
|
warnings.parameters | array of object |
各種警告和錯誤訊息會傳回一或多個變數，其中包含有關錯誤或警告的內容資訊。 |
|
名稱
|
warnings.parameters.name | string |
名稱 |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
發生錯誤或警告的子網域名稱。 |
定義
字串
這是基本資料類型「string」。