Chuyển tới nội dung chính

POST Recommend Global Categories

Đề xuất danh mục toàn cầu Seller Scope bắt buộc: seller.global_product.category.info Truy xuất các danh mục được đề xuất cho một sản phẩm toàn cầu tiềm năng dựa trên tiêu đề, mô tả và hình ảnh của sản phẩm đó. Nếu bạn đang đồng bộ danh mục sản phẩm từ một hệ thống bên ngoài sang TikTok Shop, hãy sử dụng API này để hỗ trợ phân loại sản phẩm. Lưu ý: Các ký tự hai byte (ví dụ: ký tự tiếng Trung) không được hỗ trợ trong các trường văn bản như mô tả và tiêu đề. Nếu bạn bao gồm chúng, yêu cầu API sẽ thất bại. Version 202309

POST/product/202309/global_categories/recommend

Request

Header

PropertiesTypeDescription
content-type RequiredstringLoại được phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller.

Query

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn.
sign RequiredstringChữ ký được tạo bởi thuật toán gen. Khi bạn gửi yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương.

Body

PropertiesTypeDescription
product_title RequiredstringTiêu đề sản phẩm. Độ dài tiêu đề:- DE, ES, FR, IE, IT, JP, UK, US: [1, 255] - MX:[1,300] - Các khu vực khác: [25, 255]
descriptionstringMô tả sản phẩm ở định dạng HTML.Lưu ý:- Nội dung phải tuân theo cú pháp HTML. Tất cả các thẻ HTML đều được chấp nhận nhưng để tối ưu hiển thị trên trang chi tiết sản phẩm TikTok Shop, hệ thống sẽ tự động chuyển đổi một số thẻ nhất định sang định dạng thay thế, chẳng hạn như hiển thị thẻ dưới dạng hình ảnh.- Độ dài tối đa: 10.000 ký tự.- Nguyên tắc hình ảnh: Bạn phải sử dụng URL hình ảnh TikTok Shop. Tối đa 30 thẻ , mỗi thẻ dưới 4000px với thuộc tính src, width và height.Khuyến nghị: - Nếu bạn đang đồng bộ một mô tả có sẵn từ nền tảng khác, hãy bao gồm toàn bộ mô tả nguồn HTML ở đây.- Cung cấp mô tả chi tiết, lý tưởng là trên 300 ký tự.- Bao gồm 3-5 điểm bán hàng chính, mỗi điểm dưới 250 ký tự, với hình ảnh hỗ trợ.- Sử dụng kích thước hình ảnh 1600x1600 px.
images[]objectHình ảnh sản phẩm, bao gồm hình ảnh thư viện, hình ảnh xuất hiện trong mô tả, hình ảnh biến thể sản phẩm.
category_versionstringPhiên bản cây danh mục để sử dụng cho sản phẩm này.Các giá trị có thể dựa trên khu vực:- US: v2, đại diện cho cây danh mục 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 danh mục 3 cấp.Mặc định: v1

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
messagestringThông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo.
request_idstringNhật ký yêu cầu
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 12019006 | product description is invalid | | 12019009 | product image list is invalid | | 12019064 | No matching categories. Provide the full name of your product, edit its product properties, and try again. | | 12052013 | The product description cannot exceed maximum characters | | 12052051 | The product name exceed max limit characters | | 12052056 | The num of image in description cannot exceed max limit | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052230 | Category version and categoryID are not matched. | | 12052261 | product name is empty | | 12052262 | Chinese characters are not supported in product name | | 12052266 | The product name contains non-English characters. | | 12052301 | Width and length of main image must be at least {{min_limit}}, check uri {{uri}} | | 12052305 | The main images aspect ratio cannot exceed max limit. | | 12052306 | main product images count exceed limit | | 12052340 | product description image uri illegal | | 12052345 | The product description html tag not support. | | 12052346 | The product description has Chinese characters | | 12052348 | The product description html tag required attribute is miss. | | 12052349 | The product description html tag not support nest. | | 12052350 | The product description html tag contain illegal attribute. | | 12052351 | The product description contains non-English characters. | | 12052700 | The seller is inactive. | | 12052704 | seller id not exist | | 12052722 | The image URI does not exist in TikTok Shop. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052912 | No matching category found within your account's main category. Check your main category in the seller profile on Seller Center and ensure your product falls within its scope. | | 12052931 | The title must follow these formatting rules: it cannot contain HTML escape characters (e.g.,  ), emojis, or ASCII control characters (e.g., ). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). | | 12056001 | System error, try again later |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext