GET Get Brands
Lấy danh sách thương hiệu Shop Scope yêu cầu: seller.product.basic Truy xuất tất cả thương hiệu khả dụng cho shop của bạn, bao gồm các thương hiệu tích hợp sẵn và bất kỳ thương hiệu tùy chỉnh nào được tạo bằng Create Custom Brands API
. Truyền brand ID trả về khi tạo hoặc chỉnh sửa sản phẩm để liên kết thương hiệu với sản phẩm.
- Để kiểm tra xem một thương hiệu có được cấp quyền đầy đủ để sử dụng trong một danh mục sản phẩm cụ thể hay không, hãy chỉ định category ID.
- Để lấy danh sách đầy đủ các thương hiệu mà shop của bạn có thể sử dụng và trạng thái cấp quyền của chúng, hãy bỏ qua category ID. Chúng tôi khuyến nghị bạn chỉ định tên thương hiệu để thu hẹp danh sách thương hiệu trả về. Khái niệm chính Việc bạn có thể chọn và hiển thị một thương hiệu hay không phụ thuộc vào trạng thái cấp quyền của thương hiệu, các danh mục được cấp quyền cho thương hiệu, và liệu thương hiệu có được phân loại là T1 hay không (các thương hiệu nổi tiếng quốc tế yêu cầu phải có sự cấp quyền thương hiệu trước).
- Quy tắc chọn thương hiệu: Bạn chỉ có thể chọn các loại thương hiệu sau đây trong quá trình tạo/chỉnh sửa sản phẩm.
- Các thương hiệu đã được cấp quyền có chứa danh mục mong muốn (authorized_status=AUTHORIZED và brand_status=AVAILABLE)
- Các thương hiệu không phải T1 chưa được cấp quyền (authorized_status=UNAUTHORIZED và is_t1_brand=false)
- Quy tắc hiển thị thương hiệu: Tuy nhiên lưu ý rằng thương hiệu chỉ xuất hiện trên trang hiển thị sản phẩm nếu thương hiệu đã được cấp quyền (authorized_status=AUTHORIZED) và khả dụng trong danh mục mong muốn (brand_status=AVAILABLE). Điều này có nghĩa là bạn cần phải có được sự cấp quyền thương hiệu cho các thương hiệu không phải T1 chưa được cấp quyền trước khi chúng có thể được hiển thị. Lấy quyền cấp phép thương hiệu hoặc thêm danh mục vào một thương hiệu đã được cấp quyền thông qua TikTok Shop Seller Center > Qualification Center > Brand qualification. Đối với người bán Tokopedia: Bạn có thể chọn và hiển thị bất kỳ thương hiệu trả về nào trên Tokopedia bất kể các quy tắc này. Version 202309
GET/product/202309/brands
Request
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 người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
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 tới 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ể dùng để chuyển đổi sang giờ địa phương. |
| category_id | string | Chỉ định một category ID để hiển thị tính khả dụng của các thương hiệu đã được cấp quyền trong danh mục.Lưu ý: Chỉ định giá trị này để lấy danh sách chính xác các thương hiệu bạn có thể sử dụng trong một danh mục. |
| is_authorized | bool | Lọc kết quả theo trạng thái cấp quyền thương hiệu.Các giá trị có thể có:- 1: Chỉ trả về các thương hiệu đã được cấp quyền- 0: Trả về tất cả thương hiệu |
| brand_name | string | Lọc kết quả để bao gồm các tên thương hiệu bắt đầu bằng giá trị đã chỉ định. |
| page_size Required | int | Số lượng kết quả được trả về trên mỗi trang.Phạm vi hợp lệ: [1-100] |
| page_token | string | Một token mờ (opaque) được sử dụng để truy xuất trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ kết quả next_page_token của phản hồi trước đó. Không cần thiết cho trang đầu tiên. |
| category_version | string | Lọc danh mục theo phiên bản cây danh mục.Các giá trị có thể có theo khu vực:- US, EU và 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.- Các khu vực khác: v1, đại diện cho cây danh mục 3 cấp.Mặc định: v1 |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
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 | Các 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 message. |
| 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
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 12019108 | page number is invalid | | 12019109 | page size is invalid | | 12019123 | product of pageSize and pageNumber exceeds the maximum limit | | 12019124 | pageSize and pageNumber need to be used together | | 12052023 | Category does not exist | | 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. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext