来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [TW] Mandatory and Updated Product Attributes for Specific Categories
#§2 1. Mandatory Attribute Requirement for Mobile & Gadgets Categories
1. Mandatory Attribute Requirement for Mobile & Gadgets Categories
Dear Developer,
To improve product information completeness and buyers' search experience, selected product attributes under the Mobile & Gadgets categories will change from optional to mandatory. Please review the following changes and update your API integration logic before the effective date to avoid item creation or update failures.
For details, please refer to the SEH article.
Scope of Impact
- TW local sellers
- Affected categories: Mobile & Gadgets (please refer to the attachment in the SEH article)
Summary of Changes
- Selected product attributes under the Mobile & Gadgets categories change to mandatory.
Recommendation
- Please refer to the attribute list and mandatory-field information in the SEH article
- You can call v2.product.get_attribute_tree to dynamically retrieve the latest attribute definitions for each category, and use the "mandatory" field to confirm whether an attribute is required.
Validation Logic
Starting from the effective date, a request to create, update or re-list an item under the affected categories must carry the mandatory attributes, otherwise the system will block the request and the item will NOT be created or updated.
Related APIs
- v2.product.get_attribute_tree
- v2.product.search_attribute_value_list
- v2.product.get_recommend_attribute
- v2.product.add_item
- v2.product.batch_add_item
- v2.product.update_item
- v2.product.unlist_item
Note: The system will NOT automatically modify or delist items that were created before the effective date. Existing items will keep their current attribute values until the seller edits them.
Effective date
September 4, 2026
§3 2. Product Attribute Updates for Selected Categories and Used Items
2. Product Attribute Updates for Selected Categories and Used Items
Dear Developer,
To improve product information completeness and buyers' search experience, product attributes for selected categories are being updated, enhancing product exposure and competitiveness. This includes newly added attributes for used items, helping buyers quickly understand the condition of an item. You may review the attribute list and fill in the relevant attribute information based on the actual details of the item.
Reference SEH articles:
Scope of Impact
-
TW local sellers
-
Affected categories: (please refer to the attachment in the SEH article)
- Health
- Home & Living
- Hobbies & Collections
- Spare Parts and Accessories for Vehicles
- Books & Magazines
- Categories related to used items
Summary of Changes
- New attributes have been added for the categories listed above, and the available values of some existing attributes have been adjusted.
Recommendation
- You can call v2.product.get_attribute_tree to dynamically retrieve the latest attribute definitions for each category.
Related APIs
- v2.product.get_attribute_tree
- v2.product.search_attribute_value_list
- v2.product.get_recommend_attribute
- v2.product.add_item
- v2.product.batch_add_item
- v2.product.update_item
Note: The system will NOT automatically modify or delist existing items. Existing values are not automatically carried over into the newly added attributes and need to be filled in by the seller.
Effective date
Lived
§4 1. 手機平板與周邊類別商品屬性調整為必填
1. 手機平板與周邊類別商品屬性調整為必填
開發者您好,
為提升商品資訊完整性與買家搜尋體驗,「手機平板與周邊」類別的部分商品屬性將由選填調整為必填。請於生效日前檢視並更新您的 API 串接邏輯,以避免商品新增或更新失敗。
詳細請參考:賣家幫助中心文章
影響範圍
- TW local 賣家
- 影響商品類別:手機平板與周邊 (請參閱 賣家幫助中心文章 中的附檔)
變更重點摘要
- 「手機平板與周邊」類別的部分商品屬性調整為必填。
建議
- 請參考賣家幫助中心文章的屬性清單與必填資訊。
- 您可以呼叫 v2.product.get_attribute_tree 動態取得類別的最新屬性定義,並透過 "mandatory" 欄位確認是否必填。
驗證邏輯
自生效日期起,相關類別商品於新增、更新或重新上架時,請求皆須帶有必填屬性,否則系統將攔截該請求,商品將無法成功建立或更新。
相關 API
- v2.product.get_attribute_tree
- v2.product.search_attribute_value_list
- v2.product.get_recommend_attribute
- v2.product.add_item
- v2.product.batch_add_item
- v2.product.update_item
- v2.product.unlist_item
注意:系統不會主動更改或下架生效日前已建立的商品,既有屬性值將維持不變,直到賣家自行編輯為止。
生效日期
2026 年 09 月 04 日
§5 2. 部分類別與二手商品的商品屬性更新
2. 部分類別與二手商品的商品屬性更新
開發者您好,
為提升商品資訊完整性與買家搜尋體驗,我們針對部分商品類別更新商品屬性,以強化商品曝光力與競爭力;其中包含新增二手商品屬性,協助買家快速掌握商品狀況。您可檢視屬性清單,並依商品實際情況填寫相關屬性資訊。
詳細請參考賣家幫助中心文章:
影響範圍
-
TW local 賣家
-
影響商品類別:(請參閱 賣家幫助中心文章 中的附檔)
- 保健
- 居家生活
- 愛好與收藏品
- 汽機車百貨/交通用品
- 書籍及雜誌期刊
- 二手商品相關類別
變更重點摘要
- 系統已針對上列類別新增商品屬性,並調整部分既有屬性的選項內容。
建議
- 您可以呼叫 v2.product.get_attribute_tree 動態取得類別的最新屬性定義。
相關 API
- v2.product.get_attribute_tree
- v2.product.search_attribute_value_list
- v2.product.get_recommend_attribute
- v2.product.add_item
- v2.product.batch_add_item
- v2.product.update_item
注意:系統不會主動更改或下架既有商品,既有的屬性值亦不會自動帶入新增的屬性欄位,需要由賣家自行填寫。
生效日期
已上線
