GET Get Global Attributes
Get Global Attributes Seller Required scope: seller.global_product.category.info Truy xuất các thuộc tính sản phẩm và thuộc tính bán hàng tích hợp tiêu chuẩn để đăng một sản phẩm toàn cầu trong một danh mục cụ thể, bất kể sự khác biệt giữa các thị trường. Sản phẩm trên TikTok Shop được nhóm vào các danh mục được TikTok Shop định nghĩa trước, và mỗi danh mục được liên kết với một bộ thuộc tính sản phẩm và thuộc tính bán hàng tiêu chuẩn.
- Thuộc tính bán hàng (ví dụ: kích cỡ, màu sắc, độ dài) xác định các biến thể sản phẩm và là tùy chọn nếu sản phẩm của bạn đơn giản và không có biến thể.
- Thuộc tính sản phẩm (ví dụ: nhà sản xuất, quốc gia xuất xứ, chất liệu sử dụng) mô tả sản phẩm tổng thể, bất kể biến thể. Một số thuộc tính sản phẩm là bắt buộc dựa trên các chính sách đăng sản phẩm. Sử dụng API này để xác định các thuộc tính bắt buộc và tùy chọn trước khi đăng một sản phẩm toàn cầu. Lưu ý: Đây phải là một danh mục lá
tương ứng với loại cây danh mục được chỉ định trong thuộc tính category_version. Version 202309
GET/product/202309/categories/{category_id}/global_attributes
Request
Path
| Properties | Type | Description |
|---|---|---|
| category_id Required | string | ID của danh mục. Đây phải là một danh mục lá. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá 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
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗ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 Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các 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 Required | int | Unix 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ể sử dụng để chuyển đổi sang giờ địa phương. |
| locale | string | Mã locale BCP-47 để hiển thị thông tin danh mục.Default: Locale mặc định của shop của bạn.Possible values:- cs-CZ- de-AT- de-BE- de-DE- el-GR- en-GB- en-IE- en-US- es-ES- es-MX- fr-FR- fr-BE- hu-HU- id-ID- it-IT- ja-JP- ms-MY- nl-NL- nl-BE- pl-PL- pt-BR- pt-PT- th-TH- vi-VN- zh-CN |
| category_version | string | Lọc danh mục theo phiên bản cây danh mục.Possible values based on region:- US, EU and SEA: v2, đại diện cho cây danh mục 7 cấp. Quan trọng: Đối với các shop ở US, EU và SEA, bạn phải truyền v2 khi sử dụng API này.- Other regions: v1, đại diện cho cây danh mục 3 cấp.Default: v1 |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thô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_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12052023 | Category does not exist | | 12052024 | Category is not final category | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052230 | Category version and categoryID are not matched. | | 12052700 | The seller is inactive. | | 12052704 | seller id not exist | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Is this content helpful?Helpful
Not Helpful
PreviousNext