| category_id | string | ID của category của sản phẩm này. - Phải là một leaf category tương ứng với loại cây category được chỉ định trong thuộc tính category_version. - Phải là một main category (categories.permission_statuses=AVAILABLE trong Get Global Categories API).Lưu ý: Tham khảo TikTok Shop Academy để biết thông tin về các hạn chế đối với category sản phẩm. |
| brand_id | string | ID của brand của sản phẩm này.Lưu ý: Các brand chưa được ủy quyền sẽ không hiển thị trên TikTok Shop. |
| main_images | []object | Danh sách hình ảnh để hiển thị trong thư viện hình ảnh sản phẩm.- Số lượng tối đa: 9- Sắp xếp các URI hình ảnh theo thứ tự mà chúng sẽ xuất hiện trên TikTok Shop.- Kích thước hình ảnh: [300x300 px, 4000x4000 px] Khuyến nghị:- Sử dụng tối thiểu 5 hình ảnh.- Hình ảnh đầu tiên nên có nền trắng. Sử dụng Optimize Images API để đổi nền sang màu trắng. |
| skus | []object | Danh sách các global Stock Keeping Units (SKU) dùng để xác định các biến thể riêng biệt của sản phẩm.Lưu ý:- Số SKU tối đa cho EU, JP, UK, US: 300- Số SKU tối đa cho các khu vực khác: 100Khuyến nghị: Đặt biến thể quan trọng nhất ở đầu mảng. |
| package_weight | object | Trọng lượng của gói sản phẩm.Lưu ý:- Cung cấp trọng lượng đo được sau khi đóng gói sản phẩm.- Giá trị này ảnh hưởng đến chi phí vận chuyển, vì vậy điều quan trọng là phải đảm bảo các phép đo chính xác. Bất kỳ sai lệch nào cũng có thể dẫn đến phí vận chuyển bổ sung.- Trọng lượng gói sẽ được ưu tiên hơn kích thước gói trong việc tính phí nếu phí dựa trên trọng lượng cao hơn. |
| certifications | []object | Danh sách các chứng nhận cho sản phẩm của bạn.Số lượng tối đa: 10Theo hướng dẫn của TikTok Shop, chứng nhận là bắt buộc đối với một số category sản phẩm bị hạn chế. Lấy các yêu cầu chứng nhận cho sản phẩm của bạn từ Get Global Category Rules API. Tham khảo TikTok Shop Restricted Products Policy để biết thông tin về các hạn chế đối với category sản phẩm. |
| package_dimensions | object | Kích thước của gói sản phẩm.Lưu ý:- Cung cấp kích thước đo được sau khi đóng gói sản phẩm.- Các giá trị này ảnh hưởng đến chi phí vận chuyển, vì vậy điều quan trọng là phải đảm bảo kích thước chính xác. Bất kỳ sai lệch nào cũng có thể dẫn đến phí vận chuyển bổ sung. |
| product_attributes | []object | Danh sách các thuộc tính chung (ví dụ: nhà sản xuất, quốc gia xuất xứ, vật liệu sử dụng) mô tả sản phẩm như một tổng thể, bất kể biến thể.Quan trọng: Các thuộc tính có sẵn để sử dụng được hệ thống xác định dựa trên category được gán cho sản phẩm, một số là bắt buộc. Bạn phải cung cấp các thuộc tính sản phẩm được đánh dấu là is_required trong response của Get Global Attributes API. |
| size_chart | object | Thông tin chi tiết về kích thước của sản phẩm để giúp người mua tìm đúng size.Lưu ý: - Đối với một số category sản phẩm, size chart có thể bắt buộc hoặc không được hỗ trợ. Sử dụng Get Global Category Rules API để kiểm tra các yêu cầu.- Nếu size chart không được hỗ trợ, kể cả khi bạn cung cấp size chart ở đây, size chart sẽ không được lưu.- Cung cấp một trong hai: ID của template size chart TikTok Shop hoặc hình ảnh size chart; nếu cung cấp cả hai, ID sẽ được ưu tiên. |
| video | object | Video giới thiệu hoặc quảng cáo sản phẩm để hiển thị cho sản phẩm của bạn.Khuyến nghị:- Tỷ lệ khung hình: 1:1 - Độ phân giải: HD 720p hoặc cao hơn- Thời lượng: 20 - 60 giây |
| manufacturer | object | (Deprecated: Trường này đã lỗi thời và sẽ bị xóa trong một phiên bản API tương lai. Sử dụng manufacturer_ids thay thế.)Thông tin chi tiết về nhà sản xuất sản phẩm. |
| manufacturer_ids | []string | Danh sách các manufacturer ID phân cách bằng dấu phẩy. Lấy các ID từ Search Manufacturers API.Mặc định: Các ID được cung cấp khi global product được tạo.Lưu ý: Chỉ áp dụng cho thị trường EU trong một số category nhất định. Sử dụng Get Global Category Rules API để kiểm tra các yêu cầu. |
| responsible_person_ids | []string | Danh sách các responsible person ID phân cách bằng dấu phẩy. Lấy các ID từ Search Responsible Persons API.Mặc định: Các ID được cung cấp khi global product được tạo.Lưu ý: Chỉ áp dụng cho thị trường EU trong một số category nhất định. Sử dụng Get Global Category Rules API để kiểm tra các yêu cầu. |
| category_version | string | Phiên bản cây category để gán sản phẩm này vào.Các giá trị có thể có dựa trên khu vực:- US: v2, đại diện cho cây category 7 cấp. Quan trọng: Nếu tài khoản seller chứa một shop US đang hoạt động, bạn phải truyền v2 khi sử dụng API này.- Các khu vực khác: v1, đại diện cho cây category 3 cấp.Mặc định: v1 |
| external_global_product_id | string | Một định danh bên ngoài được sử dụng trong một nền tảng thương mại điện tử bên ngoài. Định danh này dùng để liên kết global product giữa TikTok Shop và nền tảng thương mại điện tử bên ngoài. Độ dài tối đa: 999 ký tự |