Update Product

put

https://open.shopline.io/v1/products/{id}

To update current product information with open API.
透過open API更新既有商品資訊

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

id

string

required

Product ID
欲更新資訊的商品ID

Body Params

Payload for updating product

title_translations

object

Title translations
商品名稱

summary_translations

object

Summary translations
商品說明

description_translations

object

Title translations
商品名稱

show_custom_related_products

boolean

enum

Show Custom Related products
顯示相關商品

Allowed:

related_product_ids

array of strings

Custom related products
自訂相關商品

related_product_ids

same_price

boolean

Main Product and Variation Product share the same price (Including original price and member price)
規格商品是否皆同主商品價格，包含原價格與會員價
1. If same price is true, main product price is required and will be apply to all variation prices
2. If same price is false, variation price is required and each variation can apply different prices.

location_id

string

Stock Unit Number
儲位編號

sku

string

Stock Keeping Unit
商品貨號

seo_title_translations

object

Title translations
商品名稱

seo_description_translations

object

Title translations
商品名稱

seo_keywords

string

Keywords of SEO
SEO關鍵字
*Keywords should be separated by commas (,) max length 160 characters.
關鍵字以逗號(,)分隔, 最長 160字

link

string

is_reminder_active

boolean

Out-Of-Stock Reminder
商品缺貨是否提醒

is_preorder

boolean

Pre-ordered or not
是否開放預購

preorder_limit

integer

Pre-ordere Limit
預購上限

preorder_note_translations

object

Title translations
商品名稱

max_order_quantity

integer

set maximum quantity per purchase for this product
商品單次購買上限
*-1 represents there's no quantity limit for each purchase
-1代表無商品單次購買的上限

weight

number

Product's Weight (kg)
商品重量 (公斤)

tags

string

Tags
標籤
*Tags are used to search products at the admin panel and help set up the product-related coupons.
標籤功能用作商品搜尋，並能為指定商品設置優惠券的用途。

blacklisted_delivery_option_ids

array of strings

Excluded Delivery Options
排除的送貨方式

blacklisted_delivery_option_ids

blacklisted_payment_ids

array of strings

Excluded Payment
Options
排除的付款方式

blacklisted_payment_ids

available_start_time

string

available_end_time

string

schedule_publish_at

string

category_ids

array of strings

Categories' IDs
商品所屬分類之ID

category_ids

tax_type

string

Tax type
國內稅項

oversea_tax_type

string

Oversea tax type
海外稅項

status

string

enum

Product's status
商品狀態
-
true: Published 上架
false: Unpublished 下架
"active": Published 上架
"draft": Unpublished 下架
"hidden": hidden 隱藏

Default: false

Allowed:

images

array of strings

images

detail_images

array of strings

Additional Product Photos
更多商品圖片

detail_images

gtin

string

Barcode
商品條碼編號
-
有規格商品請將請求帶在 variations 欄位中
Requests for products with variants must include them in the variant_options field.

barcode_type

string

enum

Barcode type
商品條碼編號類別

Allowed:

variant_custom_type_translations

array of objects

variant_custom_type_translations

variant_options

array of objects

Product Variations
商品規格
-
Maximum 3 types of variant option for a product, type allow (color, size, custom_1, custom_2, custom_3)
最多支援三種不同的 type, type 支援(color, size, custom_1, custom_2, custom_3)

variant_options

is_replace_variations

boolean

Defaults to false

Is replacing variations?
是否更換全部規格?

variations

array of objects

Product Variations Data
商品規格資訊

variations

unlimited_quantity

boolean

enum

Unlimited product quantity or not.
商品數量是否無限

Allowed:

default_show_image_selector

boolean

Defaults to false

Show variation photos.
展示商品規格圖像。

allow_gift

boolean

Defaults to false

Specifies whether the item can be set as a gift.
是否可以設為贈品
true: the product can be set as a gift.
false: the product cannot be set as a gift.

is_custom

boolean

Defaults to false

Specifies whether the item can be set as a customized product.
是否可以設為訂制商品
true: the product can be set as a custom product.
false: the product cannot be set as a custom product.

brand

string

Product brand
商品品牌
字數不可超過 100 字
Max length is 100 characters.

gender

string

enum

Defaults to unisex

Product Category: Gender
產品類別：性別
-
male 男性
female 女性
unisex 男女通用 (default)

Allowed:

age_group

string

enum

Defaults to all_ages

Product Category:Age Group
產品類別：年齡層
-
all_ages 全年齡 (default)
adult 成人
teen 青少年
kids 兒童
toddler 幼兒
infant 嬰兒
newborn 新生兒

Allowed:

adult

string

enum

Defaults to no

Product Category:Adult
產品類別：成人
-
yes: the product is classified as adult content
no: the product is not classified as adult content (default)

Allowed:

condition

string

enum

Defaults to new

Product Category:Condition
產品類別：狀況
-
new 新品 (default)
refurbished 整新品
used 二手

Allowed:

mpn

string

Manufacturer Part Number
製造編號
-
有規格商品請將請求帶在 variations 欄位中
Requests for products with variants must include them in the variant_options field.

feed_variations

object

Feed Variations
產品資訊 - 顏色、尺寸、材質

cart_tag_id

string

Product Attribute
商品屬性設置

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json