来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Summary
Last year in the US market, TikTok Shop rolled out an increase to the levels in the category tree, from three to at-most seven, with the aim of improving product information quality.
Beginning this week, we will be introducing this product category expansion in the SEA market. This changelog will provide a quick overview of API changes you may need to implement.
For a more detailed walkthrough on how to implement the necessary changes, please read our L7 category expansion migration guide.
§2 Impact
| Impacted market(s) | * Southeast Asia (SEA) - Local and cross-border |
| Impacted version(s) | * 202309 (and later) |
§3 Listing new L7 products
When listing new products:
– Use category_version=V1 for L3 category tree
– Use category_version=V2 for L7 category tree
This applies to the following Product APIs: – GET Categories – POST Recommend Category – GET Category Rules – GET Attributes – GET Brands – POST Create Product – PUT Edit Product – POST Search Products
Note: Since the global product publishing (GS POP) workflow is also undergoing changes, developers are advised to directly upgrade to the new GS POP workflow instead of adapting the L7 category using the original Global Product APIs. Please refer to our official changelog for more details.
§4 Upgrade existing products to L7
To upgrade existing products, please use our category upgrade API. This endpoint accepts a Shop Code as a trigger, and will upgrade all active products in that shop to the new categories. We will send a webhook event when categories are being upgraded that includes product ID, old leaf category ID, and new leaf category ID. The following table lists all relevant APIs:
| API/webhook name | Type | Description |
|---|---|---|
| * POST Create Category Upgrade Task | RESTful API | * Upgrades active products to the L7 category. * Note: For newly listed active products, you must wait 24 hours before upgrading the category. |
| * Product category change | Webhook | * Used for monitoring product category changes. * After the upgrade task is created, developers need to receive webhooks to confirm the result of the category upgrade. |
| * POST Search Products | RESTful API | * After receiving the webhook, developers should query the product information for secondary confirmation to verify whether the L7 category has been successfully updated. |